Study/spring

[Java] Spring initializr 사용법(start.spring.io)

 

Spring initalizr는 스프링 부트 프로젝트를 생성할 수 있게 해주는 도구입니다.

start.spring.io 페이지에서 생성하는 방법과 CLI 환경에서 명령어를 사용해서 생성하는 방법을 설명드리겠습니다.

 

웹 페이지에서 생성하는 방법

https://start.spring.io/에 접속합니다.

Spring initalizr 메인 화면
Spring initalizr 메인 화면

 

Project: 프로젝트 빌드 도구입니다. Maven을 사용할지, Gradle을 사용할지 선택하면 됩니다.

Language: 프로젝트에서 사용할 언어입니다. Java나 Kotlin, Groovy 중 원하는 언어를 선택합니다.

Spring Boot: 버전을 선택합니다. 스프링 부트 2버전은 더이상 선택할 수 없기 때문에 3버전을 선택해야 합니다. 

SNAPSHOT이 붙은 버전은 아직 정식 출시되지 않은 버전이기 때문에 SNAPSHOT이 없는 버전을 사용하는 것이 좋습니다.

Project Metadata: 프로젝트 관련 설정입니다.

- Group: 패키지 이름입니다.

- Artifact: 모듈의 이름입니다. 프로젝트를 빌드하면 artifact id 이름으로 파일이 생성됩니다.

- Name: 프로젝트의 이름입니다. 프로젝트의 이름대로 스프링부트의 메인 클래스가 생성됩니다.

- Description: 프로젝트에 대한 설명입니다.

- Package name: 프로젝트에서 사용할 패키지의 이름입니다. group을 작성하면 자동으로 작성이 됩니다.

- Packaging: 패키징을 jar로 할지, war로 할지 선택하면 됩니다.

- Java: 사용할 자바의 버전입니다. 스프링부트 3 버전부터는 자바 17버전 이상이어야 합니다.

 

Dependencies

프로젝트에서 사용할 의존성을 설정하는 곳입니다.

Spring Initalizr Dependencies
Spring Initalizr Dependencies

spring-boot-starter-web, spring-boot-starter-security 등 스프링 부트 의존성을 여기에서 추가할 수 있습니다.

 

 

 

 

 

 

미리보기

설정한 프로젝트가 어떻게 구성되어있는지 미리볼 수 있습니다.

아래의 EXPLOER 버튼을 누르거나 Ctrl + Space를 누르면 프로젝트 구성 미리보기가 가능합니다.

Spring Initalizr에서 설정한 프로젝트 미리보기
Spring Initalizr에서 설정한 프로젝트 미리보기

상단의 Download를 누르면 파일별로 다운로드할 수 있고, Copy를 누르면 파일 내용을 복사할 수 있습니다.

 

프로젝트 다운로드

설정이 끝났으면 하단의 GENERATE 버튼을 누르거나 Ctrl + Enter를 누르면 프로젝트 zip 파일이 다운로드됩니다.

 

 

명령어를 사용하는 방법

curl 명령어로 스프링 부트 프로젝트를 생성할 수 있습니다.

curl https://start.spring.io/starter.zip -d dependencies=web,security -o cli-project.zip

curl 명령어로 프로젝트 생성

 

프로젝트 import

인텔리제이에서 진행하였습니다.

 

1. 생성된 zip 파일의 압축을 풀어줍니다.

2. 열기 기능으로 폴더를 엽니다.

압축 푼 폴더 안에 폴더가 하나 더 있을 수도 있고 없을 수도 있는데, pom.xml이나 build.gradle이 있는 폴더가 프로젝트 폴더입니다.

프로젝트 폴더 열기
프로젝트 폴더 열기

 

3. 프로젝트를 열고 조금 기다려주시면 프로젝트 세팅이 완료됩니다.

프로젝트 열기 완료