Java 元注解

学习Android APT需要我们具备自定义注解以及注解处理器的相关知识，这里简单介绍下Java元注解。注解是在JDK1.5后引入的，包含了4种元注解：@Target @Retention @Documented @Inherited
1. @Target
用于声明注解的作用位置，即使用对象。在下面的 ElementType 枚举中我们可以清楚看到 @Target 所能接受的值以及对应的使用范围。其中需要注意的是TYPE_PARAMETER和TYPE_USE是在JDK 1.8后引入的。

public enum ElementType {
    /** 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
用于声明注解的保留范围，相当于作用域，即在什么时候可以使用。
SOURCE表示该注解只能保留在源代码中，在编译时会被丢弃，不会在class字节码文件中出现
CLASS表示该注解可以保留在class字节码文件中，即编译时可用
RUNTIME表示该注解可在代码运行时保留，可以通过反射获得

public enum RetentionPolicy {
    /**
     * 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
}

3. @Documented
表示拥有该注解的元素可以被 javadoc 这类的工具文档化。

4.@Inherited
表示允许子类继承父类中的注解。