Spring Boot 3.1.x 환경세팅부터 Swagger 까지(1)

 

현재 진행하고 있는 프로젝트에 Backend 개발환경을 SpringBoot로 진행하게 되었고, API Doc은 Swagger 로 관리하기로 하여

환경세팅 부터 Swagger 설정까지 차근차근 해보기로 한다.

 

[ 개발환경 기준 ]

✔ OS : MAC Intel Ventura 13.2.1

✔ Tool : IntelliJ IDEA

✔ JDK : OpenJDK 17

✔ Spring Boot 3.1.2

✔ Gradle/Groovy

 

Maven보단 스크립트 방식으로 가독성이 좋고 빌드캐시와 병렬빌드를 지원하는 Gradle 로 진행하기로 하였다.

Spring Boot 3.x 대 부터는 Java 17 버전이 필수이므로, Open JDK 를 설치하였다.(참고로 Oracle JDK는 유료이다.)

(패키지관리를 위해 Homebrew가 설치되었다는 가정하에 진행하였다.)

 

1. Open JDK 설치

brew install openjdk@17

 

 

(설치후) 환경변수 설정

echo 'export PATH="/usr/local/opt/openjdk@17/bin:$PATH"' >> ~/.zshrc 

source ~/.zshrc

 

(설치확인)

java -version 

 

 

2. 프로젝트 생성

File -> New -> Project

 

 

Next를 눌러 Spring Boot 버전 세팅과, 필요한 Dependency 를 미리 세팅한다(나는 간단히 테스트만 할 용도로 4개정도만 하였다.) 

의존성 추가는 추후 build.gradle 에서 수정이 가능하다.

( Spring security 를 따로 추가하지 않으면 WhiteLabel Page 가 보일것이다.)

 

 

2-1.  혹시나 Gradle JVM 설정이 안되어있을경우 아래와같은 에러가 뜰 수 있다.

 

고럴땐

Settings -> build,Excution,Devlopment -> Gradle 로 진입해서

Gradle JVM 에 값을 세팅해주면된다.

 

 

 

3. 웹페이지 확인

Finish 를 누른뒤 서버가동후

http://localhost:8080/ 로 접속하게 되면,

되면 아래와 같은 화면이 뜨게 된다.

 

 

다음시간에는 Spring Security 설정 및 Swagger 설정을 같이 해보도록 하겠다.