还在为日期格式化的问题头痛?赶紧阅览文章寻找答案吧!
学习目标
快速学会使用jackson消息转换器并实现日期的全局格式化。
快速查阅
开始教程
一、全局日期格式化(基于自动配置)
关于日期格式化,很多人会想到使用jackson的自动配置:
1
2
|
spring.jackson.date-format=yyyy-mm-dd hh:mm:ss spring.jackson.timezone: gmt+ 8 |
这种全局日期格式化固然方便,但在消息传递时只能解析特定的时间格式,在实际业务开展中并不那么方便。例如某接口返回的是long类型的时间戳,显然此时消息转换器将抛出解析失败的异常。
那么有没更好的办法,既支持返回默认的日期格式,又支持解析复杂的日期字符串?
答案是有的,只需要重写jackson的消息转换器来支持解析复杂的日期格式即可。
二、全局日期格式化(基于消息转换器)
首先在项目引入jackson、thymeleaf等相关依赖:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
|
<dependency><!--web相关依赖--> <groupid>org.springframework.boot</groupid> <artifactid>spring-boot-starter-web</artifactid> </dependency> <dependency><!--thymeleaf依赖--> <groupid>org.springframework.boot</groupid> <artifactid>spring-boot-starter-thymeleaf</artifactid> </dependency> <dependency><!--json 解析工具类--> <groupid>com.fasterxml.jackson.core</groupid> <artifactid>jackson-databind</artifactid> </dependency> <dependency><!--xml 解析工具类--> <groupid>com.fasterxml.jackson.dataformat</groupid> <artifactid>jackson-dataformat-xml</artifactid> <optional> true </optional> </dependency> |
然后根据 simpledateformat 来定制支持复杂日期类型解析的工具类。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
|
private simpledateformat dateformat = new simpledateformat( "yyyy-mm-dd hh:mm:ss" ) { //根据实际业务支持各种复杂格式的日期字符串。 @override public date parse(string source) { try { return super .parse(source); //支持解析指定pattern类型。 } catch (exception e) { try { return new stddateformat().parse(source); //支持解析long类型的时间戳 } catch (parseexception e1) { throw new runtimeexception( "日期格式非法:" + e); } } } }; |
紧接着根据使用场景,来介绍如何快速实现日期的格式化。
关于日期时间格式化的三种使用场景
(1)使用@responsebody返回json信息会用到mappingjackson2httpmessageconverter 。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
|
@bean public mappingjackson2httpmessageconverter mappingjackson2httpmessageconverter() { mappingjackson2httpmessageconverter jsonconverter = new mappingjackson2httpmessageconverter(); //设置解析json工具类 objectmapper objectmapper = new objectmapper(); //设置解析日期的工具类 objectmapper.setdateformat(dateformat); //忽略未知属性 防止解析报错 objectmapper.configure(deserializationfeature.fail_on_unknown_properties, false ); jsonconverter.setobjectmapper(objectmapper); list<mediatype> list = new arraylist<>(); list.add(mediatype.application_json_utf8); jsonconverter.setsupportedmediatypes(list); return jsonconverter; } |
(2)使用@responsebody返回xml信息会用到mappingjackson2xmlhttpmessageconverter。
1
2
3
4
5
6
7
8
9
10
11
12
|
@bean public mappingjackson2xmlhttpmessageconverter mappingjackson2xmlhttpmessageconverter() { mappingjackson2xmlhttpmessageconverter xmlconverter = new mappingjackson2xmlhttpmessageconverter(); //设置解析xml的工具类 xmlmapper xmlmapper = new xmlmapper(); //设置解析日期的工具类 xmlmapper.setdateformat(dateformat); //忽略未知属性 防止解析报错 xmlmapper.configure(deserializationfeature.fail_on_unknown_properties, false ); xmlconverter.setobjectmapper(xmlmapper); return xmlconverter; } |
(3)使用modelandview返回html页面信息。
值得注意的是,无论上面哪种消息转换器均无法满足页面日期的全局格式化,因为th:object默认调用的日期date的tostring方法,所以在thymemleaf页面对日期格式化需要借助工具类#dates。
例如:<input th:value="*{#dates.format(createtime,'yyyy-mm-dd hh:mm:ss')}">
三、测试日期格式化
推荐大家下载源码对照撸一遍,实践是检验真理的唯一标准。
java代码:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
|
/** * 用户管理 */ @restcontroller public class usercontroller { /** * 打开主页 */ @getmapping ( "/" ) public modelandview index() { modelandview mv = new modelandview( "user/user" ); mv.addobject( "user" , new user( "1" , "admin" , "123456" , new date())); return mv; } /** * 自动根据请求来判断返回用户json或xml */ @getmapping ( "/user" ) public user get() { return new user( "1" , "admin" , "123456" , new date()); } /** * 返回用户json */ @getmapping (value = "/user/json" , produces = mediatype.application_json_utf8_value) public user getjson() { return new user( "1" , "admin" , "123456" , new date()); } /** * 返回用户xml */ @getmapping (value = "/user/xml" , produces = mediatype.application_xml_value) public user getxml() { return new user( "1" , "admin" , "123456" , new date()); } } |
页面代码:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
|
<!doctype html> <html xmlns:th= "http://www.thymeleaf.org" > <head> <meta charset= "utf-8" > <title>日期格式化</title> </head> <body> <h3><a th:href= "@{/}" rel= "external nofollow" > 1 .在页面中对日期格式化</a></h3> <form th:object= "${user}" > <input th:value= "*{userid}" type= "hidden" > 账号:<input th:value= "*{username}" > 密码:<input th:value= "*{password}" type= "password" > 时间:<input th:value= "*{createtime}" type= "text" > </form> <form th:object= "${user}" > 账号:<input th:value= "*{username}" > 密码:<input th:value= "*{password}" type= "password" > 时间:<input th:value= "*{#dates.format(createtime,'yyyy-mm-dd hh:mm:ss')}" > </form> <h3><a th:href= "@{/user/json}" rel= "external nofollow" > 2 .点击获取json信息</a></h3> <h3><a th:href= "@{/user/xml}" rel= "external nofollow" > 3 .点击获取xml信息</a></h3> </body> </html> |
启动项目后访问 http://localhost:8080 查看日期格式化效果:
四、小结
1、使用@responsebody会根据请求头信息来智能选择json/xml消息转换器。
2、通过重写httpmessageconverter可以自定义消息转换器来实现全局日期格式化。
3、采用类似yyyy-mm-dd hh:mm:ss的日期格式更符合国人的阅读习惯,能够提升用户体验。
以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持服务器之家。
原文链接:https://www.jianshu.com/p/7f8e1c817958