for (HandlerMethodArgumentResolver resolver : argumentResolvers) {
if (resolver.supportsParameter(parameter)) {
return resolver.resolveArgument(...); // 여기서 파라미터 값을 만들어냄
}
}
2. `@RequestBody`에 대한 resolver가 맞는지 검증합니다.
@Override
public boolean supportsParameter(MethodParameter parameter) {
return parameter.hasParameterAnnotation(RequestBody.class);
}
`MethodParameter parameter` 안에, 해당 컨트롤러 메서드의 파라미터 정보 전체가 들어있습니다.
for (HandlerMethodArgumentResolver resolver : argumentResolvers) {
if (resolver.supportsParameter(parameter)) {
return resolver.resolveArgument(...); // 여기서 파라미터 값을 만들어냄
}
}
2. 어노테이션 또는 파라미터에 대한 resolver가 맞는지 검증합니다.
@Override
public boolean supportsParameter(MethodParameter parameter) {
return parameter.hasParameterAnnotation(RequestBody.class);
}
`MethodParameter parameter` 안에, 해당 컨트롤러 메서드의 파라미터 정보 전체가 들어있습니다.
특정 Resolver의 `supportsParameter()`가 ` parameter` 정보를 통해 확인한 후, 맞으면 `true`를 반환합니다.
3. true가 반환 된다면, 그 후 특정 Resolver는 `resolveArgument()` 내부에서 다음코드를 실행합니다.
Model이나 View 이름을 담고 있는 컨테이너. 주로 `@ModelAttribute`나 `Model` 파라미터가 있을 때 사용됩니다.
`NativeWebRequest webRequest`
`HttpServletRequest`와 같은 웹 요청 객체를 래핑한 객체
`WebDataBinderFactory binderFactory`
바인딩과 검증을 위한 `WebDataBinder`를 생성해주는 팩토리. `@Valid`, `@InitBinder` 등을 처리할 때 사용합니다.
ReturnValueHandler
정의 :
컨트롤러 메서드의 리턴값을 HTTP 응답으로 변환해주는 컴포넌트입니다. 컨트롤러가 반환한 값을 Model, View, JSON, HTTP 응답 본문 등으로 변환합니다.
✨ 리턴 타입, 어노테이션 등에 따라 알맞은 Handler가 선택되어 호출됩니다.
ReturnValueHandler 구현체 종류 :
리턴 타입 또는 어노테이션
해당 Handler 클래스
설명
`@ResponseBody`
RequestResponseBodyMethodProcessor
객체를 JSON 또는 XML로 직렬화하여 HTTP 응답 body에 작성
`ResponseEntity<T>`
HttpEntityMethodProcessor
상태 코드, 헤더, body 모두 직접 설정하여 응답 가능
`HttpEntity<T>`
HttpEntityMethodProcessor
위와 동일하지만 상태 코드는 기본값 사용
`ModelAndView`
ModelAndViewMethodReturnValueHandler
명시적으로 Model과 View 이름을 포함한 객체를 리턴
`String` (View 이름)
ViewNameMethodReturnValueHandler
리턴된 문자열을 View 이름으로 간주 (JSP, Thymeleaf 등)
`Model` / `Map`
ModelMethodProcessor
Model 객체 자체를 반환 (주로 forward 용)
`@ModelAttribute` (리턴값에 사용)
ModelAttributeMethodProcessor
객체를 Model에 추가하고 View로 전달
`void` (리턴 없음)
VoidMethodReturnValueHandler
뷰 이름을 명시하지 않으면 요청 URL로부터 View 추정
`StreamingResponseBody`, `ResponseBodyEmitter`, `SseEmitter` 등
StreamingResponseBodyReturnValueHandler 외
비동기 스트리밍 방식으로 HTTP 응답 전송
모든 Handler 클래스들은 `HandlerMethodReturnValueHandler` 인터페이스를 구현하고 있습니다.
예시 :
@GetMapping("/user")
@ResponseBody
public User getUser() {
return new User("Tom");
}
리턴 타입 : `User`, 어노테이션 : `@ResponseBody`
처리 Handler : ` RequestResponseBodyMethodProcessor`
HandlerMethodReturnValueHandler
`ReturnValueHandler`의 실제 이름
resolver 클래스들은 이 인터페이스를 구현한 형태입니다.
이 인터페이스를 구현하여, 커스텀하게 파라미터를 만들 수 있습니다. (확장)
다양한 ReturnValueHander 구현체
동작 방식
1. Spring은 컨트롤러 메서드의 리턴 타입을 분석합니다.
for (HandlerMethodReturnValueHandler handler : returnValueHandlers) {
if (handler.supportsReturnType(returnType)) {
handler.handleReturnValue(...); // 여기서 리턴값 처리
break;
}
}
