【Springboot】自动配置原理（依赖管理、自动配置、组件组测、自动装配原理）

🔰 学习视频 🔰

尚硅谷雷神SpringBoot2零基础入门springboot全套完整版（spring boot2）

集数：6—15

---

🔰 学习笔记 🔰

【Java】学习笔记汇总

---

一、特点

1.1 依赖管理

只引入一个父工程，导入一个依赖，所有需要的依赖都被导入进来了。

🔶 父项目做依赖管理

<parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-parent</artifactId>
    <version>2.5.6</version>
    <relativePath/> <!-- lookup parent from repository -->
</parent>

父项目的父项目
<parent>
  <groupId>org.springframework.boot</groupId>
  <artifactId>spring-boot-dependencies</artifactId>
  <version>2.5.6</version>
</parent>

几乎声明了所有开发中常用的依赖版本号，自动版本仲裁机制。
<properties>
    <activemq.version>5.16.3</activemq.version>
    <antlr2.version>2.7.7</antlr2.version>
    <appengine-sdk.version>1.9.91</appengine-sdk.version>
    <artemis.version>2.17.0</artemis.version>
    <aspectj.version>1.9.7</aspectj.version>
    <assertj.version>3.19.0</assertj.version>
    <atomikos.version>4.0.6</atomikos.version>
    ...
</properties>

<dependencyManagement>
    <dependencies>
      <dependency>
        <groupId>org.apache.activemq</groupId>
        <artifactId>activemq-amqp</artifactId>
        <version>${activemq.version}</version>
      </dependency>
      <dependency>
        <groupId>org.apache.activemq</groupId>
        <artifactId>activemq-blueprint</artifactId>
        <version>${activemq.version}</version>
      </dependency>
      ...
    </dependencies>
</dependencyManagement>

• 引入依赖默认都可以不写版本
• 引入非版本仲裁的jar，要写版本号。

🔶 自定义依赖版本号

在spring-boot-dependencies里面 规定当前依赖的版本，用key。

在当前项目的pom.xml中修改配置

🔶 开发导入starter场景启动器

官方文档 - Using Spring Boot

• spring-boot-starter-* ： 官方提供的某种场景 *
• 只要引入starter，这个场景的所有常规需要的依赖我们都自动引入。
• SpringBoot 所有支持的场景
• *-spring-boot-starter： 第三方为我们提供的简化开发的场景启动器。
• 所有场景启动器最底层的依赖。

<dependency>
  <groupId>org.springframework.boot</groupId>
  <artifactId>spring-boot-starter</artifactId>
  <version>2.3.4.RELEASE</version>
  <scope>compile</scope>
</dependency>

1.2 自动配置

🔶 自动配置Tomcat

○ 引入Tomcat依赖
○ 配置Tomcat

spring-boot-starter-web-2.5.6.pom

<dependency>
  <groupId>org.springframework.boot</groupId>
  <artifactId>spring-boot-starter-tomcat</artifactId>
  <version>2.5.6</version>
  <scope>compile</scope>
</dependency>

🔶 自动配置SpringMVC

○ 引入SpringMVC全套组件
○ 自动配好SpringMVC常用组件（功能）

spring-boot-starter-web-2.5.6.pom

<dependency>
  <groupId>org.springframework</groupId>
  <artifactId>spring-web</artifactId>
  <version>5.3.12</version>
  <scope>compile</scope>
</dependency>
<dependency>
  <groupId>org.springframework</groupId>
  <artifactId>spring-webmvc</artifactId>
  <version>5.3.12</version>
  <scope>compile</scope>
</dependency>

🔶 自动配好Web常见功能

○ 自动配好Web常见功能，如：字符编码问题
○ 配置好了所有web开发的常见场景

🔶 默认的包结构

○ 主程序所在包及其下面的所有子包里面的组件都会被默认扫描进来
○ 无需以前的包扫描配置
○ 想要改变扫描路径，@SpringBootApplication(scanBasePackages="com.zqc")或者@ComponentScan指定扫描路径

@SpringBootApplication
public class SpringbootHelloApplication {
    public static void main(String[] args) {
        SpringApplication.run(SpringbootHelloApplication.class, args);
    }
}

@SpringBootApplication等同于以下三个注解，使用可以用下面三个注解来替换@SpringBootApplication

