首页

主题

自动配置原理 ​

Spring Boot 的自动配置（Auto-Configuration）是其核心特性之一，它极大地简化了应用程序的开发和配置过程。自动配置的工作原理基于条件化注解和 Spring 的条件注册机制，使得 Spring Boot 能够根据类路径中的依赖关系、存在的特定 Bean 以及其他环境因素智能地应用合理的默认配置。以下是自动配置的主要工作原理：

1. spring.factories 文件 ​

自动配置类通过 META-INF/spring.factories 文件进行注册。这个文件位于 Spring Boot Starter 包中，指定了哪些自动配置类应该被加载。例如：

properties
org.springframework.boot.autoconfigure.EnableAutoConfiguration=\
org.springframework.boot.autoconfigure.admin.SpringApplicationAdminJmxAutoConfiguration,\
org.springframework.boot.autoconfigure.aop.AopAutoConfiguration,...

当 Spring Boot 启动时，它会读取这些信息并加载相应的自动配置类。

2. 条件化注解 ​

自动配置类通常使用条件化注解来决定是否应该创建某些 Bean 或者应用特定配置。主要的条件化注解包括但不限于：

  • @ConditionalOnClass 和 @ConditionalOnMissingClass：根据类路径中是否存在某个类来决定是否应用配置。
  • @ConditionalOnBean 和 @ConditionalOnMissingBean：根据上下文中是否存在某个类型的 Bean 来决定是否应用配置。
  • @ConditionalOnProperty：根据配置属性的值来决定是否应用配置。
  • @ConditionalOnExpression：根据 SpEL 表达式的评估结果来决定是否应用配置。
  • @ConditionalOnWebApplication 和 @ConditionalOnNotWebApplication：根据应用程序是否为 Web 应用程序来决定是否应用配置。
  • @ConditionalOnResource：根据指定资源是否存在来决定是否应用配置。
  • @ConditionalOnJava：根据 JVM 版本来决定是否应用配置。

3. 自动配置类 ​

每个自动配置类都是一个标准的 Spring 配置类，它们通常定义了一系列带有条件化注解的 @Bean 方法。如果所有条件都满足，则会创建对应的 Bean 并将其注册到 Spring 应用上下文中。例如：

java
@Configuration
@ConditionalOnClass({DataSource.class, EmbeddedDatabaseType.class})
@EnableConfigurationProperties(DataSourceProperties.class)
public class DataSourceAutoConfiguration {

    @Bean
    @ConditionalOnMissingBean
    public DataSource dataSource(DataSourceProperties properties) {
        // 创建并返回 DataSource 实例
    }
}

在这个例子中，只有在类路径中有 DataSource 和 EmbeddedDatabaseType 类，并且上下文中没有已存在的 DataSource Bean 时，才会创建新的 DataSource Bean。

4. 自动配置顺序 ​

自动配置类的加载顺序非常重要，因为某些配置可能依赖于其他配置的存在或不存在。为了管理这种依赖关系，Spring Boot 使用了 @AutoConfigureBefore 和 @AutoConfigureAfter 注解。这些注解允许你指定自动配置类之间的相对顺序。

5. 排除自动配置 ​

如果你不想使用某些自动配置，可以通过 @SpringBootApplication 注解的 exclude 属性或者通过设置 spring.autoconfigure.exclude 属性来排除特定的自动配置类。

java
@SpringBootApplication(exclude = {DataSourceAutoConfiguration.class})
yaml
spring:
  autoconfigure:
    exclude: org.springframework.boot.autoconfigure.jdbc.DataSourceAutoConfiguration

6. 用户自定义优先 ​

自动配置的设计考虑到了用户自定义的需求。即使启用了自动配置，用户仍然可以在自己的配置类中覆盖默认行为。如果用户定义了一个与自动配置相同的 Bean，那么用户的 Bean 将会被优先使用，而不会重复创建相同的 Bean。