## 1.概述书接上回，我们总结了使用`Date`处理日期时间的存在问题以及讲述了Java 8全新日期时间`LocalDate，LocalDateTime`等强大功能。可谓是[使用LocalDateTime替代Date操作处理日期时间之后：任凭风浪起，稳坐钓鱼台](https://mp.weixin.qq.com/s?__biz=Mzg5MDY1NzI0MQ==&mid=2247487971&idx=1&sn=b7c3f5791feaf5b675a28339c905add5&chksm=cfd81155f8af9843e9fd1d9504a3f8367de9bf57304d72f505b1be33a6557893f9f4d1643f00&token=832350743&lang=zh_CN#rd) 。但我们都知道大部分开发人员是守旧的，我`Date`用的好好的，也用了这么多年了，现在要换成Java 8提供的全新`LocalDate，LocalDateTime`，你说换就换啊？？？兼容吗？出问题了谁负责？😄 所以在`Spring Boot`项目中大家从`Date`过渡到`LocalDateTime`最关心以下两个问题： - **使用`LocalDateTime`类型字段作为接口出入参数，能正常映射转换前端传入的参数吗？返回参数前端是否能收到一个正常的日期时间字段值？** - **使用`LocalDateTime`类型作为数据库实体类对象字段，能正常写入数据库和读取吗？简单来说就是看数据库能否正常序列化和反序列化`LocalDateTime`等Java 8提供的全新日期时间类型。** 接下来就分别看看这两个困扰在大家心中的问题吧。 ## 2.LocalDateTime作为接口出入参数我也挺好奇的，能不能丝滑地从`Date`过渡到`LocalDateTime`，先来看看作为接口出入参数与前端交互是什么个情况。话不多说，直接上示例，先声明一个用户信息参数对象： ``` @Data public class UserParam { private Long id; private String name; private LocalDate birthday; private LocalDateDate createTime; } ``` 接口调用：这里`userDTO`和上面的参数字段一样的，为了看看接口返回结果罢了 ``` @PostMapping("/date") public UserDTO testLocalDateTime(@RequestBody UserParam param) { UserDTO userDTO = new UserDTO(); BeanUtils.copyProperties(param, userDTO); System.out.println(userDTO); return userDTO; } ``` 没想到执行结果报错~~~出师不利，具体情况如下所示： ![](https://p9-xtjj-sign.byteimg.com/tos-cn-i-73owjymdk6/072bdc7b2021475292f21eb11a3c6b06~tplv-73owjymdk6-jj-mark-v1:0:0:0:0:5o6Y6YeR5oqA5pyv56S-5Yy6IEAgU2hlcGhlcmQ=:q75.awebp?rk3s=f64ab15b&x-expires=1757619735&x-signature=4jQZ11OUvt0yOtO66IepgYX9Hjc%3D) 控制台错误信息：不能正常解析转换成`LocalDateTime`，这真是怕啥来啥哦。。。 ``` org.springframework.http.converter.HttpMessageNotReadableException: JSON parse error: Cannot deserialize value of type `java.time.LocalDateTime` from String "2024-06-30 12:12:56": Failed to deserialize java.time.LocalDateTime: (java.time.format.DateTimeParseException) Text '2024-06-30 12:12:56' could not be parsed at index 10; nested exception is com.fasterxml.jackson.databind.exc.InvalidFormatException: Cannot deserialize value of type `java.time.LocalDateTime` from String "2024-06-30 12:12:56": Failed to deserialize java.time.LocalDateTime: (java.time.format.DateTimeParseException) Text '2024-06-30 12:12:56' could not be parsed at index 10 ``` 接下来说说解决方案： **方案1：在字段属性上加上注解`@JsonFormat`格式化日期时间，这种方式简单直接** ``` @JsonFormat(shape=JsonFormat.Shape.STRING, pattern = "yyyy-MM-dd HH:mm:ss") ``` 即`UserParam`加上之后控制入参格式和`UserDTO`加上控制出参格式： ``` @Data public class UserParam { private Long id; private String name; @JsonFormat(shape = JsonFormat.Shape.STRING, pattern="yyyy-MM-dd") private LocalDate birthday; @JsonFormat(shape = JsonFormat.Shape.STRING, pattern="yyyy-MM-dd HH:mm:ss") private LocalDateTime createTime; } ``` ``` @Data public class UserDTO { private Long id; private String name; @JsonFormat(shape = JsonFormat.Shape.STRING, pattern="yyyy-MM-dd") private LocalDate birthday; @JsonFormat(shape = JsonFormat.Shape.STRING, pattern="yyyy-MM-dd HH:mm:ss") private LocalDateTime createTime; } ``` 再次调用上面示例接口就能正常接受参数和返回结果了。这种方式简单是简单，但就是比较重复不够优雅，一个项目中有这么多接口出入参对象一个个去打上注解不得累个半死，繁琐滴很，能不能一次性搞定，来个全局配置啥的就行那种？肯定有了，下来就来看看。 **方案2：全局配置解析LocalDateTime** 我们知道`Spring Boot` 已经为我们提供了日期格式化配置项： `spring.jackson.date-format` ``` spring: jackson: date-format: yyyy-MM-dd HH:mm:ss locale: zh_CN time-zone: GMT+8 default-property-inclusion: non_null ``` 这个配置项我们之前映射`Date`也是需要配置的，否则日期解析不成功。所以我们只需要在配置类读取该配置项对`LocalDateTime`的格式化转换即可： ``` @Configuration public class LocalDateTimeSerializerConfig { @Bean public LocalDateTimeSerializer localDateTimeSerializer(JacksonProperties properties) { String dateFormat = properties.getDateFormat(); if (StringUtils.isBlank(dateFormat)) { dateFormat = "yyyy-MM-dd HH:mm:ss"; } return new LocalDateTimeSerializer(DateTimeFormatter.ofPattern(dateFormat)); } @Bean public LocalDateTimeDeserializer localDateTimeDeserializer(JacksonProperties properties) { String dateFormat = properties.getDateFormat(); if (StringUtils.isBlank(dateFormat)) { dateFormat = "yyyy-MM-dd HH:mm:ss"; } return new LocalDateTimeDeserializer(DateTimeFormatter.ofPattern(dateFormat)); } @Bean public Jackson2ObjectMapperBuilderCustomizer jackson2ObjectMapperBuilderCustomizer( LocalDateTimeSerializer localDateTimeSerializer, LocalDateTimeDeserializer localDateTimeDeserializer) { return builder -> { // 序列化 builder.serializerByType(LocalDateTime.class, localDateTimeSerializer); // 反序列化 builder.deserializerByType(LocalDateTime.class, localDateTimeDeserializer); }; } } ``` 上面出入参对象去掉注解`@JsonFormat`，重新启动项目调用接口发现同样正常输出： ![](https://p9-xtjj-sign.byteimg.com/tos-cn-i-73owjymdk6/ba5370229f984d74bd47f88eec3725c1~tplv-73owjymdk6-jj-mark-v1:0:0:0:0:5o6Y6YeR5oqA5pyv56S-5Yy6IEAgU2hlcGhlcmQ=:q75.awebp?rk3s=f64ab15b&x-expires=1757619735&x-signature=3yLu4reCiqE5%2BGjFKKJr09fKbS8%3D) > **项目推荐**：基于SpringBoot2.x、SpringCloud和SpringCloudAlibaba企业级系统架构底层框架封装，解决业务开发时常见的非功能性需求，防止重复造轮子，方便业务快速开发和企业技术栈框架统一管理。引入组件化的思想实现高内聚低耦合并且高度可配置化，做到可插拔。严格控制包依赖和统一版本管理，做到最少化依赖。注重代码规范和注释，非常适合个人学习和企业使用 > > **Github地址**： > > **Gitee地址**： > > **微信公众号**：**Shepherd进阶笔记** > > **交流探讨qun：Shepherd_126** ## 3.LocalDateTime作为实体类字段正常写入数据库和读取上面解决了作为接口出入参数映射转换问题，现在来看看作为数据库实体类字段能否正常写入和读取。实体类user ``` @Data @Builder @AllArgsConstructor @NoArgsConstructor @TableName(value = "tb_user") @ExcelIgnoreUnannotated public class User { @TableId(type = IdType.AUTO) private Long id; private String userNo; private Integer gender; private String name; private LocalDate birthday; private String phone; private String email; private Integer isDelete; private String address; private LocalDateTime createTime; } ``` 这里我们使用orm框架是：`mybatis-plus`，对该框架不太了解的可以去看看我们之前总结的入门篇：[MyBatis-Plus最详细的入门教程](https://mp.weixin.qq.com/s?__biz=Mzg5MDY1NzI0MQ==&mid=2247486885&idx=1&sn=c3b8a0be2f670312a129885ae2da8d49&chksm=cfd80d13f8af84055fdf9e708bfa2fb2e06defb7061ded3fef5e7d43b8c407ea86392e438bc2&token=1553880093&lang=zh_CN#rd) 和高级篇：[一文带你掌握MyBatis-Plus高级功能点如何使用](https://mp.weixin.qq.com/s?__biz=Mzg5MDY1NzI0MQ==&mid=2247486917&idx=1&sn=7d4a96f080058240d3b0e95331238c93&chksm=cfd80d73f8af8465715c6de245067fbeecfdcd459699ed20af30b00e5b26c9e7c0466921e68f&token=1553880093&lang=zh_CN#rd) 依赖如下：请注意我使用的版本 ``` mysql mysql-connector-java 8.0.9 com.baomidou mybatis-plus-boot-starter 3.5.2 ``` ``` public interface UserDAO extends BaseMapper { } ``` 构建单元测试用例如下： ``` @SpringBootTest @RunWith(SpringRunner.class) public class UserServiceImplTest { @Resource private UserDAO userDAO; @Test public void testWriteLocalDateTime() { User user = User.builder().id(1L).userNo("001").gender(0).name("张三").phone("12234") .birthday(LocalDate.now()).createTime(LocalDateTime.now()).build(); userDAO.insert(user); } } ``` 正常写入数据库，开心吧。下面来看看读取： ``` @Test public void testReadLocalDateTime() { User user = userDAO.selectById(1L); System.out.println(user); } ``` 控制台打印如下： ``` User(id=1, userNo=001, gender=0, name=张三, birthday=2024-07-03, phone=12234, email=null, isDelete=0, address=null, createTime=2024-07-03T16:09:12) ``` 完美哈。一切都是那么顺风又顺水。那下面我们来看看出问题的情况，把上面的依赖版本改改： ``` mysql mysql-connector-java 5.1.26 com.baomidou mybatis-plus-boot-starter 3.5.2 ``` 再次执行测试用例： ``` @Test public void testReadLocalDateTime() { User user = userDAO.selectById(1L); System.out.println(user); } ``` 控制台报错了： ``` org.springframework.dao.TransientDataAccessResourceException: Error attempting to get column 'birthday' from result set. Cause: java.sql.SQLException: Conversion not supported for type java.time.LocalDate ; Conversion not supported for type java.time.LocalDate; nested exception is java.sql.SQLException: Conversion not supported for type java.time.LocalDate ``` 是的，我们担心的情况出现了，数据库不能正常序列化转换LocalDate了.... 这里不兜圈子了直接说原因吧，`mybatis-plus3.5.2`是基于`mybaits 3.5.10`开发的，`mybatis3.5.0`及其之前是支持对`LocalDateTime`类型转换，然而从 `MyBatis 3.5.1` 开始，不再处理`LocalDateTime` （还包括：`LocalDate 、 LocalTime` ）类型的转换而是交由 JDBC 组件，也就是 `mysql-connector-java` 来实现，`5.1.26`这个版本压根没实现转换，所以报错了。所以最好使用高一点的版本 ``` mysql mysql-connector-java 8.0.9 ``` 关于这个具体详解请看 : [把 MyBatis 替换成 MyBatis-Plus出bug](https://mp.weixin.qq.com/s/ZGDeVzVf6Cx4S84iff_B8A) ## 4.总结 `LocalDateTime` 在设计上更加现代化、易用且安全，克服了 `Date` 和 `Calendar` 的诸多缺点。虽然它们在功能上有重叠之处，但 `LocalDateTime` 提供了更好的 API 和功能，推荐在 Java 8 及以上版本中使用新的日期和时间 API。结合本文教会你在`Spring Boot`项目中丝滑从`Date`过渡到`LocalDateTime`，你还在担心什么？？？