springboot 默認(rèn)使用ObjectMapper(jackson)操作對象的序列化和反序列化

分析

從springboot:3.2.1 web 項(xiàng)目序列化響應(yīng)體的過程中分析日期格式化問題（左側(cè)是請求處理流程，右側(cè)是在流程中使用的一些對象的來源）

ObjectMapper與JsonSerializer

根據(jù)上述流程可知，序列化響應(yīng)結(jié)果時使用的ObjectMapper對象是由自動配置類JacksonAutoConfiguratioin.JacksonObjectMapperConfiguration使用Jackson2ObjectMapperBuilder創(chuàng)建，并注冊到beanfactory中。

創(chuàng)建ObjectMapper對象

設(shè)置ObjectMapper對象的屬性

在Jackson2ObjectMapperBuilder#build方法中創(chuàng)建了ObjectMapper對象，然后在Jackson2ObjectMapperBuilder#configure方法中對ObjectMapper對象設(shè)置了一些屬性。

例如創(chuàng)建JavaTimeModule對象并將其注冊給ObjectMapper, 正是在JavaTimeModule的構(gòu)造方法中指定了LocalDateTime的序列化器使用com.fasterxml.jackson.datatype.jsr310.ser.LocalDateTimeSerializer，并將這種關(guān)系使用ObjectMapper#registerModules注冊給ObjectMapper對象

在以下方法中創(chuàng)建了com.fasterxml.jackson.datatype.jsr310.JavaTimeModule對象

private void registerWellKnownModulesIfAvailable(MultiValueMap<Object, Module> 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
		}
		// ...
	}

在JavaTimeModule類的構(gòu)造函數(shù)中設(shè)置了LocalDateTime類型和該類型使用的序列化器LocalDateTimeSerializer和反序列化器LocalDateTimeDeserializer的對應(yīng)關(guān)系

結(jié)論

springboot項(xiàng)目中，使用從beanfactory中獲取的ObjectMapper序列化對象時，若對象的字段類型是LocalDateTime，則使用com.fasterxml.jackson.datatype.jsr310.ser.LocalDateTimeSerializer對字段進(jìn)行序列化，但是其默認(rèn)的日期格式并不是我們想要的。

因此需要干涉上述流程，使用自定義的日期時間格式

自定義日期格式（全局）

1.直接操作spring容器中的ObjectMapperbean

利用ObjectMapper#registerModule

2.自定義容器中的Jackson2ObjectMapperBuilderbean，達(dá)到間接操作ObjectMapper的目的

從流程圖中可知，容器中的ObjectMapper對象由Jackson2ObjectMapperBuilder創(chuàng)建（創(chuàng)建者模式），因此自定義Jackson2ObjectMapperBuilder的屬性，會間接作用到ObjectMapper的屬性

根據(jù)JacksonAutoConfiguration.JacksonObjectMapperBuilderConfiguration源碼可知，創(chuàng)建一個Jackson2ObjectMapperBuilderCustomizer實(shí)現(xiàn)類，并將其注入到容器中，可對容器中的Jackson2ObjectMapperBuilder bean進(jìn)行自定義配置

按照上述思路實(shí)現(xiàn)如下（真實(shí)工作中需考慮多個customizer的順序）

也可以使用modulesToInstall方法

3.向容器中注入com.fasterxml.jackson.databind.Module的實(shí)現(xiàn)類

這是因?yàn)閟pringboot自動配置包中已經(jīng)提供了一個Jackson2ObjectMapperBuilderCustomizer實(shí)現(xiàn)類，在創(chuàng)建該實(shí)現(xiàn)類對象時，它將從容器中獲取的com.fasterxml.jackson.databind.Modulebean用于自定義配置Jackson2ObjectMapperBuilder

同時，可以看到StandardJackson2ObjectMapperBuilderCustomizer類使用了JacksonProperties的配置，也就說可以在配置文件中做些定義的配置

擴(kuò)展

利用配置文件指定java.util.Date類型的格式化

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

總結(jié)

以上為個人經(jīng)驗(yàn)，希望能給大家一個參考，也希望大家多多支持腳本之家。

最新評論