SpringBoot 自动配置原理学习

  SpringBoot 的自动配置是其核心特性之一，它通过约定优于配置的思想，简化了开发，减少了繁琐的手动配置工作。以下从自动配置的实现方式、原理及常见注解的作用三个方面进行总结。

1. 什么是自动配置

  SpringBoot 的自动配置机制可以在 Spring 容器启动后，将配置类和 Bean 对象自动加载到 IoC 容器中，无需开发者手动声明。这样：

• 简化了开发流程。

• 避免了重复性配置代码。

2. 自动配置实现方案

方案一：使用 @ComponentScan 手动扫描

通过 @ComponentScan 指定需要扫描的包路径，将第三方依赖的 Bean 加载到 IoC 容器中。例如：

@ComponentScan({"com.example", "com.zhang", "org.springframework"})
@SpringBootApplication
public class SpringbootWebConfigApplication {
    // 主类
}

• 优点：可以手动指定需要加载的包路径。

• 缺点：配置复杂，代码不优雅，性能也可能较低。

方案二：使用 @Import 注解

通过 @Import 注解将指定的类加载到 IoC 容器中。主要有以下几种形式：

导入普通类：

@Import(TokenParser.class)

导入配置类：

@Import(HeaderConfig.class)

导入实现了 ImportSelector 接口的类：

public class MyImportSelector implements ImportSelector {
    @Override
    public String[] selectImports(AnnotationMetadata importingClassMetadata) {
        return new String[]{"com.example.MyBean"};
    }
}

通过 @EnableXxx 注解封装 @Import：

@EnableHeaderConfig
@SpringBootApplication
public class SpringbootWebConfigApplication {
    // 主类
}

• 优点：使用方便，代码优雅。

• 缺点：可能增加一些额外的开发复杂度。

3. 自动配置的源码跟踪

@SpringBootApplication 是 SpringBoot 中的核心注解，它组合了以下注解：

1. @SpringBootConfiguration：

   • 等同于 @Configuration，本质上是一个配置类。

2. @ComponentScan：

   • 默认扫描当前引导类所在的包及其子包。

3. @EnableAutoConfiguration：

   • 是 SpringBoot 实现自动化配置的核心注解。

@EnableAutoConfiguration 的作用：

• 通过 @Import 导入 AutoConfigurationImportSelector。

• AutoConfigurationImportSelector 会根据条件加载符合条件的自动配置类（如 spring.factories 中的配置）。

4. 自动配置的原理 - @Conditional

@Conditional 注解是自动配置实现的核心。它根据条件动态决定某些 Bean 是否注册到 IoC 容器中。

4.1 @Conditional 的派生注解

注解	说明
@ConditionalOnClass	判断当前环境是否存在指定的类（字节码文件），满足条件则注册 Bean。
@ConditionalOnMissingBean	判断当前环境中是否不存在指定 Bean（类型或名称），满足条件则注册 Bean。
@ConditionalOnProperty	判断配置文件中是否存在指定的属性和值，满足条件则注册 Bean。

4.2 使用示例

1. 根据类是否存在注册 Bean：

   @Bean
   @ConditionalOnClass(name = "io.jsonwebtoken.Jwt")
   public HeaderParser headerParser() {
       return new HeaderParser();
   }

2. 根据 Bean 是否缺失注册：

   @Bean
   @ConditionalOnMissingBean
   public HeaderParser headerParser() {
       return new HeaderParser();
   }

3. 根据配置属性注册：

   @Bean
   @ConditionalOnProperty(name = "header.enabled", havingValue = "true")
   public HeaderParser headerParser() {
       return new HeaderParser();
   }

总结

1. 自动配置的核心：

   • 自动配置通过 @EnableAutoConfiguration 和 @Conditional 实现。

   • 避免了大量重复的手动配置，简化了开发。

2. 实现方式：

   • 通过 @ComponentScan 或 @Import 将第三方 Bean 加载到 IoC 容器。

3. 推荐方案：

   • 对于复杂项目，优先使用 @Import 及其衍生方式，如 @EnableXxx。

   • 对于自动配置类，合理使用 @Conditional 注解动态加载配置。

原文地址：https://blog.csdn.net/zzb1580/article/details/144241072

免责声明：本站文章内容转载自网络资源，如本站内容侵犯了原著者的合法权益，可联系本站删除。更多内容请关注自学内容网（zxcms.com）！