@SpringBootConfiguration
@EnableAutoConfiguration
@ComponentScan("com.zqc")

🔶 各种配置拥有默认值

○ 默认配置最终都是映射到某个类上，如：MultipartProperties
○ 配置文件的值最终会绑定每个类上，这个类会在容器中创建对象

🔶 按需加载所有自动配置项

○ 非常多的starter
○ 引入了哪些场景这个场景的自动配置才会开启
○ SpringBoot所有的自动配置功能都在 spring-boot-autoconfigure 包里面

---

二、容器

2.1 组件添加

创建两个类Person、Pet

2.1.1 @Configuration

配置类里面使用@Bean标注在方法上给容器注册组件，默认是单实例的
配置类本身也是组件

@Configuration  // 告诉SpringBoot这是一个配置类
public class MyConfig {

    @Bean  // 给容器中添加组件。以方法名作为组件的id。返回类型就是组件类型。返回值，就是在容器中的实例。
    public User user01() {
        return new User("zqc", 23);
    }

    @Bean("cat007")  // 自定义主键名
    public Pet pet01() {
        return new Pet("cat");
    }
}

在已组测组件中可以找到

user01
cat007

Full模式与Lite模式

■ 配置 类组件之间无依赖关系用Lite模式加速容器启动过程，减少判断。
■ 配置类组件之间有依赖关系，方法会被调用得到之前单实例组件，用Full模式。

#############################Configuration使用示例######################################################
/**
 * 1、配置类里面使用@Bean标注在方法上给容器注册组件，默认也是单实例的
 * 2、配置类本身也是组件
 * 3、proxyBeanMethods：代理bean的方法
 *      Full(proxyBeanMethods = true)、【保证每个@Bean方法被调用多少次返回的组件都是单实例的】
 *      Lite(proxyBeanMethods = false)【每个@Bean方法被调用多少次返回的组件都是新创建的】
 *      组件依赖必须使用Full模式默认。其他默认是否Lite模式
 */
@Configuration(proxyBeanMethods = false) //告诉SpringBoot这是一个配置类 == 配置文件
public class MyConfig {

    /**
     * Full:外部无论对配置类中的这个组件注册方法调用多少次获取的都是之前注册容器中的单实例对象
     * @return
     */
    @Bean //给容器中添加组件。以方法名作为组件的id。返回类型就是组件类型。返回的值，就是组件在容器中的实例
    public User user01(){
        User zhangsan = new User("zhangsan", 18);
        //user组件依赖了Pet组件
        zhangsan.setPet(tomcatPet());
        return zhangsan;
    }

    @Bean("tom")
    public Pet tomcatPet(){
        return new Pet("tomcat");
    }
}

#########################@Configuration测试代码如下################################
@SpringBootConfiguration
@EnableAutoConfiguration
@ComponentScan("com.atguigu.boot")
public class MainApplication {

    public static void main(String[] args) {
        //1、返回我们IOC容器
        ConfigurableApplicationContext run = SpringApplication.run(MainApplication.class, args);

        //2、查看容器里面的组件
        String[] names = run.getBeanDefinitionNames();
        for (String name : names) {
            System.out.println(name);
        }

        //3、从容器中获取组件
        Pet tom01 = run.getBean("tom", Pet.class);
        Pet tom02 = run.getBean("tom", Pet.class);
        System.out.println("组件："+(tom01 == tom02));

        //4、com.atguigu.boot.config.MyConfig$$EnhancerBySpringCGLIB$$51f1e1ca@1654a892
        MyConfig bean = run.getBean(MyConfig.class);
        System.out.println(bean);

        //如果@Configuration(proxyBeanMethods = true)代理对象调用方法。SpringBoot总会检查这个组件是否在容器中有。
        //保持组件单实例
        User user = bean.user01();
        User user1 = bean.user01();
        System.out.println(user == user1);

        User user01 = run.getBean("user01", User.class);
        Pet tom = run.getBean("tom", Pet.class);

        System.out.println("用户的宠物："+(user01.getPet() == tom));
    }
}

2.1.2 @Bean、@Component、@Controller、@Service、@Repository

2.1.3 @ComponentScan、@Import

@Import({xxx1.class, xxx2.class})

