前言
在之前的章节中，壹哥 带着各位学习了如何在Spring Boot中进行SSM整合。那么接下来，我们会继续深入研究SpringBoot对SpringMVC框架的支持，学习SpringBoot如何进行更深度的定制化Web开发。
前面我讲过，SpringBoot严格的来说，应该是一种负责把其他已有框架整合在一起的工具，SpringBoot主要是把各种框架都整合集中在一起，简化我们的Web开发。所以很多的功能，其实都不是SpringBoot完成的，而是由SpringBoot中整合的其他框架来完成的。比如Web开发，更多的是由SpringMVC来完成，只是SpringBoot很好的把SpringMVC整合了进来，而且对SpringMVC的定制化开发也提供了很多便利。
本文会给大家讲解SpringBoot中是如何对SpringMVC进行整合支持的，以此为我们以后学习其他框架的整合提供借鉴思路。
一. SpringMVC简介
Spring Boot中内嵌了Tomcat，Jetty或Undertow等服务器，使得我们可以非常轻松的创建出一个HTTP服务器，而大多数的web应用都可以使用spring-boot-starter-web模块进行快速搭建和运行，Web模块的开发主要是基于SpringMVC框架来进行实现。
1. SpringMVC概念
SpringMVC框架是一个“模型，视图，控制器”的Web框架，允许用户创建特定的@Controller或@RestController类，来处理传入的HTTP请求，通过@RequestMapping注解可以将控制器中的方法映射到相应的HTTP请求。
2. SpringMVC的自动配置特性
Spring Boot为Spring MVC提供的auto-configuration特性适用于大多数应用，并在Spring默认功能上添加了以下特性：
- 引入ContentNegotiatingViewResolver和BeanNameViewResolver beans。
- 对静态资源的支持，包括对WebJars的支持。
- 自动注册Converter，GenericConverter，Formatter beans。
- 对HttpMessageConverters的支持，负责Http信息转换。
- 自动注册MessageCodeResolver。
- 对静态index.html的支持。
- 对自定义Favicon的支持。
- 自动使用ConfigurableWebBindingInitializer bean。
我们可以添加自己的WebMvcConfigurerAdapter类型的@Configuration类，而不需要@EnableWebMvc注解；也可以添加自定义的HttpMessageConverters实现JSON、XML信息的自定义转换。
二. HttpMessageConverter简介
1. 概述
现在我们进行Web开发，一般都要设计成RESTful风格的API，通过JSON格式的数据进行交互。但是前端传入的 JSON 数据到底是如何被解析成 Java 对象作为 API入参的，后端返回的结果又是如何把 Java 对象解析成 JSON 格式的数据返回给前端的，在整个数据流转的过程中，这些工作都是由谁来完成的呢？
其实这都是由HttpMessageConverter起到的作用！
2. HttpMessageConverter简介
org.springframework.http.converter.HttpMessageConverter 是SpringMVC中提供的一个策略接口，它是一个转换器类，负责转换HTTP的请求和响应，可以把对象自动转换为JSON(使用Jackson库或Gson库)或XML(使用Jackson XML或者JAXB2)，对字符串默认使用UTF-8编码处理，一般情况下我们采用默认配置就可以。
该接口说明如下：
Strategy interface that specifies a converter that can convert from and to HTTP requests and responses。
简单说就是 HTTP request(请求)和response(响应)的转换器。该接口里有5个方法，接收到请求时判断是否能读(canRead)，能读则读(read)；返回结果时判断是否能写(canWrite)，能写则写(write)，以及获取支持的 MediaType(application/json之类)方法。
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;3. HttpMessageConverter转换原理
利用SpringMVC框架，可以使得我们在开发时，只要在代码中使用@RequestBody和@ResponseBody两个注解，就可以分别完成从请求报文到对象和从对象到响应报文的转换。而在源码内部，其实这种灵活的消息转换机制就是利用HttpMessageConverter来实现的。
实现过程参考下图：
SpringMVC在启动时会自动配置一些默认的HttpMessageConverter转换器，在 WebMvcConfigurationSupport类中添加了缺省的MessageConverter，比如MappingJackson2HttpMessageConverter，StringHttpMessageConverter等。
protected final void addDefaultHttpMessageConverters(List<HttpMessageConverter<?>> messageConverters) {
StringHttpMessageConverter stringConverter = new StringHttpMessageConverter();
stringConverter.setWriteAcceptCharset(false);
messageConverters.add(new ByteArrayHttpMessageConverter());
messageConverters.add(stringConverter);
messageConverters.add(new ResourceHttpMessageConverter());
messageConverters.add(new SourceHttpMessageConverter<Source>());
messageConverters.add(new AllEncompassingFormHttpMessageConverter());
if (romePresent) {
messageConverters.add(new AtomFeedHttpMessageConverter());
messageConverters.add(new RssChannelHttpMessageConverter());
}
if (jackson2XmlPresent) {
ObjectMapper objectMapper = Jackson2ObjectMapperBuilder.xml().applicationContext(this.applicationContext).build();
messageConverters.add(new MappingJackson2XmlHttpMessageConverter(objectMapper));
}
else if (jaxb2Present) {
messageConverters.add(new Jaxb2RootElementHttpMessageConverter());
}
if (jackson2Present) {
ObjectMapper objectMapper = Jackson2ObjectMapperBuilder.json().applicationContext(this.applicationContext).build();
messageConverters.add(new MappingJackson2HttpMessageConverter(objectMapper));
}
else if (gsonPresent) {
messageConverters.add(new GsonHttpMessageConverter());
}
}从源码中可以看到，SpringMVC中使用Jackson库或Gson库来转换json字符串，使用使用Jackson XML或者JAXB2来转换XML。
而如果我们没有配置自己的 MessageConverter，SpringMVC启动时就会调用 addDefaultHttpMessageConverters()方法。
4. SpringBoot中自定义HttpMessageConverters的实现思路
如果我们想在SpringBoot中自定义自己的HttpMessageConverters该怎么办呢？这时候，我们可以使用HttpMessageConverters添加HttpMessageConverter原生转换类或自定义转换类，如下所示：
import org.springframework.boot.autoconfigure.web.HttpMessageConverters;
import org.springframework.context.annotation.*;
import org.springframework.http.converter.*;
@Configuration
public class MyConfiguration {
@Bean
public HttpMessageConverters customConverters() {
HttpMessageConverter<?> additional = ...
HttpMessageConverter<?> another = ...
return new HttpMessageConverters(additional, another);
}
}从上面的代码示例中，我们看到，可以把HttpMessageConverter类添加到converters列表中，通过这种方式来覆盖默认的转换器列表(converters)。
5. 自定义消息转换器的方式
我们可以自定义自己的消息转换器来满足特定的需求，一般自定义消息转换器有两种方式:
- 1. 使用Spring或者第三方提供的现成的HttpMessageConverter；
- 2. 自己重写一个HttpMessageConverter。
三.使用FastJsonHttpMessageConverter替换默认的转换器
接下来 壹哥 就通过一个案例，利用FastJsonHttpMessageConverter来替换掉默认的消息转换器。
1. 创建SpringBoot项目
我们在之前的基础上，新建一个模块demo10，并将其改造为SpringBoot项目。
2. 添加FastJson依赖
在SpringBoot项目中，当我们在控制器类或者其内部的方法上添加@RestController注解和@ResponseBody注解后，默认会使用jackson插件来返回json格式的数据，但是我们也可以利用fastjson为我们提供的FastJsonHttpMessageConverter来返回json格式的数据。所以这里首先引入fastjson的依赖包。
<dependency>
<groupId>com.alibaba</groupId>
<artifactId>fastjson</artifactId>
<version>1.2.61</version>
</dependency>3. 配置FastJsonHttpMessageConverter
我们可以通过实现WebMvcConfigurer接口，来配置FastJsonHttpMessageConverter，在Spring Boot2.0版本以后推荐使用这种方式来进行Web配置，这样不会覆盖掉Spring Boot的一些默认配置。
接下来我们在项目包中创建config包，并创建一个CustomWebMvcConfigurer类，代码结构如下图所示：
CustomWebMvcConfigurer类中的内容：
/**
*实现WebMvcConfigurer接口来配置FastJsonHttpMessageConverter,
*Spring Boot2.0版本以后推荐使用这种方式来进行web配置，这样不会覆盖掉Spring Boot的一些默认配置.
*/
@Configuration
public class CustomWebMvcConfigurer implements WebMvcConfigurer {
@Override
public void extendMessageConverters(List<HttpMessageConverter<?>> converters) {
FastJsonHttpMessageConverter converter = new FastJsonHttpMessageConverter();
FastJsonConfig config = new FastJsonConfig();
config.setSerializerFeatures(SerializerFeature.DisableCircularReferenceDetect);
converter.setFastJsonConfig(config);
converter.setDefaultCharset(Charset.forName("UTF-8"));
converters.add(converter);
}
}3.1 FastJson中的SerializerFeature简介
在FastJson配置实体时，会调用setSerializerFeatures方法配置多个过滤方式，常用的配置如下：
3.2 常用的SerializerFeature释义
QuoteFieldNames,//输出key时是否使用双引号,默认为true;
UseSingleQuotes,//使用单引号而不是双引号,默认为false;
WriteMapNullValue,//是否输出值为null的字段,默认为false;
WriteEnumUsingToString,//Enum输出name()或者original,默认为false;
UseISO8601DateFormat,//Date使用ISO8601格式输出，默认为false;
WriteNullListAsEmpty,//List字段如果为null,输出为[],而非null;
WriteNullStringAsEmpty,//字符类型字段如果为null,输出为"",而非null;
WriteNullNumberAsZero,//数值字段如果为null,输出为0,而非null;
WriteNullBooleanAsFalse,//Boolean字段如果为null,输出为false,而非null;
SkipTransientField,//如果是true，类中的Get方法对应的Field是transient，序列化时将会被忽略。默认为true;
SortField,//按字段名称排序后输出,默认为false;
@Deprecated
WriteTabAsSpecial,//把\t做转义输出,默认为false;
PrettyFormat,//结果是否格式化,默认为false;
WriteClassName,//序列化时写入类型信息,默认为false,反序列化是需用到;
DisableCircularReferenceDetect,//消除对同一对象循环引用的问题,默认为false;
WriteSlashAsSpecial,//对斜杠'/'进行转义;
BrowserCompatible,//将中文都会序列化为\uXXXX格式，字节数会多一些，但是能兼容IE 6，默认为false;
WriteDateUseDateFormat,//全局修改日期格式,默认为false。JSON.DEFFAULT_DATE_FORMAT = "yyyy-MM-dd";JSON.toJSONString(obj,SerializerFeature.WriteDateUseDateFormat);
DisableCheckSpecialChar,//一个对象的字符串属性中如果有特殊字符如双引号，将会在转成json时带有反斜杠转移符。如果不需要转义，可以使用这个属性,默认为false.4. 创建对象实体
然后我们再创建一个“com.yyg.boot.domain”包，在这里创建一个User实体类。
package com.yyg.boot.domain;
import lombok.AllArgsConstructor;
import lombok.Data;
@Data
@AllArgsConstructor
public class User {
private String name;
private String address;
}5. 创建Controller
再创建一个“com.yyg.boot.web”包，在里面创建Controller类，定义一个”/users“接口。
package com.yyg.boot.web;
import com.yyg.boot.domain.User;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;
import org.springframework.web.bind.annotation.RestController;
import java.util.ArrayList;
import java.util.List;
@RestController
public class UserController {
@RequestMapping(value = "/users", method = RequestMethod.GET)
public Object getList() {
List<User> list = new ArrayList<>();
//测试字符串有null的情况
User u1 = new User("一一哥", null);
list.add(u1);
return list;
}
}6. 创建程序入口类
最后我们在项目根目录下创建启动类。
package com.yyg.boot;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
/**
* 自定义HttpMessageConverter
*/
@SpringBootApplication
public class ConvertApplication {
public static void main(String[] args) {
SpringApplication.run(ConvertApplication.class, args);
}
}7. 项目结构
最后整个项目的代码结构如下图所示，各位可以参考创建：
8. 启动项目进行测试
最后我们启动项目，在浏览器中访问http://localhost:8080/users接口。
因为我们CustomWebMvcConfigurer类的代码中，没有配置WriteMapNullValue，所以如果返回结果中有null值则不显示，效果如下:
接着我们在CustomWebMvcConfigurer中添加WriteMapNullValue配置，如下图:
然后重新启动项目并访问，从结果可以看出，我们配置的消息转换器起了作用，null值展示了出来。
然后我们在CustomWebMvcConfigurer类中，再改为WriteNullStringAsEmpty配置，如下图:
然后重新启动项目并访问，从结果中可以看出，我们配置的消息转换器又起了作用，null被替换成了""。
