4.1 返回JSON数据

4.1.1 默认实现

JSON是目前主流的前后端数据传输方式，Spring MVC中使用消息转换器HttpMessageConverter对JSON的转换提供了很好的支持，在Spring Boot中更进一步，对相关配置做了更进一步的简化。默认情况下，当开发者新创建一个Spring Boot项目后，添加Web依赖，代码如下：

这个依赖中默认加入了jackson-databind作为JSON处理器，此时不需要添加额外的JSON处理器就能返回一段JSON了。创建一个Book实体类：

然后创建BookController，返回Book对象即可：

当然，如果需要频繁地用到@ResponseBody注解，那么可以采用@RestController组合注解代替@Controller和@ResponseBody，代码如下：

此时，在浏览器中输入“http://localhost:8080/book”，即可看到返回了JSON数据，如图4-1所示。

这是Spring Boot自带的处理方式。如果采用这种方式，那么对于字段忽略、日期格式化等常见需求都可以通过注解来解决。

这是通过Spring中默认提供的MappingJackson2HttpMessageConverter来实现的，当然开发者在这里也可以根据实际需求自定义JSON转换器。

4.1.2 自定义转换器

常见的JSON处理器除了jackson-databind之外，还有Gson和fastjson，这里针对常见用法分别举例。

1. 使用Gson

Gson是Google的一个开源JSON解析框架。使用Gson，需要先除去默认的jackson-databind，然后加入Gson依赖，代码如下：

由于Spring Boot中默认提供了Gson的自动转换类GsonHttpMessageConvertersConfiguration，因此Gson的依赖添加成功后，可以像使用jackson-databind那样直接使用Gson。但是在Gson进行转换时，如果想对日期数据进行格式化，那么还需要开发者自定义HttpMessageConverter。自定义HttpMessageConverter可以通过如下方式。

首先看GsonHttpMessageConvertersConfiguration中的一段源码：

@ConditionalOnMissingBean注解表示当项目中没有提供GsonHttpMessageConverter时才会使用默认的GsonHttpMessageConverter，所以开发者只需要提供一个GsonHttpMessageConverter即可，代码如下：

代码解释：

• 开发者自己提供一个GsonHttpMessageConverter的实例。

• 设置Gson解析时日期的格式。

• 设置Gson解析时修饰符为protected的字段被过滤掉。

• 创建Gson对象放入GsonHttpMessageConverter的实例中并返回converter。

此时，将Book类中的price字段的修饰符改为protected，代码如下：

最后，在浏览器中输入“http://localhost:8080/book”，即可看到运行结果，如图4-2所示。

2. 使用fastjson

fastjson是阿里巴巴的一个开源JSON解析框架，是目前JSON解析速度最快的开源框架，该框架也可以集成到Spring Boot中。不同于Gson，fastjson继承完成之后并不能立马使用，需要开发者提供相应的HttpMessageConverter后才能使用，集成fastjson的步骤如下。

首先除去jackson-databind依赖，引入fastjson依赖：

然后配置fastjson的HttpMessageConverter：

代码解释：

• 自定义MyFastJsonConfig，完成对FastJsonHttpMessageConverter Bean的提供。

• 第7～15行分别配置了JSON解析过程的一些细节，例如日期格式、数据编码、是否在生成的JSON中输出类名、是否输出value为null的数据、生成的JSON格式化、空集合输出[]而非null、空字符串输出""而非null等基本配置。

MyFastJsonConfig配置完成后，还需要配置一下响应编码，否则返回的JSON中文会乱码，在application.properties中添加如下配置：

接下来提供BookController进行测试。BookController和上一小节一致，运行成功后，在浏览器中输入“http://localhost:8080/book”，即可看到运行结果，如图4-3所示。

对于FastJsonHttpMessageConverter的配置，除了上面这种方式之外，还有另一种方式。

在Spring Boot项目中，当开发者引入spring-boot-starter-web依赖之后，该依赖又依赖了spring-boot-autoconfigure，在这个自动化配置中，有一个WebMvcAutoConfiguration类提供了对Spring MVC最基本的配置，如果某一项自动化配置不满足开发需求，开发者可以针对该项自定义配置，只需要实现WebMvcConfigurer接口即可（在Spring 5.0之前是通过继承WebMvcConfigurerAdapter类来实现的），代码如下：

代码解释：

• 自定义MyWebMvcConfig类并实现WebMvcConfigurer接口中的configureMessageConverters方法。

• 将自定义的FastJsonHttpMessageConverter加入converters中。