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<Jackson2ObjectMapperBuilderCustomizer> customizers) { Jackson2ObjectMapperBuilder builder = new Jackson2ObjectMapperBuilder(); builder.applicationContext(applicationContext); customize(builder, customizers); return builder; } private void customize(Jackson2ObjectMapperBuilder builder, List<Jackson2ObjectMapperBuilderCustomizer> 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的资料请关注脚本之家其它相关文章!