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

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）。在配置了依赖以后，咱们只须要在上面的应用主类中增长这个序列化模块，同时开启标准的ISO 8601格式：

@Bean
public ObjectMapper serializingObjectMapper() {
    ObjectMapper objectMapper = new ObjectMapper();
    objectMapper.disable(SerializationFeature.WRITE_DATES_AS_TIMESTAMPS);
    objectMapper.registerModule(new JavaTimeModule());
    return objectMapper;
}

此时，咱们在访问刚才的接口，就再也不是数组类型了，同时对于Feign客户端的调用也不会再出现上面的错误了。

本文首发： http://blog.didispace.com/Spr...

代码示例

本文的相关例子能够查看下面仓库中的Chapter3-1-7目录：

• Github：https://github.com/dyc87112/SpringBoot-Learning
• Gitee：https://gitee.com/didispace/SpringBoot-Learning

Spring Booot 2.0 新特性详解正在连载，点击看看都有哪些解读