SpringBoot 全局日期格式化（基于注解）

àì夳堔傛蜴生んèń 2022-12-28 08:30 112阅读 0赞

关注微信公众号“java大数据修炼之道”,选择“设为星标”  ; 优质文章和精品资源, 第一时间送达

![图片][9ca803f13b9919fb5bb511964e39b39f.png]

关注公众号后台回复**资源**获取实战教学资料+视频

哈喽，各位新来的小伙伴们，大家好！由于公众号做了改版，为了保证公众号的资源能准时推送到你手里，大家记得将咱们的公众号 **加星标置顶** ，在此真诚的表示感谢

![format_png][]

领读：

json数据中的时间格式化一直都是程序员头疼的问题，这里看作者怎么使用 `@JsonComponent`来处理日期。另外还可以根据时区动态展示不同时间，厉害了，你会吗？

--------------------

> 作者：yizhiwazi
> 
> 链接：https://www.jianshu.com/p/f4654d251104

### 学习目标 ###

快速学会通过注解 `@JsonComponent`自定义日期格式化的序列化器。

### 快速查阅 ###

专题阅读：《SpringBoot 布道系列》：https://www.jianshu.com/p/964370d9374e

源码下载：SpringBoot Date Format Anno：https://github.com/yizhiwazi/springboot-socks

\--- Hey Man，Don't forget to Star or Fork . ---

### 使用教程 ###

> 根据官方文档 Custom JSON Serializers and Deserializers ，想要接管Jackson的JSON的序列化和反序列化，只需通过注解 `@JsonComponent`来声明其静态内部类即可。

首先根据项目要求提供自定义的日期序列化器和反序列化器，其中包括：

*  `DateJsonSerializerextendsJsonSerializer<Date>` 表示将Date格式化为日期字符串。
 *  `DateJsonDeserializerextendsJsonDeserializer<Date>` 表示将日期字符串解析为Date日期。

/**
     * 全局日期格式化
     */
    @JsonComponent
    public class DateFormatConfig {
        private static SimpleDateFormat dateFormat = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
        /**
         * 日期格式化
         */
        public static class DateJsonSerializer extends JsonSerializer<Date> {
            @Override
            public void serialize(Date date, JsonGenerator jsonGenerator, SerializerProvider serializerProvider) throws IOException {
                jsonGenerator.writeString(dateFormat.format(date));
            }
        }
        /**
         * 解析日期字符串
         */
        public static class DateJsonDeserializer extends JsonDeserializer<Date> {
            @Override
            public Date deserialize(JsonParser jsonParser, DeserializationContext deserializationContext) throws IOException, JsonProcessingException {
                try {
                    return dateFormat.parse(jsonParser.getText());
                } catch (ParseException e) {
                    throw new RuntimeException(e);
                }
            }
        }
    }

然后提供相应的测试信息，这里以查询用户为例：

/**
     * 查询用户信息
     */
    @RestController
    public class UserController {
        @GetMapping("/")
        public User get() {
            return new User("1", "socks", "123456", new Date(), "GMT");
        }
    }
    /**
     * 用户信息
     */
    public class User {
        private String userId;
        private String username;
        private String password;
        private Date createTime;
        private String timezone;
        public User(String userId, String username, String password, Date createTime, String timezone) {
            this.userId = userId;
            this.username = username;
            this.password = password;
            this.createTime = createTime;
            this.timezone = timezone;
        }
       //省略getters&setters
    }

大功告成，接下来启动应用并访问 http://127.0.0.1:8080 ，可以拿到正确结果：

{
      "userId": "1",
      "username": "socks",
      "password": "123456",
      "createTime": "2018-12-26 01:03:25"
    }

除了日期格式化解析之外，我们还可以在 `DateFormatConfig` 注入业务变量，例如根据当前登录人的所属时区（虽然 `SimpleDateFormat`默认读取了当地时区，但在实际的国际化系统中，用户的所属时区是指其在系统录入的所属时区，而不是指当地时区。例如Tony这个用户账号挂在GMT+0时区，但此时他出差在香港使用，系统仍需要按照GMT+0时区来显示时间），为了解决这个问题，此时我们可以在 `DateFormatConfig` 注入当前登录人然后改变日期工具类的 `TimeZone`来动态修改时区。

