Java 四种元注解（注解的注解）

前面我们介绍了注解的概念，也解释了什么是元数据。这篇博客，我们来介绍解释注解的元数据，元注解。Java中有四种元注解：@Retention，@Target，@Documented和@inherited. 接下来，我们一一来介绍这些注解。

• @Retention注解：只能用于修饰一个Annotation定义，用于指定该Annotation的生命周期。@Retention包含一个RetentionPolicy类型的成员变量，使用@Retention注解时必须为该变量成员赋值。下面是这三种保留策略的说明：

1. RetentionPolicy.SOURCE: 在源文件（.java文件），即源文件中保留，编译时期注解将被丢弃。
2. RetentionPolicy.CLASS: 在class文件中有效，即.class文件中保留。当JVM解释.class字节码时，不会保留该注解。这是默认策略。
3. RetentionPolicy.RUNTIME: 在运行时有效，即运行时保留。当运行Java程序时，JVM会保留注解，Java程序可以通过反射获取该注解。

• 自定义注解：

import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;

@Retention(RetentionPolicy.RUNTIME)
public @interface MyAnnotation {
    String [] values();
    int number();
}

• 演示@Retention(value = RetentionPolicy.RUNTIME)的使用：

import org.junit.jupiter.api.Test;

import java.lang.annotation.Annotation;

public class AnnotationTest1 {
    @Test
    @MyAnnotation(values = {"value1", "value2"}, number = 10)
    public void test1(){
    }

    @Test
    public void test2() throws NoSuchMethodException {
    	//类Class的对象，表示到加载内存里的运行时类（AnnotationTest1）
        Class clazz = AnnotationTest1.class;
        //通过方法类对象实例调用getAnnotations()去获取注解数组
        Annotation [] annotations = clazz.getMethod("test1", null).getAnnotations();
        for (Annotation annotation : annotations) {
            System.out.println(annotation.toString());
        }
    }
}

• 输出：

@org.junit.jupiter.api.Test()
@EnumAndAnnotation.MyAnnotation(values=[value1, value2], number=10)

我们可以看到注解到test1方法的两个注解都被打印了出来。说明不仅我们自定义的@MyAnnotation被@Retention注解了,而且策略为RetentionPolicy.RUNTIME，并且@Test注解也是相同的情况。

• @Target注解：用于修饰Annotation定义，指定被修饰的Annotation能用于修饰哪些程序元素。@Target包含一个数组成员变量，该值如下（Java 8版本）：
  TYPE,
  FIELD,
  METHOD,
  PARAMETER,
  CONSTRUCTOR,
  LOCAL_VARIABLE,
  ANNOTATION_TYPE,
  PACKAGE,
  TYPE_PARAMETER,
  TYPE_USE
  顾名思义，由名称可知，数组中包含哪些值，就可以注解到对应的地方。

• @Documented注解： 用于指定被该元注解修饰的Annotation类将被javadoc工具提取成文档。默认情况下，javadoc是不包括注解，@Documented注解必须要和策略为RUNTIME的@Retention注解一起使用。

• @Inherited注解：被它修饰的Annotation将具有继承性。如果某个类使用了被@Inherited修饰的Annotation，则其子类将自动具有该注解。

• @Inherited注解的实例代码：

import java.lang.annotation.*;

@Inherited
@Retention(RetentionPolicy.RUNTIME)
@Target({ElementType.TYPE,ElementType.METHOD})
public @interface MyAnnotation {
    String [] values();
    int number();
}

package EnumAndAnnotation;

@MyAnnotation(values = {"value"}, number = 10)
public class Person {
}

class Student extends Person{}

	@Test
    public void test3(){
        Class clazz = Student.class;
        Annotation[] annotations = clazz.getAnnotations();
        for (Annotation annotation : annotations) {
            System.out.println(annotation.toString());
        }
    }

• 输出：

@EnumAndAnnotation.MyAnnotation(values=[value], number=10)

• 即使Student类没有显示地被注解@MyAnnotation，但是它的父类Person被注解，而且@MyAnnotation被@Inherited注解，因此Student类自动有了该注解。