Spring Boot에서 REST API 엔드포인트 만들기: HelloController 실습 가이드

Spring Boot에서 기본 REST API 엔드포인트 만들기

React와 연동하기 위한 백엔드 개발의 첫걸음으로, Spring Boot에서 가장 기본적인 REST API 엔드포인트를 만드는 방법을 단계별로 안내합니다.

• 1) 컨트롤러 클래스 생성
  src/main/java/패키지명/controller 폴더를 만듭니다.
  (패키지명은 보통 com.example.demo 등 프로젝트에 따라 다릅니다.)
  새 파일을 생성: HelloController.java
• 2) 컨트롤러 코드 작성
  아래 코드를 복사해 붙여넣고, package 선언 부분은 본인 프로젝트의 패키지명에 맞게 수정하세요.

  package com.example.demo.controller; // ← 본인 패키지명에 맞게 수정
  
  import org.springframework.web.bind.annotation.GetMapping;
  import org.springframework.web.bind.annotation.RequestMapping;
  import org.springframework.web.bind.annotation.RestController;
  
  @RestController
  @RequestMapping("/api")
  public class HelloController {
  
      @GetMapping("/hello")
      public String hello() {
          return "Hello, React!";
      }
  }
  

• 3) 서버 실행
  터미널에서 프로젝트 루트 폴더로 이동 후 아래 명령어를 실행하세요.
  

  ./mvnw spring-boot:run

  또는

  ./gradlew bootRun

  IDE에서는 DemoApplication.java를 실행해도 됩니다.
• 4) API 동작 확인
  브라우저 또는 Postman에서 http://localhost:8080/api/hello 로 접속
  "Hello, React!" 라는 문자열이 화면에 출력되면 성공입니다.