JDK的元Annotation
@Retention
用于指定被修饰的Annotation可以保留多长时间,@Retention包含一个RetentionPolicy类型的value成员变量,value成员变量的值只能是如下三个:
RetentionPolicy.CLASS:编译器把Annotation记录在class文件中。当运行Java程序时,JVM不可获取Annotation信息。
RetentionPolicy.RUNTIME: 编译器把Annotation记录在class文件中。当运行Java程序时,JVM也可获取Annotation信息,程序 可以通过反射获取Annotation信息。
RetentionPolicy.SOURCE:Annotation只保留在源代码中,编译器直接丢弃这种Annotation。
@Retention(RetentionPolicy.RUNTIME)
public @interface TestRetention {
}
@Target
@Target用于指定被修饰的Annotation能用于修饰那些程序单元。@Target元Annotation包含一个名为value的成员变量,该成员变量的值只能是如下几个:
ElementType.TYPE : 指定该策略的Annotation可以修饰类、接口(包括注解类型)或枚举定义。
ElementType.FIELD : 指定该策略的Annotation只能修饰成员变量。
ElementType.METHOD : 指定该策略的Annotation只能修饰方法定义。
ElementType.PARAMETER : 指定该策略的Annotation可以修饰参数。
ElementType.CONSTRUCTOR : 指定该策略的Annotation只能修饰构造器。
ElementType.LOCAL_VARIABLE : 指定该策略的Annotation只能修饰局部变量。
ElementType.ANNOTATION_TYPE : 指定该策略的Annotation只能修饰Annotation。
ElementType.PACKAGE : 指定该策略的Annotation只能修饰包定义。
@Target(ElementType.TYPE)
public @interface TestTarget {
}
@Documented
@Documented用于指定该元Annotation修饰的Annotation类将被javadoc工具提取成文档。
@Documented
public @interface TestDocumented {
}
@Inherited
@Inherited元Annotation指定被它修饰的Annotation将具有继承性—如果某个类使用了@Xxx注解修饰,则其子类将自动被@Xxx修饰。