@RestController와 @GetMapping으로 첫 API 만들기

컨트롤러(Controller)와 API의 기초

웹 브라우저나 모바일 앱이 서버에 데이터를 요청할 때, 서버에서 가장 먼저 요청을 맞이하는 문지기 역할을 하는 것이 바로 Controller입니다. 이번 시간에는 클라이언트에게 데이터를 반환하는 RESTful API를 @RestController와 @GetMapping 어노테이션을 활용해 직접 만들어봅니다.

💡 핵심 어노테이션(Annotation)

스프링 부트에서는 골치 아픈 설정 파일 대신, 자바 클래스나 메서드 위에 @어노테이션을 붙여 기능을 부여합니다. 프레임워크가 알아서 어노테이션을 읽고 필요한 빈(Bean)들을 메모리에 올리고 연결해줍니다.

어노테이션	역할 설명
`@RestController`	이 클래스가 REST API의 진입점임을 선언하며, 응답 시 기본적으로 JSON/텍스트 형식으로 데이터를 직렬화하여 반환합니다.
`@GetMapping("/경로")`	HTTP GET 요청을 특정 메서드와 매핑합니다. 지정된 URL로 요청이 오면 이 메서드가 실행됩니다.

실전 코딩: 간단한 인사말 API 만들기

사용자가 브라우저 주소창에 /api/hello를 입력하면 환영 메시지를 반환하는 백엔드 코드를 작성해 봅시다.

      
      HelloController.java
    

package com.minstudio.demo.controller;

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

@RestController  // 이 클래스가 API 요청을 처리하는 컨트롤러임을 선언
public class HelloController {

    // 브라우저가 GET /api/hello 주소로 요청할 때 실행되는 메서드
    @GetMapping("/api/hello")
    public String sayHello() {
        return "안녕하세요! 스프링 부트로 만든 첫 API입니다.";
    }
}

localhost:8080/api/hello

안녕하세요! 스프링 부트로 만든 첫 API입니다.