在構建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面試題、個人成長和自我管理等主題，為讀者提供一線開發者的工作和成長經驗，期待你能在這裡有所收穫。

相關推薦