Backend/Spring

[SpringBoot] 프로젝트 생성하기

chocoji 2023. 10. 14. 01:30
💡 오늘은 SpringBoot 프로젝트 생성 방법에 대해 정리해보고자 한다.

주로 다음 두 가지 방법 중 하나를 선택하여 생성한다.

  1. Spring initializr 이용
  2. IDE(IntelliJ, eclipse) 이용

추가적으로 Spring Boot CLI를 이용하여 생성하는 방식도 있다고 한다. 

오늘은 내가 주로 사용하는 방식인 `Spring initializr`와 `IntelliJ`를 이용하여 생성하는 방법에 대해 정리해보려고 한다.

 

Spring Initializr 이용하기

Spring Initializr란?

Spring Boot 애플리케이션을 빠르게 생성하고 구성할 수 있는 웹 기반 서비스이다.

Spring Initializr 사이트에 접속하여 프로젝트 설정 후 `GENERATE`를 클릭하면 `.zip` 형식의 프로젝트 파일을 다운받을 수 있다.

 

설정 정보

 

Project : 빌드 도구

- Gradle - Groovy
- Gradle - Kotlin
- Maven
  • `Gradle`: Groovy 또는 Kotlin과 같은 DSL를 사용하여 빌드 스크립트 작성
  • `Maven`: XML 기반의 프로젝트 설정 파일(POM) 사용

Gradle이 Maven에 비해 빌드 시간이 빠르고, 가독성이 좋기 때문에 Gradle을 많이 사용하는 추세다.

 

Language : 개발 언어

- Java
- Kotlin
- Groovy

 

Spring Boot: 스프링부트 버전

⚠️ 유의사항
1. Spring Boot 3.0부터는 Java 17 이상을 필수적으로 사용해야 한다.
2. SNAPSHOT, M1과 같은 미정식 버전을 제외한 버전을 선택하는 것이 좋다. 즉, 숫자 뒤에 아무것도 없는 버전 선택
  • `SNAPSHOT`, `M1` 등은 아직 정식으로 릴리즈된 버전이 아님을 뜻한다.
  • `SNAPSHOT`: 해당 버전을 정식으로 릴리즈하기 전까지의 최신 상태를 본떠 둔 상태로, 현재 지속적으로 업데이트가 진행 중임을 뜻한다.
  • `M1`: MileStone 1의 약자로, 주요 기능들이 완성되자마자 테스트용으로 공개된 버전을 의미한다.

 

Project Metadata: 프로젝트 메타데이터

  • Group: 기업 도메인명 역순으로 입력 - ex) com.example
  • Artifact: 프로젝트명. 빌드 후 생성되는 산출물의 파일명이 된다.
  • Name: 애플리케이션 이름. Artifact 입력 시 자동으로 채워진다.
  • Description: Spring Boot 프로젝트 설명
  • Package name: Group과 Artifact 조합으로 자동으로 채워진다.

 

Packaging: 패키징 유형

- Jar
- War
  • `Jar`: 실행 가능한 Jar 파일을 생성한다.
  • `War`: 웹 애플리케이션 아카이브 파일을 생성한다.

Jar는 Spring boot 가이드 표준이기도 하고, 별도의 웹 서버 or WAS가 필요하지 않으므로,
특별한 경우(외장 WAS 사용 등)가 아니면 Jar를 사용하는 것을 추천한다.

 

Java: 자바 버전

Dependencies: 의존성

  • `ADD DEPENDENCIES`를 클릭하여 필요한 의존성 라이브러리를 추가할 수 있다.
  • ex) Lombok, Spring Web 등

 

프로젝트 실행하기

프로젝트 설정을 마친 뒤, 프로젝트 파일 다운로드까지 완료하였다면, 압축을 해제한 뒤 IDE를 이용하여 해당 파일을 열면 된다.

 

IntelliJ 이용하기

⚠️ 해당 기능을 사용하려면 IntelliJ Ultimate 버전을 사용해야 한다. (학생 인증하면 무료로 사용할 수 있다.)
🔗IntelliJ 설치 페이지
https://www.jetbrains.com/ko-kr/idea/download/?section=windows
🔗 IntelliJ 학생 인증하는 방법
https://goddaehee.tistory.com/215

 

IntellIj를 설치한 뒤, `New Project`를 클릭하면 다음과 같은 화면이 뜬다. (`Spring Initilizr` 선택)

프로젝트 설정을 완료한 뒤, `Next` 클릭하기

`Java 버전` 및 `Dependencies` 설정까지 마친 후 `Finish`를 클릭하면 생성 끝!

 

Ref

jar, war의 차이 - https://hye0-log.tistory.com/27