Spring Boot - 配置排序依赖技巧
Spring Boot 系列
- Spring Boot 入门
- Spring Boot 属性配置和使用
- Spring Boot 集成MyBatis
- Spring Boot 静态资源处理
- Spring Boot - 配置排序依赖技巧
- Spring Boot - DevTools 介绍
Spring Boot - 被错误使用的注解
我自己曾经在 Spring Boot 中集成通用 Mapper 时,写过下面的代码:
@Configuration
@AutoConfigureAfter(MyBatisConfig.class)
public class MyBatisMapperScannerConfig
//其他
这种用法我参考的 mybatis-spring-boot-starter
。
由于在我自己这个例子中可以良好的运行,因此我以为 @AutoConfigureAfter
真正起作用了,否则怎么不报错呢。但是在很长一段时间内,好多人参考这种用法时经常报错,这个配置没有起到应有的作用。我还一直以为他们用的不对。
直到昨天我开始写自己的 pagehelper-spring-boot-starter
时,我才发现,我自己一直以来都用错了。在我自己例子中,之所以能行,完全是靠运气。
Spring Boot 提供了很多新的注解,但是要注意这个包下面的所有注解:
org.springframework.boot.autoconfigure
这个包下面常见的注解有:
- @AutoConfigureAfter
- @AutoConfigureBefore
- @AutoConfigureOrder
- @AutoConfigurationPackage
- @EnableAutoConfiguration
- @SpringBootApplication
前 3 个是不能在普通项目中使用的,这 3 个注解是特地用于 autoconfigure 类的项目,后面 3 个注解是可以用于我们自己项目中的。
autoconfigure 类项目
Spring Boot Starter 提供了规范可以让开发者提供自己的 starter,例如 Spring 官方提供的:
- spring-boot-starter
- spring-boot-starter-activemq
- spring-boot-starter-cache
- 等等…
还有很多开源项目或公司提供的:
- modelmapper-spring-boot-starter
- hajdbc-spring-boot-starter
- camel-spring-boot-starter
- mybatis-spring-boot-starter
- 等等…
在 Spring Boot starter 开发规范中,项目中会有一个空的名为 xxx-spring-boot-starter 的项目,这个项目主要靠 pom.xml 将所有需要的依赖引入进来。同时项目还会有一个 xxx-spring-boot-autoconfigure 项目,这个项目主要写带 @Configuration
注解的配置类,在这个类或者类中带 @Bean
的方法上,可以使用和顺序有关的注解,也就是前面提到的自己不能使用的这部分注解。xxx-spring-boot-autoconfigure 就是这里提到的 autoconfigure 类项目。
上面的注解只在 AutoConfigurationSorter
类中排序时用到了。被排序的这些类,都是通过 xxx-spring-boot-autoconfigure
项目中的 src/resources/META-INF/spring.factories 配置文件获取的,这个文件中的配置内容一般为:
# Auto Configure
org.springframework.boot.autoconfigure.EnableAutoConfiguration=\
com.github.pagehelper.autoconfigure.PageHelperAutoConfiguration
Spring Boot 只会对从这个文件读取的配置类进行排序。
但是你不要以为将自己的配置类也配置在 spring.factories
中就能实现排序,如果你的类被自己 Spring Boot 启动类扫描到了,这个类的顺序会优先于所有通过 spring.factories
读取的配置类。所以当你的配置类对顺序有要求时就会出错。
通过 spring.factories
巧妙使用排序
如果你将自己的配置类放到特别的包下,不使用 Spring Boot 启动类扫描。完全通过 spring.factories
读取配置就可以实现这个目的。例如下图的用法:
当使用上图方式进行配置时,就可以完美的使用第一节中不可使用的注解,如果你想让这个配置应用到更多的项目中,建议按照 spring-boot-starter 规范开发自己的 starter。