当前位置：首页 > news >正文

Spring Boot系列03--自动配置原理

news 2025/8/12 16:44:23

1. 相关注解

@ConfigurationProperties(prefix = "前缀名")

该注解用于自动配置的绑定，可以将application.properties配置中的值注入到 Bean 对象上。该注解使用时必须将对象注入到 IOC 容器中才有配置绑定的功能。

@Component

该注解表示此类为Spring容器中的一个Bean，将该类交给Spring管理。

@Bean

该注解用于产生一个 Bean 对象，然后将该 Bean 对象交给 Spring 管理。SpringIOC 容器管理一个或者多个 Bean，这些 Bean 都需要在 @Configuration 注解下进行创建，在一个方法上使用 @Bean 注解就表明这个方法需要交给 Spring 进行管理。

@Configuration

该注解用于定义配置类，可替换 xml 配置文件，被注解的类内部包含有一个或多个被 @Bean 注解的方法，这些方法将会被相关类进行扫描，并用于构建 Bean、初始化 Spring 容器，并由 Spring 接管。

@EnableConfigurationProperties

该注解的作用是使使用 @ConfigurationProperties 注解的类生效。如果一个配置类只配置 @ConfigurationProperties 注解，而没有使用@Component，那么在IOC容器中是获取不到 properties 配置文件转化的 Bean。@EnableConfigurationProperties 相当于把使用 @ConfigurationProperties 的类进行了一次注入。使用 @ConfigurationProperties 注解之后实体类就不需要再加上 @Component 注解。
例如：

 @EnableConfigurationProperties(MyConfigurationProperties.class)

该注解的作用是使 MyConfigurationProperties 这个类上标注的 @ConfigurationProperties 注解生效，并且会自动将这个类注入到 IOC 容器中。

2. 自动配置原理分析

Spring Boot 启动时会加载大量的自动配置类（下图文件中的Auto Configure部分，但是我的文件没发现），每一个 xxxAutoConfiguration 类都是容器中的一个组件，并且都会加入到容器中，这些自动配置类在某些条件之才会生效。
在这里插入图片描述

进入对应的 xxxAutoConfiguration 文件后，会有一个@EnableConfigurationProperties 注解，即开启配置属性，而它后面的参数是一个 xxxProperties 类。@EnableConfigurationProperties 的功能是进入xxxProperties 中查看，将配置文件中对应的值与 xxxProperties 中的属性绑定起来，并把对应组件加入到 IOC 容器中，因此所有和这个类相关的属性都可以在主配置文件中定义对应的值。

过程讲解1
过程讲解2

在这里插入图片描述

xxxAutoConfiguration：自动配置类，给容器中添加组件。XXXProperties：封装配置文件中相关属性。

容器启动的时候会加载很多自动配置类，但是这些自动配置类需在特定条件满足的情况下才会起作用，即必须是@Conditional指定的条件成立时，才将组件添加到容器，配置里面的所有内容才生效。通过启用配置文件中的 debug=true 属性可以让控制台打印自动配置报告，这样就可以很方便的知道哪些自动配置类生效。
生效的配置类：
在这里插入图片描述
未生效的配置类：