1. HttpMessageConverter 概述
HttpMessageConverter 其實(shí)就是將 HttpServletRequest 中的數(shù)據(jù), 根據(jù) MediaType 轉(zhuǎn)換成指定格式的數(shù)據(jù), 比如我們常見(jiàn)的表單提交 或通過(guò) Json字符串提交數(shù)據(jù), 其主要實(shí)現(xiàn)接口如下:
// 數(shù)據(jù)轉(zhuǎn)換器 -> 將數(shù)據(jù)轉(zhuǎn)換成 requests 或 response 中的數(shù)據(jù)
public interface HttpMessageConverter<T> {
// 指定的 class 是否支持讀取(MediaType 指數(shù)據(jù)的格式)
boolean canRead(Class<?> clazz, MediaType mediaType);
// 傳入 class 與 MediaType -> 看 HttpMessageConverter 是否支持寫數(shù)據(jù)到數(shù)據(jù)流中
boolean canWrite(Class<?> clazz, MediaType mediaType);
// 返回 HttpMessageConverter 支持的 MediaType
List<MediaType> getSupportedMediaTypes();
// 從 HttpInputMessage 中讀取數(shù)據(jù)流, 并轉(zhuǎn)化成 T 這站類型
T read(Class<? extends T> clazz, HttpInputMessage inputMessage) throws IOException, HttpMessageNotReadableException;
// 將 T 里面的數(shù)據(jù)信息寫入到 HttpOutputMessage 的數(shù)據(jù)流中
void write(T t, MediaType contentType, HttpOutputMessage outputMessage) throws IOException, HttpMessageNotWritableException;
}
對(duì)于接口的實(shí)現(xiàn)類主要有如下幾類:
1. FormHttpMessageConverter
支持 MultiValueMap 類型, 并且 MediaType 類型是 "multipart/form-data", 從 InputStream 里面讀取數(shù)據(jù), 并通過(guò)&符號(hào)分割, 最后轉(zhuǎn)換成 MultiValueMap, 或 將 MultiValueMap轉(zhuǎn)換成 & 符號(hào)連接的字符串, 最后轉(zhuǎn)換成字節(jié)流, 輸出到遠(yuǎn)端
2. BufferedImageHttpMessageConverter
支持 BufferedImgae 的 HttpMessageConverter, 通過(guò) ImageReader 將 HttpBody 里面的數(shù)據(jù)轉(zhuǎn)換成 BufferedImage, 或ImageWriter 將ImageReader 轉(zhuǎn)換成字節(jié)流輸出到 OutputMessage
3. StringHttpMessageConverter
支持?jǐn)?shù)據(jù)是 String 類型的, 從 InputMessage 中讀取指定格式的 str, 或 將數(shù)據(jù)編碼成指定的格式輸出到 OutputMessage
4. SourceHttpMessageConverter
支持 DOMSource, SAXSource, StAXSource, StreamSource, Source 類型的消息轉(zhuǎn)換器, 在讀取的時(shí)候, 從 HttpBody 里面讀取對(duì)應(yīng)的數(shù)據(jù)流轉(zhuǎn)換成對(duì)應(yīng)對(duì)應(yīng), 輸出時(shí)通過(guò) TransformerFactory 轉(zhuǎn)換成指定格式輸出
5. ResourceHttpMessageConverter
支持?jǐn)?shù)據(jù)類型是 Resource 的數(shù)據(jù), 從 HttpBody 中讀取數(shù)據(jù)流轉(zhuǎn)換成 InputStreamResource|ByteArrayResource, 或從 Resource 中讀取數(shù)據(jù)流, 輸出到遠(yuǎn)端
6. ProtobufHttpMessageConverter
支持?jǐn)?shù)據(jù)類型是 com.google.protobuf.Message, 通過(guò) com.google.protobuf.Message.Builder 將 HttpBody 中的數(shù)據(jù)流轉(zhuǎn)換成指定格式的 Message, 通過(guò) ProtobufFormatter 將 com.google.protobuf.Message 轉(zhuǎn)換成字節(jié)流輸出到遠(yuǎn)端
7. ObjectToStringHttpMessageConverter
支持 MediaType是 text/plain 類型, 從 InputMessage 讀取數(shù)據(jù)轉(zhuǎn)換成字符串, 通過(guò) ConversionService 將字符串轉(zhuǎn)換成自定類型的 Object; 或?qū)?Obj 轉(zhuǎn)換成 String, 最后 將 String 轉(zhuǎn)換成數(shù)據(jù)流
8. ByteArrayHttpMessageConverter
支持格式是 byte 類型, 從 InputMessage 中讀取指定長(zhǎng)度的字節(jié)流, 或?qū)?OutputMessage 轉(zhuǎn)換成字節(jié)流
9. AbstractXmlHttpMessageConverter及其子類
支持從 xml 與 Object 之間進(jìn)行數(shù)據(jù)轉(zhuǎn)換的 HttpMessageConverter
10. AbstractGenericHttpMessageConverter
支持從 Json 與 Object 之間進(jìn)行數(shù)據(jù)轉(zhuǎn)換的 HttpMessageConverter (PS: 主要通過(guò) JackSon 或 Gson)
11. GsonHttpMessageConverter
支持 application/*++json 格式的數(shù)據(jù), 并通過(guò) Gson, 將字符串轉(zhuǎn)換成對(duì)應(yīng)的數(shù)據(jù)
12. MappingJackson2XmlHttpMessageConverter
持 application/*++json/*+xml 格式的數(shù)據(jù), 并通過(guò) JackSon, 將字符串轉(zhuǎn)換成對(duì)應(yīng)的數(shù)據(jù)
2. HttpMessageConverter 總結(jié)
HttpMessageConverter 在整個(gè) SpringMVC 中起著根據(jù) MediaType 類型將 HttpServletRequest 中的數(shù)據(jù)轉(zhuǎn)換成 指定對(duì)象的轉(zhuǎn)換器, 或?qū)?duì)象轉(zhuǎn)換成指定格式的數(shù)據(jù)(PS: byte/String/xml/json 等); 在其整體設(shè)計(jì)上與 HandlerMethodArgumentResolver 相似!
