springboot 默认使用ObjectMapper(jackson)操作对象的序列化和反序列化
分析
从springboot:3.2.1 web 项目序列化响应体的过程中分析日期格式化问题（左侧是请求处理流程，右侧是在流程中使用的一些对象的来源）
ObjectMapper与JsonSerializer
根据上述流程可知，序列化响应结果时使用的ObjectMapper对象是由自动配置类JacksonAutoConfiguratioin.JacksonObjectMapperConfiguration使用Jackson2ObjectMapperBuilder创建，并注册到beanfactory中。
创建ObjectMapper对象
设置ObjectMapper对象的属性
在Jackson2ObjectMapperBuilder#build方法中创建了ObjectMapper对象，然后在Jackson2ObjectMapperBuilder#configure方法中对ObjectMapper对象设置了一些属性。
例如创建JavaTimeModule对象并将其注册给ObjectMapper, 正是在JavaTimeModule的构造方法中指定了LocalDateTime的序列化器使用com.fasterxml.jackson.datatype.jsr310.ser.LocalDateTimeSerializer，并将这种关系使用ObjectMapper#registerModules注册给ObjectMapper对象
在以下方法中创建了com.fasterxml.jackson.datatype.jsr310.JavaTimeModule对象
1 2 3 4 5 6 7 8 9 10 11 12 13 | private void registerWellKnownModulesIfAvailable(MultiValueMap<object data-origwidth="" data-origheight="" style="width: 1264px;"> modulesToRegister) { // ... try { Class extends Module> javaTimeModuleClass = (Class extends Module>) ClassUtils.forName("com.fasterxml.jackson.datatype.jsr310.JavaTimeModule", this.moduleClassLoader); Module javaTimeModule = BeanUtils.instantiateClass(javaTimeModuleClass); modulesToRegister.set(javaTimeModule.getTypeId(), javaTimeModule); } catch (ClassNotFoundException ex) { // jackson-datatype-jsr310 not available } // ... }</object> |
在JavaTimeModule类的构造函数中设置了LocalDateTime类型和该类型使用的序列化器LocalDateTimeSerializer和反序列化器LocalDateTimeDeserializer的对应关系
结论
springboot项目中，使用从beanfactory中获取的ObjectMapper序列化对象时，若对象的字段类型是LocalDateTime，则使用com.fasterxml.jackson.datatype.jsr310.ser.LocalDateTimeSerializer对字段进行序列化，但是其默认的日期格式并不是我们想要的。
因此需要干涉上述流程，使用自定义的日期时间格式
自定义日期格式（全局）
1.直接操作spring容器中的ObjectMapperbean
利用ObjectMapper#registerModule
2.自定义容器中的Jackson2ObjectMapperBuilderbean，达到间接操作ObjectMapper的目的
从流程图中可知，容器中的ObjectMapper对象由Jackson2ObjectMapperBuilder创建（创建者模式），因此自定义Jackson2ObjectMapperBuilder的属性，会间接作用到ObjectMapper的属性
根据JacksonAutoConfiguration.JacksonObjectMapperBuilderConfiguration源码可知，创建一个Jackson2ObjectMapperBuilderCustomizer实现类，并将其注入到容器中，可对容器中的Jackson2ObjectMapperBuilder bean进行自定义配置
按照上述思路实现如下（真实工作中需考虑多个customizer的顺序）
也可以使用modulesToInstall方法
3.向容器中注入com.fasterxml.jackson.databind.Module的实现类
这是因为springboot自动配置包中已经提供了一个Jackson2ObjectMapperBuilderCustomizer实现类，在创建该实现类对象时，它将从容器中获取的com.fasterxml.jackson.databind.Modulebean用于自定义配置Jackson2ObjectMapperBuilder
同时，可以看到StandardJackson2ObjectMapperBuilderCustomizer类使用了JacksonProperties的配置，也就说可以在配置文件中做些定义的配置
扩展
利用配置文件指定java.util.Date类型的格式化
1 2 3 4 | spring: jackson: date-format: yyyy-MM-dd HH:mm:ss time-zone: GMT+8 |
这种方式对java.time.LocalDateTime类型无效
利用注解指定时间格式化（局部）
@JsonFormat，对java.util.Date和java.time.LocalDateTime都有效
-
@JsonSerialize、@JsonDeserialize，指定使用的序列化器 @DateTimeFormat@JsonComponent
总结
以上为个人经验，希望能给大家一个参考，也希望大家多多支持IT俱乐部。
