Spring中@order注解用法实战教程
作者:怪 咖@
前言
@order
注解是spring-core
包下的一个注解,@Order
的作用是定义Spring IOC容器中Bean的执行顺序的优先级(这里的顺序也可以理解为存放到容器中的先后顺序)。开发过程当中有时候经常会出现配置依赖关系,例如注入A对象使用了
@ConditionalOnBean(B.class)
,意思是要求容器当中必须存在B.class
的实例的时候,才会进行注入A
。这时候我们就必须保证B对象在注入A
对象前进行注入。
一、观察@order源码
(1)源码当中有三个元注解:
- @Target({ElementType.TYPE, ElementType.METHOD, ElementType.FIELD}): 使用范围接口、类、枚举、注解、方法、字段
- @Retention(RetentionPolicy.RUNTIME): @Retention是用来修饰注解的生命周期的,RetentionPolicy.RUNTIME代表的是不仅被保存到class文件中,jvm加载class文件之后,仍然存在;一直有效!
- @Documented: @Documented和@Deprecated注解长得有点像,@Deprecated是用来标注某个类或者方法不建议再继续使用,@Documented只能用在注解上,如果一个注解@B,被@Documented标注,那么被@B修饰的类,生成Javadoc文档时,会显示@B。
(2)属性:
@order当中只要一个value属性,而且还是int类型,值越低优先级越高,默认值是Ordered.LOWEST_PRECEDENCE
,表示最低优先级(输给任何其他指定的顺序值)。
@Retention(RetentionPolicy.RUNTIME) @Target({ElementType.TYPE, ElementType.METHOD, ElementType.FIELD}) @Documented public @interface Order { int value() default 2147483647; }
官网注释:https://github.com/spring-projects/spring-framework/blob/main/spring-core/src/main/java/org/springframework/core/annotation/Order.java
二、@order实战
(1)自定义两个配置类
我们要求Config2先进行加载,然后通过@order来排序测试一下
@Configuration public class Config1 { public Config1() { System.out.println("Config1构建了"); } } @Configuration public class Config2 { public Config2() { System.out.println("Config2构建了"); } }
(2)启动项目测试:默认是先创建的Config1后创建的Config2
(3)既然order可以控制加载顺序,那我们来试验一下,然后让Config2 先加载
@Configuration @Order(2) public class Config1 { public Config1() { System.out.println("Config1构建了"); } } @Configuration @Order(1) public class Config2 { public Config2() { System.out.println("Config2构建了"); } }
但是好像没什么卵用
(4)分析原因
目前这两个是在同包情况下不起作用。
于是进行分开了
分开之后竟然生效了
(5)但是分开也是将Config2放到了上面的包当中,于是我又改成了Config1放到最上面,这样进行测试,结果又失效了
(6)于是我又放在了同包下,将Config2命名为A开头的,这样他就放到了最上面,于是这样同样也生效了。
期间我还尝试着将@Configuration都改为使用@Component,结果仍然不变。
得出结论:
@order
指定加载顺序还跟类的命名和存放位置有关!假如有Config1
和Config2
两个类在一个包下,要求是Config2
先加载:
- 这时候设置
Config2
的@order值
就算是小于Config1
的@order值
同样也是Config1
先加载。 - 如果同包情况下可以重新命名Config2,只要在Config1上面就行。
- 或者拆开不同包也可以,但是Config2所在的包也必须比Config1所呆的包上面。
这样才能保证@Order生效!
三、@order失效原因
https://docs.spring.io/spring-framework/docs/current/reference/html/core.html#beans-constructor-injection
最关键的一句话:您可以在目标类级别和@Bean方法上声明@Order注释,可能针对的是单个bean定义(如果多个定义使用同一个bean类)。@Order值可能会影响注入点的优先级,但请注意,它们不会影响单例启动顺序,这是由依赖关系和@DependsOn声明确定的正交关注。
我理解的注入点的优先级应该是指的存放容器的先后顺序,也就是他并不会影响启动顺序。
四、解决排序问题
我们不可能每次遇到这种问题又是改名又是换包的,所以,springboot提供了如下三个注解可以控制顺序:
- @AutoConfigureAfter:当前配置类在指定配置类之后执行
- @AutoConfigureBefore:当前配置类在指定配置类之前执行
- @AutoConfigureOrder:指定优先级,数值越小,优先级越高。
(1)首先将代码改回原来的样子
(2)在Config2使用@AutoConfigureBefore(Config1.class),代表的是在config1加载前进行加载
@Configuration public class Config1 { public Config1() { System.out.println("Config1构建了"); } } @Configuration @AutoConfigureBefore(Config1.class) public class Config2 { public Config2() { System.out.println("Config2构建了"); } }
(3)输出结果,显然还是没生效
可能有时候走了运给你一种错觉还真的配置成功了。实际上这种方式是不可行的,以上三个注解只有针对自动配置类才会生效。
在autoconfigure包下就有spring.factories,这个文件配置了自动配置类,springboot会读取这个文件的,我们也可以在自己项目上定义spring.factories,这样我们的配置类对于@AutoConfigureAfter注解就可以生效了。
(4)自定义spring.factories
第一行是固定的,后面的就是全类名,虽然只有Config2使用了注解,但是需求是和Config1进行排序,所以这两个都得加。
org.springframework.boot.autoconfigure.EnableAutoConfiguration=\ com.gzl.cn.springbootcache.config.Config2,\ com.gzl.cn.springbootcache.config.Config1
(5)测试,成功解决
五、排序源码分析
针对于@AutoConfigure那三个注解原理:其实关键的代码还是在AutoConfigurationImportSelector中,将自动配置类从spring.factories加载出来之后会根据条件排序(只有自动配置类!),在selectImports()方法中最后一行代码如下:
紧接着会走到这个地方,实际上是分了三步排序:
- 先按照文件名字母排序
- 按照@AutoConfigureOrder进行排序
- 按照 @AutoConfigureBefore和@AutoConfigureAfter排序
从上面配置的顺序可以知道,最终决定权还是在@AutoConfigureAfter、@AutoConfigureBefore这两个注解。
当我们不设置spring.factories的时候,这里面压根都没有这两个类!
六、@AutoConfigureOrder
这种也是可以的!当然前提也是需要配置spring.factories
@Configuration @AutoConfigureOrder(2) public class Config1 { public Config1() { System.out.println("Config1构建了"); } } @Configuration @AutoConfigureOrder(1) public class Config2 { public Config2() { System.out.println("Config2构建了"); } }
总结
到此这篇关于Spring中@order注解用法的文章就介绍到这了,更多相关Spring @order注解用法内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!