Spring中HttpMessageConverter有什么用

這篇文章主要為大家展示了“Spring中HttpMessageConverter有什么用”，內(nèi)容簡(jiǎn)而易懂，條理清晰，希望能夠幫助大家解決疑惑，下面讓小編帶領(lǐng)大家一起研究并學(xué)習(xí)一下“Spring中HttpMessageConverter有什么用”這篇文章吧。

從網(wǎng)站建設(shè)到定制行業(yè)解決方案，為提供網(wǎng)站設(shè)計(jì)、成都網(wǎng)站建設(shè)服務(wù)體系，各種行業(yè)企業(yè)客戶提供網(wǎng)站建設(shè)解決方案，助力業(yè)務(wù)快速發(fā)展。創(chuàng)新互聯(lián)公司將不斷加快創(chuàng)新步伐，提供優(yōu)質(zhì)的建站服務(wù)。

相信使用過(guò)Spring的開(kāi)發(fā)人員都用過(guò)@RequestBody、@ResponseBody注解，可以直接將輸入解析成Json、將輸出解析成Json，但HTTP 請(qǐng)求和響應(yīng)是基于文本的，意味著瀏覽器和服務(wù)器通過(guò)交換原始文本進(jìn)行通信，而這里其實(shí)就是HttpMessageConverter發(fā)揮著作用。

HttpMessageConverter

Http請(qǐng)求響應(yīng)報(bào)文其實(shí)都是字符串，當(dāng)請(qǐng)求報(bào)文到j(luò)ava程序會(huì)被封裝為一個(gè)ServletInputStream流，開(kāi)發(fā)人員再讀取報(bào)文，響應(yīng)報(bào)文則通過(guò)ServletOutputStream流，來(lái)輸出響應(yīng)報(bào)文。

從流中只能讀取到原始的字符串報(bào)文，同樣輸出流也是。那么在報(bào)文到達(dá)SpringMVC / SpringBoot和從SpringMVC / SpringBoot出去，都存在一個(gè)字符串到j(luò)ava對(duì)象的轉(zhuǎn)化問(wèn)題。這一過(guò)程，在SpringMVC / SpringBoot中，是通過(guò)HttpMessageConverter來(lái)解決的。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;
}

下面以一例子來(lái)說(shuō)明，

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

在請(qǐng)求進(jìn)入test方法前，會(huì)根據(jù)@RequestBody注解選擇對(duì)應(yīng)的HttpMessageConverter實(shí)現(xiàn)類來(lái)將請(qǐng)求參數(shù)解析到param變量中，因?yàn)檫@里的參數(shù)是String類型的，所以這里是使用了StringHttpMessageConverter類，它的canRead()方法返回true，然后read()方法會(huì)從請(qǐng)求中讀出請(qǐng)求參數(shù)，綁定到test()方法的param變量中。

同理當(dāng)執(zhí)行test方法后，由于返回值標(biāo)識(shí)了@ResponseBody，SpringMVC / SpringBoot將使用StringHttpMessageConverter的write()方法，將結(jié)果作為String值寫(xiě)入響應(yīng)報(bào)文，當(dāng)然，此時(shí)canWrite()方法返回true。

借用下圖簡(jiǎn)單描述整個(gè)過(guò)程：

在Spring的處理過(guò)程中，一次請(qǐng)求報(bào)文和一次響應(yīng)報(bào)文，分別被抽象為一個(gè)請(qǐng)求消息HttpInputMessage和一個(gè)響應(yīng)消息HttpOutputMessage。

處理請(qǐng)求時(shí)，由合適的消息轉(zhuǎn)換器將請(qǐng)求報(bào)文綁定為方法中的形參對(duì)象，在這里同一個(gè)對(duì)象就有可能出現(xiàn)多種不同的消息形式，如json、xml。同樣響應(yīng)請(qǐng)求也是同樣道理。

在Spring中，針對(duì)不同的消息形式，有不同的HttpMessageConverter實(shí)現(xiàn)類來(lái)處理各種消息形式，至于各種消息解析實(shí)現(xiàn)的不同，則在不同的HttpMessageConverter實(shí)現(xiàn)類中。

