前要
以HttpEncodingAutoConfiguration为例:
// 表示这是一个配置类
@Configuration(proxyBeanMethods = false)
// 开启指定类的ConfigurationProperties功能
@EnableConfigurationProperties(ServerProperties.class)
// 判断当前是不是web应用,如果是,配置生效
@ConditionalOnWebApplication(type = ConditionalOnWebApplication.Type.SERVLET)
// 判断当前项目是否包含CharacterEncodingFilter类
// CharacterEncodingFilter:springmvc对于乱码的过滤
@ConditionalOnClass(CharacterEncodingFilter.class)
//判断项目中是否包含指定配置,(value = "enabled")默认值为true,(matchIfMissing = true)即使不存在,也是默认生效大的
@ConditionalOnProperty(prefix = "server.servlet.encoding", value = "enabled", matchIfMissing = true)
public class HttpEncodingAutoConfiguration {
/**
*已经和SpringBoot的配置文件映射
*/
private final Encoding properties;
/**
*只有一个有参构造器的情况下,参数的值就会从容器中拿
*/
public HttpEncodingAutoConfiguration(ServerProperties properties) {
this.properties = properties.getServlet().getEncoding();
}
/**
*给容器中添加一个组件,这个组件的某些值需要从properties中获取
* //@ConditionalOnMissingBean 判断容器有没有这个组件
*/
@Bean
@ConditionalOnMissingBean
public CharacterEncodingFilter characterEncodingFilter() {
CharacterEncodingFilter filter = new OrderedCharacterEncodingFilter();
filter.setEncoding(this.properties.getCharset().name());
filter.setForceRequestEncoding(this.properties.shouldForce(Encoding.Type.REQUEST));
filter.setForceResponseEncoding(this.properties.shouldForce(Encoding.Type.RESPONSE));
return filter;
}
ServerProperties类:
我们可以看到ServerProperties中的所有属性
那么是如何自动配置的呢?
还是以HttpEncodingAutoConfiguration为例:
@EnableConfigurationProperties(ServerProperties.class)
我们在HttpEncodingAutoConfiguration类展示图中可以看到这个注解,由此我们就关联到了ServerProperties类,而ServerProperties类中我们又可以通过注解
@ConfigurationProperties(prefix = "server", ignoreUnknownFields = true)
看到prefix = “server”.
那么这时候我们就可以通过yaml配置文件(我假设您已经知道此知识)看到[如下图]
由此,我们的脑海中就可以把这三个文件之间的关系串联到了一起~
自动配置类必须在一定的条件下才能生效;
我们可以在yaml中输入debug: true
之后运行项目,便可以在日志中打印出如下的内容
生效的:
没有生效的:
一句话总结 :
根据当前不同的条件判断,决定这个配置类是否生效!
一但这个配置类生效;这个配置类就会给容器中添加各种组件;
这些组件的属性是从对应的properties类中获取的,这些类里面的每一个属性又是和配置文件绑定的;
所有在配置文件中能配置的属性都是在xxxxProperties类中封装着;
配置文件能配置什么就可以参照某个功能对应的这个属性类