스프링 부트(Spring Boot) 환경 세팅 후 첫 프로젝트 생성하기

 


1. 필요한 것

Spring Boot Project를 진행하기 위해서는 크게 아래의 3가지를 준비해야 합니다.

  1. JDK (Java Development Kit) : JDK는 자바 개발을 위해 제공되는 가장 널리 사용되는 소프트웨어 개발 키트입니다. 자바 개발을 하기 위하여 필요한 도구입니다.
  2. IDE (Integrated Development Environment) : IDE는 통합 개발 환경으로 Visual Studio, Eclipse, IntelliJ와 같은 프로그램을 개발할 수 있는 환경을 제공하는 프로그램입니다. 주로 Spring Project 에는 Eclipse와 IntelliJ를 많이 사용합니다.
  3. Spring Initializr : Spring Boot Project 를 생성할 때에는 Spring Initializr를 이용하여 Spring Spring Boot 프로젝트 파일 생성하기

2. 설치 및 준비 과정

2.1. JDK (Java Development Kit) 설치하기

2.1.1. Oracle 홈페이지에서 다운로드

JDK를 하기 위해서는 글자를 클릭하여 Oracle 홈페이지나 AdoptOpenJDK 홈페이지에 들어가서 원하는 버전을 선택하여 다운로드를 진행하면 됩니다. 아래와 같은 화면을 볼 수 있으며 원하는 JDK 버전을 선택하여 JDK Download 버튼을 눌러 다운로드를 진행합니다.

Oracle 다운로드 페이지는 아래와 같습니다. 아래에서 원하는 버전을 선택하여 다운로드 받으면 됩니다. 저는 JDK 16을 선택하였습니다. Oracle 에서 다운로드 하기 위해서는 계정을 생성하여 로그인해야 합니다. 원하는 OS 설치 파일을 다운받아 설치를 진행해줍니다.

image Oracle JDK SE 설치 페이지 _ Java SE 16

image Oracle JDK SE 설치 페이지 _ Java SE 8

image Oracle JDK SE 설치 페이지 _ OS에 맞는 설치파일 선택

2.1.2. AdoptOpenJDK 홈페이지에서 다운로드

로그인 과정을 원하지 않고 AdoptOpenJDK 다운로드 페이지에서 JDK 를 다운로드 받을 수 있습니다. 아래의 화면에서 원하는 JDK 버전과 JVM 을 선택할 수 있습니다(잘 모른다면 JVM은 HotSpot을 선택하면됩니다).

image adoptopenjdk _ OS에 맞는 설치파일 선택

2.1.3. JDK (Java Development Kit) 설치 확인하기

위의 두 방법 중에 하나를 이용하여 JDK 가 설치되면 JDK 설치를 확인하는 것이 좋습니다ㅣ. Windows에서는 설치 파일에서 next를 모두 눌러서 정상적으로 설치가 완료되면 아래와 같이 C:\Program Files\Java 링크에 JDK 폴더가 생성된 것을 확인할 수 있습니다.

image C:\Program Files\Java 경로에서 확인한 JDK 폴더

설치가 완료되면 명령 프롬프트에서 java --version cmd 를 입력하여 실제 자바가 잘 깔렸는지 확인할 수 있습니다.

image cmd에서 java 설치 확인

Mac OS 의 경우 Terminal에 java --version cmd 를 입력하여 실제 자바가 잘 깔렸는지 확인할 수 있습니다.

2.2. IDE (Integrated Development Environment)

Jetbrain의 IntelliJ에 들어가면, InterlliJ를 다운받을 수 있습니다. 다운로드는 Community Version은 무료이며, 기능이 더 많은 Ultimate 는 유료입니다. Community version을 OS에 맞는 실행 파일을 이용하여 IntelliJ를 설치를 진행해 줍니다.

image IntelliJ 다운로드

2.3. Spring Initializr

