Spring Boot和Feign中使用Java 8时间日期API(LocalDate等)的序列化问题
程序猿DD 系列文章目录
号外: 最近整理了之前编写的一系列内容做成了PDF,关注我的公众号”程序猿DD”来领取吧!
LocalDate
、LocalTime
、LocalDateTime
是Java 8开始提供的时间日期API,主要用来优化Java 8以前对于时间日期的处理操作。然而,我们在使用Spring Boot或使用Spring Cloud Feign的时候,往往会发现使用请求参数或返回结果中有LocalDate
、LocalTime
、LocalDateTime
的时候会发生各种问题。本文我们就来说说这种情况下出现的问题,以及如何解决。
问题现象
先来看看症状。比如下面的例子:
@SpringBootApplication public class Application { public static void main(String[] args) { SpringApplication.run(Application.class, args); } @RestController class HelloController { @PostMapping("/user") public UserDto user(@RequestBody UserDto userDto) throws Exception { return userDto; } } @Data @NoArgsConstructor @AllArgsConstructor static class UserDto { private String userName; private LocalDate birthday; } }
上面的代码构建了一个简单的Spring Boot Web应用,它提供了一个提交用户信息的接口,用户信息中包含了LocalDate
类型的数据。此时,如果我们使用Feign来调用这个接口的时候,会得到如下错误:
2018-03-13 09:22:58,445 WARN [http-nio-9988-exec-3] org.springframework.web.servlet.mvc.support.DefaultHandlerExceptionResolver - Failed to read HTTP message: org.springframework.http.converter.HttpMessageNotReadableException: JSON parse error: Can not construct instance of java.time.LocalDate: no suitable constructor found, can not deserialize from Object value (missing default constructor or creator, or perhaps need to add/enable type information?); nested exception is com.fasterxml.jackson.databind.JsonMappingException: Can not construct instance of java.time.LocalDate: no suitable constructor found, can not deserialize from Object value (missing default constructor or creator, or perhaps need to add/enable type information?) at [Source: java.io.PushbackInputStream@67064c65; line: 1, column: 63] (through reference chain: java.util.ArrayList[0]->com.didispace.UserDto["birthday"])
分析解决
对于上面的错误信息JSON parse error: Can not construct instance of java.time.LocalDate: no suitable constructor found, can not deserialize from Object value
,熟悉Spring MVC的童鞋应该马上就能定位错误与LocalDate
的反序列化有关。但是,依然会有很多读者会被这段错误信息java.util.ArrayList[0]->com.didispace.UserDto["birthday"]
所困惑。我们命名提交的UserDto["birthday"]
是个LocalDate
对象嘛,跟ArrayList
列表对象有啥关系呢?
我们不妨通过postman等手工发一个请求看看服务端返回的是什么?比如你可以按下图发起一个请求:
从上图中我们就可以理解上面我所提到的困惑了,实际上默认情况下Spring MVC对于LocalDate
序列化成了一个数组类型,而Feign在调用的时候,还是按照ArrayList
来处理,所以自然无法反序列化为LocalDate
对象了。
解决方法
为了解决上面的问题非常简单,因为jackson也为此提供了一整套的序列化方案,我们只需要在pom.xml
中引入jackson-datatype-jsr310
依赖,具体如下:
<dependency> <groupId>com.fasterxml.jackson.datatype</groupId> <artifactId>jackson-datatype-jsr310</artifactId> </dependency>
注意:在设置了spring boot的parent的情况下不需要指定具体的版本,也不建议指定某个具体版本
在该模块中封装对Java 8的时间日期API序列化的实现,其具体实现在这个类中:com.fasterxml.jackson.datatype.jsr310.JavaTimeModule
(注意:一些较早版本疯转在这个类中“com.fasterxml.jackson.datatype.jsr310.JSR310Module
)。在配置了依赖之后,我们只需要在上面的应用主类中增加这个序列化模块,并禁用对日期以时间戳方式输出的特性:
@Bean public ObjectMapper serializingObjectMapper() { ObjectMapper objectMapper = new ObjectMapper(); objectMapper.disable(SerializationFeature.WRITE_DATES_AS_TIMESTAMPS); objectMapper.registerModule(new JavaTimeModule()); return objectMapper; }
此时,我们在访问刚才的接口,就不再是数组类型了,同时对于Feign客户端的调用也不会再出现上面的错误了。
代码示例
本文的相关例子可以查看下面仓库中的Chapter3-1-7
目录:
- Github:https://github.com/dyc87112/SpringBoot-Learning
- Gitee:https://gitee.com/didispace/SpringBoot-Learning
Spring Booot 2.0 新特性详解正在连载,点击看看都有哪些解读
本文由
程序猿DD-翟永超 创作,采用
CC BY 3.0 CN协议 进行许可。 可自由转载、引用,但需署名作者且注明文章出处。如转载至微信公众号,请在文末添加作者公众号二维码。
原文地址:http://blog.didispace.com/Spring-Boot-And-Feign-Use-localdate/
相关推荐
-
使用Spring Cloud Sleuth实现链路监控 Java框架
2020-7-4
-
EFK接入kafka消息队列 Java框架
2019-5-3
-
Spring boot for Eclipse 开发指南第六节 Oauth 2.0 Java框架
2020-7-4
-
多研究些架构,少谈些框架(3)– 微服务和事件驱动 Java框架
2019-3-27
-
Spring Cloud Alibaba基础教程:Sentinel使用Apollo存储规则 Java框架
2020-6-1
-
spring+atomikos+mytatis+jpa实现分布式事务管理实战篇 Java框架
2019-7-4
-
Spring Boot @EnableAutoConfiguration解析 Java框架
2020-6-1
-
详解Tomcat 配置文件server.xml Java框架
2019-4-2
-
SpringBoot 之Thymeleaf模板. Java框架
2019-8-16
-
Gadtry-Aop, Spring Aop之外的新选择 Java框架
2020-6-1