@RequestBody、@ResponseBody注解是如何将输入输出转换成json的

@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。

借用下图简单描述整个过程：

 

 

00001.png

 

在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返回以下：

 

 

00002.png

 

这就是使用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接口，返回以下：

 

 

00003.png

 

能够看到此时null都转化成“”或0了。