Spring Boot2中如何优雅地个性化定制Jackson实现示例

更新时间：2023年05月29日 10:51:54 作者：八卦程序

这篇文章主要为大家介绍了Spring Boot2中如何优雅地个性化定制Jackson实现示例详解，有需要的朋友可以借鉴参考下，希望能够有所帮助，祝大家多多进步，早日升职加薪

概述

本文的编写初衷，是想了解一下Spring Boot2中，具体是怎么序列化和反序列化JSR 310日期时间体系的，Spring MVC应用场景有如下两个：

使用@RequestBody来获取JSON参数并封装成实体对象；
使用@ResponseBody来把返回给前端的数据转换成JSON数据。

对于一些Integer、String等基础类型的数据，Spring MVC可以通过一些内置转换器来解决，无需用户关心，但是日期时间类型（例如LocalDateTime），由于格式多变，没有内置转换器可用，就需要用户自己来配置和处理了。

阅读本文，假设读者初步了解了如何使用Jackson。

测试环境

本文使用Spring Boot2.6.6版本，锁定的Jackson版本如下：

<jackson-bom.version>2.13.2.20220328</jackson-bom.version>

Jackson处理JSR 310日期时间需要引入依赖：

<dependency>
    <groupId>com.fasterxml.jackson.datatype</groupId>
    <artifactId>jackson-datatype-jsr310</artifactId>
    <version>2.13.2</version>
</dependency>

Spring Boot自动配置

在spring-boot-autoconfigure包中，自动配置了Jackson：

package org.springframework.boot.autoconfigure.jackson;
@Configuration(proxyBeanMethods = false)
@ConditionalOnClass(ObjectMapper.class)
public class JacksonAutoConfiguration {
    // 详细代码略
}

其中有一段代码配置了ObjectMapper

@Bean
@Primary
@ConditionalOnMissingBean
ObjectMapper jacksonObjectMapper(Jackson2ObjectMapperBuilder builder) {
   return builder.createXmlMapper(false).build();
}

可以看到ObjectMapper是由Jackson2ObjectMapperBuilder构建的。

再往下会看到如下代码：

@Configuration(proxyBeanMethods = false)
@ConditionalOnClass(Jackson2ObjectMapperBuilder.class)
static class JacksonObjectMapperBuilderConfiguration {
   @Bean
   @Scope("prototype")
   @ConditionalOnMissingBean
   Jackson2ObjectMapperBuilder jacksonObjectMapperBuilder(ApplicationContext applicationContext,
         List&lt;Jackson2ObjectMapperBuilderCustomizer&gt; customizers) {
      Jackson2ObjectMapperBuilder builder = new Jackson2ObjectMapperBuilder();
      builder.applicationContext(applicationContext);
      customize(builder, customizers);
      return builder;
   }
   private void customize(Jackson2ObjectMapperBuilder builder,
         List&lt;Jackson2ObjectMapperBuilderCustomizer&gt; customizers) {
      for (Jackson2ObjectMapperBuilderCustomizer customizer : customizers) {
         customizer.customize(builder);
      }
   }
}

发现在这里创建了Jackson2ObjectMapperBuilder，并且调用了customize(builder, customizers)方法，传入Lis<Jackson2ObjectMapperBuilderCustomizer> 进行定制ObjectMapper。

Jackson2ObjectMapperBuilderCustomizer是个接口，只有一个方法，源码如下：

@FunctionalInterface
public interface Jackson2ObjectMapperBuilderCustomizer {
   /**
    * Customize the JacksonObjectMapperBuilder.
    * @param jacksonObjectMapperBuilder the JacksonObjectMapperBuilder to customize
    */
   void customize(Jackson2ObjectMapperBuilder jacksonObjectMapperBuilder);
}

简单点说，Spring Boot会收集容器里面所有的Jackson2ObjectMapperBuilderCustomizer实现类，统一对Jackson2ObjectMapperBuilder进行设置，从而实现定制ObjectMapper。因此，如果我们想个性化定制ObjectMapper，只需要实现Jackson2ObjectMapperBuilderCustomizer接口并注册到容器就可以了。

