ArgumentResolver와 ReturnValueHandler 란?

[koreaioi]

최근 Spring MVC를 디버깅하다가, ArgumentResolver 말고도 ReturnValueHandler를 알게되었는데요!
신기해서 같이 학습해보면 좋을 거 같아 발제해봅니다.

ArgumentResolver와 ReturnValueHandler란 무엇이며 어떤 역할을할까요??

[haeyoon1]

Http 요청부터 응답까지의 흐름은 아래와 같습니다.

HTTP 요청
   ↓
[ArgumentResolver] // 1️⃣
   ↓
컨트롤러 메서드 실행
   ↓
[ReturnValueHandler] // 2️⃣
   ↓
HTTP 응답

각각의 역할에 대해 알아보겠습니다!

ArgumentResolver

HTTP 요청 -> 메서드 파라미터로 변환하는 역할을 합니다

- @PathVariable, @RequestBody, @RequestParam 를 동작하게합니다.

• 각 어노테이션 별로 전담하는 ArgumentResolver가 있습니다.
• 커스텀 어노테이션으로 파라미터 추출 로직을 추상화할 때 직접 구현하기도 합니다.

ReturnValueHandler

메서드 반환값 -> HTTP 응답으로 변환하는 역할을 합니다

• 컨트롤러의 다양한 반환값의 모든 분기 처리를 담당합니다
  • @ResponseBody가 객체를 JSON으로 직렬화
  • 문자열을 뷰 이름으로 해석
  • ResponseEntity가 status/header/body를 설정 등

[koreaioi]

ArgumentResolver (HandlerMethodArgumentResolver)

컨트롤러 메서드의 파라미터(인자)를 자동으로 조립 및 주입해 주는 역할 (HTTP 요청 정보를 자바 객체/변수로 변환).

주된 구현 메서드

supportsParameter()
검증: 해당 컨트롤러 파라미터를 이 Resolver가 처리할 수 있는지 확인 (예: @RequestBody가 붙어 있는지 체크).

resolveArgument()
변환 및 주입: 조건이 맞다면 HTTP 요청 데이터(Body, URL, 헤더 등)를 파라미터 타입에 맞게 변환하여 컨트롤러에 주입.

---

ReturnValueHandler (HandlerMethodReturnValueHandler)

컨트롤러 메서드가 반환한 값(리턴값)을 HTTP 응답 형식에 맞게 처리해 주는 역할.

주된 구현 메서드

supportsReturnType()
검증: 컨트롤러가 리턴한 타입을 이 Handler가 처리할 수 있는지 확인 (예: 반환 타입이 ResponseEntity인지 체크).

handleReturnValue()
응답 처리: 조건이 맞다면 리턴값을 기반으로 JSON 응답 바디를 작성하거나, HTML 뷰(View) 화면으로 포워딩.

[Uechann]

등장 배경

초기 Spring MVC는 시그니처가 정해져 있었습니다.
하지만 파라미터의 종류는 매우 다양합니다.
이렇게 많은 종류의 파라미터를 받으려면 dispatcherServlet이 조건문으로 처리하면 코드가 폭발하게 됩니다.
이러한 상황에서 어떻게 하면 파라미터/반환값 처리 로직을 모듈처럼 끼워 넣을 수 있을까요?
이 해결을 하기 위해서 등장한 것이 ArgumentResolver와 ReturnValueHandler입니다.

어떻게 동작할까

요청이 들어오면 RequestMappingHandlerAdapter가 컨트롤러 메서드를 호출하기 직전에 이런 흐름을 탑니다.

HTTP 요청
   ↓
DispatcherServlet → HandlerAdapter (컨트롤러 호출 책임)
   ↓
[메서드 파라미터마다 반복]
   → ArgumentResolver 목록을 순회하며 supportsParameter()로 묻기
   → "이 파라미터 내가 처리할 수 있어?" → Yes인 첫 번째 리졸버가 resolveArgument()로 값 생성
   ↓
컨트롤러 메서드 실행 (만들어진 인자들로)
   ↓
반환값을 ReturnValueHandler 목록에 넘김
   → supportsReturnType()으로 "내가 처리할 수 있어?" 묻기
   → Yes인 첫 번째 핸들러가 handleReturnValue()로 응답 처리
   ↓
HTTP 응답