写在前面

一直以来使用的接口文档方案都是Knife4j。此次编写新项目，鉴于springfox和Swagger2规范都已经停止维护，所以选择拥抱springdoc+OpenAPI3规范。knife4j也已更新版本，本项目基于Spring Boot2.7.x版本。
忠告：一定要认真看官方文档

问题描述

项目中定义了实体类属性的时间格式为LocalDateTime，如果不做任何处理后端会向前端返回数组格式，而不是我们想要的时间格式。

// 创建时间
private LocalDateTime createTime;

// 更新时间
private LocalDateTime updateTime;

pyifoQy

像这种情况，以前的项目也遇到过，所以是轻松解决。这里说一下两种解决方案，推荐使用的是第二种。

第一种：
遇到这个问题是因为后端向前端发送的时间是一个LocalDateTime对象，我们只需要把该对象转成时间戳在发送即可。

在定义LocalDateTime类型的属性上上加上注解，对日期进行格式化

// 创建时间
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
private LocalDateTime createTime;

// 更新时间
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
private LocalDateTime updateTime;

但这种方式，需要在每个时间属性都加上该注解，使用麻烦，耦合度高

第二种：
通过重写WebMvcConfigurationSupport里的消息转换器方法实现(全局)，统一对日期类型进行格式处理

具体实现步骤：

提供对象转换器JacksonObjectMapper，基于Jackson进行Java对象到json数据的转换

在WebMvcConfig配置类中扩展Spring mvc的消息转换器，在此消息转换器中使用提供的对象转换器进行Java对象到json数据的转换

/**
 * 对象映射器:基于jackson将Java对象转为json，或者将json转为Java对象
 * 将JSON解析为Java对象的过程称为 [从JSON反序列化Java对象]
 * 从Java对象生成JSON的过程称为 [序列化Java对象到JSON]
 */
public class JacksonObjectMapper extends ObjectMapper {

    public static final String DEFAULT_DATE_FORMAT = "yyyy-MM-dd";

    public static final String DEFAULT_DATE_TIME_FORMAT = "yyyy-MM-dd HH:mm";
    
    public static final String DEFAULT_TIME_FORMAT = "HH:mm:ss";

    public JacksonObjectMapper() {
        super();
        // 收到未知属性时不报异常
        this.configure(FAIL_ON_UNKNOWN_PROPERTIES, false);

        // 反序列化时，属性不存在的兼容处理
        this.getDeserializationConfig().withoutFeatures(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES);

        SimpleModule simpleModule = new SimpleModule()
                .addDeserializer(LocalDateTime.class, new LocalDateTimeDeserializer(DateTimeFormatter.ofPattern(DEFAULT_DATE_TIME_FORMAT)))
                .addDeserializer(LocalDate.class, new LocalDateDeserializer(DateTimeFormatter.ofPattern(DEFAULT_DATE_FORMAT)))
                .addDeserializer(LocalTime.class, new LocalTimeDeserializer(DateTimeFormatter.ofPattern(DEFAULT_TIME_FORMAT)))
                .addSerializer(LocalDateTime.class, new LocalDateTimeSerializer(DateTimeFormatter.ofPattern(DEFAULT_DATE_TIME_FORMAT)))
                .addSerializer(LocalDate.class, new LocalDateSerializer(DateTimeFormatter.ofPattern(DEFAULT_DATE_FORMAT)))
                .addSerializer(LocalTime.class, new LocalTimeSerializer(DateTimeFormatter.ofPattern(DEFAULT_TIME_FORMAT)));

        // 注册功能模块 例如，可以添加自定义序列化器和反序列化器
        this.registerModule(simpleModule);
    }
}