LocalDate 、 LocalTime 、 LocalDateTime 是Java 8開始提供的時(shí)間日期API,主要用來優(yōu)化Java 8以前對(duì)于時(shí)間日期的處理操作。然而,我們?cè)谑褂肧pring Boot或使用Spring Cloud Feign的時(shí)候,往往會(huì)發(fā)現(xiàn)使用請(qǐng)求參數(shù)或返回結(jié)果中有 LocalDate 、 LocalTime 、 LocalDateTime 的時(shí)候會(huì)發(fā)生各種問題。本文我們就來說說這種情況下出現(xiàn)的問題,以及如何解決。
問題現(xiàn)象
先來看看癥狀。比如下面的例子:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
|
@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; } } |
上面的代碼構(gòu)建了一個(gè)簡(jiǎn)單的Spring Boot Web應(yīng)用,它提供了一個(gè)提交用戶信息的接口,用戶信息中包含了 LocalDate 類型的數(shù)據(jù)。此時(shí),如果我們使用Feign來調(diào)用這個(gè)接口的時(shí)候,會(huì)得到如下錯(cuò)誤:
1
2
|
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" ]) |
分析解決
對(duì)于上面的錯(cuò)誤信息 JSON parse error: Can not construct instance of java.time.LocalDate: no suitable constructor found, can not deserialize from Object value
,熟悉Spring MVC的童鞋應(yīng)該馬上就能定位錯(cuò)誤與 LocalDate 的反序列化有關(guān)。但是,依然會(huì)有很多讀者會(huì)被這段錯(cuò)誤信息 java.util.ArrayList[0]->com.didispace.UserDto["birthday"]
所困惑。我們命名提交的 UserDto["birthday"]
是個(gè) LocalDate 對(duì)象嘛,跟 ArrayList 列表對(duì)象有啥關(guān)系呢?
我們不妨通過postman等手工發(fā)一個(gè)請(qǐng)求看看服務(wù)端返回的是什么?比如你可以按下圖發(fā)起一個(gè)請(qǐng)求:
從上圖中我們就可以理解上面我所提到的困惑了,實(shí)際上默認(rèn)情況下Spring MVC對(duì)于 LocalDate 序列化成了一個(gè)數(shù)組類型,而Feign在調(diào)用的時(shí)候,還是按照 ArrayList 來處理,所以自然無法反序列化為 LocalDate 對(duì)象了。
解決方法
為了解決上面的問題非常簡(jiǎn)單,因?yàn)閖ackson也為此提供了一整套的序列化方案,我們只需要在 pom.xml 中引入 jackson-datatype-jsr310 依賴,具體如下:
1
2
3
4
|
<dependency> <groupId>com.fasterxml.jackson.datatype</groupId> <artifactId>jackson-datatype-jsr310</artifactId> </dependency> |
注意:在設(shè)置了spring boot的parent的情況下不需要指定具體的版本,也不建議指定某個(gè)具體版本
在該模塊中封裝對(duì)Java 8的時(shí)間日期API序列化的實(shí)現(xiàn),其具體實(shí)現(xiàn)在這個(gè)類中: com.fasterxml.jackson.datatype.jsr310.JavaTimeModule (注意:一些較早版本瘋轉(zhuǎn)在這個(gè)類中“ com.fasterxml.jackson.datatype.jsr310.JSR310Module )。在配置了依賴之后,我們只需要在上面的應(yīng)用主類中增加這個(gè)序列化模塊,同時(shí)開啟標(biāo)準(zhǔn)的 ISO 8601 格式:
1
2
3
4
5
6
7
|
@Bean public ObjectMapper serializingObjectMapper() { ObjectMapper objectMapper = new ObjectMapper(); objectMapper.disable(SerializationFeature.WRITE_DATES_AS_TIMESTAMPS); objectMapper.registerModule( new JavaTimeModule()); return objectMapper; } |
此時(shí),我們?cè)谠L問剛才的接口,就不再是數(shù)組類型了,同時(shí)對(duì)于Feign客戶端的調(diào)用也不會(huì)再出現(xiàn)上面的錯(cuò)誤了。
代碼示例
本文的相關(guān)例子可以查看下面?zhèn)}庫(kù)中的 Chapter3-1-7 目錄:
Github:https://github.com/dyc87112/SpringBoot-Learning
Gitee:https://gitee.com/didispace/SpringBoot-Learning
總結(jié)
以上所述是小編給大家介紹的解決Spring Boot和Feign中使用Java 8時(shí)間日期API(LocalDate等)的序列化問題,希望對(duì)大家有所幫助,如果大家有任何疑問請(qǐng)給我留言,小編會(huì)及時(shí)回復(fù)大家的。在此也非常感謝大家對(duì)服務(wù)器之家網(wǎng)站的支持!