1.3、SpringBoot注解分析
@SpringBootApplication: 申明让springboot自动给程序进行必要的配置,这是一个复合注解:
里面包含了@Configuration, @EnableAutoConfiguration 和 @ComponentScan三个配置。
@Target({ElementType.TYPE}) //元注解是用来修饰注解声明的注解,可以控制被修饰的注解的特性。
/**
*@Target: 用来声明被修饰的注解可以用在什么位置。可以在@Target的属性中设置ElementType类型的数组来指
*定可以使用的位置。如果不用此元注解修饰,默认注解可以用在任意位置。
*/
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Inherited
@SpringBootConfiguration
@EnableAutoConfiguration
@ComponentScan(
@Target({ElementType.TYPE})
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Inherited
这四个注解是原注解,大家可以参考 : https://blog.csdn.net/c17315377559/article/details/101282730
@Configuration, @EnableAutoConfiguration 和 @ComponentScan
1、@Configuration注解是Spring里面的注解,在Spring里,它表示该类也是一个配置类。进入@Configuration注解,我们发现他是被@Component所修饰的,所以该配置类也是一个组件。
2、@EnableAutoConfiguration注解表示开启自动配置功能。进入@EnableAutoConfiguration中,发现它仍然是一个组合注解。里面包含以下两个注解。
//@EnableAutoConfiguration注解下包含
@AutoConfigurationPackage
@Import({AutoConfigurationImportSelector.class})
3、@Import注解表明给容器导入一个组件,这个组件的内容就由Registrar.class传入的对象决定。进入到该对象中,我们发现metadata源数据包含@SpringBootApplication修饰的类,包名等信息。
@AutoConfigurationPackage注解的主要作用就是将@SpringBootApplication修饰的类的同包,子孙包下的所有组件都扫描到Spring容器中
//Registrar.class类中所引用的部分
static class Registrar implements ImportBeanDefinitionRegistrar, DeterminableImports {
Registrar() {
}
public void registerBeanDefinitions(AnnotationMetadata metadata, BeanDefinitionRegistry registry) {
AutoConfigurationPackages.register(registry, (String[])(new AutoConfigurationPackages.PackageImports(metadata)).getPackageNames().toArray(new String[0]));
}
public Set<Object> determineImports(AnnotationMetadata metadata) {
return Collections.singleton(new AutoConfigurationPackages.PackageImports(metadata));
}
}
4、@Import({AutoConfigurationImportSelector.class})表示根据上述所说@Import的作用是导入组件,导入自动配置选择器的组件。当我们进入到AutoConfigurationImportSelector中。
autoConfigurationMetadata 表示的是需要导入组件的全路径名
annotationMetadata 表示的是被@SpringBootApplication标识类的信息
Configurations 包含了非常多的自动配置类,这些类都会被导入到Spring容器中
getCandidateConfigurations 会帮我们去spring-boot-autoconfigure-2.2.0.RELEASE/META-INF/spring.factories中获取EnableAutoConfiguration指定的值。将指定的值导入到Spring容器中,帮我们进行自动配置的功能。
protected AutoConfigurationImportSelector.AutoConfigurationEntry getAutoConfigurationEntry(AnnotationMetadata annotationMetadata) {
if (!this.isEnabled(annotationMetadata)) {
return EMPTY_ENTRY;
} else {
AnnotationAttributes attributes = this.getAttributes(annotationMetadata);
List<String> configurations = this.getCandidateConfigurations(annotationMetadata, attributes);
configurations = this.removeDuplicates(configurations);
Set<String> exclusions = this.getExclusions(annotationMetadata, attributes);
this.checkExcludedClasses(configurations, exclusions);
configurations.removeAll(exclusions);
configurations = this.getConfigurationClassFilter().filter(configurations);
this.fireAutoConfigurationImportEvents(configurations, exclusions);
return new AutoConfigurationImportSelector.AutoConfigurationEntry(configurations, exclusions);
}
}
5、@ComponentScan用来表示将指定包(如果未指定就是将当前类所在包及其子孙包)加入SpringIOC的包扫描,本质上等于<context:component-scan>配置。
注意:请严谨遵守springboot的自动自动配置约束。
SpringBoot在开发过程中为了简化开发过程中,为了简化开发配置,往往会在SpringBoot启动类下创建若干个子包,这样子包中的注解就都可以扫描到(@EnableAutoConfiguration注解不支持此功能),并且可以实现依赖关系的自动配置。
此时保存在cn.mldn.mldnbool下的所有子包中配置的注解都可以被spring容器自动扫描,如果不在指定的子包下,程序启动类就需要配置 @ComponentScan注解设置扫描包。
可以简单地将@SpringBootApplication理解为:@SpringBootApplication = @EnableAutoConfiguration + @ComponentScan(扫描父包)