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

更新时间：2018年12月26日 11:15:52 作者：yizhiwazi

这篇文章主要介绍了SpringBoot基于HttpMessageConverter实现全局日期格式化，使用Jackson消息转换器，非常具有实用价值，需要的朋友可以参考下

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

学习目标

快速学会使用Jackson消息转换器并实现日期的全局格式化。

快速查阅

源码下载：SpringBoot-Date-Format

开始教程

一、全局日期格式化（基于自动配置）

关于日期格式化，很多人会想到使用Jackson的自动配置：

spring.jackson.date-format=yyyy-MM-dd HH:mm:ss
spring.jackson.timeZone: GMT+8

这种全局日期格式化固然方便，但在消息传递时只能解析特定的时间格式，在实际业务开展中并不那么方便。例如某接口返回的是long类型的时间戳，显然此时消息转换器将抛出解析失败的异常。

那么有没更好的办法，既支持返回默认的日期格式，又支持解析复杂的日期字符串？

答案是有的，只需要重写Jackson的消息转换器来支持解析复杂的日期格式即可。

二、全局日期格式化（基于消息转换器）

首先在项目引入Jackson、Thymeleaf等相关依赖：

   <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 来定制支持复杂日期类型解析的工具类。

  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 。

 @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。

 @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代码：

/**
 * 用户管理
 */
@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());
  }

}

页面代码：

<!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的日期格式更符合国人的阅读习惯，能够提升用户体验。

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

您可能感兴趣的文章:

MyBatis select标签的使用示例
MyBatis中,select 标签是最常用也是功能最强大的 SQL 语言,用于执行查询操作,本文就来介绍了MyBatis select标签的使用示例,具有一定的参考价值,感兴趣的可以了解一下
2023-10-10
Kotlin + Retrofit + RxJava简单封装使用详解
这篇文章主要介绍了Kotlin + Retrofit + RxJava简单封装使用详解，小编觉得挺不错的，现在分享给大家，也给大家做个参考。一起跟随小编过来看看吧
2018-07-07
Java聊天室之解决连接超时问题
这篇文章主要为大家详细介绍了Java简易聊天室之解决连接超时问题的方法，文中的示例代码讲解详细，具有一定的借鉴价值，需要的可以了解一下
2022-10-10
SpringBoot使用RESTful接口详解
RESTful是一种web软件风格，它不是标准也不是协议，它不一定要采用,只是一种风格，它倡导的是一个资源定位(url)及资源操作的风格，这篇文章主要介绍了SpringBoot使用RESTful接口
2022-10-10
Spring Security基本架构与初始化操作流程详解
这篇文章主要介绍了Spring Security基本架构与初始化操作流程，Spring Security是一个能够为基于Spring的企业应用系统提供声明式的安全访问控制解决方案的安全框架
2023-03-03
SpringBoot利用validation实现优雅的校验参数
数据的校验是交互式网站一个不可或缺的功能，如果数据库中出现一个非法的邮箱格式，会让运维人员头疼不已。本文将介绍如何利用validation来对数据进行校验，感兴趣的可以跟随小编一起学习一下
2022-06-06
springboot关闭druid监控 druid2改配置文件无效的解决
这篇文章主要介绍了springboot关闭druid监控 druid2改配置文件无效的解决方案,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
2024-05-05
struts2中实现多个文件同时上传代码
struts2中实现多个文件同时上传代码，需要的朋友可以参考一下
2013-04-04
深入理解JSON及其在Java中的应用小结
json它是一种轻量级的数据交换格式,由于其易于阅读和编写,同时也易于机器解析和生成,因此广泛应用于网络数据交换和配置文件,这篇文章主要介绍了深入理解JSON及其在Java中的应用,需要的朋友可以参考下
2023-12-12
拦截器获取request的值之后,Controller拿不到值的解决
这篇文章主要介绍了拦截器获取request的值之后,Controller拿不到值的解决方案，具有很好的参考价值，希望对大家有所帮助。如有错误或未考虑完全的地方，望不吝赐教
2021-10-10

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

相关文章

最新评论

大家感兴趣的内容

最近更新的内容

常用在线小工具