Spring Boot自动配置原理

Spring Boot启动的时候加载了主配置类,开启了自动配置功能@EnableAutoConfiguration

@EnableAutoConfiguration的作用:
利用@Import({AutoConfigurationImportSelector.class})给容器导入了一些组件。可以查看selectImports方法的内容。

List<String> configurations 
    = this.getCandidateConfigurations(annotationMetadata, attributes);

该方法的作用是扫描所有jar包类路径下的META-INF/spring.factories。把扫描到的这些文件的内容包装成properties对象。从properties中获取到EnableAutoConfiguration.class类的类名对应的值,然后把它们添加在容器中。

将类路径下META-INF/spring-factories里配置的所有EnableAutoConfiguration的值加入到容器中。用它们做自动配置。

每一个自动配置类进行自动配置功能。

以HttpEncodingAutoConfiguration为例解释自动配置原理

@Configuration(
    proxyBeanMethods = false
)
@EnableConfigurationProperties({HttpProperties.class})
@ConditionalOnWebApplication(
    type = Type.SERVLET
)
@ConditionalOnClass({CharacterEncodingFilter.class})
@ConditionalOnProperty(
    prefix = "spring.http.encoding",
    value = {"enabled"},
    matchIfMissing = true
)
public class HttpEncodingAutoConfiguration {

@Configuration:表示这是一个配置类,和以前编写的配置文件一样,也可以给容器中添加组件。

@EnableConfigurationProperties:启动指定类的ConfigurationProperties功能。将配置文件中对应的值和HttpEncoding绑定起来了。并把这个类加入到IOC容器中。
在这个程序中我们指定的类是HttpProperties.class。我们能配置的属性都来自于这个类。

public static class Encoding {
        public static final Charset DEFAULT_CHARSET;
        private Charset charset;
        private Boolean force;
        private Boolean forceRequest;
        private Boolean forceResponse;
        private Map<Locale, Charset> mapping;

根据这个类我们可以这样写我们的配置文件:

spring.http.encoding.charset=utf-8
spring.http.encoding.force=true
...
@ConfigurationProperties(
    prefix = "spring.http"
)
public class HttpProperties {

从配置文件中获取指定的值和bean的属性进行绑定。

所有在配置文件中能配置的属性都是在...properties类中封装着。配置文件能配置什么就可以参照某一个功能的属性类。

@ConditionalOnWebApplication:首先需要解释@Conditional标签。该标签根据不同的条件进行条件判断。如果满足指定的条件,指定的配置类中的配置才会生效。该标签的作用就是判断当前应用是否为web应用。

@ConditionalOnClass:判断当前项目有没有指定的类。

@ConditionalOnProperty:判断配置文件中是否存在某个配置。即使配置文件中不存在该配置,也是默认生效的。

根据当前不同的条件进行判断,决定这个配置类是否生效。给容器中添加一个组件。一旦这个配置类生效,这个配置类就会给容器中添加各种组件。这些组件的属性是从对应的propertises类中获取的。propertises中的每一个属性又是和配置文件绑定的。

Spring Boot的精髓:

  1. Spring Boot启动会加载大量的自动配置类。
  2. 我们需要看我们需要的功能有没有Spring Boot写好的自动配置类。
  3. 如果有这个自动配置类中配置了那些组件。只要有我们需要就组件,就不需要配置了。如果没有就需要我们自己写了。
  4. 给容器中的自动配置类添加组件时,会从properties中获取某些属性。我们就可以在配置文件中指定这些属性的值。

xxxAutoConfiguration:自动配置类
给容器中添加组件
xxxProperties:封装配置文件中的相关属性

细节

@Conditional派生注解(Spring注解版原生的@Conditional作用)
作用:必须是@Conditional指定的条件成立,才给容器中添加组件,配置类里的所有内容才生效。

@Conditional扩展注解 作用(判断是否满足当前指定的条件)
@ConditionalOnJava 系统的Java版本是否符合要求
@ConditionalOnBean 容器中存在指定的Bean
@ConditionalOnMissingBean 容器中不存在指定的Bean
@ConditionalOnExpression 满足SpEL表达式指定
@ConditionalOnClass 系统中有指定的类
@ConditionalOnMissingClass 系统中没有指定的类
@ConditionalOnSingleCandidate 容器中只有一个指定的Bean,或者这个Bean是首选Bean。
@ConditionalOnProperty 系统中指定的属性是否有指定的值
@ConditionalOnResource 类路径下是否存在指定资源文件

自动配置类必须在一定的条件下才能生效。

如何知道那些配置类生效:
在配置文件中写上

debug=true

控制台就会输出那些配置类使用了,那些配置类没有使用。控制台的输出结果中有positive matches表示那些类启动了,而negative matches表示没有匹配成功的自动配置类。

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 204,053评论 6 478
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,527评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 150,779评论 0 337
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,685评论 1 276
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,699评论 5 366
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,609评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,989评论 3 396
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,654评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,890评论 1 298
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,634评论 2 321
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,716评论 1 330
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,394评论 4 319
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,976评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,950评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,191评论 1 260
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 44,849评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,458评论 2 342

推荐阅读更多精彩内容