自定义Jackson配置类

废话不多说，直接上代码：

@Component
public class JacksonConfig implements Jackson2ObjectMapperBuilderCustomizer, Ordered {
    /** 默认日期时间格式 */
    private final String dateTimeFormat = "yyyy-MM-dd HH:mm:ss";
    /** 默认日期格式 */
    private final String dateFormat = "yyyy-MM-dd";
    /** 默认时间格式 */
    private final String timeFormat = "HH:mm:ss";
    @Override
    public void customize(Jackson2ObjectMapperBuilder builder) {
        // 设置java.util.Date时间类的序列化以及反序列化的格式
        builder.simpleDateFormat(dateTimeFormat);
        // JSR 310日期时间处理
        JavaTimeModule javaTimeModule = new JavaTimeModule();
        DateTimeFormatter dateTimeFormatter = DateTimeFormatter.ofPattern(dateTimeFormat);
        javaTimeModule.addSerializer(LocalDateTime.class, new LocalDateTimeSerializer(dateTimeFormatter));
        javaTimeModule.addDeserializer(LocalDateTime.class, new LocalDateTimeDeserializer(dateTimeFormatter));
        DateTimeFormatter dateFormatter = DateTimeFormatter.ofPattern(dateFormat);
        javaTimeModule.addSerializer(LocalDate.class, new LocalDateSerializer(dateFormatter));
        javaTimeModule.addDeserializer(LocalDate.class, new LocalDateDeserializer(dateFormatter));
        DateTimeFormatter timeFormatter = DateTimeFormatter.ofPattern(timeFormat);
        javaTimeModule.addSerializer(LocalTime.class, new LocalTimeSerializer(timeFormatter));
        javaTimeModule.addDeserializer(LocalTime.class, new LocalTimeDeserializer(timeFormatter));
        builder.modules(javaTimeModule);
        // 全局转化Long类型为String，解决序列化后传入前端Long类型精度丢失问题
        builder.serializerByType(BigInteger.class, ToStringSerializer.instance);
        builder.serializerByType(Long.class,ToStringSerializer.instance);
    }
    @Override
    public int getOrder() {
        return 1;
    }
}

这个配置类实现了三种个性化配置：

设置java.util.Date时间类的序列化以及反序列化的格式；
JSR 310日期时间处理；
全局转化Long类型为String，解决序列化后传入前端Long类型缺失精度问题。

当然，读者还可以按自己的需求继续进行定制其他配置。

测试

这里用JSR 310日期时间进行测试。

创建实体类User

@Data
@NoArgsConstructor
@AllArgsConstructor
public class User {
    private Long id;
    private String name;
    private LocalDate localDate;
    private LocalTime localTime;
    private LocalDateTime localDateTime;
}

创建控制器UserController

@RestController
@RequestMapping("user")
public class UserController {
    @PostMapping("test")
    public User test(@RequestBody User user){
        System.out.println(user.toString());
        return user;
    }
}

前端传参

{
  "id": 184309536616640512,
  "name": "八卦程序",
  "localDate": "2023-03-01",
  "localTime": "09:35:50",
  "localDateTime": "2023-03-01 09:35:50"
}

后端返回数据

{
  "id": "184309536616640512",
  "name": "八卦程序",
  "localDate": "2023-03-01",
  "localTime": "09:35:50",
  "localDateTime": "2023-03-01 09:35:50"
}

可以看到，前端传入了什么数据，后端就返回了什么数据，唯一的区别就是后端返回的id是字符串了，可以防止前端（例如JavaScript）出现精度丢失问题。

同时也证明LocalDateTime等日期时间类型，到后端参观了一圈，又正常返回了（没有被拒，也没有遭到后端毒打变形，例如变成时间戳回来，导致亲妈都不认识了）。

前端表白被拒

如果不配置JacksonConfig呢，Spring MVC在尝试内置转换器无果后，会报异常如下：
JSON parse error: Cannot deserialize value of type java.time.LocalDateTime

返回给前端的数据如下：

