Java 注解（Annotation）

1. 什么是Java注解（Annotation）

　　- Java 注解（Annotation）又称 Java 标注，是 JDK5.0 引入的一种注释机制。用来标注在Java语言中的类、方法、变量、参数等

　　- 和 Javadoc 不同，Java 注解可以通过反射获取标注内容。在编译器生成类文件时，标注可以被嵌入到字节码中。Java 虚拟机可以保留标注内容，在运行时可以获取到标注内容 。

　　- 支持自定义Java注解

2. Java注解（Annotation）的架构：

　　- 一个 Annotation 和一个 RetentionPolicy 关联，可以理解成每一个Annotation对象都有一个RetentionPolicy属性

　　- 一个 Annotation 和1~n个 ElementType 关联，可以理解成每一个Annotation对象可以有若干个ElementType属性

 3. ElementType.java：

package java.lang.annotation;

public enum ElementType {
    TYPE,               /* 类、接口（包括注释类型）或枚举声明  */

    FIELD,              /* 字段声明（包括枚举常量）  */

    METHOD,             /* 方法声明  */

    PARAMETER,          /* 参数声明  */

    CONSTRUCTOR,        /* 构造方法声明  */

    LOCAL_VARIABLE,     /* 局部变量声明  */

    ANNOTATION_TYPE,    /* 注释类型声明  */

    PACKAGE             /* 包声明  */
}

　　-  ElementType 是 Enum 枚举类型，它用来指定 Annotation 的类型。例如，若一个 Annotation 对象是 METHOD 类型，则该 Annotation 只能用来修饰方法。

4. RetentionPolicy.java：

package java.lang.annotation;
public enum RetentionPolicy {
    SOURCE,            /* Annotation信息仅存在于编译器处理期间，编译器处理完之后就没有该Annotation信息了  */

    CLASS,             /* 编译器将Annotation存储于类对应的.class文件中。默认行为  */

    RUNTIME            /* 编译器将Annotation存储于class文件中，并且可由JVM读入 */
}

　　- RetentionPolicy 是 Enum 枚举类型，它用来指定 Annotation 的策略。通俗点说，就是不同 RetentionPolicy 类型的 Annotation 的作用域不同。

　　　　- 若 Annotation 的类型为 SOURCE，则意味着：Annotation 仅存在于编译器处理期间，编译器处理完之后，该 Annotation 就没用了。 例如，" @Override" 标志就是一个 Annotation。当它修饰一个方法的时候，就意味着该方法覆盖父类的方法；并且在编译期间会进行语法检查！编译器处理完后，"@Override" 就没有任何作用了。

　　　　- 若 Annotation 的类型为 CLASS，则意味着：编译器将 Annotation 存储于类对应的 .class 文件中，它是 Annotation 的默认行为。

　　　　- 若 Annotation 的类型为 RUNTIME，则意味着：编译器将 Annotation 存储于 class 文件中，并且可由JVM读入。

5. 注解（Annotation）通用定义：

@Documented
@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
public @interface MyAnnotation1 {
}

　　- 这里使用@interface自定义一个注解为MyAnnotation1，定义好该注解后就可以通过@MyAnnotation1使用该注解

　　　　- @interface：该注解的作用是定义一个注解。通过@interface定义注解后，该注不能继承其他的注解后接口，且实现过程都是由编译器完成的

　　　　- @Documented：该注解的作用是使类和方法的Annotation出现在javadoc中。定义注解时，@Documented可有可无，若没有定义，默认是不出现在javadoc中

　　　　- @Target(ElementType.TYPE)：该注解的作用是指定声明的注解是修饰在哪里的，定义时可有可无，若有则只能修饰所定义的地方，若无则可以修饰在任何地方

　　　　- @Retention(RetentionPolicy.RUNTIME)：该注解的作用是指定声明的注解的策略，定义时可有可无，默认为RetentionPolicy.CLASS

6. Java常用的注解（Annotation）：

　　- 元注解：作用在其他注解的注解

　　　　- @Documented：所标注的内容，可以出现在javadoc中

　　　　- @Inherited：只能被用来标注“Annotation”类型，所标注的注解具有继承性

　　　　- @ Retention：只能被用来标注“Annotation”类型，用来指定注解的RetentionPolicy属性

　　　　- @Target：只能被用来标注“Annotation”类型，用来指定注解的ElementType属性

　　　　- @SafeVarargs：java7开始支持，忽略任何使用参数为泛型变量的方法或构造函数调用产生的警告

　　　　- @FunctionalInterface - Java 8 开始支持，标识一个匿名函数或函数式接口

　　　　- @Repeatable - Java 8 开始支持，标识某注解可以在同一个声明上使用多次

　　- 作用在代码的注解

　　　　- @Deprecated：所标注的内容不再被建议使用，例如有些过期的方法

　　　　- @Override：只能标注方法，表示该方法覆盖父类中的方法

　　　　- @SuppressWarnings：无视所标注内容产生的警告

7. 注解（Annotation）的作用：

　　- 编译检查：如@SuppressWarnings, @Deprecated 和 @Override 都具有编译检查作用。

　　- 反射中使用：

　　- 根据注解生成帮助文档：通过给 Annotation 注解加上 @Documented 标签，能使该 Annotation 标签出现在 javadoc 中。

　　- 能够帮忙查看代码：通过 @Override, @Deprecated 等，我们能很方便的了解程序的大致结构。