给容器中自动创建出这两个类型的组件、默认组件的名字就是全类名

@Import({User.class, DBHelper.class})
@Configuration(proxyBeanMethods = false) //告诉SpringBoot这是一个配置类 == 配置文件
public class MyConfig {
}

2.1.4 @Conditional

条件装配：满足Conditional指定的条件，则进行组件注入

=====================测试条件装配==========================
@Configuration(proxyBeanMethods = false) //告诉SpringBoot这是一个配置类 == 配置文件
//@ConditionalOnBean(name = "tom")
@ConditionalOnMissingBean(name = "tom")
public class MyConfig {
    /**
     * Full:外部无论对配置类中的这个组件注册方法调用多少次获取的都是之前注册容器中的单实例对象
     */

    @Bean //给容器中添加组件。以方法名作为组件的id。返回类型就是组件类型。返回的值，就是组件在容器中的实例
    public User user01(){
        User zhangsan = new User("zhangsan", 18);
        //user组件依赖了Pet组件
        zhangsan.setPet(tomcatPet());
        return zhangsan;
    }

    @Bean("tom22")
    public Pet tomcatPet(){
        return new Pet("tomcat");
    }
}
=====================主启动类==========================
public static void main(String[] args) {
        //1、返回我们IOC容器
        ConfigurableApplicationContext run = SpringApplication.run(MainApplication.class, args);

        //2、查看容器里面的组件
        String[] names = run.getBeanDefinitionNames();
        for (String name : names) {
            System.out.println(name);
        }

        boolean tom = run.containsBean("tom");
        System.out.println("容器中Tom组件："+tom);

        boolean user01 = run.containsBean("user01");
        System.out.println("容器中user01组件："+user01);

        boolean tom22 = run.containsBean("tom22");
        System.out.println("容器中tom22组件："+tom22);
    }

2.2 原生配置文件引入 @ImportResource

bean.xml

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xmlns:context="http://www.springframework.org/schema/context"
       xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd http://www.springframework.org/schema/context https://www.springframework.org/schema/context/spring-context.xsd">

    <bean id="haha" class="com.atguigu.boot.bean.User">
        <property name="name" value="zhangsan"></property>
        <property name="age" value="18"></property>
    </bean>

    <bean id="hehe" class="com.atguigu.boot.bean.Pet">
        <property name="name" value="tomcat"></property>
    </bean>
</beans>

配置类

@ImportResource("classpath:beans.xml")
public class MyConfig {
	...
}

主启动类测试

boolean haha = run.containsBean("haha");
boolean hehe = run.containsBean("hehe");
System.out.println("haha："+haha);//true
System.out.println("hehe："+hehe);//true

2.3 配置绑定

如何使用Java读取到properties文件中的内容，并且把它封装到JavaBean中，以供随时使用；

public class getProperties {
     public static void main(String[] args) throws FileNotFoundException, IOException {
         Properties pps = new Properties();
         pps.load(new FileInputStream("a.properties"));
         Enumeration enum1 = pps.propertyNames();//得到配置文件的名字
         while(enum1.hasMoreElements()) {
             String strKey = (String) enum1.nextElement();
             String strValue = pps.getProperty(strKey);
             System.out.println(strKey + "=" + strValue);
             //封装到JavaBean。
         }
     }
 }

2.3.1 @Component + @ConfigurationProperties

/**
 * 只有在容器中的组件，才会拥有SpringBoot提供的强大功能
 */
@Component
@ConfigurationProperties(prefix = "mycar")
public class Car {

    private String brand;
    private Integer price;

    public String getBrand() {
        return brand;
    }

    public void setBrand(String brand) {
        this.brand = brand;
    }

    public Integer getPrice() {
        return price;
    }

    public void setPrice(Integer price) {
        this.price = price;
    }

    @Override
    public String toString() {
        return "Car{" +
                "brand='" + brand + '\'' +
                ", price=" + price +
                '}';
    }
}

配置文件application.properties

mycar.brand=byd
mycar.price=1

2.3.2 @EnableConfigurationProperties + @ConfigurationProperties

@ConfigurationProperties(prefix = "mycar")
public class Car {

