SpringBoot 自动配置@EnableAutoConfiguration

自动配置vs自动装配

Spring有两个名字听起来相似的概念:一个是自动装配,一个是自动配置。他们两个只是听起来相似,实际根本不同。自动装配是autowire,自动配置是autoconfiguration,他们之间没有任何关系,概念也相差甚远。

Springboot的自动配置通过@EnableAutoConfiguration注解实现,@EnableAutoConfiguration是Springboot的注解,通过@EnableAutoConfiguration注解,Springboot实现了“约定大于配置”:系统猜测你需要哪些配置,从而帮助你自动实现了这些配置,所以程序员就不需要手动再进行配置了。

这个说起来非常简单的约定,实际上却大大简化了程序员的日常工作,让Spring项目变的非常简单。

@SpringBootApplication

学习SpringBoot,还是要从SpringBoot的入门注解@SpringBootApplication开始:

@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Inherited
@SpringBootConfiguration
@EnableAutoConfiguration
@ComponentScan(excludeFilters = { @Filter(type = FilterType.CUSTOM, classes = TypeExcludeFilter.class),
		@Filter(type = FilterType.CUSTOM, classes = AutoConfigurationExcludeFilter.class) })
public @interface SpringBootApplication {

可以看到@SpringBootApplication是一个组合注解,由@SpringBootConfiguration+@EnableAutoConfiguration+@ComponentScan组成。

@SpringBootConfiguration的主要作用其实就是实现@Configuration注解的功能,告诉Spring当前类是一个配置类。

然后再加上@ComponentScan注解,告诉Spring容器包扫描路径,由于我们在@SpringBootApplication注解上其实并没有指定包扫描路径,所以,Spring容器会采用默认的包扫描路径:当前配置类所在的路径。因此才有了一个约定:SpringBoot的启动类(其实准确的叫法应该是配置类,配置类不一定必须是启动类,编写一个其他的配置类送给SpringApplication的run方法也是一样可以启动SpringBoot的)要放在项目的主路径下,因为不放在主路径下、而是放在特定包下的话,就可能会导致除这个特定包之外的其他包下的类不能被Spring容器扫描到。

然后最重要的是这个@EnableAutoConfiguration注解,@EnableAutoConfiguration也是一个组合注解:

@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Inherited
@AutoConfigurationPackage
@Import(AutoConfigurationImportSelector.class)
public @interface EnableAutoConfiguration {

主要包含两个注解:@AutoConfigurationPackage和@Import,比较重要的是这个@Import注解。

其实我们可以看到,SpringBoot项目启动时的几个注解实际上都是由Spring注解组合生成的,所以说SpringBoot其实不算是什么新技术,只不过是Spring框架的一个应用,而已。

@EnableAutoConfiguration

接下来我们要重点分析一下@EnableAutoConfiguration注解,因为他是实现“约定大于配置”思想的关键。

前面已经看到了,@EnableAutoConfiguration注解中最重要的其实是@Import注解,所以我们先对@Import注解做一个简单的了解,之后再回来深入学习@EnableAutoConfiguration注解。

@Import注解

@Import注解和@Configuration注解一起作用,放在@Configuration配置类中,作用是通过该配置类引入Bean到Spring IoC容器中。

比如:

@Configuration
@Import(Person.class)
public class MyConfiguration(){
}

public class Person(){
   @Bean
   public Person createPerson(){
      return new Person();
   }
}

以上配置类通过@Import注解将Person对象注入到SpringIoC容器中。

@Import需要通过参数value指定引入类。

@Import是在Spring Ioc容器刷新的时候、通过BeanFactoryPostProcessors生效的。具体的调用路径:

Spring容器refresh方法 -> AbstractApplicationContext.refresh()->
invokeBeanFactoryPostProcessors()->
PostProcessorRegistrationDelegate.invokeBeanFactoryPostProcessors->
ConfigurationClassPostProcessor.processConfigBeanDefinitions ->
ConfigurationClassParser.parse()->
processConfigurationClass()->
doProcessConfigurationClass()

调用链路特别长,代码也特别多,所以我们今天也就没有办法分析全部代码。但是看到这个doProcessConfigurationClass就感觉快要找到核心代码了,因为Spring源码的特点,doxxxx方法是干实事的。

确实,这个ConfigurationClassParser类是专门用来处理配置类的,也就是加了@Configuration注解的类,@Import注解也是这个类负责解析,这也是@Import注解必须和@Configuration注解绑定才能生效的原因。

doProcessConfigurationClass方法源码也特别长,首先处理@Component、@PropertySource、@ComponentScan注解,之后调用processImports方法处理@Import注解。

processImports方法是正儿八经处理@Import注解的地方。

代码也比较长,我们还是简单一点,只关心比较重要的部分:

for (SourceClass candidate : importCandidates) {
                    //1.如果@Import的类实现了ImportSelector接口
					if (candidate.isAssignable(ImportSelector.class)) {
						// Candidate class is an ImportSelector -> delegate to it to determine imports
						Class candidateClass = candidate.loadClass();
						ImportSelector selector = ParserStrategyUtils.instantiateClass(candidateClass, ImportSelector.class,
								this.environment, this.resourceLoader, this.registry);
						Predicate selectorFilter = selector.getExclusionFilter();
						if (selectorFilter != null) {
							exclusionFilter = exclusionFilter.or(selectorFilter);
						}
						if (selector instanceof DeferredImportSelector deferredImportSelector) {
							this.deferredImportSelectorHandler.handle(configClass, deferredImportSelector);
						}
						else {
							String[] importClassNames = selector.selectImports(currentSourceClass.getMetadata());
							Collection importSourceClasses = asSourceClasses(importClassNames, exclusionFilter);
							processImports(configClass, currentSourceClass, importSourceClasses, exclusionFilter, false);
						}
					}
                    //2.如果@Import的类实现了ImportBeanDefinitionRegistrar接口
					else if (candidate.isAssignable(ImportBeanDefinitionRegistrar.class)) {
						// Candidate class is an ImportBeanDefinitionRegistrar ->
						// delegate to it to register additional bean definitions
						Class candidateClass = candidate.loadClass();
						ImportBeanDefinitionRegistrar registrar =
								ParserStrategyUtils.instantiateClass(candidateClass, ImportBeanDefinitionRegistrar.class,
										this.environment, this.resourceLoader, this.registry);
						configClass.addImportBeanDefinitionRegistrar(registrar, currentSourceClass.getMetadata());
					}
                    //3.@Import引入的是普通类
					else {
						// Candidate class not an ImportSelector or ImportBeanDefinitionRegistrar ->
						// process it as an @Configuration class
						this.importStack.registerImport(
								currentSourceClass.getMetadata(), candidate.getMetadata().getClassName());
						processConfigurationClass(candidate.asConfigClass(configClass), exclusionFilter);
					}
				}

代码中加了注释,其实主要关注的是@Import注解支持引入三种类型的类:

