【Spring】HttpMessageConverter的做用及替換

相信使用過Spring的開發人員都用過@RequestBody、@ResponseBody註解，能夠直接將輸入解析成Json、將輸出解析成Json，但HTTP 請求和響應是基於文本的，意味着瀏覽器和服務器經過交換原始文本進行通訊，而這裏其實就是HttpMessageConverter發揮着做用。

HttpMessageConverter

Http請求響應報文其實都是字符串，當請求報文到java程序會被封裝爲一個ServletInputStream流，開發人員再讀取報文，響應報文則經過ServletOutputStream流，來輸出響應報文。

從流中只能讀取到原始的字符串報文，一樣輸出流也是。那麼在報文到達SpringMVC / SpringBoot和從SpringMVC / SpringBoot出去，都存在一個字符串到java對象的轉化問題。這一過程，在SpringMVC / SpringBoot中，是經過HttpMessageConverter來解決的。HttpMessageConverter接口源碼：

public interface HttpMessageConverter<T> {

    boolean canRead(Class<?> clazz, MediaType mediaType);

    boolean canWrite(Class<?> clazz, MediaType mediaType);

    List<MediaType> getSupportedMediaTypes();

    T read(Class<? extends T> clazz, HttpInputMessage inputMessage) throws IOException, HttpMessageNotReadableException;

    void write(T t, MediaType contentType, HttpOutputMessage outputMessage) throws IOException, HttpMessageNotWritableException;
}
複製代碼

下面以一例子來講明

@RequestMapping("/test")
@ResponseBody
public String test(@RequestBody String param) {
    return "param '" + param + "'";
}
複製代碼

在請求進入test方法前，會根據@RequestBody註解選擇對應的HttpMessageConverter實現類來將請求參數解析到param變量中，由於這裏的參數是String類型的，因此這裏是使用了StringHttpMessageConverter類，它的canRead()方法返回true，而後read()方法會從請求中讀出請求參數，綁定到test()方法的param變量中。

同理當執行test方法後，因爲返回值標識了@ResponseBody，SpringMVC / SpringBoot將使用StringHttpMessageConverter的write()方法，將結果做爲String值寫入響應報文，固然，此時canWrite()方法返回true。

借用下圖簡單描述整個過程：

在Spring的處理過程當中，一次請求報文和一次響應報文，分別被抽象爲一個請求消息HttpInputMessage和一個響應消息HttpOutputMessage。

處理請求時，由合適的消息轉換器將請求報文綁定爲方法中的形參對象，在這裏同一個對象就有可能出現多種不一樣的消息形式，如json、xml。一樣響應請求也是一樣道理。

在Spring中，針對不一樣的消息形式，有不一樣的HttpMessageConverter實現類來處理各類消息形式，至於各類消息解析實現的不一樣，則在不一樣的HttpMessageConverter實現類中。

替換@ResponseBody默認的HttpMessageConverter

這裏使用SpringBoot演示例子，在SpringMVC / SpringBoot中@RequestBody這類註解默認使用的是jackson來解析json，看下面例子：

@Controller
@RequestMapping("/user")
public class UserController {

    @RequestMapping("/testt")
    @ResponseBody
    public User testt() {
        User user = new User("name", 18);
        return user;
    }
}
複製代碼

public class User {

    private String username;

    private Integer age;
    
    private Integer phone;
    
    private String email;

    public User(String username, Integer age) {
    super();
    this.username = username;
    this.age = age;
    }
}
複製代碼

瀏覽器訪問/user/testt返回以下：

這就是使用jackson解析的結果，如今來改爲使用fastjson解析對象，這裏就是替換默認的HttpMessageConverter，就是將其改爲使用FastJsonHttpMessageConverter來處理Java對象與HttpInputMessage/HttpOutputMessage間的轉化。

首先新建一配置類來添加配置FastJsonHttpMessageConverter，Spring4.x開始推薦使用Java配置加註解的方式，也就是無xml文件，SpringBoot就更是了。

import com.alibaba.fastjson.serializer.SerializerFeature;
import com.alibaba.fastjson.support.config.FastJsonConfig;
import com.alibaba.fastjson.support.spring.FastJsonHttpMessageConverter;
import org.springframework.boot.autoconfigure.web.HttpMessageConverters;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.http.converter.HttpMessageConverter;

import java.nio.charset.Charset;

@Configuration
public class HttpMessageConverterConfig {

    //引入Fastjson解析json，不使用默認的jackson
    //必須在pom.xml引入fastjson的jar包，而且版必須大於1.2.10
    @Bean
    public HttpMessageConverters fastJsonHttpMessageConverters() {
        //一、定義一個convert轉換消息的對象
        FastJsonHttpMessageConverter fastConverter = new FastJsonHttpMessageConverter();

        //二、添加fastjson的配置信息
        FastJsonConfig fastJsonConfig = new FastJsonConfig();

        SerializerFeature[] serializerFeatures = new SerializerFeature[]{
                // 輸出key是包含雙引號
// SerializerFeature.QuoteFieldNames,
                // 是否輸出爲null的字段,若爲null 則顯示該字段
// SerializerFeature.WriteMapNullValue,
                // 數值字段若是爲null，則輸出爲0
                SerializerFeature.WriteNullNumberAsZero,
                // List字段若是爲null,輸出爲[],而非null
                SerializerFeature.WriteNullListAsEmpty,
                // 字符類型字段若是爲null,輸出爲"",而非null
                SerializerFeature.WriteNullStringAsEmpty,
                // Boolean字段若是爲null,輸出爲false,而非null
                SerializerFeature.WriteNullBooleanAsFalse,
                // Date的日期轉換器
                SerializerFeature.WriteDateUseDateFormat,
                // 循環引用
                SerializerFeature.DisableCircularReferenceDetect,
        };

        fastJsonConfig.setSerializerFeatures(serializerFeatures);
        fastJsonConfig.setCharset(Charset.forName("UTF-8"));

        //三、在convert中添加配置信息
        fastConverter.setFastJsonConfig(fastJsonConfig);

        //四、將convert添加到converters中
        HttpMessageConverter<?> converter = fastConverter;

        return new HttpMessageConverters(converter);
    }
}
複製代碼

這裏將字符串類型的值若是是null就返回「」，數值類型的若是是null就返回0，重啓應用，再次訪問/user/testt接口，返回以下：

能夠看到此時null都轉化成「」或0了。