HTTP 메시지 컨버터

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

• HTTP 요청 : @RequestBody, HttpEntity(RequestEntity)
• HTTP 응답 : @ResponseBody, HttpEntity(ResponseEntity)

HTTP 메시지 컨버터 인터페이스

• org.springframework.http.converter.HttpMessageConverter

HTTP 메시지 컨버터는 HTTP 요청, HTTP 응답 둘 다 사용된다.

• canRead(), canWrite() : 메시지 컨버터가 해당 클래스, 미디어 타입을 지원하는지 체크
• read(), write() : 메시지 컨버터를 통해 메시지를 읽고 쓰는 기능

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

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

0. ByteArrayHttpMessageConverter : byte[] 데이터 처리

• 클래스 타입 : byte[], 미디어타입 : */*
• 요청 예) : @RequestBody byte[] data
• 응답 예) : @ResponseBody return byte[], 쓰기 미디어타입 'application/octet-stream'

1. StringHttpMessageConverter : String 문자로 데이터 처리

• 클래스 타입 : String, 미디어타입 : */*
• 요청 예) : @RequestBody String data
• 응답 예) : @ResponseBody return "OK", 쓰기 미디어타입 'text/plain'

2. MappingJacson2HttpMessageConverter : application/json

• 클래스 타입 : 객체 또는 HashMap, 미디어타입 : application/json 관련
• 요청 예) : @RequestBody HelloData hellodata
• 응답 예) : @ResponseBody return hellodata, 쓰기 미디어타입 'application/json' 관련

HTTP 요청 데이터 읽기

• HTTP 요청이 오고, 컨트롤러에서 @RequestBody, HttpEntity 파라미터를 사용한다.
• 메시지 컨버터가 메시지를 읽을 수 있는지 확인하기 위해 canRead()를 호출한다.
  • 대상 클래스 타입을 지원하는가
    • 예) @RequestBody의 대상 클래스 (byte[], String, HelloData)
  • HTTP 요청의 Content-Type 미디어 타입을 지원 하는가
    • 예) text/plain, application/json, */*
• 3. canRead() 조건을 만족하면 read()를 호출해서 객체를 생성하고, 반환한다.

HTTP 응답 데이터 생성

• 컨트롤러에서 @ResponseBody, HttpEntity로 값이 반환된다.
• 메시지 컨버터가 메시지를 쓸 수 있는지 확인하기 위해 canWrite()를 호출한다.
  • 대상 클래스 타입을 지원하는가.
    • 예) return의 대상 클래스 (byte[], String, HelloData)
  • HTTP 요청의 Accept 미디어 타입을 지원하는가(@RequestMapping의 produces)
    • 예) text/plain, application/json, */*
• canWrite() 조건을 만족하면 write()를 호풀해서 HTTP 응답 메시지 바디에 데이터를 생성한다.