消息转换器--通过此工具进行时间转换

在 Spring MVC 处理中，HttpMessageConverter 负责在 HTTP 报文与 Java 对象之间完成序列化／反序列化。
项目常见需求包括：统一 JSON 日期格式、过滤未知字段、为前端与后端提供一致的时间序列化策略等。
下文以截图中的代码为例说明 如何编写并注册自定义 JSON 消息转换器，并给出关键原理与最小可运行配置。

1 HttpMessageConverter 的职责与执行流程

2 为何需要自定义 JSON 转换器

• Java 8 日期（LocalDateTime/LocalDate/LocalTime）默认序列化为 ISO-8601，如 2023-05-26T14:45:30。

• 业务常见格式为 yyyy-MM-dd HH:mm 等，需要统一输出／输入格式并容忍未知字段。

• 通过自定义 ObjectMapper 并置于 首位，即可在不修改实体类的情况下实现全局控制Stack OverflowBaeldung。

3 代码拆解：extendMessageConverters

java

复制编辑

@Override protected void extendMessageConverters(List<HttpMessageConverter<?>> converters) { // ① 构造 JSON 消息转换器 MappingJackson2HttpMessageConverter converter = new MappingJackson2HttpMessageConverter(); // ② 注入自定义 ObjectMapper converter.setObjectMapper(new JacksonObjectMapper()); // ③ 插入 converters 第 0 位，确保优先匹配 converters.add(0, converter); }

4 自定义 JacksonObjectMapper 的关键设置

java

复制编辑

public class JacksonObjectMapper extends ObjectMapper { public static final String DATE_TIME_FMT = "yyyy-MM-dd HH:mm"; public static final String DATE_FMT = "yyyy-MM-dd"; public static final String TIME_FMT = "HH:mm:ss"; public JacksonObjectMapper() { // 1. 关闭未知字段失败 this.configure(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES, false); // 2. 注册自定义 (de)serializer SimpleModule module = new SimpleModule() .addDeserializer(LocalDateTime.class, new LocalDateTimeDeserializer(DateTimeFormatter.ofPattern(DATE_TIME_FMT))) .addSerializer (LocalDateTime.class, new LocalDateTimeSerializer(DateTimeFormatter.ofPattern(DATE_TIME_FMT))) .addDeserializer(LocalDate.class, new LocalDateDeserializer(DateTimeFormatter.ofPattern(DATE_FMT))) .addSerializer (LocalDate.class, new LocalDateSerializer(DateTimeFormatter.ofPattern(DATE_FMT))) .addDeserializer(LocalTime.class, new LocalTimeDeserializer(DateTimeFormatter.ofPattern(TIME_FMT))) .addSerializer (LocalTime.class, new LocalTimeSerializer(DateTimeFormatter.ofPattern(TIME_FMT))); this.registerModule(module); } }

• 日期格式统一：通过 LocalDateTimeSerializer/Deserializer 指定业务格式Stack Overflow。

• 容错设置：FAIL_ON_UNKNOWN_PROPERTIES=false 避免前端字段冗余时抛异常Baeldung。

5 完整序列化流程示例

1. 请求阶段

   • 前端发送 JSON：{"orderTime":"2023-11-01 12:30"}。

   • 自定义转换器 → 反序列化为 LocalDateTime 对象，格式解析成功。

2. 响应阶段

   • Controller 返回含时间字段的实体。

   • 同一转换器序列化 → JSON 输出 "2023-11-01 12:30" 而非 ISO-8601。

3. 顺序保证

   • 若未在索引 0 插入，Spring 可能使用默认转换器，日期仍为 2023-11-01T12:30:00Stack Overflow。

6 实践注意事项