LocalDateTime序列化总结

版权说明： 本文由CSDN博主keep丶原创，转载请保留此块内容在文首。
原文地址： https://blog.csdn.net/qq_38688267/article/details/146703276

1.背景

  现平台中存在两种日期类型数据，一种为精度为秒的，一种为精度为毫秒的。目前存在三个序列化场景：WEB接口、Excel文件IO、Mysql数据交互。
  这三个场景的序列化方式各不相同，现需要将这些场景中的序列化方式统一为'yyyy-MM-dd HH:mm:ss.SSS' 或 'yyyy-MM-dd HH:mm:ss'。
  本文将从概念、总体方案及各场景实现方案等方面详细介绍LocalDateTime序列化事项，本文适合开发人员查阅。
 

2.序列化介绍

  序列化是将对象转换为可传输或存储的格式（如JSON、字符串、二进制等），反序列化则是将序列化后的数据恢复为原始对象。

常见场景

• Web接口返回数据时，将LocalDateTime转换为特定格式的字符串。
• 数据库交互时，处理时间字段的读写格式（基于MyBatis/MyBatis-Plus）。
• Excel导出时，格式化日期时间字段。

关键问题

• 默认格式不符合需求（如T字符需要替换为空格）。
• 需支持毫秒和非毫秒两种格式的兼容处理。

 

3.总体方案

• **目标：**统一处理时间字段格式，避免T字符，支持毫秒与非毫秒格式。
• 规则：
  • 序列化：
    若字段不需要毫秒，格式化为yyyy-MM-dd HH:mm:ss。
    若字段需要毫秒，格式化为yyyy-MM-dd HH:mm:ss.SSS。
  • 反序列化：
    根据字符串长度自动匹配格式：
    长度19字符：yyyy-MM-dd HH:mm:ss。
    长度23字符：yyyy-MM-dd HH:mm:ss.SSS。
    其他情况使用hutools的DateUtil.formatDateTime()方法处理。

 

4.各场景实现方式

WEB接口

• web接口默认序列化方式为Jackson，其序列化工具为ObjectMapper。
• 注册自定义ObjectMapper实现自定义LocalDateTime序列化。
• 也可以通过@JsonFormat注解实现特例处理。
  
   

EasyExcel

easyExcel有其自身的序列化方式，通过实现其Convert接口并注册来实现自定义序列化方式。

 

Mybatis/MybatisPlus

mybatis的序列化方式基于TypeHandler，mybatis和mybatis plus都有默认各类型TypeHandler，通过注册自定义TypeHandler来实现自定义序列化方式。

Mybatis

• 在resultMap中指定typeHandler以实现自定义反序列化：
  <result typeHandler="org.apache.ibatis.type.BigDecimalTypeHandler"/>

• 在SQL中指定日期格式以实现自定义序列化：

  • INSERT INTO table_name (date_column) VALUES (DATE_FORMAT(#{dateParam}, '%Y-%m-%d %H:%i:%s'))
  • INSERT INTO table_name (date_column) VALUES (#{dateParam,typeHandler=com.example.CustomDateTypeHandler})

Mybatis Plus

• 配置通用TypeHandler
  
   

• 需要配置扫描路径才能生效

• @TableField注解指定typeHandler:
  

 

5.工具类封装

在DateUtil中封装了统一LocalDateTime序列化方法，平台中统一使用。

 

6.反思和总结

• 封装设计时，需要考虑序列化统一的问题，避免由于配置不完整导致的问题。
• 当遇到序列化行为不符合预期时，需要分析定位序列化方式，然后通过更换序列化工具或自定义序列化器来解决。
• 尽量统一序列化方案或规则，避免在不同场景下序列化规则不一致导致的系统问题。
• 时间类型对象和精度尽量统一，避免为了兼容和适配导致的问题。