服务器之家

服务器之家 > 正文

SpringBoot基于HttpMessageConverter实现全局日期格式化

时间:2021-06-25 13:53     来源/作者:yizhiwazi

还在为日期格式化的问题头痛?赶紧阅览文章寻找答案吧!

学习目标

快速学会使用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://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 查看日期格式化效果:

SpringBoot基于HttpMessageConverter实现全局日期格式化

四、小结

1、使用@responsebody会根据请求头信息来智能选择json/xml消息转换器。
2、通过重写httpmessageconverter可以自定义消息转换器来实现全局日期格式化。
3、采用类似yyyy-mm-dd hh:mm:ss的日期格式更符合国人的阅读习惯,能够提升用户体验。

以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持服务器之家。

原文链接:https://www.jianshu.com/p/7f8e1c817958

相关文章

热门资讯

2020微信伤感网名听哭了 让对方看到心疼的伤感网名大全
2020微信伤感网名听哭了 让对方看到心疼的伤感网名大全 2019-12-26
yue是什么意思 网络流行语yue了是什么梗
yue是什么意思 网络流行语yue了是什么梗 2020-10-11
背刺什么意思 网络词语背刺是什么梗
背刺什么意思 网络词语背刺是什么梗 2020-05-22
苹果12mini价格表官网报价 iPhone12mini全版本价格汇总
苹果12mini价格表官网报价 iPhone12mini全版本价格汇总 2020-11-13
2021德云社封箱演出完整版 2021年德云社封箱演出在线看
2021德云社封箱演出完整版 2021年德云社封箱演出在线看 2021-03-15
返回顶部