> 文章列表 > SpringBootApplication最详细注解

SpringBootApplication最详细注解

SpringBootApplication最详细注解

SpringBootApplication最详细注解

  • SpringBootApplication的注解分类
    • 1.Target
  • 2.Retention
    • 3.Document
  • 4.Inherited
    • 5.SpringBootConfiguration
  • 6.@EnableAutoConfiguration
      • 6.1@AutoConfigurationPackage这个注解
        • 6.1.1 Import
        • 6.1.2 AutoConfigurationpackages.Registrar.class
      • 6.2 AutoConfigurationImportSelector.class

SpringBootApplication的注解分类

先来看看SpringBootApplication里面是啥:
SpringBootApplication最详细注解
SpringBootApplication注解中的注解的详细解释

@Target(ElementType.TYPE) //注解的作用域
@Retention(RetentionPolicy.RUNTIME) //注解的生存周期
@Documented //可以被文档化
@Inherited //注解用于标注一个父类的注解是否可以被子类继承
@SpringBootConfiguration //声明为一个配置类 proxyBeanMethods是否开启bean代理,默认是true,从IOC容器中取;如果是false则每次获取都是一个新的实例
@EnableAutoConfiguration //开启自动配置---这个将是我们研究的重点
@ComponentScan(excludeFilters = { @Filter(type = FilterType.CUSTOM, classes = TypeExcludeFilter.class),
@Filter(type = FilterType.CUSTOM, classes = AutoConfigurationExcludeFilter.class) }) //包扫描的规则

1.Target

它是用于设定注解范围(被描述的注解可以用在什么地方)也急速hi限制了注解的作用域,那啥是注解的范围?注解的范围又有哪些呢?

@Target说明了Annotation所修饰的对象范围:Annotation可被用于 packages、types(类、接口、枚举、Annotation类型)、类型成员(方法、构造方法、成员变量、枚举值)、方法参数和本地变量(如循环变量、catch参数)。在Annotation类型的声明中使用了target可更加明晰其修饰的目标。

/ Class, interface (including annotation type), or enum declaration */TYPE,//类,接口,枚举类/ Field declaration (includes enum constants) */FIELD,//枚举/ Method declaration */METHOD,//只用于方法/ Formal parameter declaration */PARAMETER,/ Constructor declaration */CONSTRUCTOR,//构造方法/ Local variable declaration */LOCAL_VARIABLE,/ Annotation type declaration */ANNOTATION_TYPE,/ Package declaration */PACKAGE,/* Type parameter declaration @since 1.8*/TYPE_PARAMETER,/* Use of a type @since 1.8*/TYPE_USE

2.Retention

说明:Retention定义了被它注解了的注解可以保留多久,我们点如它的枚举类型看看

    /* Annotations are to be discarded by the compiler.*/SOURCE,/* Annotations are to be recorded in the class file by the compiler* but need not be retained by the VM at run time.  This is the default* behavior.*/CLASS,/* Annotations are to be recorded in the class file by the compiler and* retained by the VM at run time, so they may be read reflectively. @see java.lang.reflect.AnnotatedElement*/RUNTIME

source:注解只保留在源文件,当Java文件编译成class文件的时候,注解被遗弃;被编译器忽略

class:注解被保留到class文件,但jvm加载class文件时候被遗弃,这是默认的生命周期

runtime:注解不仅被保存到class文件中,jvm加载class文件之后,仍然存在

生命周期:runtime>class>source

没有了解过元注解的读者可以先去了解下元注解,再回头来看这篇文章会收获很多。

3.Document

注解表明这个注解应该被 javadoc工具记录. 默认情况下,javadoc是不包括注解的. 但如果声明注解时指定了 @Documented,则它会被 javadoc 之类的工具处理, 所以注解类型信息也会被包括在生成的文档中,是一个标记注解,没有成员。
SpringBootApplication最详细注解

4.Inherited

如果一个类用上了@Inherited修饰的注解,那么其子类也会继承这个注解
SpringBootApplication最详细注解

5.SpringBootConfiguration

SpringBootApplication最详细注解
SpringBootConfiguration与Spring中的@Configuation的作用基本一致,只不过@SpringBootConfiguration是springboot的注解,而@Configuration是spring的注解。

@Configuration 可以理解为一个Configuration就是对应的一个Spring的xml版的容器;(beans)

@configuation的作用,实现IOC的关键

@Configuation等价于

@Bean等价于

@ComponentScan等价于<context:component-scan base-package=”com.dxz.demo”/>

6.@EnableAutoConfiguration

自动装配
SpringBootApplication最详细注解
Target、Retention、Documentd就不用我过多描述了,我们来看看

6.1@AutoConfigurationPackage这个注解

顾名思义:他的中文意思就是自动配置包

我们再来看看@autoConfigurationPackage里面是啥
SpringBootApplication最详细注解

6.1.1 Import

这个注解类是用于导入配置类或者一些需要前置加载的类,你就当作Import 包 / 类

6.1.2 AutoConfigurationpackages.Registrar.class

这就话其实是引用AutoConfigurationpackages抽象类里面的Registrar类

我们点进去来看看:SpringBootApplication最详细注解
这个类实现了哪些接口我们就不管了,我们直接来看它重写的两个方法:在registerBeanDefinitions方法中,我们可以从左到右读他的方法体,register(register,新建一个PackageImports匿名对象,将metadata这个对象形参填入,然后使用getPackageNames方法填入数组)

其实这就是扫描主配置类同级目录以及子包,然后一一记录下来,并将相应的组件导入到springboot创建管理的容器中。

这里我们大概就明白了@AutoConfigurationPackage这个注解的意思了,其实就是自动扫描包,并记录下来的注解,不过我们要明白的是它的作用范围是同级的包,以及以下的包,如果有包在@AutoConfigurationPackage注解范围以上,那么@AutoConfigurationPackage就扫描不到这个包。

6.2 AutoConfigurationImportSelector.class

我们先看看它的结构:SpringBootApplication最详细注解
虽然说这个类的变量很多,但是我们仍然可以看到几个带有bean、filter的变量名,那我们可以肯定这个类和bean(类的代理或代言人(实际上确实是通过反射、代理来实现的))以及filter(过滤器)有乱七八糟的关系

猜想已经确定了,我们再来看看方法体,来看我们的猜想是不是正确的。


protected Class<?> getSpringFactoriesLoaderFactoryClass() {return EnableAutoConfiguration.class;
}

这个方法体的名字叫做(我的直译):得到spring的工厂加载工厂类

工厂加载工厂类?我咋感觉像是实现IOC的嘞?我们再来看看返回的是啥?

return EnableAutoConfiguration.class;

只能说SpringBoot框架做的真是太厉害了!