Spring Boot：玩转日期时间类型参数转换技巧

前言

在实际使用Spring MVC开发java web项目的过程中，前端调用后端的接口时，通常是以json报文的格式传递到后台，spring会对抆参数进行解析最后映射到controller层方法中。而日期类型参数前端传递过来通常是yyyy-MM-dd或yyyy-MMdd HH:mm:ss格式的字符串，而接收参数的对象中往往是LocalDate、LocalDateTime、Date，映射的时候经常会出现异常报错，这篇文章用一个小例子来分享遇到这种情况是应该是如何解决？

常用的日期类型

java.time.LocalDate;

java.time.LocalDateTime;

java.util.Date;

完成目标

前台传递到后台一个字符类型的日期（yyyy-MM-dd），后台使用LocalDate来接收，并且返回值中格式与传入相同。

前台传递到后台一个字符类型的日期时间（yyyy-MM-dd HH:mm:ss），后台怎么使用LocalDateTime来接收，并且返回值中格式与传入相同。

前台传递到后台一个字符类型的日期时间（yyyy-MM-dd HH:mm:ss），后台怎么使用java.util.Date来接收，并且返回值中格式与传入相同。

具体实现方法

1、java.util.Date类型的日期的类型转移与格式化使用@JsonFormat即可解决；对于LocalDate与LocalDateTime类型的需要全局配置自定义类型转换器;

2、对于LoclDateTime类型的参数，在序列化与反序列化的时候会有异常，通过Jackson2ObjectMapperBuilderCustomizer自定义一下LocalDate和LocalDateTime两种类型的序列化处理器即可解决这个异常；

JSON parse error: Cannot deserialize value of type `java.time.LocalDateTime` 
Failed to deserialize java.time.LocalDateTime
 nested exception is com.fasterxml.jackson.databind.exc.InvalidFormatException: Cannot deserialize value of type `java.time.LocalDateTime`

日期格式转换器配置

• LocalDateConverter方法使用Converter接口实现了一个将字符串转换为LocalDate对象的转换器。它使用LocalDate.parse方法将传入的字符串按照"yyyy-MM-dd"的格式解析成LocalDate对象。
• LocalDateTimeConverter方法也使用Converter接口实现了一个将字符串转换为LocalDateTime对象的转换器。它使用LocalDateTime.parse方法将传入的字符串按照"yyyy-MM-dd HH:mm:ss"的格式解析成LocalDateTime对象。
• jsonCustomizer方法定义了一个Jackson2ObjectMapperBuilderCustomizer对象，该对象用于自定义Jackson库的配置。首先，它创建了一个JavaTimeModule对象，用于支持Java 8日期时间类的序列化和反序列化。然后，它创建了一个LocalDateTimeDeserializer对象，用于将字符串按照"yyyy-MM-dd HH:mm:ss"的格式反序列化成LocalDateTime对象。最后，它使用Jackson2ObjectMapperBuilder的方法设置了日期时间格式和序列化器，并将JavaTimeModule模块添加到构建器中。

@Bean
    public Converter LocalDateConverter() {
        return new Converter() {
            @Override
            public LocalDate convert(String source) {
                return LocalDate.parse(source, DateTimeFormatter.ofPattern("yyyy-MM-dd"));


            }
        };
    }


    @Bean
    @ConditionalOnBean(name = "requestMappingHandlerAdapter")
    public Converter LocalDateTimeConverter() {
        return new Converter() {
            @Override
            public LocalDateTime convert(String source) {
                return LocalDateTime.parse(source, DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss"));


            }
        };
    }


    @Bean
    public Jackson2ObjectMapperBuilderCustomizer jsonCustomizer() {
        JavaTimeModule module = new JavaTimeModule();
        LocalDateTimeDeserializer localDateTimeDeserializer = new LocalDateTimeDeserializer(DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss"));
        module.addDeserializer(LocalDateTime.class, localDateTimeDeserializer);
        return new Jackson2ObjectMapperBuilderCustomizer() {
            @Override
            public void customize(Jackson2ObjectMapperBuilder builder) {
                builder.simpleDateFormat("yyyy-MM-dd HH:mm:ss");
                builder.serializers(new LocalDateSerializer(DateTimeFormatter.ofPattern("yyyy-MM-dd")));
                builder.serializers(new LocalDateTimeSerializer(DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss")));
                builder.modules(module);
            }
        };
    }
}

接收参数对象配置

@Data
public class Person implements Serializable {


    private String perName;


    private LocalDate born;


    private LocalDateTime loginTime;


    @JsonFormat(pattern = "yyyy-MM-dd")
    private Date date1;
    @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
    private Date date2;
    private List localDates;
    private List localDateTimes;
    @JsonFormat(pattern = "yyyy-MM-dd")
    private List dates;
    @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
    private List dateTimes;
}

controller层方法接收参数

@RestController
@RequestMapping("/date")
public class DateConvertController {
    @PostMapping("/conTest")
    public Person conTest(@RequestBody Person person){
        System.out.println("姓名:"+person.getPerName()+",出生日期:"+person.getBorn()+",登入时间:"+person.getLoginTime());


        return person;
    }
}