SpringBoot項目中如何定製HTTP消息轉換器

本文首發於我的網站：Spring Boot項目中如何定製HTTP消息轉換器，如需轉載，請註明來源

在構建RESTful數據服務過程當中，咱們定義了controller、repositories，並用一些註解修飾它們，可是到如今爲止咱們還沒執行過對象的轉換——將java實體對象轉換成HTTP的數據輸出流。

Spring Boot底層經過HttpMessageConverters和Jackson庫將Java實體類輸出爲JSON格式。當有多個轉換器可用時，根據消息對象類型和須要的內容類型選擇最適合的轉換器使用。

在SpringMVC源碼剖析（五)-消息轉換器HttpMessageConverter一文中，有一張圖能夠很清楚得表示消息轉換器的位置。

消息轉換器的目標是：

1. HTTP輸入請求格式向Java對象的轉換；
2. Java對象向HTTP輸出請求的轉換。

有的消息轉換器只支持多個數據類型，有的只支持多個輸出格式，還有的二者兼備。

例如：MappingJackson2HttpMessageConverter能夠將Java對象轉換爲application/json，而ProtobufHttpMessageConverter僅支持com.google.protobuf.Message類型的輸入，可是能夠輸出application/json、application/xml、text/plain和application/x-protobuf這麼多格式。

實踐

在項目中有三種辦法配置消息轉換器，主要是從可定製性和易用度兩個方面進行衡量。

1. 在WebConfiguration類中加入@Bean定義

@Bean
public ByteArrayHttpMessageConverter byteArrayHttpMessageConverter() {
    return new ByteArrayHttpMessageConverter();
}複製代碼

1. 重寫（override）configureMessageConverters方法，擴展示有的消息轉換器鏈表；

@Override
public 
void configureMessageConverters(List<HttpMessageConverter<?>> converters) {
    converters.add(new ByteArrayHttpMessageConverter());
}複製代碼

1. 更多的控制，能夠重寫extendMessageConverters方法，首先清空轉換器列表，再加入自定義的轉換器。

@Override
public 
void extendMessageConverters(List<HttpMessageConverter<?>> converters) {
    converters.clear();
    converters.add(new ByteArrayHttpMessageConverter());
}複製代碼

分析

Spring Boot提供了多種方法完成一樣的任務，選擇哪一個取決於咱們更側重便捷性仍是更側重可定製性。

上述提到的三種方法各有什麼不一樣呢？

經過@Bean定義HttpMessageConverter是向項目中添加消息轉換器最簡便的辦法，這相似於以前提到的添加Servlet Filters。若是Spring掃描到HttpMessageConverter類型的bean，就會將它自動添加到調用鏈中。推薦讓項目中的WebConfiguration繼承自WebMvcConfigurerAdapter。

經過重寫configureMessageConverters方法添加自定義的轉換器很方便，但有一個弱點：若是項目中存在多個WebMvcConfigurers的實例（咱們本身定義的，或者Spring Boot默認提供的），不能確保重寫後的configureMessageConverters方法按照固定順序執行。

若是須要更精細的控制：清除其餘消息轉換器或者清楚重複的轉換器，能夠經過重寫extendMessageConverters完成，仍然有這種可能：別的WebMvcConfigurer實例也能夠重寫這個方法，可是這種概率很是小。

Spring Boot 1.x系列

1. Spring Boot的自動配置、Command-line-Runner
2. 瞭解Spring Boot的自動配置
3. Spring Boot的@PropertySource註解在整合Redis中的使用
   ***
   本號專一於後端技術、JVM問題排查和優化、Java面試題、我的成長和自我管理等主題，爲讀者提供一線開發者的工做和成長經驗，期待你能在這裏有所收穫。