  1. 第一种是实现了ImportSelector接口的类,这种情况下又判断是否实现了DeferredImportSelector接口,会有不同的处理逻辑,实现了DeferredImportSelector接口的类,最终会调用到其内部接口DeferredImportSelector.Group的process方法,否则,如果没有实现DeferredImportSelector接口,则会调用到ImportSelector的getImports方法。
  2. 第二种是实现了ImportBeanDefinitionRegistrar接口的类,通过将BeanDefinition注册到Spring容器中从而实现bean加载。
  3. 第三种是普通类,可以直接加载到SpringIoC容器中。

需要注意的是第一种情况中的DeferredImportSelector接口:

A variation of ImportSelector that runs after all @Configuration beans have been processed. This type of selector can be particularly useful when the selected imports are @Conditional.
Implementations can also extend the org.springframework.core.Ordered interface or use the org.springframework.core.annotation.Order annotation to indicate a precedence against other DeferredImportSelectors.
Implementations may also provide an import group which can provide additional sorting and filtering logic across different selectors.
Since:
4.0
Author:
Phillip Webb, Stephane Nicoll

DeferredImportSelector接口实现类的延迟导入,在所有的@Configuration配置类全部处理之后再运行。这个特性对于@Conditional注解下的条件配置很有用。

实现类也可以扩展Order接口实现对延迟导入配置类的排序,也可以提供一个导入的group实现排序(Group是DeferredImportSelector的子接口)。

以上是DeferredImportSelector类的javaDoc的解释,基本上说清楚了DeferredImportSelector接口的作用,我们今天理解到这个程度就OK了,不影响我们对SpringBoot自动配置原理的理解了。

好了,对于@Import注解的学习就到这里了,有了对@Import注解的基本认识,我们就可以继续深入分析@EnableAutoConfiguration注解了。

@EnableAutoConfiguration

继续研究@EnableAutoConfiguration注解:

@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Inherited
@AutoConfigurationPackage
@Import(AutoConfigurationImportSelector.class)
public @interface EnableAutoConfiguration {

@Import注解引入了AutoConfigurationImportSelector类,这个类是SpringBoot自动配置的关键实现类:

public class AutoConfigurationImportSelector implements DeferredImportSelector, BeanClassLoaderAware,
		ResourceLoaderAware, BeanFactoryAware, EnvironmentAware, Ordered {

发现AutoConfigurationImportSelector类实现了DeferredImportSelector接口,根据上面我们对@Import注解的分析,Spring容器的refresh方法最终会调用到DeferredImportSelector.Group的process方法,我们需要从AutoConfigurationImportSelector源码中找一下process方法的实现。

发现AutoConfigurationImportSelector类实现了一个AutoConfigurationGroup类,该类实现了eferredImportSelector.Group接口,我们找到它的process方法:

		@Override
		public void process(AnnotationMetadata annotationMetadata, DeferredImportSelector deferredImportSelector) {
			Assert.state(deferredImportSelector instanceof AutoConfigurationImportSelector,
					() -> String.format("Only %s implementations are supported, got %s",
							AutoConfigurationImportSelector.class.getSimpleName(),
							deferredImportSelector.getClass().getName()));
			AutoConfigurationEntry autoConfigurationEntry = ((AutoConfigurationImportSelector) deferredImportSelector)
				.getAutoConfigurationEntry(annotationMetadata);
			this.autoConfigurationEntries.add(autoConfigurationEntry);
			for (String importClassName : autoConfigurationEntry.getConfigurations()) {
				this.entries.putIfAbsent(importClassName, annotationMetadata);
			}
		}

process方法强转参数deferredImportSelector为AutoConfigurationImportSelector后,调用getAutoConfigurationEntry方法,拿到需要实例化并放入SpringIoC容器中的类的全限定名之后,返回给Spring容器(我们肯定知道Bean的实例化不会在当前阶段完成、一定是Spring IoC容器统一完成的(还记得吗,入口方法是getBean))。

getAutoConfigurationEntry方法源码会揭露SpringBoot自动装配实现机制的真相:

	protected AutoConfigurationEntry getAutoConfigurationEntry(AnnotationMetadata annotationMetadata) {
		if (!isEnabled(annotationMetadata)) {
			return EMPTY_ENTRY;
		}
		AnnotationAttributes attributes = getAttributes(annotationMetadata);
        //找到自动配置,获取需要自动配置的类
		List configurations = getCandidateConfigurations(annotationMetadata, attributes);
        //去重
		configurations = removeDuplicates(configurations);
        //根据排除配置,进行排除
		Set exclusions = getExclusions(annotationMetadata, attributes);
		checkExcludedClasses(configurations, exclusions);
		configurations.removeAll(exclusions);
        //filter方法,实现条件配置,根据条件排除掉不必要的配置
		configurations = getConfigurationClassFilter().filter(configurations);
		fireAutoConfigurationImportEvents(configurations, exclusions);
		return new AutoConfigurationEntry(configurations, exclusions);
	}

上面加了备注的方法是关键方法,我们一个个看一下。

getCandidateConfigurations

从方法名上可以看出,是要获取到备选的配置项。

代码非常简单:

	protected List getCandidateConfigurations(AnnotationMetadata metadata, AnnotationAttributes attributes) {
		List configurations = SpringFactoriesLoader.loadFactoryNames(getSpringFactoriesLoaderFactoryClass(),
				getBeanClassLoader());
		Assert.notEmpty(configurations, "No auto configuration classes found in META-INF/spring.factories. If you "
				+ "are using a custom packaging, make sure that file is correct.");
		return configurations;
	}

关键方法loadFactoryNames:

  public static List loadFactoryNames(Class factoryType, @Nullable ClassLoader classLoader) {
        ClassLoader classLoaderToUse = classLoader;
        if (classLoader == null) {
            classLoaderToUse = SpringFactoriesLoader.class.getClassLoader();
        }

        String factoryTypeName = factoryType.getName();
        return (List)loadSpringFactories(classLoaderToUse).getOrDefault(factoryTypeName, Collections.emptyList());
    }

又调用了方法loadSpringFactories:

private static Map> loadSpringFactories(ClassLoader classLoader) {
        Map> result = (Map)cache.get(classLoader);
        if (result != null) {
            return result;
        } else {
            HashMap result = new HashMap();

            try {
                //读取配置文件META-INF/spring.factories
                Enumeration urls = classLoader.getResources("META-INF/spring.factories");

                while(urls.hasMoreElements()) {
                    URL url = (URL)urls.nextElement();
                    UrlResource resource = new UrlResource(url);
                    Properties properties = PropertiesLoaderUtils.loadProperties(resource);
                    Iterator var6 = properties.entrySet().iterator();

                    while(var6.hasNext()) {
                        Entry entry = (Entry)var6.next();
                        String factoryTypeName = ((String)entry.getKey()).trim();
                        String[] factoryImplementationNames = StringUtils.commaDelimitedListToStringArray((String)entry.getValue());
                        String[] var10 = factoryImplementationNames;
                        int var11 = factoryImplementationNames.length;

                        for(int var12 = 0; var12 < var11; ++var12) {
                            String factoryImplementationName = var10[var12];
                            ((List)result.computeIfAbsent(factoryTypeName, (key) -> {
                                return new ArrayList();
                            })).add(factoryImplementationName.trim());
                        }
                    }
                }

                result.replaceAll((factoryType, implementations) -> {
                    return (List)implementations.stream().distinct().collect(Collectors.collectingAndThen(Collectors.toList(), Collections::unmodifiableList));
                });
                cache.put(classLoader, result);
                return result;
            } catch (IOException var14) {
                throw new IllegalArgumentException("Unable to load factories from location [META-INF/spring.factories]", var14);
            }
        }
    }

我们先有一个认识:类加载器可以在当前类加载上下文环境下找到指定位置的配置文件。

代码虽然比较长,但是实现的功能比较简单:通过类加载器读取配置文件“META-INF/spring.factories”,加工配置文件内容、放入Map之后返回。

我们简单看一眼META-INF/spring.factories文件的内容:
SpringBoot 自动配置@EnableAutoConfiguration_第1张图片

其中的org.springframework.boot.autoconfigure.AutoConfigurationImportFilter、以及org.springframework.boot.autoconfigure.EnableAutoConfiguration是key,后面的内容是value(是一个list),读取该文件的配置后最终以map的形式返回。

这样的话,getCandidateConfigurations方法就通过类加载器返回配置在META-INF/spring.factories文件中的内容并返回。

这段代码逻辑其实就是SpringBoot自动配置的核心内容,SpringBoot帮助程序员完成配置的机密就在这个META-INF/spring.factories文件中,其实如果没有META-INF/spring.factories文件,SpringBoot也不可能知道他究竟要自动加载哪些Bean!

getExclusions

getExclusions方法完成的功能比较简单,就是检查@Import注解是否有exclude的配置,根据配置对返回的自动配置结合进行排除。

getConfigurationClassFilter().filter

getConfigurationClassFilter().filter方法也非常关键,因为配置文件META-INF/spring.factories中的自动配置类非常多,但是我们的项目中不一定需要,比如RabbitMQ,在META-INF/spring.factories文件中就有关于RabbitMQ的配置,但是如果我们的项目不需要mq的话,SpringBoot就没有必要加载他。

SpringBoot就是通过filter方法来过滤上述不必要加载的组件的。过滤的方法是:

  1. SpringBoot通过META-INF/spring.factories配置文件指定了AutoConfigurationImportFilter过滤器
  2. filter方法中通过过滤器,以及各组件的自动配置类完成过滤

比如,RabbitMQ的自动配置类:

@Configuration(proxyBeanMethods = false)
@ConditionalOnClass({ RabbitTemplate.class, Channel.class })
@EnableConfigurationProperties(RabbitProperties.class)
@Import({ RabbitAnnotationDrivenConfiguration.class, RabbitStreamConfiguration.class })
public class RabbitAutoConfiguration {

其中@ConditionalOnClass注解,指定如果当前项目中有RabbitTemplate.class, 以及Channel.class,两个类存在的情况下就执行自动配置,否则,如果不存在的话,RabbitMQ的自动配置类RabbitAutoConfiguration就会被这个filter方法过滤掉,不会被Spring容器加载进来。

而这个“过滤掉”的具体工作,就是由AutoConfigurationImportFilter过滤器完成的。

OK,SpringBoot自动配置的实现原理就搞清楚了!

但是还是有必要提一下SpringBoot3.0,实现自动配置的逻辑和我们上面看到的有变化。

SpringBoot3.0

如果你的项目使用的是SpringBoot3.0,你会发现我上面写的这些内容是在胡说。

因为压根就没有META-INF/spring.factories这个东西!

META-INF/spring.factories其实是在SpringBoot2.7之后就被移除了。

看一下源码,从getCandidateConfigurations开始:

	protected List getCandidateConfigurations(AnnotationMetadata metadata, AnnotationAttributes attributes) {
		List configurations = ImportCandidates.load(AutoConfiguration.class, getBeanClassLoader())
			.getCandidates();
		Assert.notEmpty(configurations,
				"No auto configuration classes found in "
						+ "META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports. If you "
						+ "are using a custom packaging, make sure that file is correct.");
		return configurations;
	}

关键是这个ImportCandidates.load方法:

	public static ImportCandidates load(Class annotation, ClassLoader classLoader) {
		Assert.notNull(annotation, "'annotation' must not be null");
        //获取类加载器
		ClassLoader classLoaderToUse = decideClassloader(classLoader);
		String location = String.format(LOCATION, annotation.getName());
		//在类加载器的帮助下,获取到指定位置的配置
        Enumeration urls = findUrlsInClasspath(classLoaderToUse, location);
		List importCandidates = new ArrayList<>();
		while (urls.hasMoreElements()) {
			URL url = urls.nextElement();
			importCandidates.addAll(readCandidateConfigurations(url));
		}
		return new ImportCandidates(importCandidates);
	}

要找到的就是location指定的文件,其中LOCATION定义为:

	private static final String LOCATION = "META-INF/spring/%s.imports";

发现配置文件META-INF/spring.factories被META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports取代!

这个变化对既有项目的影响很大!因为虽然SpringBoot自己的自动配置很容易就完成了修改,但是你项目中使用的那些第三方包不一定能够无缝支持!

有关第三方包的自动配置,我们下一篇文章分析。

上一篇 Spring MVC 十一:@EnableWebMvc

你可能感兴趣的:(spring,boot,java,后端)