Spring Boot는 간편한 설정과 자동화된 설정으로 신속하게 웹 애플리케이션을 개발할 수 있는 프레임워크입니다. 이번 포스트에서는 Spring Boot를 사용하여 RESTful API 서버를 구축하는 방법에 대해 알아보겠습니다.

목차

1. Spring Boot 프로젝트 생성
2. 의존성 추가
3. API 컨트롤러 작성
4. 빌드 및 실행
5. API 테스트

1. Spring Boot 프로젝트 생성

먼저 Spring Initializr를 사용하여 Spring Boot 프로젝트를 생성합니다. Spring Initializr 웹 사이트에 접속하여 아래와 같이 프로젝트 설정을 입력합니다.

• Project: Maven Project
• Language: Java
• Spring Boot: 2.5.4 (최신 버전)
• Group: com.example
• Artifact: myapi
• Packaging: Jar
• Java: 11 (혹은 원하는 버전)
• Dependencies: Spring Web

설정을 마치고 프로젝트를 생성한 후, IDE에서 해당 프로젝트를 열어 진행합니다.

2. 의존성 추가

Spring Boot 프로젝트는 Maven 또는 Gradle을 사용하여 의존성을 관리합니다. 이번 포스트에서는 Maven을 사용하여 설명합니다. pom.xml 파일에 다음과 같이 spring-boot-starter-web 의존성을 추가합니다.

<dependencies>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>
</dependencies>

의존성을 추가한 후, IDE에서 Maven 프로젝트를 업데이트합니다.

3. API 컨트롤러 작성

Spring Boot에서는 @RestController 어노테이션을 사용하여 API 컨트롤러를 작성할 수 있습니다. com.example.myapi.controller 패키지를 생성하고, 해당 패키지에 SampleController 클래스를 다음과 같이 작성합니다.

package com.example.myapi.controller;

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

@RestController
public class SampleController {

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

위의 코드는 /hello 경로로 요청이 들어오면 “Hello, World!”라는 문자열을 반환하는 간단한 API를 구현한 것입니다.

4. 빌드 및 실행

프로젝트를 빌드하고 실행하기 위해 터미널 또는 IDE의 터미널 창에서 다음 명령어를 실행합니다.

mvn spring-boot:run

Spring Boot 애플리케이션은 8080 포트에서 실행되며, 브라우저에서 http://localhost:8080/hello로 접속하여 API 응답을 확인할 수 있습니다.

5. API 테스트

API를 테스트하기 위해 Postman 또는 curl 명령을 사용할 수 있습니다. 터미널에서 다음 명령어를 실행하여 API를 테스트할 수 있습니다.

curl http://localhost:8080/hello

위의 명령어를 실행하면 “Hello, World!”라는 응답을 받을 수 있습니다.

이제 Spring Boot를 사용하여 간단한 RESTful API 서버를 구축하는 방법에 대해 알아보았습니다. Spring Boot는 편리한 개발 환경과 자동 설정으로 웹 애플리케이션 개발을 더욱 쉽고 빠르게 할 수 있습니다.

더 자세한 내용은 Spring Boot 공식 문서를 참고하세요.