    private String brand;
    private Integer price;
	...

// 开启Car的配置绑定功能，把Car组件自动注册到容器中
@EnableConfigurationProperties(Car.class)
public class MyConfig {
	...
}

三、自动配置原理入门

3.1 引导自动配置类

@SpringBootApplication

@SpringBootConfiguration
@EnableAutoConfiguration
@ComponentScan(
    excludeFilters = {@Filter(
    type = FilterType.CUSTOM,
    classes = {TypeExcludeFilter.class}
), @Filter(
    type = FilterType.CUSTOM,
    classes = {AutoConfigurationExcludeFilter.class}
)}
)
public @interface SpringBootApplication {...}

🔶 3.1.1 @SpringBootConfiguration

@Configuration
@Indexed
public @interface SpringBootConfiguration {...}

它就是一个@Configuration，代表它是一个配置类。

🔶 3.1.2 @ComponentScan

指定扫描哪些包，Spring注解；

🔶 3.1.3 @EnableAutoConfiguration

@AutoConfigurationPackage
@Import({AutoConfigurationImportSelector.class})
public @interface EnableAutoConfiguration {...}

🔸 3.1.3.1 @AutoConfigurationPackage

自动配置包，是一个Import，给容器中导入一个组件，

@Import({Registrar.class})
public @interface AutoConfigurationPackage {...}

利用Registrar给容器中导入一系列组件，将指定的一个包下的所有组件导入进来（MainApplication 所在包下）。

🔸 3.1.3.3 @Import({AutoConfigurationImportSelector.class})

1 利用getAutoConfigurationEntry(annotationMetadata) 给容器中批量导入一些组件
2 调用List<String> configurations = getCandidateConfigurations(annotationMetadata, attributes)获取到所有需要导入到容器中的配置类
3 利用工厂加载 Map<String, List<String>> loadSpringFactories(@Nullable ClassLoader classLoader)得到所有的组件
4 从META-INF/spring.factories位置来加载一个文件。
默认扫描我们当前系统里面所有META-INF/spring.factories位置的文件
spring-boot-autoconfigure-版本.jar包里面也有META-INF/spring.factories

文件里面写死了spring-boot一启动就要给容器中加载的所有配置类。

3.2 按需开启自动配置项

虽然我们127个场景的所有自动配置启动的时候默认全部加载。
xxxxAutoConfiguration按照条件装配规则（@Conditional），最终会按需配置。

3.3 修改默认配置

@Bean
@ConditionalOnBean(MultipartResolver.class)  //容器中有这个类型组件
@ConditionalOnMissingBean(name = DispatcherServlet.MULTIPART_RESOLVER_BEAN_NAME) //容器中没有这个名字 multipartResolver 的组件
public MultipartResolver multipartResolver(MultipartResolver resolver) {
    //给@Bean标注的方法传入了对象参数，这个参数的值就会从容器中找。
    //SpringMVC multipartResolver。防止有些用户配置的文件上传解析器不符合规范
	// Detect if the user has created a MultipartResolver but named it incorrectly
	return resolver;
}
给容器中加入了文件上传解析器；

SpringBoot默认会在底层配好所有的组件。但是如果用户自己配置了以用户的优先。

@Bean
@ConditionalOnMissingBean
public CharacterEncodingFilter characterEncodingFilter() {...}

总结：

● SpringBoot先加载所有的自动配置类 xxxxxAutoConfiguration
● 每个自动配置类按照条件进行生效，默认都会绑定配置文件指定的值。xxxxProperties里面拿。xxxProperties和配置文件进行了绑定
● 生效的配置类就会给容器中装配很多组件
● 只要容器中有这些组件，相当于这些功能就有了
● 定制化配置
○ 用户直接自己@Bean替换底层的组件
○ 用户去看这个组件是获取的配置文件什么值就去修改。
xxxxxAutoConfiguration —> 组件 —> xxxxProperties里面拿值 ----> application.properties

3.4 最佳实践

• 引入场景依赖

• 查看自动配置了哪些（选做）

  • 自己分析，引入场景对应的自动配置一般都生效了
  • 配置文件中debug=true开启自动配置报告。Negative（不生效）\Positive（生效）

• 是否需要修改

  • 参照文档修改配置项
  • 自己分析。xxxxProperties绑定了配置文件的哪些。
    自定义加入或者替换组件
  • @Bean、@Component。。。
    自定义器 XXXXXCustomizer；