HttpMessageConverter 概述

HttpMessageConverter 其實(shí)就是將 HttpServletRequest 中的數(shù)據(jù), 根據(jù) MediaType 轉(zhuǎn)換成指定格式的數(shù)據(jù), 比如我們常見的表單提交 或通過 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;
}

接口的實(shí)現(xiàn)類

對(duì)于接口的實(shí)現(xiàn)類主要有如下幾類:

1. FormHttpMessageConverter
    支持 MultiValueMap 類型, 并且 MediaType 類型是 "multipart/form-data", 從 InputStream 里面讀取數(shù)據(jù), 并通過&符號(hào)分割, 最后轉(zhuǎn)換成 MultiValueMap, 或 將 MultiValueMap轉(zhuǎn)換成 & 符號(hào)連接的字符串, 最后轉(zhuǎn)換成字節(jié)流, 輸出到遠(yuǎn)端
2. BufferedImageHttpMessageConverter
    支持 BufferedImgae 的 HttpMessageConverter, 通過 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í)通過 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, 通過 com.google.protobuf.Message.Builder 將 HttpBody 中的數(shù)據(jù)流轉(zhuǎn)換成指定格式的 Message, 通過 ProtobufFormatter 將 com.google.protobuf.Message 轉(zhuǎn)換成字節(jié)流輸出到遠(yuǎn)端
7. ObjectToStringHttpMessageConverter
    支持 MediaType是 text/plain 類型, 從 InputMessage 讀取數(shù)據(jù)轉(zhuǎn)換成字符串, 通過 ConversionService 將字符串轉(zhuǎn)換成自定類型的 Object; 或?qū)?Obj 轉(zhuǎn)換成 String, 最后 將 String 轉(zhuǎn)換成數(shù)據(jù)流
8. ByteArrayHttpMessageConverter
    支持格式是 byte 類型, 從 InputMessage 中讀取指定長度的字節(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: 主要通過 JackSon 或 Gson)
11. GsonHttpMessageConverter
    支持 application/*++json 格式的數(shù)據(jù), 并通過 Gson, 將字符串轉(zhuǎn)換成對(duì)應(yīng)的數(shù)據(jù)
12. MappingJackson2XmlHttpMessageConverter
    支持 application/*++json/*+xml 格式的數(shù)據(jù), 并通過 JackSon, 將字符串轉(zhuǎn)換成對(duì)應(yīng)的數(shù)據(jù)

總結(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 相似!

以上就是SpringMVC4.3 HttpMessageConverter源碼分析的詳細(xì)內(nèi)容，更多關(guān)于SpringMVC HttpMessageConverter的資料請(qǐng)關(guān)注腳本之家其它相關(guān)文章！

最新評(píng)論