SpringBoot自动配置原理

分析自动装配原理

我们以**HttpEncodingAutoConfiguration（Http编码自动配置）**为例解释自动配置原理；

//表示这是一个配置类，和以前编写的配置文件一样，也可以给容器中添加组件；
@Configuration 
 
 
//启动指定类的ConfigurationProperties功能；
  //进入这个HttpProperties查看，将配置文件中对应的值和HttpProperties绑定起来；
  //并把HttpProperties加入到ioc容器中
@EnableConfigurationProperties({HttpProperties.class}) 
 
 
//Spring底层@Conditional注解
  //根据不同的条件判断，如果满足指定的条件，整个配置类里面的配置就会生效；
  //这里的意思就是判断当前应用是否是web应用，如果是，当前配置类生效
@ConditionalOnWebApplication(
    type = Type.SERVLET
)
 
 
//判断当前项目有没有这个类CharacterEncodingFilter；SpringMVC中进行乱码解决的过滤器；
@ConditionalOnClass({CharacterEncodingFilter.class})
 
 
//判断配置文件中是否存在某个配置：spring.http.encoding.enabled；
  //如果不存在，判断也是成立的
  //即使我们配置文件中不配置pring.http.encoding.enabled=true，也是默认生效的；
@ConditionalOnProperty(
    prefix = "spring.http.encoding",
    value = {"enabled"},
    matchIfMissing = true
)
 
 
public class HttpEncodingAutoConfiguration {
    //他已经和SpringBoot的配置文件映射了
    private final Encoding properties;
    //只有一个有参构造器的情况下，参数的值就会从容器中拿
    public HttpEncodingAutoConfiguration(HttpProperties properties) {
        this.properties = properties.getEncoding();
    }
    
    //给容器中添加一个组件，这个组件的某些值需要从properties中获取
    @Bean
    @ConditionalOnMissingBean //判断容器没有这个组件？
    public CharacterEncodingFilter characterEncodingFilter() {
        CharacterEncodingFilter filter = new OrderedCharacterEncodingFilter();
        filter.setEncoding(this.properties.getCharset().name());
        filter.setForceRequestEncoding(this.properties.shouldForce(org.springframework.boot.autoconfigure.http.HttpProperties.Encoding.Type.REQUEST));
        filter.setForceResponseEncoding(this.properties.shouldForce(org.springframework.boot.autoconfigure.http.HttpProperties.Encoding.Type.RESPONSE));
        return filter;
    }
    //。。。。。。。
}

总结：根据当前不同的条件判断决定这个配置类是否生效！

• 一但这个配置类生效；这里配置类就会给容器中增加各种组件；
• 这些组件的属性是从对应的properties类中获取的，这些类里面的每一个属性都是跟配置文件进行绑定的，所有我们可以根据配置文件来进行修改。
• 所有的配置文件中能够配置属性都在xxxProperties（就是配置的类）类中封装着；
• 配置文件能配置什么就可以参照某个功能对应的这个属性类

//从配置文件中获取指定的值和bean的属性进行绑定
@ConfigurationProperties(
    prefix = "server",
    ignoreUnknownFields = true
)
public class ServerProperties {

我们可以去看看配置文件中的前缀，我们需要设置端口号，前缀就是什么配置的名字，port就是这个类中的属性。

这就是自动装配原理

总结精髓

1. SpringBoot启动会加载大量的自动配置类
2. 我们看我们需要的功能是否在SpringBoot默认写好的自动配置类当中。
3. 我们在看看自动配置类中有那些属性，（只要组件存在使用的时候就不用手动的去导入了）
4. 给容器中自动配置类增加组件的时候，会从properties类中获取某些属性。我们只需要在配置文件中指定这些属性的值即可；

**xxxxAutoConFigurartion：自动配置类；**给容器中添加组件

xxxxProperties： 封装配置文件中的相关属性；

了解：@Conditional

自动配置类必须在一定条件下才能实现

@Conditional派生注解（Spring注解版原生的@Conditional作用）

作用：必须是@Conditional指定的条件成立，才给容器中增加组件，配置类里面的所有内容才能生效。

@Conditional                                       | 作用（判断是否满足当前指定条件）              

@ConditionalOnJava                           | 系统的java版本是否符合要求               
@ConditionalOnBean                          | 容器中存在指定Bean；                  
@ConditionalOnMissingBean              | 容器中不存在指定Bean；                 
@ConditionalOnExpression                 | 满足SpEL表达式指定                   
@ConditionalOnClass                          | 系统中有指定的类                      
@ConditionalOnMissingClass              | 系统中没有指定的类                     
@ConditionalOnSingleCandidate         | 容器中只有一个指定的Bean，或者这个Bean是首选Bean
@ConditionalOnProperty                      | 系统中指定的属性是否有指定的值               
@ConditionalOnResource                    | 类路径下是否存在指定资源文件                
@ConditionalOnWebApplication           | 当前是web环境                      
@ConditionalOnNotWebApplication      | 当前不是web环境                     
@ConditionalOnJndi                              | JNDI存在指定项     

SpeingBoot那么多的自动配置都必需要满足要求才能生效，那我们怎么样看是否生效哪？

我们可以通过启动 debug=true属性； 让控制台打印出自动配置报告，这样我们就能很清楚的看出那些是自动配置了

#开启springboot的调试类
debug=true    

Positive matches:（自动配置类启用的：正匹配）

Negative matches:（没有启动，没有匹配成功的自动配置类：负匹配）

#开启springboot的调试类
debug=true

**Positive matches:（自动配置类启用的：正匹配）**

**Negative matches:（没有启动，没有匹配成功的自动配置类：负匹配）**

**Unconditional classes: （没有条件的类）**