[3장] Spring Boot 프로젝트 첫 실행 — 처음 만나는 Spring Boot

 

 

3장. Spring Boot 프로젝트 첫 실행

3.1 서버 첫 실행

MyappApplication.java 파일을 열고 왼쪽 ▶ 버튼을 클릭하거나 Shift + F10을 누릅니다.

Started MyappApplication in 5.421 seconds (process running for 6.424)

▲ 서버 첫 실행 콘솔 — Started MyappApplication 메시지 확인

3.2 브라우저에서 확인

브라우저에서 http://localhost:8080 에 접속합니다.
아직 아무 API도 없으므로 아래 화면이 뜨는 것이 정상입니다.

▲ Whitelabel Error Page — API가 없을 때 나타나는 정상 화면

Whitelabel Error Page는 에러가 아닙니다.
Spring Boot 서버가 정상 실행됐지만 해당 경로에 매핑된 API가 없다는 뜻입니다.

3.3 첫 번째 API 만들기

com/example/myapp 폴더에 HelloController.java 파일을 만들고 아래 코드를 작성합니다.

package com.example.myapp;

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

@RestController
public class HelloController {

    @GetMapping("/hello")
    public String hello() {
        return "안녕하세요! Spring Boot입니다.";
    }
}

서버 재시작 후 http://localhost:8080/hello 에 접속합니다.

▲ localhost:8080/hello — 첫 API 응답 성공!

3.4 코드 분석

어노테이션	역할
@RestController	이 클래스가 REST API 컨트롤러임을 Spring에 알림
@GetMapping("/hello")	GET /hello 요청을 이 메서드가 처리함
return 값	반환값이 그대로 HTTP 응답 본문이 됨

3.5 Spring Boot 동작 흐름

클라이언트 (브라우저/앱)
    │ GET /hello
    ▼
DispatcherServlet ← 모든 요청의 첫 번째 관문
    │ "/hello" 처리할 컨트롤러 탐색
    ▼
HelloController.hello() 실행
    │ "안녕하세요!" 반환
    ▼
HTTP 응답으로 클라이언트에 전달

DispatcherServlet은 Spring Boot가 자동으로 생성하고 관리합니다.
개발자가 직접 만들 필요 없습니다.