怎么在SpringBoot中利用HttpMessageConverter实现全局日期格式化

本篇文章给大家分享的是有关怎么在SpringBoot中利用HttpMessageConverter实现全局日期格式化，小编觉得挺实用的，因此分享给大家学习，希望大家阅读完这篇文章后可以有所收获，话不多说，跟着小编一起来看看吧。

目前创新互联公司已为数千家的企业提供了网站建设、域名、网页空间、网站托管、服务器托管、企业网站设计、肥乡网站维护等服务，公司将坚持客户导向、应用为本的策略，正道将秉承"和谐、参与、激情"的文化，与客户和合作伙伴齐心协力一起成长，共同发展。

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

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

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

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

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

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

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

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

   
      org.springframework.boot
      spring-boot-starter-web
    
    
      org.springframework.boot
      spring-boot-starter-thymeleaf
    
    
      com.fasterxml.jackson.core
      jackson-databind
    
    
      com.fasterxml.jackson.dataformat
      jackson-dataformat-xml
      true
    

然后根据 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 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。

例如：

三、测试日期格式化

推荐大家下载源码对照撸一遍，实践是检验真理的唯一标准。

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());
  }

}

页面代码：

  
  


1.在页面中对日期格式化

  
  账号：
  密码：
  时间：


  账号：
  密码：
  时间：


2.点击获取JSON信息
3.点击获取XML信息

启动项目后访问 http://localhost:8080 查看日期格式化效果：

以上就是怎么在SpringBoot中利用HttpMessageConverter实现全局日期格式化，小编相信有部分知识点可能是我们日常工作会见到或用到的。希望你能通过这篇文章学到更多知识。更多详情敬请关注创新互联行业资讯频道。