替換@ResponseBody默認(rèn)的HttpMessageConverter

這里使用SpringBoot演示例子，在SpringMVC / SpringBoot中@RequestBody這類注解默認(rèn)使用的是jackson來(lái)解析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;
  }
}

瀏覽器訪問(wèn)/user/testt返回如下：

這就是使用jackson解析的結(jié)果，現(xiàn)在來(lái)改成使用fastjson解析對(duì)象，這里就是替換默認(rèn)的HttpMessageConverter，就是將其改成使用FastJsonHttpMessageConverter來(lái)處理Java對(duì)象與HttpInputMessage/HttpOutputMessage間的轉(zhuǎn)化。

首先新建一配置類來(lái)添加配置FastJsonHttpMessageConverter，Spring4.x開(kāi)始推薦使用Java配置加注解的方式，也就是無(wú)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，不使用默認(rèn)的jackson
  //必須在pom.xml引入fastjson的jar包，并且版必須大于1.2.10
  @Bean
  public HttpMessageConverters fastJsonHttpMessageConverters() {
    //1、定義一個(gè)convert轉(zhuǎn)換消息的對(duì)象
    FastJsonHttpMessageConverter fastConverter = new FastJsonHttpMessageConverter();

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

    SerializerFeature[] serializerFeatures = new SerializerFeature[]{
        //  輸出key是包含雙引號(hào)
//        SerializerFeature.QuoteFieldNames,
        //  是否輸出為null的字段,若為null 則顯示該字段
//        SerializerFeature.WriteMapNullValue,
        //  數(shù)值字段如果為null，則輸出為0
        SerializerFeature.WriteNullNumberAsZero,
        //   List字段如果為null,輸出為[],而非null
        SerializerFeature.WriteNullListAsEmpty,
        //  字符類型字段如果為null,輸出為"",而非null
        SerializerFeature.WriteNullStringAsEmpty,
        //  Boolean字段如果為null,輸出為false,而非null
        SerializerFeature.WriteNullBooleanAsFalse,
        //  Date的日期轉(zhuǎn)換器
        SerializerFeature.WriteDateUseDateFormat,
        //  循環(huán)引用
        SerializerFeature.DisableCircularReferenceDetect,
    };

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

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

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

    return new HttpMessageConverters(converter);
  }
}

這里將字符串類型的值如果是null就返回“”，數(shù)值類型的如果是null就返回0，重啟應(yīng)用，再次訪問(wèn)/user/testt接口，返回如下：

可以看到此時(shí)null都轉(zhuǎn)化成“”或0了。

以上是“Spring中HttpMessageConverter有什么用”這篇文章的所有內(nèi)容，感謝各位的閱讀！相信大家都有了一定的了解，希望分享的內(nèi)容對(duì)大家有所幫助，如果還想學(xué)習(xí)更多知識(shí)，歡迎關(guān)注創(chuàng)新互聯(lián)行業(yè)資訊頻道！

當(dāng)前名稱：Spring中HttpMessageConverter有什么用
文章起源：http://muchs.cn/article34/ghhipe.html

成都網(wǎng)站建設(shè)公司_創(chuàng)新互聯(lián)，為您提供做網(wǎng)站、面包屑導(dǎo)航、靜態(tài)網(wǎng)站、ChatGPT、電子商務(wù)、網(wǎng)站排名

廣告

聲明：本網(wǎng)站發(fā)布的內(nèi)容（圖片、視頻和文字）以用戶投稿、用戶轉(zhuǎn)載內(nèi)容為主，如果涉及侵權(quán)請(qǐng)盡快告知，我們將會(huì)在第一時(shí)間刪除。文章觀點(diǎn)不代表本網(wǎng)站立場(chǎng)，如需處理請(qǐng)聯(lián)系客服。電話：028-86922220；郵箱：631063699@qq.com。內(nèi)容未經(jīng)允許不得轉(zhuǎn)載，或轉(zhuǎn)載時(shí)需注明來(lái)源： 創(chuàng)新互聯(lián)