Spring Initializr에 들어가면, Spring Boot를 위한 프로젝트 zip 파일을 다운받을 수 있습니다. Spring에서 진행해야 되는 복잡한 프로젝트 설정을 아래와 같이 간단한 옵션 선택을 통하여 바로 프로젝트를 생성할 수 있습니다.

image Spring Initializr 사이트

각각의 항목은 아래와 같은 의미를 가지고 있습니다.

  • Package
    • 앱이나 라이브러리를 컴파일, 빌드 및 패키징하기 위한 유연한 방법을 제공
    • Maven, Gradle 중에 선택할 수 있으며, 최근에는 Gradle을 많이 사용하는 추세
  • Language
    • 개발을 위한 프로그래밍 언어 선택.
    • Java, Kotlin, Groovy
  • Spring Boot
    • Spring Boot Version 선택
  • Project Metadata
    • Group
      • Group id는 여러가지 프로젝트들 사이에서 프로젝트를 식별하게 해주는 식별자, 고유한 이름(ex. com.googl)
      • 주로 Group은 기업의 도메인명을 반대로 입력(ex. google.com -> com.google 과 같은 형태로 입력)
    • Artifact
      • 빌드 결과물 이름.
      • aritifact는 소프트웨어의 산출물을 의미. 자바는 빌드하게 되면 .jar 파일이 만들어지고 이 파일의 이름을 aritifact라고 함.
      • 버전 정보는 기입하지 않음
    • Name
    • Description
    • Pacakge name
      • Group 과 Artifact 가 합쳐져서 만들어짐
    • Packaging
    • Java
      • JDK Version 선택
  • Dependencies
    • 프로젝트에 사용되는 부가적인 기능을 위하여 사용하기 위한 Dependency 라이브러리

하기와 같이 세팅하여 GENERATE 버튼을 눌러주면 압축된 파일을 다운로드 받을 수 있습니다.

image Spring Initializr 사이트 _ Dependencies가 추가된 상태

3. Spring 서버 실행하기

image 다운로드 받은 파일의 구조

Spring Boot를 위하여 다운로드한 압축 파일을 해제하면 Artifact로 지정한 이름인 demo로 폴더가 생성됩니다. demo 폴더 내부로 들어가면 구조는 위의 이미지 같은 구조로 되어 있습니다. 프로젝트를 수행하기 위해서는 위에서 다운받은 IntelliJ를 이용하여 아래와 같이 build.gradle 을 실행시켜줍니다.

image Project Open을 할 때, build.gradle 선택

image Project Open을 할 때, build.gradle 선택2

image Open as Project 선택

프로젝트가 정상적으로 완료되면 아래와 같은 모양으로 프로젝트가 생성됩니다.

image Open as Project 선택

이렇게 Project를 정상적으로 수행하게 되면 DemoApplication이라는 Java Class가 생성된 것을 확인할 수 있습니다. 해당 Class에서 오른쪽 마우스를 누르고 Run 버튼을 눌러서 Spring 웹 어플리케이션을 동작시킬 수 있습니다.

image Spring Boot Application 수행

Spring Server가 정상적으로 수행되면 기본적으로 8080 port를 사용합니다. 해당 포트에 접속하기 위하여 http://localhost:8080/ 로 접속하여 정상적으로 동작하는 것을 확인해줍니다.

image 정상적으로 수행된 Spring Server

위의 페이지가 뜨면 정상적으로 서버가 수행되고 있는 상태입니다. 다만 아직 어떤 내용을 넣을지 정하지 않아 이런 메시지가 뜨고 있습니다. 아래의 그림과 같이 IntelliJ의 하단 로그를 보면 Tomcat이 8080 포트를 이용하는 것을 확인할 수 있습니다.

image IntelliJ를 보면 Tomcat이 8080 포트를 이용하는 것을 확인할 수 있습니다.

index.html을 넣는 과정은 다음에 더 자세히 알아보겠습니다.