Spring Boot 教程

@EnableAutoConfiguration 注解

@EnableAutoConfiguration 注解表示开启自动配置功能,该注解是 Spring Boot 框架最重要的注解,也是实现自动化配置的注解。

Spring 框架将试图猜测和配置您可能需要的 bean,通常根据您的类路径和定义的 bean 来应用自动配置类。例如,如果您在类路径上具有 tomcat-embedded.jar,则可能需要 TomcatServletWebServerFactory(除非已定义自己的ServletWebServerFactory bean)。

当使用 @SpringBootApplication 时,会自动启用上下文的自动配置,因此添加该注释不会产生额外的效果。

自动配置会尝试尽可能智能化,并且在您定义更多自己的配置时会自动退出。您可以手动 exclude() 任何您不想应用的配置(如果您没有访问权限,可以使用 excludeName())。您还可以通过 spring.autofigre.exit 属性将它们排除在外。自动配置始终在注册用户定义的 bean 之后应用。

带有 @EnableAutoConfiguration 注释的类的包(通常通过 @SpringBootApplication)具有特殊的意义,通常用作 “default”。例如,在扫描 @Entity 类时将使用它。通常建议您将 @EnableAutoConfiguration(如果您未使用 @SpringBootApplication)放在根包中,以便可以搜索所有子包和类。

自动配置类是普通的 Spring @Configuration Bean。它们使用 SpringFactoriesLoader 机制定位(针对此类)。通常,自动配置 bean 是 @Conditional Bean(最经常使用 @ConditionalOnClass 和 @ConditionalOnMissing Bean注解)。

为了进一步了解 @EnableAutoConfiguration 注解,我们可以查看它的源码:

@Target({ElementType.TYPE})
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Inherited
@AutoConfigurationPackage
@Import({AutoConfigurationImportSelector.class})
public @interface EnableAutoConfiguration {
    String ENABLED_OVERRIDE_PROPERTY = "spring.boot.enableautoconfiguration";
    Class<?>[] exclude() default {};
    String[] excludeName() default {};
}

查看上面源码,@EnableAutoConfiguration 注解也是一个组合注解。其中:

  • exclude():排除特定的自动配置类,使它们永远不会被应用.

  • excludeName():排除特定的自动配置类名,使它们永远不会被应用.

通常情况下,我们不需要显示使用 @EnableAutoConfiguration 注解。因为在 @SpringBootApplication 注解上面声明了 @EnableAutoConfiguration 注解。源码如下:

@Target({ElementType.TYPE})
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Inherited
@SpringBootConfiguration
@EnableAutoConfiguration
@ComponentScan(
    excludeFilters = {@Filter(
    type = FilterType.CUSTOM,
    classes = {TypeExcludeFilter.class}
), @Filter(
    type = FilterType.CUSTOM,
    classes = {AutoConfigurationExcludeFilter.class}
)}
)
public @interface SpringBootApplication {
    // ...
}
说说我的看法
全部评论(
没有评论
关于
本网站属于个人的非赢利性网站,转载的文章遵循原作者的版权声明,如果原文没有版权声明,请来信告知:hxstrive@outlook.com
公众号