DispatcherServlet 심화 — HTTP 요청 하나가 컨트롤러에 도달하기까지

1. 클라이언트 → 서블릿 컨테이너 (톰캣)
2. → Filter 체인 (서블릿 필터)
3. → DispatcherServlet.service()
4.   → HandlerMapping: 요청에 맞는 핸들러 검색
5.   → HandlerExecutionChain: 핸들러 + 인터셉터 반환
6.   → HandlerInterceptor.preHandle()
7.   → HandlerAdapter: 핸들러 실행
8.     → ArgumentResolver: 파라미터 바인딩
9.     → 컨트롤러 메서드 실행
10.    → ReturnValueHandler: 반환값 처리
11.  → HandlerInterceptor.postHandle()
12.  → ViewResolver: 뷰 해석 (필요 시)
13.  → View 렌더링 또는 HttpMessageConverter 변환
14.  → HandlerInterceptor.afterCompletion()
15. → Filter 체인 (응답)
16. → 클라이언트

// 등록된 HandlerMapping 순서 (기본)
// 1. RequestMappingHandlerMapping → @RequestMapping 기반
// 2. BeanNameUrlHandlerMapping → 빈 이름으로 URL 매핑
// 3. RouterFunctionMapping → 함수형 엔드포인트
// 4. SimpleUrlHandlerMapping → 정적 리소스 등

// HandlerAdapter 인터페이스
public interface HandlerAdapter {
    boolean supports(Object handler); // 이 핸들러를 처리할 수 있는가?
    ModelAndView handle(HttpServletRequest request,
                        HttpServletResponse response,
                        Object handler); // 핸들러 실행
}

RequestMappingHandlerAdapter
├── ArgumentResolver로 파라미터 바인딩
│   ├── @RequestParam → RequestParamMethodArgumentResolver
│   ├── @PathVariable → PathVariableMethodArgumentResolver
│   ├── @RequestBody → RequestResponseBodyMethodProcessor
│   └── @ModelAttribute → ModelAttributeMethodProcessor
├── 컨트롤러 메서드 호출
└── ReturnValueHandler로 반환값 처리
    ├── @ResponseBody → RequestResponseBodyMethodProcessor
    ├── ModelAndView → ModelAndViewMethodReturnValueHandler
    └── String (뷰 이름) → ViewNameMethodReturnValueHandler

protected void doDispatch(HttpServletRequest request, HttpServletResponse response) {
    // 1. 핸들러 검색
    HandlerExecutionChain mappedHandler = getHandler(request);
    if (mappedHandler == null) {
        noHandlerFound(request, response); // 404
        return;
    }

    // 2. 핸들러 어댑터 검색
    HandlerAdapter ha = getHandlerAdapter(mappedHandler.getHandler());

    // 3. 인터셉터 preHandle
    if (!mappedHandler.applyPreHandle(request, response)) {
        return; // 인터셉터가 false 반환하면 중단
    }

    // 4. 핸들러 실행 (컨트롤러 메서드 호출)
    ModelAndView mv = ha.handle(request, response, mappedHandler.getHandler());

    // 5. 인터셉터 postHandle
    mappedHandler.applyPostHandle(request, response, mv);

    // 6. 뷰 렌더링 또는 응답 작성
    processDispatchResult(request, response, mappedHandler, mv, null);
}

@RestController
@RequestMapping("/api/users")
public class UserController {

    @GetMapping("/{id}")
    public UserResponse getUser(@PathVariable Long id) {
        // 이 메서드가 호출되기까지의 과정:
        // 1. HandlerMapping: GET /api/users/123 → 이 메서드 매핑
        // 2. ArgumentResolver: "123" → Long 123으로 변환
        // 3. 메서드 실행
        // 4. ReturnValueHandler: UserResponse → JSON 변환
        User user = userService.findById(id);
        return UserResponse.from(user);
    }
}

logging:
  level:
    org.springframework.web.servlet.DispatcherServlet: DEBUG
    org.springframework.web.servlet.handler.AbstractHandlerMapping: TRACE
    org.springframework.web.servlet.mvc.method.annotation: TRACE

DEBUG DispatcherServlet - GET "/api/users/1"
DEBUG RequestMappingHandlerMapping - Mapped to UserController#getUser(Long)
DEBUG RequestResponseBodyMethodProcessor - Writing [UserResponse{id=1, name='홍길동'}]
DEBUG DispatcherServlet - Completed 200 OK

@Configuration
public class WebConfig implements WebMvcConfigurer {

    @Override
    public void addResourceHandlers(ResourceHandlerRegistry registry) {
        // 정적 리소스 매핑 (SimpleUrlHandlerMapping)
        registry.addResourceHandler("/static/**")
                .addResourceLocations("classpath:/static/")
                .setCachePeriod(3600);
    }
}

// 커스텀 어노테이션
@Target(ElementType.PARAMETER)
@Retention(RetentionPolicy.RUNTIME)
public @interface CurrentUser {}

// ArgumentResolver 구현
public class CurrentUserArgumentResolver implements HandlerMethodArgumentResolver {

    @Override
    public boolean supportsParameter(MethodParameter parameter) {
        return parameter.hasParameterAnnotation(CurrentUser.class);
    }

    @Override
    public Object resolveArgument(MethodParameter parameter,
                                   ModelAndViewContainer mavContainer,
                                   NativeWebRequest webRequest,
                                   WebDataBinderFactory binderFactory) {
        HttpServletRequest request = webRequest.getNativeRequest(HttpServletRequest.class);
        // JWT 토큰에서 사용자 정보 추출
        String token = request.getHeader("Authorization");
        return jwtService.parseUser(token);
    }
}

// 등록
@Configuration
public class WebConfig implements WebMvcConfigurer {
    @Override
    public void addArgumentResolvers(List<HandlerMethodArgumentResolver> resolvers) {
        resolvers.add(new CurrentUserArgumentResolver());
    }
}

// 사용
@GetMapping("/profile")
public UserResponse profile(@CurrentUser User user) {
    return UserResponse.from(user);
}

@Controller
public class HomeController {
    @GetMapping("/")
    public String home(Model model) {
        model.addAttribute("message", "Hello");
        return "home"; // → ViewResolver → /templates/home.html
    }
}