Spring @DateTimeFormat日期格式化时注解场景分析
总结写前面
关于它 @DateTimeFormat：
- 可以接收解析前端传入字符时间数据；
- 不能格式化接收的字符时间类型数据，需要的转换格式得配置；
- 入参格式必须与后端注解格式保持一致，否则会报错；
为什么用
场景：跟前端交互时，接收字符类型的时间值，就需要使用 @DateTimeFormat 注解来解析，否则就会报错；
@RestController
@RequestMapping("/demo")
public class DemoTestController {
@PostMapping("/testOne")
public DemoTest testOne(DemoTest demoTest){
return demoTest;
}
}
@Data
public class DemoTest {
private Date nowTime;
}请求示例结果：
Resolved [org.springframework.validation.BindException: org.springframework.validation.BeanPropertyBindingResult: 1 errors<EOL>Field error in object 'demoTest' on field 'nowTime': rejected value [2022-11-20 16:42:26,2022-11-20 16:42:01]; codes [typeMismatch.demoTest.nowTime,typeMismatch.nowTime,typeMismatch.java.util.Date,typeMismatch]; arguments [org.springframework.context.support.DefaultMessageSourceResolvable: codes [demoTest.nowTime,nowTime]; arguments []; default message [nowTime]]; default message [Failed to convert property value of type 'java.lang.String[]' to required type 'java.util.Date' for property 'nowTime'; nested exception is org.springframework.core.convert.ConversionFailedException: Failed to convert from type [java.lang.String] to type [java.util.Date] for value '2022-11-20 16:42:26'; nested exception is java.lang.IllegalArgumentException]]
怎么用
场景一
接收非 JSON 格式请求参数。
@RestController
@RequestMapping("/demo")
public class DemoTestController {
@PostMapping("/testOne")
public DemoTest testOne(DemoTest demoTest){
return demoTest;
}
}
@Data
public class DemoTest {
@DateTimeFormat(pattern = "yyyy-MM-dd HH:mm:ss")
private Date nowTime;
}请求示例结果：
- 请求：POST
- 数据格式：form-data
从结果可以看出，@DateTimeFormat(pattern = "yyyy-MM-dd HH:mm:ss") 可以保证接收解析前端传入的字符时间参数，但是并不能完成时间格式化操作，如果需要获取想要的时间格式，是需要自己手动转换的。
场景二
接收 JSON 格式请求数据，与场景一的区别是请求的数据格式：
- 场景一：form-data
- 场景二：JSON
@RestController
@RequestMapping("/demo")
public class DemoTestController {
@PostMapping("/testTwo")
public DemoTest testTwo(DemoTest demoTest){
return demoTest;
}
}
@Data
public class DemoTest {
@DateTimeFormat(pattern = "yyyy-MM-dd HH:mm:ss")
private Date nowTime;
}请求示例结果：
- 请求：POST
- 数据格式：JSON
从结果可以看出，返回数据 nowTime 是空的，因为这里的Controller层没有使用 @RequestBody 去接收 JSON 格式的数据，而 Spring 默认的转换器类型是不包含 JSON 的（有兴趣的可以看下 org.springframework.core.convert.support 包，这里面包含Spring支持的默认转换器）。
场景三
场景三跟场景二的区别就是，在 Controller 层方法入参配合使用 @RequestBody 去接收 JSON 格式，使用该注解会自动调用对应的JSON转换器。
@RestController
@RequestMapping("/demo")
public class DemoTestController {
@PostMapping("/testThree")
public DemoTest testThree(@RequestBody DemoTest demoTest){
return demoTest;
}
}
@Data
public class DemoTest {
@DateTimeFormat(pattern = "yyyy-MM-dd HH:mm:ss")
private Date nowTime;
}请求示例结果：
- 请求：POST
- 数据格式：JSON
这里可以看到，请求报错400，导致400的原因比较多，这里只说明一下场景三，场景三中使用 @DateTimeFormat(pattern = "yyyy-MM-dd HH:mm:ss") 注解格式与请求入参格式不一致，所以会导致请求报错；
大概意思就是说，Spring 框架在尝试转换参数的过程中，没有找到合适接收格式导致转换失败。（注意！注意！注意！讲三遍，所以前端入参格式必须与后端约定格式保持一致，否则会报错）。
场景四
场景四的目的是为了解决场景一中时间格式化的问题。
关于 @JsonFormat 注解，可以看看我的另一篇blog中有做分享，感兴趣的大佬可以去看看，附上传送门：@JsonFormat 和 @DateTimeFormat 时间格式化注解详解（不看血亏）
@RestController
@RequestMapping("/demo")
public class DemoTestController {
@PostMapping("/testThree")
public DemoTest testThree(@RequestBody DemoTest demoTest){
return demoTest;
}
}
@Data
public class DemoTest {
@JsonFormat(pattern = "yyyy-MM-dd", timezone = "GMT+8")
@DateTimeFormat(pattern = "yyyy-MM-dd HH:mm:ss")
private Date nowTime;
}请求示例结果：
- 请求：POST
- 数据格式：form-data
场景五
方式一
针对场景四的数据请求格式是 form-data，场景五来说明 JSON 同样适用。
@RestController
@RequestMapping("/demo")
public class DemoTestController {
@PostMapping("/testThree")
public DemoTest testThree(@RequestBody DemoTest demoTest){
return demoTest;
}
}
@Data
public class DemoTest {
@JsonFormat(pattern = "yyyy-MM-dd", timezone = "GMT+8")
@DateTimeFormat(pattern = "yyyy-MM-dd HH:mm:ss")
private Date nowTime;
}请求示例结果：
- 请求：POST
- 数据格式：JSON
方式二
可以继承 Spring 提供的org.springframework.boot.autoconfigure.jackson.Jackson2ObjectMapperBuilderCustomizer 来进行全局配置。
@RestController
@RequestMapping("/demo")
public class DemoTestController {
@PostMapping("/testThree")
public DemoTest testThree(@RequestBody DemoTest demoTest){
return demoTest;
}
}
@Data
public class DemoTest {
@DateTimeFormat(pattern = "yyyy-MM-dd HH:mm:ss")
private Date nowTime;
}
@Configuration
public class CustomsDateConvert implements Jackson2ObjectMapperBuilderCustomizer {
@Override
public void customize(Jackson2ObjectMapperBuilder jacksonObjectMapperBuilder) {
String dateFormat = "yyyy-MM-dd HH";
// 针对于Date类型，文本格式化
jacksonObjectMapperBuilder.simpleDateFormat(dateFormat);
// 针对于JDK新时间类。序列化时带有T的问题，自定义格式化字符串
JavaTimeModule javaTimeModule = new JavaTimeModule();
javaTimeModule.addSerializer(LocalDateTime.class, new LocalDateTimeSerializer(DateTimeFormatter.ofPattern(dateFormat)));
javaTimeModule.addDeserializer(LocalDateTime.class, new LocalDateTimeDeserializer(DateTimeFormatter.ofPattern(dateFormat)));
jacksonObjectMapperBuilder.modules(javaTimeModule);
}
}
/**
* 解决Jackson2ObjectMapperBuilderCustomizer失效问题
*/
@Configuration
@ConditionalOnWebApplication(type = ConditionalOnWebApplication.Type.SERVLET)
public class ConvertConfiguration implements WebMvcConfigurer {
@Autowired(required = false)
private MappingJackson2HttpMessageConverter mappingJackson2HttpMessageConverter;
@Override
public void extendMessageConverters(List<HttpMessageConverter<?>> converters) {
converters.removeIf(converter -> converter instanceof MappingJackson2HttpMessageConverter);
if (Objects.isNull(mappingJackson2HttpMessageConverter)) {
converters.add(0, new MappingJackson2HttpMessageConverter());
} else {
converters.add(0, mappingJackson2HttpMessageConverter);
}
}
}请求示例结果：
- 请求：POST
- 数据格式：JSON
到此这篇关于Spring @DateTimeFormat日期格式化时注解场景分析的文章就介绍到这了,更多相关Spring @DateTimeFormat日期格式化内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！
相关文章
这篇文章主要给大家介绍了关于Java正则表达式的基本用法和实例的相关资料,大家在使用Java正则表达式的时候可查阅这篇文章,文中通过实例代码介绍的非常详细,需要的朋友可以参考下2022-03-03
SpringBoot使用ApplicationEvent&Listener完成业务解耦
这篇文章主要介绍了SpringBoot使用ApplicationEvent&Listener完成业务解耦示例详解，有需要的朋友可以借鉴参考下，希望能够有所帮助，祝大家多多进步，早日升职加薪2023-05-05
下面小编就为大家带来一篇dom4j创建和解析xml文档的实现方法。小编觉得挺不错的，现在就分享给大家，也给大家做个参考。一起跟随小编过来看看吧2017-06-06
这篇文章主要介绍了关于Spring Actuator的简单测试,Spring-Actuator 是spring下的程序监控系统,通过简单的配置就可以查看程序的相关信息,本文提供了相关配置,需要的朋友可以参考下2023-10-10
这篇文章主要介绍了Java数组(Array)最全汇总(中篇)，本文章内容详细，通过案例可以更好的理解数组的相关知识，本模块分为了三部分，本次为中篇，需要的朋友可以参考下2023-01-01
访问速率限制是一种API访问限制的策略,它限制客户端在一定时间内调用API的次数,本文就来介绍一下Spring Boot中使用Bucket4j实现限流,感兴趣的可以了解一下2025-08-08
Springboot 整合RabbitMq(用心看完这一篇就够了)
这篇文章主要介绍了Springboot 整合RabbitMq(用心看完这一篇就够了)，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧2020-12-12
final方法不能被子类的方法覆盖，但可以被继承。用static修饰的代码块表示静态代码块，当Java虚拟机（JVM）加载类时，就会执行该代码块，下面通过本文给大家分享Java关键字final、static使用总结，感兴趣的朋友一起看看吧2017-07-07
SpringBoot整合EasyExcel 3.x的完整示例
EasyExcel 是一个基于 Java 的、快速、简洁、解决大文件内存溢出的 Excel 处理工具，它能让你在不用考虑性能、内存的等因素的情况下，快速完成 Excel 的读、写等功能，这篇文章主要介绍了SpringBoot整合EasyExcel3.x的过程,需要的朋友可以参考下2023-07-07
这篇文章主要介绍了Spring Boot 配置MySQL数据库重连的操作方法,需要的朋友可以参考下2018-04-04
最新评论