1. HTTP 메시지 컨버터

뷰 템플릿에서 HTML을 생성해서 응답하는 것이 아니라 HTTP API처럼 HTTP 요청 메시지를 직접 메시지 바디에서 읽거나, HTTP 응답 메시지를 메시지 바디에 담아 응답하는 경우 HTTP 메시지 컨버터를 사용하면 편리하다.

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

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

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

HTTP 메시지 컨버터 인터페이스 내부에는 다음과 같은 메소드가 정의되어 있다.

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

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

스프링 부트 기본 메시지 컨버터

스프링 부트는 다양한 메시지 컨버터를 제공한다. 대상 클래스 타입과 미디어 타입을 체크해서 다양한 메시지 컨버터들 중 사용할 컨버터를 결정한다. 우선순위가 높은 컨버터부터 체크하고, 만족하지 않으면 다음 컨버터로 우선순위가 넘어간다.

1. ByteArrayHttpMessageConverter

   • 클래스 타입: byte[], 미디어 타입: */* (아무거나 상관 없음)
   • 요청 ex, */* -> @RequestBody byte[] data
   • 응답 ex, @ResponseBody return byte[] -> application/octet-stream

2. StringHttpMessageConverter

   • 클래스 타입: String, 미디어 타입: */*
   • 요청 ex, */* -> @RequestBody String data
   • 응답 ex, @ResponseBody return "ok" -> test/plain

3. MappingJackson2HttpMessageConverter

   • 클래스 타입: 객체 또는 HashMap, 미디어 타입: application/json
   • 요청 ex, application/json -> @RequestBody HelloData data
   • 응답 ex, @ResponseBody return helloData -> application/json

예제1. StringHttpMessageConverter

content-type: application/json

@RequestMapping
void hello(@RequestBody String data) {}

예제2. MappingJackson2HttpMessageConverter

content-type: application/json

@RequestMapping
void hello(@RequestBody HelloData data) {}

예제3. 메시지 컨버터 실행 X

content-type: text/html

@RequestMapping
void hello(@RequestBody HelloData data) {}

HTTP 요청 데이터 읽기 순서

1. HTTP 요청이 오고, 컨트롤러에서 @RequestBody, HttpEntity를 사용한다.

2. 메시지 컨버터가 메시지를 읽을 수 있는지 확인하기 위해 canRead()를 호출한다.

   • 대상 클래스 타입을 지원하는가?

   • HTTP 요청의 Content-Type 미디어 타입을 지원하는가?

3. canRead()의 조건을 만족하면 read()를 호출해서 객체를 생성하고, 컴트롤러의 파라미터로 넘겨준다.

HTTP 응답 데이터 생성 순서

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

2. 메시지 컨버터가 메시지를 쓸 수 있는지 확인하기 위해 canWrite()를 호출한다.

   • 대상 클래스 타입을 지원하는가?

   • HTTP 요청의 Accept 미디어 타입을 지원하는가?

3. canWrite()의 조건을 만족하면 write()를 호출해서 HTTP 응답 메시지 바디에 데이터를 생성한다.

---

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

그렇다면 HTTP 메시지 컨버터는 스프링 MVC 구조 중 어디에 위치할까?

애노테이션 기반의 컨트롤러, 즉 @RequestMapping를 처리하는 핸들러 어댑터인 RequestMappingHandlerAdapter가 핵심이다.

RequestMappingHandlerAdapter 동작 방식

• ArgumentResolver
  애노테이션 기반의 컨트롤러는 매우 다양한 파라미터를 사용할 수 있다. 이렇게 파라미터를 유연하게 처리할 수 있는 이유가 바로 ArgumentResolver 덕분이다.

  애노테이션 기반의 컨트롤러를 처리하는 핸들러 어댑터인 RequestMappingHandlerAdapter는 ArgumentResolver를 호출해서 컨트롤러가 필요로 하는 파라미터의 값(객체)을 생성한다.

  그리고 이렇게 파라미터의 값이 모두 준비되면, 컨트롤러를 호출하면서 값을 넘겨준다.

• ReturnValueHandler
  컨트롤러에서 String으로 뷰 이름을 반환해도, ModelAndView를 반환해도 동작하는 이유가 ReturnValueHandler 덕분이다.

  ReturnValueHandler는 응답 값을 변환하고 처리하는 역할을 한다.

• HTTP 메시지 컨버터
  ArgumentResolver가 요청 데이터를 생성하는 과정과 ReturnValueHandler가 응답 데이터를 생성하는 과정에서 HTTP 메시지 컨버터가 호출된다.