彻底解决Spring mvc中时间的转换和序列化等问题
痛点
在使用Spring mvc 进行开发时我们经常遇到前端传来的某种格式的时间字符串无法用java8的新特性java.time
包下的具体类型参数来直接接收。 我们使用含有java.time
封装类型的参数接收也会报反序列化问题,在返回前端带时间类型的同样会出现一些格式化的问题。今天我们来彻底解决他们。
建议
其实最科学的建议统一使用时间戳来代表时间。这个是最完美的,避免了前端浏览器的兼容性问题,同时也避免了其它一些中间件的序列化/反序列化问题。但是用时间表达可能更清晰语义化。两种方式各有千秋,如果我们坚持使用java8的时间类库也不是没有办法。下面我们会以java.time.LocalDateTime
为例逐一解决这些问题。
局部注解方式
网上有很多文章说该注解是前端指向后端的,也就是前端向后端传递时间参数格式化使用的,这没有错!但是有一个小问题,该方式只能适用于不涉及反序列化的情况下。也就是以下场景才适用:
@GetMapping("/local") public Map<String, String> data(@DateTimeFormat(pattern = "yyyy-MM-dd HH:mm:ss") LocalDateTime localDateTime) { Map<String, String> map = new HashMap<>(1); map.put("data", localDateTime.format(DateTimeFormatter.ofPattern("yyyy-MM-dd"))); return map; }
如果你在下面这个场景使用就不行了:
@Data public class UserInfo { @DateTimeFormat(pattern = "yyyy-MM-dd HH:mm:ss") private LocalDateTime birthday; private String name; private Integer age; } @PostMapping("/user") public Object postData(@RequestBody UserInfo userInfo) { System.out.println("userInfo = " + userInfo); return userInfo; }
原因是Post请求参数在body中,需要反序列化成对象。默认是jackson类库来进行反序列化,并不触发@DateTimeFormat
注解机制。 这时我们就需要使用jackson的格式化注解@JsonFormat
。我们将实体类UserInfo
改造成下面的就可以了:
@Data public class UserInfo { @DateTimeFormat(pattern = "yyyy-MM-dd HH:mm:ss") @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8") private LocalDateTime birthday; private String name; private Integer age; }
以上两个注解可以并存,但是一定要清楚各自的使用场景。这里还有一个小细节:格式一定要对应好时间类型。比如yyyy-MM-dd
对应java.time.LocalDate
。如果再个性化一些@JsonFormat
可以被@JsonDeserialize
和@JsonSerialize
代替。但是它们的using
参数需要你自己实现为你对应的时间类型类型。 如果@JsonFormat
、@JsonDeserialize
和@JsonSerialize
同时存在@JsonFormat
的优先级要更高。
局部处理的好处
局部处理的好处在于八个字:百花齐放,百家争鸣 。可以保持多样性、个性化 。但是局部带来了一个新的问题 :没有共同的标准 、不兼容。进而不方便维护。所以有时候基于业务需要我们全局化可以统一管理。下面我们将讲解如何进行全局化配置。
全局化化时间格式配置
全局化其实也是基于 @DateTimeFormat
和@JsonFormat
两种场景来进行配置。对于@DateTimeFormat
的场景我们通过实现Spring提供的接口:
DateTimeFormatter :
// 时间格式化 private static final DateTimeFormatter FORMATTER = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss", Locale.CHINA);
类型转换接口:
org.springframework.core.convert.converter.Converter<S,T>
实现:
@Bean public Converter<String, LocalDateTime> localDateConverter() { return new Converter<String, LocalDateTime>() { @Override public LocalDateTime convert(String source) { return LocalDateTime.parse(source, FORMATTER); } }; }
或者格式化接口:
org.springframework.format.Formatter<T>
实现 :
@Bean public Formatter<LocalDateTime> localDateFormatter() { return new Formatter<LocalDateTime>() { @Override public LocalDateTime parse(String text, Locale locale) throws ParseException { return LocalDateTime.parse(text, FORMATTER); } @Override public String print(LocalDateTime object, Locale locale) { return object.format(FORMATTER); } }; }
以上两个接口的实现都要注册为Spring Bean,配置的时候二者选其一即可,其中S即Source也就是来源,其实就是前端的时间字符串。T即Target也就是目标,代表你需要转化或者格式化的时间java类型。
那么对于时间序列化和反序列化我们进行如下配置就行了(基于默认jackson,以LocalDateTime 为例):
@Bean public Jackson2ObjectMapperBuilderCustomizer jackson2ObjectMapperBuilderCustomizer() { return jacksonObjectMapperBuilder -> jacksonObjectMapperBuilder // 反序列化 .deserializerByType(LocalDateTime.class, new LocalDateTimeDeserializer(FORMATTER)) // 序列化 .serializerByType(LocalDateTime.class, new LocalDateTimeSerializer(FORMATTER)); }
同样该jsonMapper自定义构建器要注册成Spring Bean才行。
全局配置要点
全局配置的一些优缺点上面已经阐述了,这里我还是要啰嗦一下要点避免你踩坑。全局配置跟局部配置一样。同样要约定pattern。这就要求我们全局保持一致。我们可以实现多个以上的全局配置来对其他诸如LocalDate
、OffsetDateTime
的适配。同时如果我们接入了其它一些需要用到序列化/反序列化的中间件,比如redis、rabbitmq,我们也要注意进行适配。
总结
通过以上对时间格式的局部和全局处理方式的介绍,相信困扰你的Spring mvc 时间问题不会再存在了。如果感觉写对可以请转发告诉其他同学,点个赞,关注一下。
关注公众号:码农小胖哥 获取更多资讯

低调大师中文资讯倾力打造互联网数据资讯、行业资源、电子商务、移动互联网、网络营销平台。
持续更新报道IT业界、互联网、市场资讯、驱动更新,是最及时权威的产业资讯及硬件资讯报道平台。
转载内容版权归作者及来源网站所有,本站原创内容转载请注明来源。
- 上一篇
vue项目实践@树洞(二)
书接上文 上一篇粗略地搭建了项目,运行一下,编译通过,但是控制台上打出一个红色错误警告!报错了?!什么情况,还没做事就错了,来看看什么错! 'Locale' is defined but never used,就是说Locale这个变量没有使用。在引入UI组件库的时候,我的编辑器已经错误提示了,莫名其妙嘛。并非这个错抛得莫名其妙,而是这个错不是自己造成的。设想一下,在插件的基础上加了很复杂的逻辑,这时来一个这样莫名其妙的错,是不是很无语。这只是一个假想,绝大多数情况不会是插件带来的。不过,我还是选择自己撸代码,不去使用所谓的插件,除非使用例如Babel之类的工具。 除此之外,使用ESLint还会有更多的错误提示。比如,配置postcss.config.js的时候也会给出错误警告,我在上一篇文章给的配置文件的key使用的是双引号,它会提示使用单引号。再比如,ES推荐使用箭头函数,在某些时候没用使用箭头函数也会跑错,特别是使用插件。代码提示会抛出很多语法上的错误提示,如果开了ESLint,那就按着它的提示来培养代码编写习惯吧。 // 重新给一下postcss.config.js modu...
- 下一篇
分析源码,学会正确使用 Java 线程池
在日常的开发工作当中,线程池往往承载着一个应用中最重要的业务逻辑,因此我们有必要更多地去关注线程池的执行情况,包括异常的处理和分析等。本文主要聚焦在如何正确使用线程池上,以及提供一些实用的建议。文中会稍微涉及到一些线程池实现原理方面的知识,但是不会过多展开。 线程池的异常处理 UncaughtExceptionHandler 我们都知道Runnable接口中的run方法是不允许抛出异常的,因此派生出这个线程的主线程可能无法直接获得该线程在执行过程中的异常信息。如下例: public static void main(String[] args) throws Exception { Thread thread = new Thread(() -> { Uninterruptibles.sleepUninterruptibly(2, TimeUnit.SECONDS); System.out.println(1 / 0); // 这行会导致报错! }); thread.setUncaughtExceptionHandler((t, e) -> { e.printS...
相关文章
文章评论
共有0条评论来说两句吧...
文章二维码
点击排行
-
Docker使用Oracle官方镜像安装(12C,18C,19C)
- Springboot2将连接池hikari替换为druid,体验最强大的数据库连接池
- Docker快速安装Oracle11G,搭建oracle11g学习环境
- CentOS8编译安装MySQL8.0.19
- SpringBoot2配置默认Tomcat设置,开启更多高级功能
- MySQL8.0.19开启GTID主从同步CentOS8
- Jdk安装(Linux,MacOS,Windows),包含三大操作系统的最全安装
- CentOS7,8上快速安装Gitea,搭建Git服务器
- SpringBoot2编写第一个Controller,响应你的http请求并返回结果
推荐阅读
最新文章
- Hadoop3单机部署,实现最简伪集群
- CentOS6,CentOS7官方镜像安装Oracle11G
- CentOS8,CentOS7,CentOS6编译安装Redis5.0.7
- Jdk安装(Linux,MacOS,Windows),包含三大操作系统的最全安装
- 2048小游戏-低调大师作品
- Windows10,CentOS7,CentOS8安装Nodejs环境
- CentOS8编译安装MySQL8.0.19
- SpringBoot2整合Thymeleaf,官方推荐html解决方案
- Red5直播服务器,属于Java语言的直播服务器
- Docker快速安装Oracle11G,搭建oracle11g学习环境