{
  "timestamp": "2023-03-01T09:53:02.158+00:00",
  "status": 400,
  "error": "Bad Request",
  "path": "/user/test"
}

你懂的，被拒了。

总结

核心类ObjectMapper

ObjectMapper是jackson-databind模块最为重要的一个类，它完成了数据处理的几乎所有功能。
尽管Spring MVC在处理前端传递的JSON参数时，进行了一系列眼花缭乱的操作，但是一顿操作猛如虎，最终还是靠ObjectMapper来完成序列化和反序列化。因此，只需要对Spring Boot默认提供的ObjectMapper进行个性化定制即可。

不要覆盖默认配置

我们通过实现Jackson2ObjectMapperBuilderCustomizer接口并注册到容器，进行个性化定制，Spring Boot不会覆盖默认ObjectMapper的配置，而是进行了合并增强，具体还会根据Jackson2ObjectMapperBuilderCustomizer实现类的Order优先级进行排序，因此上面的JacksonConfig配置类还实现了Ordered接口。

默认的Jackson2ObjectMapperBuilderCustomizerConfiguration优先级是0，因此如果我们想要覆盖配置，设置优先级大于0即可。

注意：在SpringBoot2环境下，不要将自定义的ObjectMapper对象注入容器，这样会将原有的ObjectMapper配置覆盖！

QueryString格式参数

需要注意的是，Jackson不能解决QueryString格式参数的问题，因为Spring对于这类参数用的是Converter类型转换机制，那就是另一条参数绑定之路了（不好意思，Jackson没在这条路上帮忙）。

需要自定义参数类型转换器来处理日期时间类型，需要另写文章介绍了，更多关于Spring Boot2定制Jackson的资料请关注脚本之家其它相关文章！

您可能感兴趣的文章:

快速上手Java单元测试框架JUnit5
今天给大家带来的是关于Java单元测试的相关知识,文章围绕着Java单元测试框架JUnit5展开,文中有非常详细的介绍及代码示例,需要的朋友可以参考下
2021-06-06
java统计字符串中指定元素出现次数方法
这篇文章主要介绍了java统计字符串中指定元素出现次数方法,需要的朋友可以参考下
2015-12-12
多数据源如何实现事务管理
Spring中涉及三个核心事务处理接口：PlatformTransactionManager、TransactionDefinition和TransactionStatus,PlatformTransactionManager提供事务操作的基本方法,如获取事务、提交和回滚
2024-09-09
JAVA中寻找最大的K个数解法
寻找最大的K个数，这个是面试中比较常见的一道题，网上也有很多例子，在这里是比较传统的解法
2014-04-04
Java如何使用字符流读写非文本文件
这篇文章主要介绍了Java如何使用字符流读写非文本文件,以Java的字符流读取文件为例：它只能读取0-65535之间的字符，可以看出来字符都是正数，但是二进制的byte是可以为负数的,需要的朋友可以参考下
2023-04-04
封装了一个Java数据库访问管理类
刚刚试着用JDBC，仿着原来C#的写法写了这段代码，自己觉得还是挺粗糙的，还烦请路过的朋友推荐一个写得较好较完整的相关例程以便学习。谢谢！
2009-02-02
SpringBoot热部署启动关闭流程详解
Spring Boot启动热部署是一种技术，它能让开发者在不重启应用程序的情况下实时更新代码。这样可以提高开发效率，避免频繁重启应用，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习吧
2023-04-04
深入了解Spring的事务传播机制
Spring事务传播机制是指，包含多个事务的方法在相互调用时，事务是如何在这些方法间传播的。本文通过示例详细介绍了Spring的事务传播机制，需要的可以参考一下
2022-09-09
使用maven一步一步构建spring mvc项目（图文详解）
这篇文章主要介绍了详解使用maven一步一步构建spring mvc项目，具有一定的参考价值，感兴趣的小伙伴们可以参考一下
2017-09-09
Spring Boot 单元测试和集成测试实现详解
这篇文章主要介绍了Spring Boot 单元测试和集成测试实现详解,文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
2019-09-09