元注解

前言：

什么是注解：　

　　注解其实就是代码里的特殊标记，这些标记可以在编译,类加载,运行时被读取,并执行相应的处理。通过使用注解,程序员可以在不改变原有逻辑的情况下，在源文件中嵌入一些补充信息。代码分析工具、开发工具和部署工具可以通过这些补充信息进行验证或者进行部署。

使用注解时要在其前面增加@符号,并把该注解当成一个修饰符使用。用于修饰它支持的程序元素

什么是元注解：

　　元注解就是解释注解的注解

 

1、@Target

用于描述注解的作用范围，即注解在哪用

　　属性值如下：java.lang.annotation.ElementType

　　　　1.1、TYPE:用于描述类、接口(包括注解类型) 或enum声明

　　　　1.2、FIELD:用于描述域即类成员变量

　　　　1.3、METHOD:用于描述方法

　　　　1.4、PARAMETER:用于描述参数

　　　　1.5、CONSTRUCTOR:用于描述构造器（构造方法上）

　　　　1.6、LOCAL_VARIABLE:用于描述局部变量

　　　　1.7、PACKAGE:用于描述包

　　　　1.8、ANNOTATION_TYPE:用在描述注释上

　　　　1.9、TYPE_PARAMETER:1.8版本开始，自定义类型参数上

　　　　1.10、TYPE_USE:1.8版本开始，对类型注解

案例：

@Target({ElementType.METHOD,ElementType.TYPE})
public @interface AddLog {
    String value();
}

AddLog注解表示：用在类、接口、enum和方法上

 

2、@Retention

用于描述注解的生命周期

　　属性值如下：java.lang.annotation.RetentionPolicy

　　　　1.1、SOURCE:在源文件中有效（即源文件保留，检查时）

　　　　1.2、CLASS:在class文件中有效（即class保留，编译时）

　　　　1.3、RUNTIME:在运行时有效（即运行时保留，运行时）

案例：

@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
public @interface AddLog {
    String value();
}

RetentionPolicy.RUNTIME：这样注解处理器可以通过反射，获取到该注解的属性值，从而去做一些运行时的逻辑处理。

 

3、@Documented

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

案例：

@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface AddLog {
    String value();
}

 

4、@Inherited

用于表示某个被标注的类型是被继承的。如果一个使用了@Inherited修饰的annotation类型被用于一个class，则这个annotation将被用于该class的子类。（子类会继承父类注解）