1024程序员节特辑：【Spring Boot自动配置原理揭秘】

自动配置原理

主页传送门：📀 传送

概述

  Spring Boot 是一个用于创建独立的、生产级别的 Spring 应用程序的框架。它极大地简化了 Spring 应用程序的开发过程，其中一个关键的功能就是自动配置（Auto-Configuration）。

  自动配置可以根据项目需求自动配置各种服务和组件，它可以帮助开发者在不需要显式配置的情况下，快速地构建一个运行的应用程序。

  自动配置是 Spring Boot 的一个核心特性，它通过分析项目的依赖和环境，自动地为应用程序配置 Spring 配置文件。这意味着开发者无需手动配置大量的 Spring Bean，Spring Boot 会根据环境和项目的依赖来智能地为应用程序创建所需的 Bean。

原理

  Spring Boot的自动配置原理基于Java的反射机制和Spring的IoC容器。它通过读取项目中的配置文件（如application.properties或application.yml），根据配置信息自动创建和配置各种服务。

可以概括为以下几个步骤：

Spring Boot Starter

  Spring Boot 项目通常依赖于所谓的 “Starters”，这是一组预定义了常用库的依赖集合。Starters 包含了应用程序所需的所有依赖，比如 Web Starter 会包含用于构建 Web 应用程序的所有必要库。

spring.factories 文件

  在每个 Starter 的

META-INF/spring.factories

文件中，定义了一系列的自动配置类。这些自动配置类会在应用程序启动时被 Spring Boot 自动扫描和加载。

@ConditionalOnX 注解

  在自动配置类中，通常会使用

@ConditionalOnX

注解来控制该自动配置是否生效。这个注解会根据特定的条件（比如类是否在类路径中、特定的 Bean 是否存在等）来决定是否应用这个配置。

配置 Bean

  自动配置类会定义一些必要的 Bean，并使用

@Configuration

注解将它们标记为配置类。这些 Bean 会在 Spring 上下文中被自动注册。

配置属性

  自动配置类还可以通过读取

application.properties

或

application.yml

文件中的属性来自定义它们的行为。这样，开发者可以根据需要进行定制。

源码剖析

Spring Boot 应用的启动类一般均位于src/main/java根路径下

@SpringBootApplicationpublicclassApplication{publicstaticvoidmain(String[] args){SpringApplication.run(Application.class, args);}}

复合

Annotation

@SpringBootApplication

开启组件扫描和自动配置，而

SpringApplication.run

则负责启动引导应用程序。

@SpringBootApplication

是一个复合

Annotation

，它将三个有用的注解组合在一起：

@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@interfaceSpringBootApplication{// ...省略内容}

@SpringBootConfiguration

就相当于

@Configuration

，它是 Spring 框架的注解，标明该类是一个

JavaConfig

配置类。而

@ComponentScan

启用组件扫描。

@EnableAutoConfiguration

@EnableAutoConfiguration

注解表示开启 Spring Boot 自动配置功能，Spring Boot 会根据应用的依赖、自定义的 bean、classpath 下有没有某个类 等等因素来猜测你需要的 bean，然后注册到 IOC 容器中。

@EnableAutoConfiguration

是如何推算出需求的？首先来看下它的定义：

@Target(ElementType.TYPE)@Retention(RetentionPolicy.RUNTIME)@Documented@Inherited@AutoConfigurationPackage@Import(EnableAutoConfigurationImportSelector.class)public@interfaceEnableAutoConfiguration{// ...省略内容}

重点关注点在

@Import({AutoConfigurationImportSelector.class})

@Import

注解用于导入类，并将这个类作为一个 bean 的定义注册到容器中，这里它将把

EnableAutoConfigurationImportSelector

作为 bean 注入到容器中，而这个类会将所有符合条件的

@Configuration 

配置都加载到容器中。

  查看

EnableAutoConfigurationImportSelector

代码可以看到：

AutoConfigurationImportSelector

AutoConfigurationImportSelector

实现了

DeferredImportSelector, BeanClassLoaderAware, ResourceLoaderAware, BeanFactoryAware, EnvironmentAware, Ordered

这些接口。核心代码为

publicclassAutoConfigurationImportSelectorimplementsDeferredImportSelector,BeanClassLoaderAware,ResourceLoaderAware,BeanFactoryAware,EnvironmentAware,Ordered{//...publicString[]selectImports(AnnotationMetadata annotationMetadata){if(!this.isEnabled(annotationMetadata)){returnNO_IMPORTS;}else{AutoConfigurationImportSelector.AutoConfigurationEntry autoConfigurationEntry =this.getAutoConfigurationEntry(annotationMetadata);returnStringUtils.toStringArray(autoConfigurationEntry.getConfigurations());}}}

再来具体看

getAutoConfigurationEntry

方法具体是如何判断哪些是需要导入的。

protectedAutoConfigurationImportSelector.AutoConfigurationEntrygetAutoConfigurationEntry(AnnotationMetadata annotationMetadata){if(!this.isEnabled(annotationMetadata)){returnEMPTY_ENTRY;}else{AnnotationAttributes attributes =this.getAttributes(annotationMetadata);List<String> configurations =this.getCandidateConfigurations(annotationMetadata, attributes);
            configurations =this.removeDuplicates(configurations);Set<String> exclusions =this.getExclusions(annotationMetadata, attributes);this.checkExcludedClasses(configurations, exclusions);
            configurations.removeAll(exclusions);
            configurations =this.getConfigurationClassFilter().filter(configurations);this.fireAutoConfigurationImportEvents(configurations, exclusions);returnnewAutoConfigurationImportSelector.AutoConfigurationEntry(configurations, exclusions);}}

annotationMetadata

参数是一个元数据接口，它提供了对注解元数据的访问权限，通常用于在运行时检查类上的注解。

getAutoConfigurationEntry(annotationMetadata)

方法会根据传入的

annotationMetadata

返回一个

AutoConfigurationEntry 

对象。

AutoConfigurationEntry 

是一个内部类，用于封装自动配置项的信息，包括该自动配置项的类名、条件（Conditions）等信息。

  通过获取到的

autoConfigurationEntry 

对象，Spring Boot 就能够知道哪些自动配置类需要被导入，从而将它们注册到 Spring 上下文中。

  如果喜欢的话，欢迎 🤞关注 👍点赞 💬评论 🤝收藏  🙌一起讨论
  你的支持就是我✍️创作的动力！                      💞💞💞