Java的Annotation（3）

JDK的元Annotation

前面我们提到，java.lang下提供了三个基本的Annotation，分别是：@Override,@Deprecated,@SurppressWarnings.除此之外，java.lang.annotation包下还提供了四个元Annotation。

@Retention

• 只能用于修饰一个Annotation定义，作用是指定这个Annotation可以保留多长时间。它包含一个RetentionPolicy类型的value成员变量，所以使用@Retention时必须为value变量指定值，并且只能时如下三个：
  • RetentionPolicy.CLASS:编译器把注释记录在class文件中。当运行java程序时，JVM不再保留注释。这也是默认值。
  • RetentionPolicy.RUNTIME：也会记录在class文件中，不过当运行java程序是，JVM会保留注释，程序可以通过反射获取该注释。
  • RetentionPolicy.SOURCE：编译器直接丢弃这种策略的注释。

@Target

• 和@Retention一样，用于修饰一个Annotation方法，作用是指定被修饰的Annotation能用于修饰哪些程序元素，比如是方法啊，还是类啊，还是成员变量啊，等。所以，其取值也被限定，只能是如下几类：
  • ElementType.ANNOTTION_TYPE:只能修饰Annotation
  • ElementType.CONSTRUCTOR:修饰构造器
  • ElementType.FIELD：修饰成员变量
  • ElementType.LOCAL_VARIABLE：局部变量
  • ElementType.METHOD：只能修饰方法定义
  • ElementType.PACKAGE：修饰包定义
  • ElementType.PARAMETER：修饰参数
  • ElementType.TYPE：可以修饰类，接口（包括注释类型）或枚举定义

@Documented

• 用于指定该Annotation修饰的Annotation类将被javadoc工具提取成文档

@Inherited

• @Inherited元Annotation指定被它修饰的Annotation将具有继承性：如果某个类使用了A Annotation修饰，则其子类将自动具有A注释。
  
  判断某个类是否包含有某注释的方法（以TestInheritable类举例）：

TestInheritable.class.isAnnotationPresent(Inheritable.class)
//Inheritable是一个定义Annotation的类

使用APT处理Annotation

APT是一种注释处理工具，他对源代码文件进行检测，找出其中的Annotation后对Annotation进行额外的处理。