DEV/Spring

[Spring Boot] java 기반 Spring Boot 프로젝트 생성 방법

Bi3a 2023. 10. 12. 07:34

목차
반응형

java 기반 Spring Boot 프로젝트 생성 방법
Spring boot 기초 깨부시기

 

 

본 포스팅은 Window 환경에서 IntelliJ를 활용한 생성방법에 대해만 다룹니다.

 

설치 자바 버전 확인

좌하단 윈도, 검색 → 명령 프롬프트(a.k.a cmd)로 들어가 본인의 설치된  java 버전을 확인합니다.

 

shell
닫기
java -version

 

java -version으로 cmd로 자바 버전 확인
자바 버전 확인, 저는 17버전을 쓰고 있습니다.

 

2Spring Initializer 접속, Spring Boot 프로젝트 생성

Spring Initializer는 Spring Boot 기반으로 프로젝트를 간편하게 생성할 수 있는 기능을 제공하는 사이트입니다.

 

접속 링크 : https://start.spring.io/

 

spring initializer 홈페이지 접속
접속하면 보이는 화면

 

간략하게 설명하겠습니다.

  • Project : 어떤 프로젝트 구성 관리 및 빌드 툴로 빌드할 것인지를 정합니다.
    • Maven : Java 전용 프로젝트 관리 도구 (비교적 역사가 오래되었음)
    • Gradle : Maven을 대체로 나온 관리 도구, Maven에 비해 빌드 속도가 10~100배 빠르며, 재사용과 가독성 용이

 

  • Spring Boot : 사용할 스프링 부트 버전을 선택합니다.
    • 안정성 및 변화 주기는 Snapshot <  M < RC < GA(Release version) 순입니다.
    • 업데이트 및 배포 또한 Snapshot(이전 버전) →  M → RC → GA(Release version) → Snapshot(다음 버전) 순으로 진행됩니다. 
    • Snapshot : 실험 중인 버전으로 안정화 진행 중, 업데이트 주기가 데일리 ~ (가장 최신 버전)
    • M(Miletone) : 실험 중인 버전,  안정화 진행중, 정해진 주기마다 배포하는 버전으로 Snapshot보다는 안정적
    • RC(Release candidate) : 실험 중인 버전, M 버전에서 조금 더 정제되고 안정화되었음
    • GA : 최종 release 버전

 

  • Project Metadata : 생성할 프로젝트의 개요와 정의를 작성합니다.
    • Group : 그룹명을 지정합니다. 보통은 기업 도메인을 작성하므로 만약 작성할 웹사이트의 이름이 helloworld.com이라면, com.helloworld와 같이 통상 작성합니다.
    • Artifact : 빌드되어 나올 결과물입니다.
    • Name : 프로젝트명(통상 Artifact와 동일하게 설정해줍니다.
    • Description : 프로젝트의 설명을 작성합니다.
    • Package name : 패키지 이름이며 위 아티팩트와 그룹 등을 설정하면 자동으로 설정해 줍니다.

 

  • Packaging : Jar로 선택하면 tomcat이 자동으로 세팅되어 단독 실행이 가능합니다.
  • Java : 1단계에서 확인하였던 자바 버전에 맞게끔 설정을 합니다.
  • Dependencies : 의존성 및 가져올 라이브러리를 선택합니다.
    • 추천하는 dependencies
    • Spring Web : RESTful api 및 Spring MVC, 톰캣을 지원하는 기초 웹 빌드 라이브러리
    • Tymeleaf : HTML을 빌드하는 템플릿 엔진으로 여러 가지 기능을 지원
    • Lombok : 코드 재사용성을 높여주는 어노테이션 라이브러리

 

모든 설정을 마쳤으면 폴더를 지정하고 Generate를 눌러 zip 파일을 다운로드합니다.

 

ZIP파일 압축해제, IntelliJ에서 프로젝트 오픈

프로젝트 구조 화면
압축 해제 시 아래와 같은 하위 파일이 생성됩니다.

압축해제한 파일의 폴더를 개인이 작업할 폴더로 옮겨놓은 뒤 Intellij에서 오픈합니다.

저와 같은 경우는 mogakco라는 패키지 스트럭쳐 파일입니다.

여기서 build.gradle 파일을 선택 후 오픈하면 됩니다.

Open → Open as Project

 

build.gradle 지정

 

Spring Boot 프로젝트 파일 실행

src → main → java → 패키지명 → 패키지명+Application.java 파일을 연 후 run으로 실행합니다.

 

콘솔에 spring이 뜨면 정상이다.
콘솔 창에 아래와 같은 화면이 표시되면 성공한겁니다.

 

localhost:8080 접속

콘솔 창에 이후에는 톰캣을 통해 8080 포트에 열었다고 명시가 되어 있으므로

브라우저를 통해 localhost:8080으로 접속해 봅니다.

 

localhost 8080의 white error page
위와 같은 창이 떴으면, 스프링 프로젝트 생성에 성공했습니다.

 

부가 : 빌드 설정

Spring Boot 프로젝트가 실행될 때 Gradle, Maven을 통해 실행이 아닌, IntelliJ를 통해 실행될 수 있게끔 설정합니다. 

 

1. Settings (Ctrl + ALt + S) → Build, Execution, Deployment → Build Tools → 지정한 프로젝트 관리 툴로 들어갑니다.

 

build &gt; gradle &gt; intellij idea로 변경

 

2. 설정되어 있는 Build and run using, Run tests using을 default에서 IntelliJ로 바꿔줍니다.

 

이로써 Gradle을 거치는 것이 아닌 IDEA에서 바로 빌드 실행을 하므로 빌드 시간이 단축됩니다.

반응형