1. 概述

当使用JSON格式时，Spring Boot将使用ObjectMapper实例来序列化响应和反序列化请求。在本文中，我们将介绍配置序列化和反序列化选项的最常见方法。

2. 默认配置

默认情况下，Spring 引导配置将禁用以下内容：

• MapperFeature.DEFAULT_VIEW_INCLUSION
• DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES
• SerializationFeature.WRITE_DATES_AS_TIMESTAMPS

让我们从一个简单的例子开始：

• 客户端将向我们的 /coffee？name=Lavazza 发送一个 GET 请求。
• 控制器将返回一个新的 Coffee 对象。
• Spring 将使用 ObjectMapper 将我们的 POJO 序列化为 JSON。

我们将通过使用字符串和本地日期时间对象来举例说明自定义选项：

public class Coffee {

    private String name;
    private String brand;
    private LocalDateTime date;

   //getters and setters
}

我们还将定义一个简单的 REST 控制器来演示序列化：

@GetMapping("/coffee")
public Coffee getCoffee(
        @RequestParam(required = false) String brand,
        @RequestParam(required = false) String name) {
    return new Coffee()
      .setBrand(brand)
      .setDate(FIXED_DATE)
      .setName(name);
}

默认情况下，这将是调用 GET http://lolcahost:8080/coffee?brand=Lavazza 时的响应：

{
  "name": null,
  "brand": "Lavazza",
  "date": "2020-11-16T10:21:35.974"
}

我们希望排除空值并具有自定义日期格式（dd-MM-yyyy HH：mm）。这是我们的最终回应：

{
  "brand": "Lavazza",
  "date": "04-11-2020 10:34"
}

使用 Spring Boot 时，我们可以选择自定义默认的 ObjectMapper 或覆盖它。

3. 自定义默认对象映射器

我们将看到如何自定义 Spring Boot 使用的默认 ObjectMapper。

3.1. 应用程序属性和自定义杰克逊模块

配置映射器的最简单方法是通过应用程序属性。以下是配置的一般结构：

spring.jackson.<category_name>.<feature_name>=true,false

例如，我们将添加以下内容以禁用SerializationFeature.WRITE_DATES_AS_TIMESTAMPS：

spring.jackson.serialization.write-dates-as-timestamps=false

除了上述功能类别外，我们还可以配置属性包含：

spring.jackson.default-property-inclusion=always, non_null, non_absent, non_default, non_empty

配置环境变量是最简单的方法。这种方法的缺点是我们无法自定义高级选项，例如为本地日期时间自定义日期格式。

此时，我们将获得以下结果：

{
  "brand": "Lavazza",
  "date": "2020-11-16T10:35:34.593"
}

为了实现我们的目标，我们将使用自定义日期格式注册一个新的 JavaTimeModule：

@Configuration
@PropertySource("classpath:coffee.properties")
public class CoffeeRegisterModuleConfig {

    @Bean
    public Module javaTimeModule() {
        JavaTimeModule module = new JavaTimeModule();
        module.addSerializer(LOCAL_DATETIME_SERIALIZER);
        return module;
    }
}

此外，配置属性文件 coffee.properties 将包含以下内容：

spring.jackson.default-property-inclusion=non_null

Spring Boot 将自动注册任何类型为 com.fasterxml.jackson.databind.Module 的 bean。以下是我们的最终结果：

{
  "brand": "Lavazza",
  "date": "16-11-2020 10:43"
}

3.2. Jackson2ObjectMapperBuilderCustomizer

这个函数接口的目的是允许我们创建配置 bean。它们将应用于通过 Jackson2ObjectMapperBuilder 创建的默认 ObjectMapper：

@Bean
public Jackson2ObjectMapperBuilderCustomizer jsonCustomizer() {
    return builder -> builder.serializationInclusion(JsonInclude.Include.NON_NULL)
      .serializers(LOCAL_DATETIME_SERIALIZER);
}

配置 bean 按特定顺序应用，我们可以使用 @Order 注释来控制。如果我们想从不同的配置或模块配置 ObjectMapper，这种优雅的方法很合适。

4. 覆盖默认配置

如果我们想完全控制配置，有几个选项可以禁用自动配置并仅允许应用我们的自定义配置。

4.1.对象映射器

覆盖默认配置的最简单方法是定义 ObjectMapper Bean 并将其标记为@Primary：

@Bean
@Primary
public ObjectMapper objectMapper() {
    JavaTimeModule module = new JavaTimeModule();
    module.addSerializer(LOCAL_DATETIME_SERIALIZER);
    return new ObjectMapper()
      .setSerializationInclusion(JsonInclude.Include.NON_NULL)
      .registerModule(module);
}

当我们想要完全控制序列化过程并且不想允许外部配置时，我们应该使用此方法。

4.2. 杰克逊2对象映射器生成器

另一种干净的方法是定义一个 Jackson2ObjectMapperBuilder bean。Spring Boot 在构建 ObjectMapper 时实际上默认使用此构建器，并将自动选取定义的构建器：

@Bean
public Jackson2ObjectMapperBuilder jackson2ObjectMapperBuilder() {
    return new Jackson2ObjectMapperBuilder().serializers(LOCAL_DATETIME_SERIALIZER)
      .serializationInclusion(JsonInclude.Include.NON_NULL);
}

默认情况下，它将配置两个选项：

• 禁用MapperFeature.DEFAULT_VIEW_INCLUSION
• 禁用DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES

根据 Jackson2ObjectMapperBuilder 文档，如果类路径中存在一些模块，它还将注册它们：

• jackson-datatype-jdk8：支持其他Java 8类型，如可选
• jackson-datatype-jsr310：支持 Java 8 日期和时间 API 类型
• jackson-datatype-joda：支持 Joda-Time 类型
• jackson-module-kotlin：支持 Kotlin 类和数据类

这种方法的优点是Jackson2ObjectMapperBuilder提供了一种简单直观的方法来构建ObjectMapper。

4.3.MappingJackson2HttpMessageConverter

我们可以定义一个类型为 MappingJackson2HttpMessageConverter 的 bean，Spring Boot 将自动使用它：

@Bean
public MappingJackson2HttpMessageConverter mappingJackson2HttpMessageConverter() {
    Jackson2ObjectMapperBuilder builder = new Jackson2ObjectMapperBuilder().serializers(LOCAL_DATETIME_SERIALIZER)
      .serializationInclusion(JsonInclude.Include.NON_NULL);
    return new MappingJackson2HttpMessageConverter(builder.build());
}

5. 测试配置

为了测试我们的配置，我们将使用 TestRestTemplate 并将对象序列化为 String。通过这种方式，我们可以验证我们的 Coffee 对象是否在没有空值的情况下使用自定义日期格式进行序列化：

@Test
public void whenGetCoffee_thenSerializedWithDateAndNonNull() {
    String formattedDate = DateTimeFormatter.ofPattern(CoffeeConstants.dateTimeFormat).format(FIXED_DATE);
    String brand = "Lavazza";
    String url = "/coffee?brand=" + brand;
    
    String response = restTemplate.getForObject(url, String.class);
    
    assertThat(response).isEqualTo("{\"brand\":\"" + brand + "\",\"date\":\"" + formattedDate + "\"}");
}