🌱 Spring Boot 시리즈 10 — 프론트 컨트롤러 패턴 & DispatcherServlet 흐름 완전 정리

김세현·2025년 10월 22일

Spring boot

Spring

목록 보기

10/19

날짜:2025-10-22

학습 목표

프론트 컨트롤러 패턴 이해
어댑터 패턴 이해
DispatcherServlet의 동작 원리 파악
/hello 예제를 통해 요청–응답 흐름 익히기

1. 프론트 컨트롤러 패턴

프론트 컨트롤러란?

모든 요청을 단일 진입점에서 받아 공통 로직을 처리하고, 이후 적절한 컨트롤러로 위임하는 구조입니다.

기존 방식의 문제점

각 서블릿마다 공통 로직(인증, 로깅, 인코딩 등)이 중복
기능 추가 시 모든 서블릿을 수정해야 함
관리가 어렵고 일관성 유지가 힘듬

프론트 컨트롤러 도입 후

모든 요청을 중앙 컨트롤러가 먼저 처리
공통 로직을 한 곳에서 관리
필요한 컨트롤러로 작업을 위임(delegate)
👉 즉, “모든 요청이 한 곳을 거친다”는 개념입니다.

장점

공통 로직 중앙화
일관된 요청 처리 흐름
유지보수성과 확장성 향상

2. 어댑터 패턴

정의

서로 다른 인터페이스를 연결해주는 디자인 패턴
즉, 다형성을 활용해 다양한 컨트롤러를 통합적으로 다루는 구조입니다.

Spring MVC에서의 필요성

-- Spring은 다양한 형태의 컨트롤러(@Controller, Controller 인터페이스, HttpRequestHandler 등)를 지원합니다.

이때 각기 다른 형태의 컨트롤러를 일관된 방식으로 처리하려면 어댑터 패턴이 필요합니다.

 // @Controller 어노테이션 방식
    @Controller
    public class HelloController {
    @RequestMapping("/hello")
    public String hello() {
        return "hello";
    }
    }

    // Controller 인터페이스 방식
    public class OldController implements Controller {
    @Override
    public ModelAndView handleRequest(HttpServletRequest request, HttpServletResponse response) {
        return new ModelAndView("hello");
    }
    }

    // HttpRequestHandler 방식
    public class SimpleController implements HttpRequestHandler {
    @Override
    public void handleRequest(HttpServletRequest request, HttpServletResponse response) {
        // 처리 로직
    }
    }

어댑터로 해결하기

// HandlerAdapter 인터페이스
   public interface HandlerAdapter {
   boolean supports(Object handler);
   ModelAndView handle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception;
   }

예시 구현

// @Controller용 어댑터
   public class RequestMappingHandlerAdapter implements HandlerAdapter {
   @Override
   public boolean supports(Object handler) {
       return handler instanceof HandlerMethod;
   }

   @Override
   public ModelAndView handle(HttpServletRequest request, HttpServletResponse response, Object handler) {
       return invokeHandlerMethod((HandlerMethod) handler, request, response);
   }
   }

// Controller 인터페이스용 어댑터
    public class SimpleControllerHandlerAdapter implements HandlerAdapter {
    @Override
    public boolean supports(Object handler) {
        return handler instanceof Controller;
    }

    @Override
    public ModelAndView handle(HttpServletRequest request, HttpServletResponse response, Object handler) {
        return ((Controller) handler).handleRequest(request, response);
    }
    }

장점

다양한 컨트롤러 타입을 통일된 방식으로 처리 가능
새로운 컨트롤러 추가 시 어댑터만 추가하면 됨
기존 코드 수정 없이 확장 가능

3.DispatcherServlet

DispatcherServlet이란?

Spring MVC의 핵심 프론트 컨트롤러입니다.
프론트 컨트롤러 패턴과 어댑터 패턴을 기반으로 만들어져,모든 요청의 진입점이 됩니다.

동작 흐름

1️⃣ 클라이언트 요청 → DispatcherServlet 도착
2️⃣ HandlerMapping → 어떤 컨트롤러가 처리할지 탐색
3️⃣ HandlerAdapter → 해당 컨트롤러를 실행
4️⃣ 컨트롤러 실행 → ModelAndView 반환
5️⃣ ViewResolver → 뷰 이름을 실제 뷰 객체로 변환
6️⃣ 뷰 렌더링(View Rendering)
7️⃣ 클라이언트에게 최종 응답 반환

hello 예제

이번 예제에서 우리가 구현할 부분은 비즈니스 로직 부분(Controller + View) 입니다.
나머지 복잡한 흐름은 모두 Spring이 자동으로 처리합니다.

의존성

dependencies {
 implementation 'org.springframework.boot:spring-boot-starter-thymeleaf'
 implementation 'org.springframework.boot:spring-boot-starter-web'
 compileOnly 'org.projectlombok:lombok'
 annotationProcessor 'org.projectlombok:lombok'
 testImplementation 'org.springframework.boot:spring-boot-starter-test'
 testRuntimeOnly 'org.junit.platform:junit-platform-launcher'
 }

HelloController

@Controller
   public class HelloController {
   
   @GetMapping("/hello")
   public String hello(Model model) {
       model.addAttribute("message", "Hello, Spring!");
       return "hello"; // view 이름
   }
   }

hello.html

<!DOCTYPE html>
   <html xmlns:th="http://www.thymeleaf.org">
   <head>
   <title>Hello Page</title>
   </head>
   <body>
   <h1 th:text="${message}">(메시지가 보여지는 곳)</h1>
   </body>
   </html>

실행 결과

서버 실행 후
👉 http://localhost:8080/hello 접속 시 브라우저에

정리

패턴	역할	핵심 포인트
프론트 컨트롤러	요청의 단일 진입점	공통 로직 중앙 관리
어댑터 패턴	다양한 컨트롤러 지원	다형성 기반 확장성
DispatcherServlet	Spring MVC의 핵심 컨트롤	요청–응답 전체 흐름 관리

김세현

개발자를 위한 한 걸음

이전 포스트

🌱 Spring Boot 9 — MVC 패턴, Thymeleaf, 그리고 SSR & CSR 이해하기

다음 포스트