解决日期转换异常 JSON parse error: Cannot deserialize value of type `java.util.Date` from String

前言

今天在开发新闻发布模块时，需要从前端传入一个日期字符串（格式YYYY-MM-DD)，后端Bean类日期属性（java.util.Date）接收，发生JSON转换异常问题，异常情况如下：

Resolved [org.springframework.http.converter.HttpMessageNotReadableException: JSON parse error: Cannot deserialize value of type `java.util.Date` from String "2021-1-16": not a valid representation (error: Failed to parse Date value '2021-1-16': Cannot parse date "2021-1-16": while it seems to fit format 'yyyy-MM-dd', parsing fails (leniency? null)); nested exception is com.fasterxml.jackson.databind.exc.InvalidFormatException: Cannot deserialize value of type `java.util.Date` from String "2021-1-16": not a valid representation (error: Failed to parse Date value '2021-1-16': Cannot parse date "2021-1-16": while it seems to fit format 'yyyy-MM-dd', parsing fails (leniency? null))
 at [Source: (PushbackInputStream); line: 1, column: 69] (through reference chain: com.xuanbing.bean.News["date"])]

分析

从异常信息来看，可能是日期型数据被序列化为JSON之后，无法转换成java.util.date类型，需要显式的指定一个日期转换格式。

解决办法

在对应的bean日期属性上增加注解 @JsonFormat 注解

package com.xuanbing.bean;

import com.fasterxml.jackson.annotation.JsonFormat;
import lombok.Data;
import lombok.experimental.Accessors;

import java.util.Date;

@Data
@Accessors(chain = true)
public class News {
     

    private int id;
    private String title;
    private String content;
    private String teacher_id;

    @JsonFormat(locale="zh", timezone="GMT+8", pattern="yyyy-MM-dd")
    private Date date;

}

补充：@JsonFormat与@DateTimeFormat注解的使用

背景

从数据库获取时间传到前端进行展示的时候，我们有时候可能无法得到一个满意的时间格式的时间日期，在数据库中显示的是正确的时间格式，获取出来却变成了很丑的时间戳，@JsonFormat注解很好的解决了这个问题，我们通过使用@JsonFormat可以很好的解决：后台到前台时间格式保持一致的问题，其次，另一个问题是，我们在使用WEB服务的时，可能会需要用到，传入时间给后台，比如注册新用户需要填入出生日期等，这个时候前台传递给后台的时间格式同样是不一致的，而我们的与之对应的便有了另一个注解，@DataTimeFormat便很好的解决了这个问题，接下来记录一下具体的@JsonFormat与DateTimeFormat的使用过程。

声明：关于@JsonFormat的使用，一定要导入正确完整的包。

1. 注解@JsonFormat

1. 使用maven引入@JsonFormat所需要的jar包，我贴一下我这里的pom文件的依赖

<dependency>
	<groupId>com.fasterxml.jackson.coregroupId>
	<artifactId>jackson-annotationsartifactId>
	<version>2.8.8version>
dependency>
 
<dependency>
	<groupId>com.fasterxml.jackson.coregroupId>
	<artifactId>jackson-databindartifactId>
	<version>2.8.8version>
dependency>
  
<dependency>
	<groupId>org.codehaus.jacksongroupId>
	<artifactId>jackson-mapper-aslartifactId>
	<version>1.9.13version>
dependency>

2. 在你需要查询出来的时间的数据库字段对应的实体类的属性上添加@JsonFormat

package com.xuanbing.bean;

import com.fasterxml.jackson.annotation.JsonFormat;
import lombok.Data;
import lombok.experimental.Accessors;

import java.util.Date;

@Data
@Accessors(chain = true)
public class News {
     

    private int id;
    private String title;
    private String content;
    private String teacher_id;

	//设置时区为上海时区，时间格式自己据需求定。
    @JsonFormat(locale="zh", timezone="GMT+8", pattern="yyyy-MM-dd")
    private Date date;

}

这里解释一下：@JsonFormat(locale=“zh”, timezone=“GMT+8”, pattern=“yyyy-MM-dd”)
pattern:是你需要转换的时间日期的格式
timezone：是时间设置为东八区，避免时间在转换中有误差

提示：@JsonFormat注解可以在属性的上方，同样可以在属性对应的get方法上，两种方式没有区别

3. 完成上面两步之后，我们用对应的实体类来接收数据库查询出来的结果时就完成了时间格式的转换，再返回给前端时就是一个符合我们设置的时间格式了

2.注解@DateTimeFormat

1. @DateTimeFormat的使用和@jsonFormat差不多，首先需要引入是spring还有jodatime,spring我就不贴了

<dependency>
	<groupId>joda-timegroupId>
	<artifactId>joda-timeartifactId>
	<version>2.3version>
dependency>

2. 在controller层我们使用 spring mvc 表单自动封装映射对象时，我们在对应的接收前台数据的对象的属性上加@DateTimeFormat

@DateTimeFormat(pattern = "yyyy-MM-dd")
@JsonFormat(pattern = "yyyy-MM-dd",timezone="GMT+8")
private Date symstarttime;
 
@DateTimeFormat(pattern = "yyyy-MM-dd")
@JsonFormat(pattern = "yyyy-MM-dd",timezone="GMT+8")
private Date symendtime;

我这里就只贴这两个属性了，这里我两个注解都同时使用了，因为我既需要取数据到前台，也需要前台数据传到后台，都需要进行时间格式的转换，可以同时使用

3. 通过上面两个步骤之后，我们就可以获取一个符合自定义格式的时间格式存储到数据库了

3.总结

• 注解@JsonFormat主要是后台到前台的时间格式的转换
• 注解@DataFormat主要是前台到后台的时间格式的转换