Annotation是JDK 5.0以后提供对元数据的支持，可以在编译、加载和运行时被读取，并执行相应的处理。所谓Annotation就是提供了一种为程序元素设置元数据的方法，可用于修饰包、类、构造器、方法、成员变量、参数和局部变量的声明，这些信息被存储在Annotation的“name=value”对中。



Annotation能被用来为程序元素设置元数据，比如一段代码的作者或者告诉编译器禁止一些特殊的错误，不会影响代码的执行。


使用Annotation时要在其前面增加【@】符号，并把该Annotation当作一个修饰符使用，用于修饰它支持的程序元素。



定义一个Annotation类型使用【@interface】关键字，定义一个Annotation类型与定义一个接口非常像（只是多了一个@符号）。

public @interface TestAnnotation {
}

注解的属性

4个元注解

@Documented用于描述其它类型的annotation应该被作为被标注的程序成员的公共API，因此可以被例如javadoc此类的工具文档化。
@Documented是一个标记注解，没有成员。




@Documented
@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.ANNOTATION_TYPE)
public @interface Documented {

}



@Inherited也是一个标记注解，阐述了某个被标注的类型是被继承的。
如果一个使用了@Inherited修饰的annotation类型被用于一个class，则这个annotation将被用于该class的子类。
注意：@Inherited类型是被标注过的class的子类所继承。类并不从它所实现的接口继承annotation，方法并不从它所重载的方法继承annotation。
当@Inherited annotation类型标注的annotation的Retention是RetentionPolicy.RUNTIME，则反射API增强了这种继承性。如果我们使用java.lang.reflect去查询一个@Inherited annotation类型的annotation时，反射代码检查将展开工作：检查class和其父类，直到发现指定的annotation类型被发现，或者到达类继承结构的顶层。




@Documented
@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.ANNOTATION_TYPE)
public @interface Inherited {

}

在java.lang包中提供了3个基本Annotation的用法，可以通过查看API文档来了解。



1、@Override：限定重写父类方法。值得注意的是，@Override只能修饰方法，不能修饰其他程序元素。

@Target(ElementType.METHOD)

@Retention(RetentionPolicy.SOURCE)
public @interface Override {

}


2、@Deprecated：标示已过时，用于表示某个程序元素已过时，当其他程序使用已过时的类、方法时，编译器将会给出警告。

@Documented

@Retention(RetentionPolicy.RUNTIME)
@Target(value={CONSTRUCTOR, FIELD, LOCAL_VARIABLE, METHOD, PACKAGE, PARAMETER, TYPE})
public @interface Deprecated {

}


3、@SuppressWarnings：抑制编译器警告，表示被该Annotation修饰的代码取消显示指定的编译器警告。

@Target({TYPE, FIELD, METHOD, PARAMETER, CONSTRUCTOR, LOCAL_VARIABLE})

@Retention(RetentionPolicy.SOURCE)
public @interface SuppressWarnings {
    String[] value();

}

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

@Target({ ElementType.METHOD, ElementType.FIELD })
@Retention(RetentionPolicy.RUNTIME)
public @interface MyAnno {
    // 属性
    String name();

    String[] jobs();

    String addr() default "广州";

}



public class Person {

    @MyAnno(jobs = { "码农", "架构师" }, name = "白乾涛")
    public int age = 26;



    @MyAnno(jobs = "工作", name = "包青天")
    private void fun() {
        System.out.println("方法");
    }


}




public class Test {

    public static void main(String[] args) throws Exception {
        //1 获取对应类的Class类对象
        Class<Person> clazz = Person.class;

        //2 根据Class类对象获取Method或Field
        Field field = clazz.getField("age");
        Method method = clazz.getDeclaredMethod("fun");

        //3 通过Class类对象、Metod对象、Field对象,获取对应的注解信息.
        MyAnno myAnno1 = field.getAnnotation(MyAnno.class);
        MyAnno myAnno2 = method.getAnnotation(MyAnno.class);



        System.out.println(Arrays.toString(myAnno1.jobs()));
        System.out.println(myAnno2.name());
    }


}