Spring Boot 自动配置注解源码解析

前言

为什么Spring Boot这么火？因为便捷，开箱即用，但是你思考过为什么会这么便捷吗？传统的SSM架构配置文件至少要写半天，而使用Spring Boot之后只需要引入一个starter之后就能直接使用，why？？？

原因很简单，每个starter内部做了工作，比如Mybatis的启动器默认内置了可用的SqlSessionFactory。

至于如何内置的？Spring Boot 又是如何使其生效的？这篇文章就从源码角度介绍一下Spring Boot的自动配置原理。

源码版本

作者Spring Boot是基于2.4.0。每个版本有些变化，读者尽量和我保持一致，以防源码有些出入。

@SpringBootApplication干了什么？

这么说吧，这个注解什么也没做，废物，活都交给属下做了，源码如下：



上方标注了三个重要的注解，如下：

@SpringBootConfiguration：其实就是@Configuration，因此主启动类可以当做配置类使用，比如注入Bean等。
@EnableAutoConfiguration：这个注解牛批了，名字就不一样，开启自动配置，哦，关键都在这了.....
@ComponentScan：包扫描注解。

经过以上的分析，最终定位了一个注解@EnableAutoConfiguration，顾名思义，肯定和自动配置有关，要重点分析下。

@EnableAutoConfiguration干了什么？

想要知道做了什么肯定需要看源码，如下：

上方标注了两个重要的注解，如下：

@AutoConfigurationPackage：自动配置包注解，默认将主配置类(@SpringBootApplication)所在的包及其子包里面的所有组件扫描到IOC容器中。
@Import：该注解不必多说了，前面文章说过很多次了，这里是导入了AutoConfigurationImportSelector，用来注入自动配置类。

以上只是简单的分析了两个注解，下面将会从源码详细的介绍一下。

@AutoConfigurationPackage

这个注解干了什么？这个需要看下源码，如下；

@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Inherited
@Import(AutoConfigurationPackages.Registrar.class)
public @interface AutoConfigurationPackage {}

重要的还是@Import注解，导入了AutoConfigurationPackages.Registrar，这个类是干什么的？源码如下图：

其实就两个方法，但是的最重要的就是registerBeanDefinitions方法，但是这个方法不用看，肯定是注入Bean，这里的重点是注入哪些Bean，重点源码如下：

//获取扫描的包
new PackageImports(metadata).getPackageNames().toArray(new String[0])

跟进代码，主要逻辑都在#PackageImports.PackageImports()这个构造方法中，源码解析如下图：

从上面源码分析可以知道，这里扫描的包名是由两部分组成，分别如下：

从@AutoConfigurationPackage注解中的两个属性解析得来的包名。
注解AutoConfigurationPackage所在的包名，即是@SpringBootApplication所在的包名。

@AutoConfigurationPackage默认将主配置类(@SpringBootApplication)所在的包及其子包里面的所有组件扫描到IOC容器中。

@Import(AutoConfigurationImportSelector.class)

这个注解不用多说了，最重要的就是AutoConfigurationImportSelector，我们来看看它的继承关系，如下图：

这个类的继承关系还是挺简单的，实现了Spring中的xxAware注入一些必要的组件，但是最值得关心的是实现了一个DeferredImportSelector这个接口，这个接口扩展了ImportSelector，也改变了其运行的方式，这个在后面章节会介绍。

「注意」：这个类会导致一个误区，平时看到xxxSelector已经有了反射弧了，肯定会在selectImports()方法上DEBUG，但是这个类压根就没执行该方法，我第一次看也有点怀疑人生了，原来它走的是DeferredImportSelector的接口方法。

其实该类真正实现逻辑的方法是process()方法，但是主要加载自动配置类的任务交给了getAutoConfigurationEntry()方法，具体的逻辑如下图：

上图的逻辑很简单，先从spring.factories文件中获取自动配置类，在去掉@SpringBootApplication中定义排除的自动配置类。

上图中的第④步就是从META-INF/spring.factories中加载自动配置类，代码很简单，在上一篇分析启动流程的时候也有很多组件是从spring.facotries文件中加载的，代码都类似。

在springboot-autoconfigure中的spring.facotries文件内置了很多自动配置类，如下：

# Auto Configure
org.springframework.boot.autoconfigure.EnableAutoConfiguration=\
org.springframework.boot.autoconfigure.admin.SpringApplicationAdminJmxAutoConfiguration,\
org.springframework.boot.autoconfigure.aop.AopAutoConfiguration,\
org.springframework.boot.autoconfigure.amqp.RabbitAutoConfiguration,\
org.springframework.boot.autoconfigure.batch.BatchAutoConfiguration,\
org.springframework.boot.autoconfigure.cache.CacheAutoConfiguration,\
org.springframework.boot.autoconfigure.cassandra.CassandraAutoConfiguration,\
org.springframework.boot.autoconfigure.context.ConfigurationPropertiesAutoConfiguration,\
org.springframework.boot.autoconfigure.context.LifecycleAutoConfiguration,\
org.springframework.boot.autoconfigure.context.MessageSourceAutoConfiguration,\
org.springframework.boot.autoconfigure.context.PropertyPlaceholderAutoConfiguration,\
................

了解了Spring Boot 如何加载自动配置类，那么自定义一个自动配置类也是很简单了，后续章节教你如何定制自己的自动配置类，里面还是有很多门道的.....