스프링부트 초기 세팅

본 포스팅은 Java17 / Gradle / 인텔리제이 / MacOS 환경에서 쓰여졌다.

 

자바 설치

먼저 자바가 안깔려있다면 자바를 설치해야한다.

맥 OS에서는 brew를 통해 손쉽게 설치할 수 있다.

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

brew가 깔려있지 않다면, 위 명령어로 설치할 수 있다.

 

 brew install openjdk@17

brew를 통해 jdk를 설치한다. 여기서는 Java17을 사용할 것이기 때문에 @를 통해 버전을 명시해주었다.

 

vi ~/.zshrc

export JAVA_HOME=/opt/homebrew/Cellar/openjdk@17/17.0.3/libexec/openjdk.jdk/Contents/Home
export PATH=${PATH}:$JAVA_HOME/bin

vi 등의 텍스트편집기로 사용자 폴더에 있는 .zshrc에 path를 추가해주면 자바 관련 세팅은 완료된다.

 

 

인텔리제이 설치

 

Other Versions - IntelliJ IDEA

인텔리제이의 개발사인 jetblain 홈페이지에서 설치할 수 있다.

현재 홈페이지에서 다운로드 탭을 눌러 접근하면 Ultimate 버전의 다운로드만 표시되기 때문에 위 링크를 달아두었다.

 

여기서 좌측은 유료버전인 Ultimate, 우측은 무료버전인 Community이다. 학생이라면 Ultimate를 무료로 사용할 수 있으니 한 번 알아보면 좋을 것 같다. Rest API를 개발하는 정도라면 Community만으로도 충분하다.

 

 

스프링 프로젝트 생성

https://start.spring.io/

위 링크에서 프로젝트를 간단하게 생성할 수 있다.

접속하면 위와 같은 화면이 나온다.

 

Project는 빌드 관리 도구를 선택한다. 요즘에는 Maven보단 Gradle을 더 많이 사용한다.

Gradle에서도 Groovy 버전과 Kotlin 버전으로 나뉘는데, Kotlin 버전은 문법 등이 비교적 강제되어 통일성이 부여되고 개발된 프로젝트를 수정하는 단계에서의 빌드 속도가 Groovy보다 빠른 등 여러 장점이 있다. 다만 본 포스팅에서는 Groovy를 선택하겠다.

 

Language는 사용할 언어를 선택한다. Java 기반으로 개발할 것이기에 Java를 선택해주겠다.

 

Spring Boot에서는 스프링부트의 버전을 선택한다. SNAPSHOT은 아직 개발중인 버전으로 불안정할 수 있다. 따라서 개발이 완료된 버전 중 현재 가장 최신 버전인 3.2.1을 선택하도록 하겠다.

 

Project Metadata에는 여러 입력 사항이 있다. 각각을 정리하면 다음과 같다.

Group: 팀/기업의 도메인 이름
Artifact: 빌드 결과물, 즉 프로젝트의 이름
Name: 이름
Description: 프로젝트 설명
Package name: 패키지 이름, 보통 Group.Artifact로 정해진다.
Packaging: 배포 형태
Java: 자바 버전

 

Dependencies는 프로젝트에서 사용할 라이브러리(의존성)를 미리 추가할 수 있다. 프로젝트 생성 후에 build.gradle에서 새롭게 추가하거나 제거할 수 있다.

참고로, 여기서 따로 추가를 하지 않더라도 spring-boot-starter(-test)라는 의존성이 자동으로 추가된다. 이는 spring에서 간단한 설정과 구성으로 프로젝트의 개발을 빠르게 시작할 수 있도록 만들어주는 프로젝트로, 이를 추가해야 "spring boot"라고 할 수 있다.

 

우리는 미리 spring web과 thymeleaf 라이브러리를 추가할 것이다. 여기서 spring web은 스프링 MVC를 사용하여 RESTful을 포함하는 웹을 구축할 때 사용하는 라이브러리이고, thymeleaf는 서버에서 html을 동적으로 렌더링할 때 사용하는 템플릿엔진이다.

 

모든 세팅이 완료되었으면 아래의 GENERATE 버튼으로 프로젝트를 다운받을 수 있다.

 

프로젝트 실행

인텔리제이에서 "열기"를 누르고, 다운받은 프로젝트(압축 풀어야 함)를 선택하면 프로젝트를 열 수 있다.

프로젝트를 열면 인텔리제이가 알아서 추가한 의존성을 임폴트한다.

 

/src/main/java/[package_name]/[project_name]Application.java에서 프로젝트를 실행할 수 있다.

 

빌드가 완료되면 localhost:8080으로 접근할 수 있다.

 

물론 접근하면 위와 같은 에러 페이지가 출력된다. 당연하다. 아직 아무 것도 안했기 때문이다.

 

 

다음으로

다음 포스팅에서는 스프링부트에서 사용하는 파일들, build.gradle 등의 파일에 대해 소개하도록 하겠다.

https://pupuduck.tistory.com/232

스프링부트 프로젝트 기본 구조