概述
最近小胖哥搞了个小程序,有几个spring mvc 接口传递了时间,时间用java 8 time 相关的api 来直接接收:
当使用根据ISO 8601格式化的参数向任何这些方法发送POST请求时,报出了如下异常:
这是因为默认情况下Spring不能将String参数转换为任何日期或时间对象。下面小胖哥就来带大家来搞一搞如何在spring mvc中进行类型转换和格式化操作,webflux也是同样的机制。多多关注码农小胖哥,更多it知识分享。
在请求级别转换日期参数
其中的一个解决方案是使用@DateTimeFormat注释注释参数 并提供格式设置模式参数,我们将上面的方法改动一下:
这样,如果使用ISO 8601格式格式化字符串,则字符串将正确转换为日期对象。我们也可以使用自己的转换模式。我们可以在@DateTimeFormat中设置一个pattern参数 :
在应用程序全局转换日期参数
在Spring中处理日期和时间对象转换的另一种方法是提供全局配置。我们可以通过自动化配置类WebMvcAutoConfiguration中找到相关的处理机制:重点是该类的参数:
我们指定了格式就可以自动转换了。通过此约定配置我们可以指定一个统一的处理风格。从spring源码中我们得知在初始化FormattingConversionService类调用了addFormatters(FormatterRegistry registry),我们找到了该方法的具体实现:
我们发现Converter、GenericConverter、Formatter 三种类型的的Spring bean 都可以被自动注入到格式化注册机中去。当然必须注册为spring bean才能在应用中起作用。下面小胖哥就来介绍它们。
转换器
Converter<S,T>是一个函数接口。作用是将泛型S 转换为T,也就是类型转换器,可以实现String 到 Integer,String到LocalDate等不同类型之间的转换。特别指出的是,一定要确保S类型不能为null,而且保证该实现一定是线程安全的。如果你有集中转换的需要可以实现工厂转换器接口ConverterFactory。
GenericConverter是两种或更多种类型之间转换的通用转换器接口,最为灵活的转换接口,通过上面的片段可以知道,通过构建多个源数据到转换目标的唯一映射对ConvertiblePair可以实现一对多、多对多的转换关系 。
格式����,ϸ��化器
Formatter<T>接口用于实现字段格式化逻辑而且是强类型化的,该接口是组合接口。Printer<T>是将对象输出为展示时的字符串,而Parser<T> 则相反将字符串格式化为目标对象,甚至可以结合本地化。比如像上面将yyyy-MM-dd 的字符串格式化为 LocalDate。
总结
我们学习了如何接受Spring MVC请求中的日期参数。而且我们也介绍了如何在局部和全局使用它们,通过延伸探索,我们也知道了它们的一些运行机制,如何的转换类型以及格式化,而且通过实现转换器、格式化器接口 并注入spring bean 就可以工作。可以根据我的介绍实际演练一下。