스프링 부트 3 설치 및 설정 가이드

 

스프링 부트(Spring Boot)는 스프링 프레임워크를 더욱 쉽게 사용하고 신속하게 애플리케이션을 개발할 수 있도록 도와주는 도구입니다. 특히, 스프링 부트 3은 최신 기능과 성능 최적화를 통해 개발자들에게 더 나은 개발 환경을 제공합니다. 이 글에서는 스프링 부트 3을 설치하고 기본 설정을 하는 방법을 단계별로 안내하겠습니다.

1. JDK 설치

스프링 부트 3을 사용하기 위해서는 JDK(Java Development Kit)가 필요합니다. JDK 17 이상을 권장합니다. 다음 단계에 따라 JDK를 설치합니다.

1. JDK 다운로드:
   • Oracle JDK 또는 OpenJDK 웹사이트에서 JDK를 다운로드합니다.
2. JDK 설치:
   • 다운로드한 설치 파일을 실행하고 안내에 따라 설치를 완료합니다.
   • 설치가 완료되면 JAVA_HOME 환경 변수를 설정합니다. 이는 시스템 설정에서 환경 변수를 통해 설정할 수 있습니다.
3. 설치 확인:
   • 명령 프롬프트(또는 터미널)를 열고 java -version 명령어를 입력하여 JDK가 정상적으로 설치되었는지 확인합니다.

$ java -version
java version "17.0.1" 2021-10-19 LTS
Java(TM) SE Runtime Environment (build 17.0.1+12-LTS-39)
Java HotSpot(TM) 64-Bit Server VM (build 17.0.1+12-LTS-39, mixed mode, sharing)

2. 스프링 부트 CLI 설치

스프링 부트 CLI(Command Line Interface)는 스프링 애플리케이션을 빠르게 생성하고 실행할 수 있도록 도와줍니다. 다음은 스프링 부트 CLI를 설치하는 방법입니다.

1. 스프링 부트 CLI 다운로드:
   • 스프링 부트 다운로드 페이지에서 스프링 부트 CLI를 다운로드합니다.
2. 스프링 부트 CLI 설치:
   • 다운로드한 압축 파일을 풀고, bin 디렉토리를 시스템의 PATH 환경 변수에 추가합니다.
3. 설치 확인:
   • 명령 프롬프트(또는 터미널)를 열고 spring --version 명령어를 입력하여 스프링 부트 CLI가 정상적으로 설치되었는지 확인합니다.

$ spring --version
Spring CLI v3.0.0

3. 스프링 이니셜라이저(Spring Initializr) 사용

스프링 이니셜라이저는 웹 인터페이스를 통해 스프링 프로젝트를 손쉽게 생성할 수 있도록 도와줍니다. 다음 단계에 따라 스프링 이니셜라이저를 사용해 보겠습니다.

1. 스프링 이니셜라이저 접속:
   • 웹 브라우저를 열고 스프링 이니셜라이저에 접속합니다.
2. 프로젝트 설정:
   • 프로젝트 메타데이터를 입력합니다.
     • Project: Gradle Project 또는 Maven Project 선택
     • Language: Java 선택
     • Spring Boot: 3.x.x 선택
     • Project Metadata: Group, Artifact, Name, Description 등 입력
3. 의존성 추가:
   • 필요한 의존성을 추가합니다. 예를 들어, Spring Web, Spring Data JPA, Thymeleaf 등을 선택합니다.
4. 프로젝트 생성 및 다운로드:
   • 모든 설정이 완료되면 GENERATE 버튼을 클릭하여 프로젝트를 생성하고 다운로드합니다.

4. IDE에서 프로젝트 열기

다운로드한 프로젝트를 IDE(IntelliJ IDEA, Eclipse, VS Code 등)에서 열어 설정을 완료합니다.

1. 프로젝트 열기:
   • IDE를 열고, Open or Import 메뉴를 선택하여 다운로드한 프로젝트를 엽니다.
2. 의존성 다운로드:
   • 프로젝트를 열면 Gradle 또는 Maven이 자동으로 필요한 의존성을 다운로드하고 설정합니다.
3. 애플리케이션 실행:
   • src/main/java 디렉토리 아래에 생성된 Application 클래스를 찾아 실행합니다.

package com.example.demo;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication
public class DemoApplication {

    public static void main(String[] args) {
        SpringApplication.run(DemoApplication.class, args);
    }

}

IDE의 실행 버튼을 클릭하거나 명령 프롬프트에서 ./gradlew bootRun 또는 mvn spring-boot:run 명령어를 입력하여 애플리케이션을 실행합니다.

5. 애플리케이션 설정

스프링 부트 애플리케이션 설정은 src/main/resources 디렉토리의 application.properties 또는 application.yml 파일을 통해 이루어집니다. 예를 들어, 서버 포트를 변경하고 데이터베이스 연결을 설정하는 방법은 다음과 같습니다.

1. 서버 포트 변경:
   • application.properties 파일에 다음 설정을 추가합니다.

server.port=8081

1. 데이터베이스 설정:
   • MySQL 데이터베이스를 사용하는 예제입니다.

spring.datasource.url=jdbc:mysql://localhost:3306/mydb
spring.datasource.username=myuser
spring.datasource.password=mypassword
spring.jpa.hibernate.ddl-auto=update

6. 예제 코드

스프링 부트 3을 이용한 간단한 RESTful 웹 서비스 예제를 만들어 보겠습니다.

1. Controller 클래스 생성:
   • src/main/java/com/example/demo 디렉토리에 HelloController 클래스를 생성합니다.

package com.example.demo;

import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class HelloController {

    @GetMapping("/hello")
    public String hello() {
        return "Hello, Spring Boot 3!";
    }
}

1. 애플리케이션 실행 및 테스트:
   • 애플리케이션을 실행하고 웹 브라우저에서 http://localhost:8081/hello에 접속하여 결과를 확인합니다.

7. 결론

이로써 스프링 부트 3의 설치 및 기본 설정 과정을 마쳤습니다. 이 가이드를 통해 스프링 부트를 쉽게 시작할 수 있을 것입니다. 다음 단계로는 다양한 스프링 부트 기능을 활용하여 더 복잡한 애플리케이션을 개발해 보시기 바랍니다. 스프링 부트의 강력한 기능과 편리한 설정을 통해 빠르고 효율적인 개발을 경험하시길 바랍니다.