根据当前登录人动态展示时区：

/**
     * 全局日期格式化
     */
    @JsonComponent
    public class DateFormatConfig {
        private static SimpleDateFormat dateFormat = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss Z") {
            @Override
            public Date parse(String source) throws ParseException {
                try {
                    if (StringUtils.isEmpty(source)) {
                        return null;
                    }
                    return super.parse(source);
                } catch (Exception e) {
                    return new StdDateFormat().parse(source);
                }
            }
        };
        private static UserController userController;//这里是指获取当前登录人的工具类
        @Autowired
        public void setUserController(UserController userController) {
            DateFormatConfig.userController = userController;
        }
        /**
         * 日期格式化
         */
        public static class DateJsonSerializer extends JsonSerializer<Date> {
            @Override
            public void serialize(Date date, JsonGenerator jsonGenerator, SerializerProvider serializerProvider) throws IOException {
                //获取当前登录人的所属时区
                dateFormat.setTimeZone(TimeZone.getTimeZone(userController.get().getTimezone()));
                //格式化日期
                jsonGenerator.writeString(dateFormat.format(date));
            }
        }
        /**
         * 解析日期字符串
         */
        public static class DateJsonDeserializer extends JsonDeserializer<Date> {
            @Override
            public Date deserialize(JsonParser jsonParser, DeserializationContext deserializationContext) throws IOException, JsonProcessingException {
                try {
                    //获取当前登录人的所属时区
                    dateFormat.setTimeZone(TimeZone.getTimeZone(userController.get().getTimezone()));
                    //解析日期
                    return dateFormat.parse(jsonParser.getText());
                } catch (ParseException e) {
                    throw new RuntimeException(e);
                }
            }
        }
    }

修改完后重新启动应用并访问 http://127.0.0.1:8080 ，可以拿到正确结果：

{
      "userId": "1",
      "username": "socks",
      "password": "123456",
      "createTime": "2018-12-25 17:35:50 +0000",
      "timezone": "GMT"
    }

### 小结 ###

1、使用注解 `@JsonComponent` 可以快速自定义日期格式化的序列化器，免除传统通过模块注册的烦恼。

2、使用注解 `@JsonComponent` 实现与当地无关的动态时区的精髓就在于将获取当前等人的方法写在解析日期和格式化日期的代码里。

3、使用注解 `@JsonComponent` 是直接处理String和Date的相互转换的，所以要注意空串问题。例如dateFormat.parse()要预防空串。

![图片][06db1ba5ea516dc14d91e9e942677c0e.gif]

**推荐阅读：**

**1、[为了甩锅，我写了个牛逼的日志切面！][Link 1]**

**[2][][、][2][Redis的8大数据类型，写得非常好！][Redis_8]**

**3、[最新SQL数据库面试题以及答案！][SQL]**

**[4、][4][MyBatis 如何兼容所有日志框架？][MyBatis]**

**5、[面试官：来说说单点登录的三种实现方式][Link 2]**

**[6、][6][这5个能挣钱的 SpringBoot 项目，真TMD香！][5_ SpringBoot _TMD]**

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM1NjYxMTcx_size_16_color_FFFFFF_t_70][]

点赞、在看![format_png 1][]和分享一条龙吧![format_png 2][]

