這篇文章將為大家詳細講解有關(guān)如何在Spring Boot中自定義一個HTTP消息轉(zhuǎn)換器,文章內(nèi)容質(zhì)量較高,因此小編分享給大家做個參考,希望大家閱讀完這篇文章后對相關(guān)知識有一定的了解。
網(wǎng)站建設(shè)哪家好,找創(chuàng)新互聯(lián)建站!專注于網(wǎng)頁設(shè)計、網(wǎng)站建設(shè)、微信開發(fā)、成都微信小程序、集團企業(yè)網(wǎng)站建設(shè)等服務(wù)項目。為回饋新老客戶創(chuàng)新互聯(lián)還提供了陽曲免費建站歡迎大家使用!
在構(gòu)建RESTful數(shù)據(jù)服務(wù)過程中,我們定義了controller、repositories,并用一些注解修飾它們,但是到現(xiàn)在為止我們還沒執(zhí)行過對象的轉(zhuǎn)換——將java實體對象轉(zhuǎn)換成HTTP的數(shù)據(jù)輸出流。Spring Boot底層通過HttpMessageConverters依靠Jackson庫將Java實體類輸出為JSON格式。當(dāng)有多個轉(zhuǎn)換器可用時,根據(jù)消息對象類型和需要的內(nèi)容類型選擇最適合的轉(zhuǎn)換器使用。
在SpringMVC源碼剖析之消息轉(zhuǎn)換器HttpMessageConverter一文中,有一張圖可以很清楚得表示消息轉(zhuǎn)換器的位置。
消息轉(zhuǎn)換器的位置
消息轉(zhuǎn)換器的目標是:HTTP輸入請求格式向Java對象的轉(zhuǎn)換;Java對象向HTTP輸出請求的轉(zhuǎn)換。有的消息轉(zhuǎn)換器只支持多個數(shù)據(jù)類型,有的只支持多個輸出格式,還有的兩者兼?zhèn)洹@纾篗appingJackson2HttpMessageConverter可以將Java對象轉(zhuǎn)換為application/json,而ProtobufHttpMessageConverter僅支持com.google.protobuf.Message類型的輸入,但是可以輸出application/json、application/xml、text/plain和application/x-protobuf這么多格式。
How Do
在項目中有三種辦法配置消息轉(zhuǎn)換器,主要區(qū)別是可定制性和易用度的衡量。
在WebConfiguration類中加入@Bean定義
@Beanpublic ByteArrayHttpMessageConverter byteArrayHttpMessageConverter() { return new ByteArrayHttpMessageConverter(); }
重寫(override)configureMessageConverters方法,擴展現(xiàn)有的消息轉(zhuǎn)換器鏈表;
@Overridepublic void configureMessageConverters(List> converters) { converters.add(new ByteArrayHttpMessageConverter()); }
更多的控制,可以重寫extendMessageConverters方法,首先清空轉(zhuǎn)換器列表,再加入自定義的轉(zhuǎn)換器。
@Overridepublic void extendMessageConverters(List> converters) { converters.clear(); converters.add(new ByteArrayHttpMessageConverter()); }
分析
Spring提供了多種方法完成同樣的任務(wù),選擇哪個取決于我們更側(cè)重便捷性還是更側(cè)重可定制性。
上述提到的三種方法各有什么不同呢?
通過@Bean定義HttpMessageConverter是向項目中添加消息轉(zhuǎn)換器最簡便的辦法,這類似于之前提到的添加Servlet Filters。如果Spring掃描到HttpMessageConverter類型的bean,就會將它自動添加到調(diào)用鏈中。推薦讓項目中的WebConfiguration繼承自WebMvcConfigurerAdapter。
通過重寫configureMessageConverters方法添加自定義的轉(zhuǎn)換器很方便,但有一個弱點:如果項目中存在多個WebMvcConfigurers的實例(我們自己定義的,或者Spring Boot默認提供的),不能確保重寫后的configureMessageConverters方法按照固定順序執(zhí)行。
如果需要更精細的控制:清除其他消息轉(zhuǎn)換器或者清楚重復(fù)的轉(zhuǎn)換器,可以通過重寫extendMessageConverters完成,仍然有這種可能:別的WebMvcConfigurer實例也可以重寫這個方法,但是這種幾率非常小。
關(guān)于如何在Spring Boot中自定義一個HTTP消息轉(zhuǎn)換器就分享到這里了,希望以上內(nèi)容可以對大家有一定的幫助,可以學(xué)到更多知識。如果覺得文章不錯,可以把它分享出去讓更多的人看到。