Spring Boot - 配置排序依赖技巧

Spring Boot - 配置排序依赖技巧

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。