您好,登录后才能下订单哦!
这篇文章主要介绍“如何理解Spring的Registrar倒排思想”,在日常操作中,相信很多人在如何理解Spring的Registrar倒排思想问题上存在疑惑,小编查阅了各式资料,整理出简单好用的操作方法,希望对大家解答”如何理解Spring的Registrar倒排思想”的疑惑有所帮助!接下来,请跟着小编一起来学习吧!
本文提纲
版本约定
Spring Framework:5.3.x
Spring Boot:2.4.x
正文
上文是通过手动调用API的方式实现元数据的解析从而达到数据格式化(转换)的目的,而在实际应用场景中,作为业务开发者是不可能去直接去操纵API的,毕竟说到底那对开发者太不友好,使用门槛过高。
因此,本文将介绍的是一种更为“高级”的使用方案,看看Spring是如何做到兼具高扩展性的整合,从而对开发者十分友好,相信这便也是Spring最有魅力的地方,一起来学习学习吧。
FormatterRegistry:注册中心
对于多组件的管理,注册中心是个很好的解决方案。
FormatterRegistry其实在:9. 细节见真章,Formatter注册中心的设计很讨巧 这篇文章已经有过很详细的分析,学到了它那非常巧妙的设计,这里也顺道推荐你花几分钟前往看看。在这篇文章的末尾,A哥故意留下了一个小尾巴没讲:注册中心对注解工厂AnnotationFormatterFactory的支持,也就是这个接口方法:
FormatterRegistry: void addFormatterForFieldAnnotation(AnnotationFormatterFactory<? extends Annotation> annotationFormatterFactory);
现在时机成熟,本文就来重点关照它。
该接口方法的唯一实现在FormattingConversionService里:
①:从AnnotationFormatterFactory的泛型类型中提取到注解类型。注意:若没有指定泛型(没有指定注解类型)就抛出异常②:该工厂类支持的类型们③:对于支持的每个类型,均注册一个Printer/Parser
重点在于步骤③,AnnotationPrinterConverter和AnnotationParserConverter均是一个ConditionalGenericConverter转换器,底层实现实际委托给AnnotationFormatterFactory去完成,所以说对AnnotationFormatterFactory的理解格外的重要,还好上篇文章对它已经做了详尽分析,点击这里电梯直达。
下面以AnnotationPrinterConverter为例观其源码:
①:该转换器只负责将fieldType类型转换为String类型②:只有fieldType上标注有指定的这个注解,此转换器才会生效③:转换逻辑。这种缓存式处理逻辑很是常见,其实最核心的代码往往只有一句,本处就是它:this.annotationFormatterFactory.getPrinter(...)。获取到合适的Printer,然后适配为PrinterConverter从而完成最终的convert转换动作
❝说明:PrinterConverter和ParserConverter在本系列前面文章已介绍,相关内容可出门左拐在本系列内很容易找到❞AnnotationParserConverter的实现逻辑如出一辙,这里就不再啰嗦了。
FormattingConversionService它实现了FormatterRegistry接口的所有接口方法,但是它并未提供一些默认行为。换句话讲:实现了所有的组件注册/管理的能力,但并没有“帮你”注册任何组件,所以还不具备能够直接提供服务的条件,若要使用还需“人工干预”放些组件进去才行。
一般来讲,对于这种情况一般在外部再包一层 DefaultXXX来提供默认服务是一种对开发者十分友好的解决方案,Spring也是这么干的,下面来看看DefaultFormattingConversionService为我们默认注册了哪些基础组件,提供了哪些能力呢。
DefaultFormattingConversionService
默认的格式化器转换服务,该默认行为适用于大多数应用程序对格式化器、转换器的需求。
继承自FormattingConversionService,这个默认行为是为该实例而设计的,但为了方便使用,它对外暴露了其static静态方法addDefaultFormatters(),这个设计方式同DefaultConversionService暴露了静态方法addDefaultConverters()如出一辙。
默认注册了哪些组件?
对于一个默认的Service服务,最关心的当属它提供了哪些能力。换句话讲:它默认帮我们注册了哪些组件呢?
要回答这个问题可不能靠“背答案”,方式方法其实非常的简单,爬进去它的源码处一看便知:
①:虽然说本类(其实是父类)实现了EmbeddedValueResolverAware接口,但构造时依旧可以指定占位符处理器StringValueResolver,当然一般情况下传入null即可②:调用DefaultConversionService的静态方法,把默认的转换器们都注册进来。那么,默认到底注册了哪些转换器呢?DefaultConversionService.addDefaultConverters(this)该静态方法其实是本系列前面文章所讲的内容,这里A哥顺道也贴在这吧:
③:若registerDefaultFormatters为true就添加默认的格式化器们,一般来讲,此值都为true。那么,默认到底注册了哪些格式化器呢?
①:对@NumberFormat注解提供支持,格式化数字(Currency、数字、百分数等)
②:对JSR 354钱币类型javax.money.CurrencyUnit、Monetary等类型提供支持。一般情况下,用不着,所以此part不会被真的注册
③:对JSR-310日期时间的格式化提供支持。这里使用到了其专用的注册器DateTimeFormatterRegistrar统一操作
④、⑤:第4、5步是互斥操作,若有Jota-Time就提供对它的支持而不触发java.util.Date的注册器,否则使用后者注册器。
注意:你以为④、⑤是真的互斥吗?难道导入了joda-time的包后java.util.Date相关模块就失效了?很明显不是这样的,让你“放心”的地方在于JodaTimeFormatterRegistrar注册器内部包含了java.util.Date格式化器的注册关系,因此一切都还得到xxxRegistrar里去看才能揭晓。
总之,DefaultFormattingConversionService作为默认的格式化转换服务,它是DefaultConversionService的超集,在其基础上扩展了格式化器,格式化注解支持等相关能力。在Spring环境下,大多数情况使用都是它而非DefaultConversionService。
现在,对FormatterRegistry类一个笼统的认识,知道它默认给注册了哪些组件,支持哪些功能,但是细节部分还不清晰。比如说:支持哪些数据类型?支持哪些格式?这些都藏在相应的xxxRegistrar里~
FormatterRegistrar:注册员
registrar:登记员;注册主任。
xxxRegistrar它是一种“倒排”思想的设计体现,能达到高内聚的效果。Spring、Spring Boot惯用的“伎俩”,譬如你随便一搜就能看能看到很多很多:
FormatterRegistrar代表的是格式化器注册员接口,接口定义:
public interface FormatterRegistrar { void registerFormatters(FormatterRegistry registry); }
接口方法含义:将Converter和Formatter注册进FormatterRegistry注册中心里,至于注册哪些组件由各子类自行管理和负责,而非Registry注册中心主动去编排。这是一种倒排设计思想,能够很好的达到高内聚的目的。
❝注意:虽然存在ConverterRegistry和FormatterRegistry两个接口,但只有FormatterRegistrar而 没有 ConverterRegistrar哦❞该接口有三个实现类:
见名之意,每个实现子类都维护着自己分内之事,边界十分清晰。
DateFormatterRegistrar:Date注册员
提供对java.util.Date、java.util.Calendar、long类型的日期时间的注册支持。
接口方法实现如下:
①:添加常规转换器,支持DateToLong、DateToCalendar、LongToCalendar等基础转换能力②:若有个性化指定格式化器,那就给Calendar专门使用。当然,大多数情况下并不会这么做,这步逻辑是为了向后兼容性而考虑而已,一般可忽略③:添加@DateTimeFormat注解的解析支持
代码示例
下面介绍DateFormatterRegistrar注册员的使用示例。
普通使用方式
最常规的转换,Date、Long、Calendar等日期时间类型似乎是可以互转的。
@Test public void test1() { FormattingConversionService conversionService = new FormattingConversionService(); // 注册员负责添加格式化器以支持Date系列的转换 new DateFormatterRegistrar().registerFormatters((FormatterRegistry) conversionService); // 1、普通使用 long currMills = System.currentTimeMillis(); System.out.println("当前时间戳:" + currMills); // Date -> Calendar System.out.println(conversionService.convert(new Date(currMills), Calendar.class)); // Long -> Date System.out.println(conversionService.convert(currMills, Date.class)); // Calendar -> Long Calendar calendar = Calendar.getInstance(TimeZone.getDefault()); calendar.setTimeInMillis(currMills); System.out.println(conversionService.convert(calendar, Long.class)); }
运行程序,输出:
当前时间戳:1612741385457 java.util.GregorianCalendar[time=1612741385457 ... Mon Feb 08 07:43:05 CST 2021 1612741385457
完美。
注解使用方式
使用更高级的注解方式,如@DateTimeFormat
// 准备一个Java Bean: @Data @AllArgsConstructor class Son { @DateTimeFormat(iso = DateTimeFormat.ISO.DATE) private Date birthday; }
测试代码:
@Test public void test1() { FormattingConversionService conversionService = new FormattingConversionService(); // 重要:重要:重要:注册基础的转换能力 DefaultConversionService.addDefaultConverters((ConverterRegistry) conversionService); // 注册员负责添加格式化器以支持Date系列的转换 new DateFormatterRegistrar().registerFormatters((FormatterRegistry) conversionService); // 1、注解使用 Son son = new Son(new Date()); // 输出:将Date类型输出为Long类型 System.out.println(conversionService.convert(son.getBirthday(), Long.class)); // 输出:将String烈性输入为Date类型 // System.out.println(conversionService.convert("2021-02-12", Date.class)); // 报错 System.out.println(conversionService.convert(1613034123709L, Date.class)); }
运行程序,输出:
1613034230018 Thu Feb 11 17:02:03 CST 2021
完美。实现了Long类型 <-> Date类型的互转。
到此,关于“如何理解Spring的Registrar倒排思想”的学习就结束了,希望能够解决大家的疑惑。理论与实践的搭配能更好的帮助大家学习,快去试试吧!若想继续学习更多相关知识,请继续关注亿速云网站,小编会继续努力为大家带来更多实用的文章!
免责声明:本站发布的内容(图片、视频和文字)以原创、转载和分享为主,文章观点不代表本网站立场,如果涉及侵权请联系站长邮箱:is@yisu.com进行举报,并提供相关证据,一经查实,将立刻删除涉嫌侵权内容。