【Spring Boot 源码学习】@EnableAutoConfiguration 注解

/**
 * 启用Spring应用程序上下文的自动配置，尝试猜测和配置可能需要的Bean。
 * 自动配置类通常基于你的类路径和你已定义的Bean来应用。
 * 例如，如果你在类路径中引入了tomcat-embedded.jar，那么很可能希望有一个
 * TomcatServletWebServerFactory（除非你已经定义了自己的ServletWebServerFactory Bean）。
 * 
 * 当使用@SpringBootApplication注解时，上下文的自动配置会自动启用，因此添加此注解没有额外的效果。
 * 
 * 自动配置试图尽可能智能，并且随着你定义更多自己的配置而退避。
 * 你可以手动使用exclude()方法排除任何你不想应用的配置（如果无法访问它们，
 * 则可以使用excludeName()方法）。你还可以通过spring.autoconfigure.exclude属性来排除它们。
 * 自动配置总是在用户自定义的Bean注册之后应用。
 * 
 * 使用@EnableAutoConfiguration注解标注的类所在的包通常具有特殊意义，并且经常被用作"默认"。
 * 例如，在扫描@Entity类时将使用该包。通常建议将@EnableAutoConfiguration（如果你没有使用
 * @SpringBootApplication）放在根包中，以便可以搜索所有子包和类。
 * 
 * 自动配置类是常规的Spring @Configuration Bean。它们是通过ImportCandidates 和
 * SpringFactoriesLoader 机制（针对这个类进行索引）来定位的。通常，自动配置Bean是
 * @Conditional Bean（通常使用@ConditionalOnClass和@ConditionalOnMissingBean注解）。
 *
 * @author Phillip Webb
 * @author Stephane Nicoll
 * @since 1.0.0
 * @see ConditionalOnBean
 * @see ConditionalOnMissingBean
 * @see ConditionalOnClass
 * @see AutoConfigureAfter
 * @see SpringBootApplication
 */
@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Inherited
@AutoConfigurationPackage
@Import(AutoConfigurationImportSelector.class)
public @interface EnableAutoConfiguration {

    /**
     * 可以用于覆盖自动配置是否启用的环境属性
     */
    String ENABLED_OVERRIDE_PROPERTY = "spring.boot.enableautoconfiguration";

    /**
     * 排除特定的自动配置类，以使它们永远不会应用
     * @return 要排除的类
     */
    Class<?>[] exclude() default {};

    /**
     * 排除特定的自动配置类名，以使它们永远不会应用
     * @return 要排除的类名
     * @since 1.3.0
     */
    String[] excludeName() default {};

}

// 通过 @SpringBootApplication 排除 DataSourceAutoConfiguration
@SpringBootApplication(exclude = DataSourceAutoConfiguration.class)
public class DemoApplication {

}

// 通过 @EnableAutoConfiguration 排除 DataSourceAutoConfiguration
@Configuration
@EnableAutoConfiguration(exclude = DataSourceAutoConfiguration.class)
public class DemoConfiguration {
}

/**
 * 指示导入一个或多个组件类，通常是@Configuration类。
 * 
 * 提供与Spring XML中的<import/>元素相当的功能。允许导入@Configuration类、
 * ImportSelector 和 ImportBeanDefinitionRegistrar 实现，以及普通的组件类
 * （从4.2开始；类似于AnnotationConfigApplicationContext.register）。
 * 
 * 在导入的 @Configuration 类中声明的@Bean定义应该通过@Autowired注入来访问。
 * 可以将bean本身进行自动装配，也可以将声明bean的配置类实例进行自动装配。
 * 后一种方法允许在@Configuration类方法之间进行显式且友好的导航（适用于IDE）。
 * 
 * 可以在类级别或作为元注解进行声明。
 * 
 * 如果需要导入XML或其他非 @Configuration 的bean定义资源，请使用 @ImportResource 注解来实现。
 *
 * @author Chris Beams
 * @author Juergen Hoeller
 * @since 3.0
 * @see Configuration
 * @see ImportSelector
 * @see ImportBeanDefinitionRegistrar
 * @see ImportResource
 */
@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface Import {

    /**
     * @Configuration、ImportSelector、ImportBeanDefinitionRegistrar 或常规组件类可以用来进行导入。
     */
    Class<?>[] value();

}

/**
 * 将包注册到 AutoConfigurationPackages 中。
 * 当没有指定基础包或基础包类时，将会注册带有注解类的包。
 *
 * @author Phillip Webb
 * @since 1.3.0
 * @see AutoConfigurationPackages
 */
@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Inherited
@Import(AutoConfigurationPackages.Registrar.class)
public @interface AutoConfigurationPackage {

    /**
     * 应该注册到 AutoConfigurationPackages 的基础包。
     * 使用 basePackageClasses 作为基于类型安全的替代方法，而不是基于字符串的包名。
     * 
     * @since 2.3.0
     */
    String[] basePackages() default {};

    /**
     * @AutoConfigurationPackage 提供了一种类型安全的替代方案，用于指定要注册到 AutoConfigurationPackages 的包。
     * 考虑在每个包中创建一个特殊的无操作标记类或接口，除了被此属性引用外，不具备任何其他功能。
     * 
     * @since 2.3.0
     */
    Class<?>[] basePackageClasses() default {};

}

@Import(AutoConfigurationPackages.Registrar.class)