Annotation 前言

Java注解是JSR 250的规范，在jdk1.5版本以后引入。

Java注解

Annotation(注解)是JDK1.5及之后版本引入的。它能够用于建立文档，跟踪代码中的依赖性，甚至执行基本编译时检查。注解是以‘@注解名’在代码中存在的，根据注解参数的个数，咱们能够将注解分为：标记注解、单值注解、完整注解三类。它们都不会直接影响到程序的语义，只是做为注解（标识）存在，咱们能够经过反射机制编程实现对这些元数据（用来描述数据的数据）的访问。另外，你能够在编译时选择代码里的注解是否只存在于源代码级，或者它也能在class文件、或者运行时中出现（SOURCE/CLASS/RUNTIME）。

元数据的做用

若是要对于元数据的做用进行分类，尚未明确的定义，不过咱们能够根据它所起的做用，大体可分为三类：

编写文档：经过代码里标识的元数据生成文档。

代码分析：经过代码里标识的元数据对代码进行分析。

编译检查：经过代码里标识的元数据让编译器能实现基本的编译检查

注解的高级应用

限制注解的使用范围

用@Target指定ElementType属性

public enum ElementType {
    // 用于类，接口，枚举但不能是注解
    TYPE,
    // 字段上，包括枚举值
    FIELD,
    // 方法，不包括构造方法
    METHOD,
    // 方法的参数
    PARAMETER,
    // 构造方法
    CONSTRUCTOR,
    // 本地变量或catch语句
    LOCAL_VARIABLE,
    // 注解类型(无数据)
    ANNOTATION_TYPE,
    // Java包
    PACKAGE
}

举例：

// 限制注解使用范围
@Target({ElementType.METHOD,ElementType.CONSTRUCTOR})
public @interface Greeting {
    // 使用枚举类型
    public enum FontColor {
        BLUE,RED,GREEN
    };
    String name();
    FontColor fontColor() default FontColor.RED;
}

注解保持性策略

在Java编译器编译时，它会识别在源代码里添加的注解是否还会保留，这就是RetentionPolicy。下面是Java定义的RetentionPolicy枚举：

public enum RetentionPolicy {
    // 此类型会被编译器丢弃
    SOURCE,
    // 此类型注解会保留在class文件中，但JVM会忽略它
    CLASS,
    // 此类型注解会保留在class文件中，JVM会读取它
    RUNTIME
}

编译器的处理有三种策略：

将注解保留在编译后的类文件中，并在第一次加载类时读取它；

将注解保留在编译后的类文件中，可是在运行时忽略它；

按照规定使用注解，可是并不将它保留到编译后的类文件中。

// 让保持性策略为运行时态，即将注解编码到class文件中，让虚拟机读取
@Retention(RetentionPolicy.RUNTIME)
public @interface Greeting {
    // 使用枚举类型
    public enum FontColor {
        BLUE,RED,GREEN
    };
    String name();
    FontColor fontColor() default FontColor.RED;
}

文档化功能

Java提供的Documented元注解跟Javadoc的做用是差很少的，其实它存在的好处是开发人员能够定制Javadoc不支持的文档属性，并在开发中应用。它的使用跟前两个也是同样的，简单代码示例以下：

// 让它定制文档化功能
// 使用此注解时必须设置RetentionPolicy为RUNTIME
@Documented
public @interface Greeting {
    // 使用枚举类型
    public enum FontColor {
        BLUE,RED,GREEN
    };
    String name();
    FontColor fontColor() default FontColor.RED;
}

标注继承

// 让它容许继承，可做用到子类
@Inherited
public @interface Greeting {
    // 使用枚举类型
    public enum FontColor {
        BLUE,RED,GREEN
    };
    String name();
    FontColor fontColor() default FontColor.RED;
}

读取注解信息的方法

属于重点，在系统中用到注解权限时很是有用，能够精确控制权限的粒度

注意：要想使用反射去读取注解，必须将Retention的值选为Runtime

import java.lang.annotation.Annotation;
import java.lang.reflect.Method;
 
//读取注解信息
public class ReadAnnotationInfoTest {
    public static void main(String[] args) throws Exception {
        // 测试AnnotationTest类，获得此类的类对象
        Class c = Class.forName("com.iwtxokhtd.annotation.AnnotationTest");
        // 获取该类全部声明的方法
        Method[] methods = c.getDeclaredMethods();
        // 声明注解集合
        Annotation[] annotations;
        // 遍历全部的方法获得各方法上面的注解信息
        for (Method method : methods) {
            // 获取每一个方法上面所声明的全部注解信息
            annotations = method.getDeclaredAnnotations();
            // 再遍历全部的注解，打印其基本信息
            System.out.println(method.getName());
            for (Annotation an : annotations) {
                System.out.println("方法名为：" + method.getName() + "其上面的注解为：" + an.annotationType().getSimpleName());
                Method[] meths = an.annotationType().getDeclaredMethods();
                // 遍历每一个注解的全部变量
                for (Method meth : meths) {
                    System.out.println("注解的变量名为：" + meth.getName());
                }
            }
        }
    }
}