[9ca803f13b9919fb5bb511964e39b39f.png]: /images/20221120/e7a8400b8c3447a0ba957e567d4a31ed.png
[format_png]: /images/20221120/ed0c118d50ef44a1a2a11f9936853cf4.png
[06db1ba5ea516dc14d91e9e942677c0e.gif]: https://img-blog.csdnimg.cn/img_convert/06db1ba5ea516dc14d91e9e942677c0e.gif
[Link 1]: http://mp.weixin.qq.com/s?__biz=MzU1NjczNTM5NQ==&mid=2247494818&idx=1&sn=14553ab24b8c954846be66333116c01f&chksm=fbc2226eccb5ab78d1dc1b9c82965b3dd57e01aa154f68fc81353866af2010534d2cb0bf7ee6&scene=21#wechat_redirect
[2]: http://mp.weixin.qq.com/s?__biz=MzU1NjczNTM5NQ==&mid=2247492315&idx=1&sn=37c6888e30892c7fae56d0769c35a571&chksm=fbc22c17ccb5a501df41ddeaecf0f7e85e292b45d6c7522e4d6a4d9c4a93a389338ee175eae8&scene=21#wechat_redirect
[Redis_8]: http://mp.weixin.qq.com/s?__biz=MzU1NjczNTM5NQ==&mid=2247494511&idx=1&sn=bddc2a964cc7ecc77201f6fe19ac53ed&chksm=fbc225a3ccb5acb5d67e4ac6f7e5be3ab32de92a9521a08696020d01a324a3a016568ff6158f&scene=21#wechat_redirect
[SQL]: http://mp.weixin.qq.com/s?__biz=MzU1NjczNTM5NQ==&mid=2247493386&idx=1&sn=6014e7fb6c2a43ca8df3b011754fa4e1&chksm=fbc229c6ccb5a0d068fdce76d8e457510c9c43e866952a917ae63ee0f1da8c5c25bd5d3879a2&scene=21#wechat_redirect
[4]: http://mp.weixin.qq.com/s?__biz=MzU1NjczNTM5NQ==&mid=2247492363&idx=1&sn=6975a1a5de92dc49d04654f21ffa7c21&chksm=fbc22dc7ccb5a4d1b94f2a9bbce26082c9f845fbbf7d588a5540d072bcef39b2281d0b705f91&scene=21#wechat_redirect
[MyBatis]: http://mp.weixin.qq.com/s?__biz=MzU1NjczNTM5NQ==&mid=2247494408&idx=1&sn=c7687378a3babe90e6cc21d722dd8f46&chksm=fbc225c4ccb5acd239695b50ed02e6162394a8947f07f63dfd7a71b1acd14eb7f610249cbf73&scene=21#wechat_redirect
[Link 2]: http://mp.weixin.qq.com/s?__biz=MzU1NjczNTM5NQ==&mid=2247493492&idx=1&sn=cd0a9b65387d5107fe9d0e1ded268d22&chksm=fbc229b8ccb5a0ae5f433e40aeb031d462bc825b837ca9e09720b6b58439dada694eeb54bbaf&scene=21#wechat_redirect
[6]: http://mp.weixin.qq.com/s?__biz=MzU1NjczNTM5NQ==&mid=2247492809&idx=1&sn=47c50b227f8063129ed09edc91449100&chksm=fbc22a05ccb5a31383ee13bb6c58f8c12dada691c16624e028f23f24c32d1e4201b4ebd1a354&scene=21#wechat_redirect
[5_ SpringBoot _TMD]: http://mp.weixin.qq.com/s?__biz=MzU1NjczNTM5NQ==&mid=2247494522&idx=1&sn=98eb0cfc5d325f7f06582ad4cdf844cd&chksm=fbc225b6ccb5aca0a42bc26c5b7a9cecc3222a5e1e8517b243a8882c1baf2b24a9cfb449bfc8&scene=21#wechat_redirect
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM1NjYxMTcx_size_16_color_FFFFFF_t_70]: https://img-blog.csdnimg.cn/20201216091909659.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM1NjYxMTcx,size_16,color_FFFFFF,t_70
[format_png 1]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly9tbWJpei5xcGljLmNuL21tYml6X2pwZy9DMXVETURxam4xOXd0dVFwSzNqbUpXM2JGR1dJOFl6NkZSMTd0bDFNRjhWZnFZeFB4OTkwa3YySjc0THZxd2liMjZLYXlIZE9YZDZlYnpycVlpYmJUand3LzY0MA?x-oss-process=image/format,png
[format_png 2]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly9tbWJpei5xcGljLmNuL21tYml6X2dpZi9iOTZDaWJDdDcwaWFhOHI3UEpveUF0bGZIQUtlOFJvc0Uzd1lWS0JhYzU1cDFIUEJKSFpTNDJ5d25HNHlZdEQzam85QTllNWthd0JaczRJRTZSMUM0d2lidy82NDA?x-oss-process=image/format,png