Spring Boot和Feign中使用Java 8时间日期API(LocalDate等)的序列化问题

LocalDateLocalTimeLocalDateTime是Java 8开始提供的时间日期API,主要用来优化Java 8以前对于时间日期的处理操作。然而,我们在使用Spring Cloud Feign的时候,往往会发现使用请求参数或返回结果中有 LocalDateLocalTimeLocalDateTime的时候会发生各种问题。本文我们就来说说这种情况下出现的问题,以及如何解决。

问题现象

先来看看症状。比如下面的例子:

@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:Cannotconstruct instance of java.time.LocalDate:nosuitable constructor found,cannotdeserializefromObjectvalue,熟悉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)。在配置了依赖之后,我们只需要在上面的应用主类中增加这个序列化模块,同时开启标准的 ISO8601格式:

@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 Boot 2.0 新特性详解正在连载,关注我吧

原文发布于微信公众号 - 程序猿DD(didispace)

原文发表时间:2018-03-14

本文参与腾讯云自媒体分享计划,欢迎正在阅读的你也加入,一起分享。

发表于

我来说两句

0 条评论
登录 后参与评论

相关文章

来自专栏编舟记

R3 Corda 和 springboot 集成

因为Corda内置的Corda Webserver已经被标记成弃用了,一般不再提供支持;再者,springboot的生态明显占优。

2512
来自专栏CSDN技术头条

Spring Data REST 与 Spring RestTemplate 实战详解

这篇分为两部分内容进行介绍(Spring Data REST 和 Spring RestTemplate)。我之前有一篇文章完整的介绍了 HTTP 协议的内容,...

9595
来自专栏battcn

一起来学SpringBoot | 第十篇:使用Spring Cache集成Redis

Spring3.1 引入了激动人心的基于注解( annotation)的缓存( cache)技术,它本质上不是一个具体的缓存实现方案(例如 EHCache 或者...

2301
来自专栏菩提树下的杨过

Spring 4.0.2 学习笔记(2) - 自动注入及properties文件的使用

接上一篇继续, 学习了基本的注入使用后,可能有人会跟我一样觉得有点不爽,Programmer的每个Field,至少要有一个setter,这样spring配置文件...

2186
来自专栏技术墨客

Spring核心——数据校验

在Java数据校验详解中详细介绍了Java数据校验相关的功能(简称Bean Validation,涵盖JSR-303、JSR-349、JSR-380),本文将在...

1181
来自专栏技术墨客

Spring核心——数据校验

在Java数据校验详解中详细介绍了Java数据校验相关的功能(简称Bean Validation,涵盖JSR-303、JSR-349、JSR-380),本文将在...

6052
来自专栏LuckQI

SpringBoot~SpringBatch 使用

Spring Batch 提供了大量可重用的组件,包括了日志、追踪、事务、任务作业统计、任务重启、跳过、重复、资源管理。对于大数据量和高性能的批处理任务,Spr...

1373
来自专栏李家的小酒馆

Spring MVC面试整理

Spring MVC执行过程 1. 客户端的请求提交到dispatcherServlet 2. DispatcherServ...

2760
来自专栏JavaEdge

@Autowired 与@Resource之争

39410
来自专栏老码农专栏

ActFramework r1.2.0 带来的新特性

1053

扫码关注云+社区

领取腾讯云代金券