Spring Boot四个元注解

1、@Target

说明了Annotation所修饰的对象范围

public enum ElementType {

    /** 用于描述Class, interface (包括 annotation type),或 enum 声明 */    TYPE,
    /** 用于描述域Field(包含枚举常量(enum)) */    FIELD,
    /** 用于描述方法Method */    METHOD,
    /** 用于描述参数parameter */    PARAMETER,
    /** 用于描述构造器Constructor */    CONSTRUCTOR,
    /** 用于描述局部变量Local variable */    LOCAL_VARIABLE,
    /** Annotation type declaration */    ANNOTATION_TYPE,
    /** 用于描述包Package */    PACKAGE,
    /**
     * Type parameter declaration
     * @since 1.8
     */    TYPE_PARAMETER,
    /**
     * Use of a type
     * @since 1.8
     */    TYPE_USE
}

2、@Retention

定义了注解(Annotation)被保留的时间长短

public enum RetentionPolicy {

    /**
     * 说明所修饰的注解(Annotation)在编译时将被丢弃(即源文件保留)
     */    SOURCE,
    /**
     * 注解(Annotation)将由编译器记录在类文件中,但不需要在运行时由VM保留。这是默认行为(即class保留)
     */    CLASS,
    /**
     * 注解(Annotation)将由编译器记录在类文件中,并在运行时由VM保留,因此可以反射地读取注解。
     *(即运行时保留)
     * @see java.lang.reflect.AnnotatedElement
     */    RUNTIME
}

3、@Inherited

指示自动继承注解(Annotation)类型。如果继承的元注解(meta-annotation)出现在注解(Annotation)类型声明上,并且用户在类声明上查询注解(Annotation)类型,并且类声明没有此类型的注解(Annotation),则将自动查询类的超类以查找注解(Annotation)类型。此过程将重复,直到找到此类型的注解(Annotation),或者到达类层次结构(对象)的顶部。如果没有超类具有此类型的注解(Annotation),则查询将指示相关类没有此类注解(Annotation)
注意:如果元注解(meta-annotation)类型用于注释类以外的任何内容,则此元注释类型无效。还要注意,这个元注释只会导致注释从超类继承;实现接口上的注解(Annotation)没有效果

4、@Documented

定义注解会被javadoc或者其他类似工具文档化。默认情况下,javadoc是不包括注解的。但如果声明注解时指定了@Documented,则它会被 javadoc之类的工具处理

发表评论