[IntelliJ] 인텔리제이 Ultimate 버전 Spring Boot 프로젝트 생성 방법

Spring Boot 프로젝트 생성

💢 Community Edition (무료버전)에서는 Spring 프로젝트 생성 도구가 없기 때문에 직접 세팅을 해야 하는 불편함이 있습니다

✅ Uitimate 버전에서는 Spring 생성을 도와주는 도구가 있기 때문에 편리하게 프로젝트를 생성할수 있습니다

 

이전에 설치 했던 인텔리제이 Uitimate 버전으로 Spring Boot 프로젝트를 생성하는 방법을 알아보겠습니다

[IntelliJ] 인텔리제이 Ultimate 버전 설치 및 학생용 라이선스 발급 방법

인텔리제이를 실행하고 새 프로젝트를 눌러 프로젝트를 생성합니다

프로젝트 생성 창을 보면 Uitimate 버전은 기본 프로젝트 유형외 여러 가지 프로젝트 유형의 생성 도구를 지원하고 있습니다

이중 Spring Boot 제너레이터를 선택해줍니다

 

- 이름: Spring 프로젝트의 이름을 지정

- 위치: Spring 프로젝트의 경로를 지정

- 언어: Spring 프로젝트에 사용할 언어 지정

- 타입: Project 빌드 도구를 설정

빌드 도구: 컴파일,테스트 빌드,배포 등의 작업을 하는 빌드를 자동화하는 프로그램

Maven (pom.xml)

• XML 기반 설정 
• 프로젝트 구조가 정형화
• Gradle보다 느린 빌드 속도

<dependencies>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
        <version>3.0.0</version>
    </dependency>
</dependencies>

Gradle (build.gradle Groovy DSL)

• Groovy 기반 DSL
• XML보다 간결한 문법
• 빌드 속도가 빠름
• 대중적으로 많이 사용됨

plugins {
    id 'org.springframework.boot' version '3.0.0'
    id 'java'
}

dependencies {
    implementation 'org.springframework.boot:spring-boot-starter-web'
}

Gradle (build.gradle.kts - Kotlin DSL)

• Kotlin 기반 DSL
• 타입 안정성이 좋으며 IDE 자동 완성 기능이 원할
• Spring Boot 공식 추천

plugins {
    id("org.springframework.boot") version "3.0.0"
    kotlin("jvm") version "1.8.0"
}

dependencies {
    implementation("org.springframework.boot:spring-boot-starter-web")
}

요즘은 Maven보다는 Gradle을 주로 사용하는 추체로 보인다

 

하지만 이런 개인 프로젝트는 주로 사용되는 빌드 도구를 사용하면 되지만

기존 프로젝트를 관리하거나 여러 사람과 협업할 때는 고려해야 하는 부분이 있다고 생각한다

 

여러 명이 Maven이 익숙하거나 필요로 한다면 사용해야 할 거고 최신 기술을 도입해보기 위해서 Gradle을 선택할 수도 있다

이런 프로젝트를 구성할 때 여러 번 고민해 보고 어떤 장단점이 있는지 확인하는 습관을 들이면 좋겠다

• 그룹: Spring 프로젝트의 그룹을 지정 (회사 및 개인 도메인을 넣고 도메인 역순으로 작성)
• 아티팩트: Spring 프로젝트의 아티팩트를 지정,이름과 동일

JDK (Java Development Kit)

Spring Boot 3.x 버전 이상은 JDK 17 이상 요구하고 있다

그러므로 3 버전 이상을 사용한다면 JDK를 다운로드하여 사용해야 합니다

JDK가 없거나 버전이 맞지 않는다면 JDK 다운로드를 통해서 받을 수 있습니다

JDK 다운로드를 누르고 버전과 공급업체를 선택

Amazon Corretto의 17 버전 JDK를 사용합니다

패키지생성

항목	JAR (Java ARchive)	WAR (WEB Application Archive)
실행 방식	내장 웹 서버 포함	외부 WAS(Tomcat,JBoss 등)에서 실행
설치 필요 여부	별도 설치 필요 없음	WAS 설치 필요
배포환경	클라우드,컨테이너	엔터프라이즈 환경
설정변경	application.properties 수정 가능	배포 환경에서 설정 변경

JAR는 내장 웹 서버를 포함하여 java -jar 실행으로 웹 서버가 자동으로 실행됩니다 

WAR는 내장 웹 서버가 존재하지 않고 외부 WAS에 배포하여 사용됩니다 

 

이런 사이드 프로젝트를 구성하다면 내장 웹 서버를 포함하는 JAR를 사용하는 게 좋겠네요

배포 환경에 따라서 다르게 사용하면 될 것 같습니다

종속성 (Dependencies) 설정

프로젝트 설정을 완료하고 다음을 누르면 Spring에서 의존성이라고 부르는 종속성을 설정해야 합니다

간단하게 말하면 Spring 프로젝트에 사용될 라이브러리를 추가하는 과정입니다

😊 거의 기본으로 사용되는 의존성

• Spring Web: REST AI 및 MVC 개발
• Lombok: Getter,Setter 자동 생성

💾 데이터베이스 관련 의존성

• Spring Data JPA: Spring의 ORM JPA 및 Hibernate 지원
• H2 Database: 인메모리 데이터베이스
• MySQL Driver: MySQL 연결 드라이버
• 여러가지 DB Driver: 각각 DB 드라이버

🔒보 안 기능 관련 의존성

• Spring Security: 인증 및 인가 기능
• OAuth2 Client: OAuth2 기반 로그인

✅ OAuth2가 뭐죠?

Google,Facebook,Github등 소셜 로그인을 통한 안전한 인증 및 인가 방식을 제공하는 프로토콜

프로젝트에  필요한 의존성을 선택하여 추가해 줍니다 간단하게 만들 예정이라서 Spring Web만 추가하겠습니다

 

생성 단계에서 의존성을 모두 추가할 필요는 없습니다

https://mvnrepository.com/ 사이트에서 필요한 의존성을 검색하여 build.gradle에 추가하면 됩니다

생성 버튼을 누르면 Spring 프로젝트 생성이 완료됩니다

 

프로젝트를 처음 실행하면 Gradle 파일 다운로드 등 Spring Boot에 필요한 파일들이 다운로드가 진행됩니다

다운로드가 끝날 때까지 기다리고 Spring 프로젝트가 정상적으로 작동하는지 테스트를 진행합니다

project - src - main - java - com.(도메인).(이름) 경로의 (이름) Application.java 파일을 더블클릭

상단 또는 코드 좌측에 위치한 재생 버튼을 눌러 Spring Boot를 실행

서버가 정상적으로 실행되면 다음과 같이 로그가 나오게 됩니다

브라우저에 http://localhost:8080 입력하여 서버에 접속하게 되면 다음과 같은 메시지가 출력됩니다

현재는 요청을 처리할 controller가 없기 때문에 404 에러를 표시