Spring自动装配 - 干饭角度学习

## 什么是Spring的自动装配

Spring框架的一个核心功能是IoC（控制反转），管理着应用程序中的对象及其依赖关系。在没反转前，我们写应用需要自己知道并初始化依赖实例，然后再使用依赖实例。反转后，应用只需要告诉spring需要什么依赖接口，spring自己会找注册了该接口的依赖实例提供给我们。控制权从使用方反转到了提供方。

从干饭角度理解：当我们需要一份筷子（依赖实例）干饭时，并不需要关心筷子是怎么生产出来的，而是去食堂（Spring）领一份就行。我们只需要告诉食堂，我需要是筷子而不是刀叉(声明依赖接口)，那么食堂就会帮我们准备好一份筷子。

Spring自动装配就是Spring自动识别和注入组件依赖关系的步骤。

干饭角度理解：食堂帮我从仓库识别筷子、找到一份筷子、提供筷子的一系列步骤。

这个场景在应用上非常常见： 引入spring-boot-starter-data-redis并配置链接信息后，我们直接就能在service中引入RedisTemplate 并使用。

## SpringBoot2.X 自动装配是如何完成的？

SpringBoot 2.X 的启动入口main函数，有个注解 @SpringBootApplication，它通过@EnableAutoConfiguration 的@Import，将AutoConfigurationImportSelector收集到的全类名注册成bean。

```java
@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Inherited
@AutoConfigurationPackage
// 关键在这个 @Import引入其他start里通过Configuration注册的Bean， 也就是先把筷子存入仓库
@Import(AutoConfigurationImportSelector.class)
public @interface EnableAutoConfiguration {
    // 可以配置修改是否自动装配，默认true
    String ENABLED_OVERRIDE_PROPERTY = "spring.boot.enableautoconfiguration";
    Class<?>[] exclude() default {};
    String[] excludeName() default {};
}
```
从import的处理见 ConfigurationClassParser::processImports。
我们重点关注AutoConfigurationImportSelector的收集过程。
```java
// 注意是延迟导入，所以用DeferredImportSelector懒加载
public class AutoConfigurationImportSelector implements DeferredImportSelector {
    
    protected AutoConfigurationEntry getAutoConfigurationEntry(AnnotationMetadata annotationMetadata) {
		if (!isEnabled(annotationMetadata)) {
			return EMPTY_ENTRY;
		}
		AnnotationAttributes attributes = getAttributes(annotationMetadata);
        // 加载到所有自动装配的全类名，收集的是所有 Spring Boot Starter下的 META-INF/spring.factories
		List<String> configurations = getCandidateConfigurations(annotationMetadata, attributes);
		configurations = removeDuplicates(configurations);
		Set<String> exclusions = getExclusions(annotationMetadata, attributes);
		checkExcludedClasses(configurations, exclusions);
		configurations.removeAll(exclusions);
        // 过滤不满足 @ConditionalOnXXX 条件的启动类。比如过年才给用红筷子，就能这么限制过滤。
		configurations = getConfigurationClassFilter().filter(configurations);
		fireAutoConfigurationImportEvents(configurations, exclusions);
		return new AutoConfigurationEntry(configurations, exclusions);
	}
}
```

从上面可以看到，SpringBoot 通过SPI的方式，约定了 Spring Boot Starter只要resource下有 META-INF/spring.factories 就能帮忙注册成Bean

一个简单的spring.factories如下

```yaml
# Initializers
org.springframework.context.ApplicationContextInitializer=\
org.springframework.boot.autoconfigure.SharedMetadataReaderFactoryContextInitializer,\
org.springframework.boot.autoconfigure.logging.ConditionEvaluationReportLoggingListener

# Application Listeners
org.springframework.context.ApplicationListener=\
org.springframework.boot.autoconfigure.BackgroundPreinitializer

# Environment Post Processors
org.springframework.boot.env.EnvironmentPostProcessor=\
org.springframework.boot.autoconfigure.integration.IntegrationPropertiesEnvironmentPostProcessor

# Auto Configuration Import Listeners
org.springframework.boot.autoconfigure.AutoConfigurationImportListener=\
org.springframework.boot.autoconfigure.condition.ConditionEvaluationReportAutoConfigurationImportListener

# Auto Configuration Import Filters
org.springframework.boot.autoconfigure.AutoConfigurationImportFilter=\
org.springframework.boot.autoconfigure.condition.OnBeanCondition,\
org.springframework.boot.autoconfigure.condition.OnClassCondition,\
org.springframework.boot.autoconfigure.condition.OnWebApplicationCondition

# 一般我们只需要这个，指向我们的@Configuration的类，这样就能正常使用里面注册的依赖实例了。
# 是的，厂商提供筷子也得通过标准的@Bean提供，这部分各依赖各自实现，需要的话啃他们源码吧，祝大家吃饱。
org.springframework.boot.autoconfigure.EnableAutoConfiguration=\
com.baomidou.mybatisplus.autoconfigure.MybatisPlusLanguageDriverAutoConfiguration,\
com.baomidou.mybatisplus.autoconfigure.MybatisPlusAutoConfiguration
```

## SpringBoot3.X 的自动装配？

很遗憾，我们的干饭之旅不是那么顺利，如果我们追求吃口热乎饭，就会发现 spring.factories功能在Spring Boot 2.7标识废弃，在Spring Boot 3.0彻底移除

升级方案是 文件从`META-INF/spring.factories` 换成 `META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports`

```ymal
# 拆分成单独文件，故不需要前面的 xxx.EnableAutoConfiguration=, 同时格式换成一个全类名一行，不再用逗号拼接
com.baomidou.dynamic.datasource.spring.boot.autoconfigure.DynamicDataSourceAutoConfiguration
com.baomidou.mybatisplus.autoconfigure.MybatisPlusLanguageDriverAutoConfiguration
com.baomidou.mybatisplus.autoconfigure.MybatisPlusAutoConfiguration
```

参考资料： 
https://www.cnblogs.com/throwable/p/16950353.html
https://javaguide.cn/system-design/framework/spring/spring-boot-auto-assembly-principles.html