还在为 日期格式化 的问题头痛？赶紧阅览文章寻找答案吧！
学习目标
快速学会使用jackson消息转换器并实现日期的全局格式化。
快速查阅
源码下载： springboot-date-format
开始教程
一、全局日期格式化（基于自动配置）
关于日期格式化，很多人会想到使用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://HdhCmsTestthymeleaf.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://HdhCmsTestjianshu测试数据/p/7f8e1c817958
查看更多关于SpringBoot基于HttpMessageConverter实现全局日期格式化的详细内容...