본문으로 건너뛰기
Advertisement

2.2 프로젝트 환경 설정 (Project Setup)

가장 빠르고 표준화된 방식인 '스프링 이니셜라이저(Spring Initializr)'를 사용하여 첫 번째 스프링 부트 프로젝트를 생성하고 로컬 환경에 구성하는 방법을 알아봅니다.

1. 스프링 이니셜라이저 접속하기​

스프링 생태계를 관리하는 곳에서 제공하는 공식 프로젝트 생성 페이지입니다. https://start.spring.io/ 에 접속합니다.

2. 초기 세팅 옵션 고르기​

웹 화면에서 다음 설정들을 개발하고자 하는 용도에 맞춰 선택합니다. 아래는 권장되는 실무 표준(Standard) 빌드 환경입니다.

Project & Language​

  • Project: Gradle - Groovy (의존성을 관리하는 도구입니다. 현재 실무에서는 전통적인 Maven보다 Gradle을 압도적으로 선호합니다.)
  • Language: Java (자바 언어 기반)

Spring Boot Version​

  • 괄호 안에 (SNAPSHOT)이나 (M1), (RC1)이 붙어있지 않은 순수한 숫자(예: 3.4.1)만 적힌 최신 버전 을 선택하세요. 안정화(Stable) 버전이라는 뜻입니다.

Project Metadata​

  • Group: 기업의 도메인 명을 뒤집어서 적는 관례가 있습니다. (예: com.example)
  • Artifact: 프로젝트의 결과물 이름입니다. 영소문자와 하이픈(-) 조합을 추천합니다. (예: my-first-app)
  • Name: 프로젝트의 표기 이름 (예: my-first-app)
  • Description: 프로젝트 설명 (예: Demo project for Spring Boot)
  • Package name: 기본 패키지 계층 구조입니다. (자동으로 Group + Artifact 로 합쳐짐)
  • Packaging: Jar (스프링 부트는 내장 톰캣을 포함하여 하나의 자바 실행 파일(Jar)로 패키징할 수 있습니다.)
  • Java: 본인의 환경에 깔려있는 자바 버전에 맞춥니다. (현재 LTS 표준인 17 이상 사용).

3. 의존성 (Dependencies) 추가하기​

가장 중요한 부분입니다. 개발에 필요한 라이브러리(스타터 모듈)를 장바구니에 담듯 추가할 수 있습니다. Add Dependencies 버튼을 눌러보세요.

  1. Spring Web: 필수 항목. 내부 톰캣 서버와 스프링 MVC 엔진(REST API), 그리고 JSON 매핑 라이브러리(Jackson)를 한 번에 추가해줍니다.
  2. Lombok: Getter, Setter, 생성자 코드를 단 한 번의 애너테이션으로 자동 생성해주는 자바 개발의 필수 라이브러리입니다.

4. 프로젝트 다운로드 및 IDE 열기​

  1. 모든 세팅이 끝나면 좌측 하단의 [GENERATE] 버튼을 클릭하여 .zip 압축 파일을 다운받습니다.
  2. 프로젝트를 열 폴더로 이동하여 압축을 해제합니다.
  3. 인텔리제이(IntelliJ IDEA)를 실행합니다.
  4. File -> Open 메뉴에서, 압축을 푼 폴더 내부의 코끼리 아이콘이 그려진 build.gradle 파일을 선택하여 엽니다.
  5. "Open as Project" 여부를 묻는다면 수락하고, IDE 하단의 진행바(Gradle 갱신) 처리가 완전히 끝날 때까지 대기합니다. (첫 로딩은 1~2분 소요)

5. 실행 확인​

src/main/java/com/example/.../Application.java (녹색 재생 마크가 달린 클래스) 파일을 열고 Run을 클릭하세요. 하단 콘솔에 아래와 같은 스프링 배너가 출력되고 에러 로그 없이 끝나면 준비가 완료된 것입니다!

  .   ____          _            __ _ _
 /\\ / ___'_ __ _ _(_)_ __  __ _ \ \ \ \
( ( )\___ | '_ | '_| | '_ \/ _` | \ \ \ \
 ...
Started Application in 2.15 seconds
Advertisement
Advertisement