📌 메시지 컨버터

API와 같이 JSON 데이터를 HTTP 메시지 바디에서 직접 읽거나 쓰는 경우, HTTP 메시지 컨버터를 사용하면 편리하다. 다시 말해, HTTP 요청, HTTP 응답 둘 다 사용된다.

HTTP 메시지 컨버터 인터페이스의 메소드

• canRead(), canWrite() : 메시지 컨버터가 해당 클래스, 미디어타입을 지원하는 지 체크

• read(), write() : 메시지 컨버터를 통해서 메시지를 읽고 쓰는 기능

스프링 MVC는 다음의 경우에 HTTP 메시지 컨버터를 적용

• HTTP 요청: @RequestBody , HttpEntity(RequestEntity)

• HTTP 응답: @ResponseBody , HttpEntity(ResponseEntity)

❗ @ResponseBody 사용 원리는 스프링 입문 파트에 정리해둔 내용을 참고하자.

HTTP 요청 데이터 읽기

1. HTTP 요청이 오고, 컨트롤러에서 @RequestBody, HttpEntity 파라미터를 사용

2. 메시지를 읽을 수 있는지 확인하기 위해 canRead() 호출

3. 대상 클래스 타입을 지원하는지, HTTP 요청의 Content-Type 미디어 타입을 지원하는지 확인

4. canRead() 조건 만족 시, read() 호출하여 객체를 생성한 뒤 반환

HTTP 응답 데이터 생성

1. 컨트롤러에서 @ResponseBody, HttpEntity로 값이 반환

2. 메시지를 쓸 수 있는지 확인하기 위해 canWrite() 호출

3. 대상 클래스 타입을 지원하는지, HTTP 요청의 Content-Type 미디어 타입을 지원하는지 확인

4. canWrite() 조건 만족 시, write() 호출하여 HTTP 응답 메시지 바디에 데이터 생성

---

📌 요청 매핑 핸들러 어댑터 구조

그렇다면 HTTP 메시지 컨버터는 스프링 MVC 어디쯤에서 사용되는 것일까?

바로 @RequestMapping을 처리하는 핸들러 어댑터인 RequestMappingHandlerAdapter에 있다.

ArgumentResolver

애노테이션 기반 컨트롤러에서 여러 파라미터를 처리할 수 있는 이유는 ArgumentResolver❗

RequestMappingHandlerAdapter는ArgumentResolver를 호출해 컨트롤러가 필요로 하는 다양한 파라미터의 값을 생성하여 값이 준비되면 컨트롤러를 호출하면서 값을 넘겨준다.

ReturnValueHandler

HandlerMethodReturnValueHandler를 줄여서 ReturnValueHandler라 부른다.
ArgumentResolver와 비슷한데, 이것은 응답 값을 변환하고 처리한다.

컨트롤러에서 String으로 뷰 이름을 반환해도, 동작하는 이유는 ReturnValueHandler❗

HTTP 메시지 컨버터의 위치

HTTP 메시지 컨버터를 사용하는 @RequestBody도 컨트롤러가 필요로 하는 파라미터의 값에 사용된다. @ResponseBody의 경우도 컨트롤러의 반환 값을 이용한다.

요청의 경우

@RequestBody와 HttpEntity를 처리하는 각각의 ArgumentResolver가 있다.
이러한 ArgumentResolver들이 HTTP 메시지 컨버터를 사용해서 필요한 객체를 생성하는 것이다.

응답의 경우

@ResponseBody와 HttpEntity를 처리하는 ReturnValueHandler가 있다.
여기에서 HTTP 메시지 컨버터를 호출해서 응답 결과를 만든다.

---

📌 본 포스트는 스프링 MVC 1편 - 백엔드 웹 개발 핵심 기술 통해 학습한 내용을 요약 및 정리한 것입니다.