文章内容
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之类的工具处理