@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 { // ... }