本文内容：

• 注解 Annotation 的介绍
• 基本注解的用法

• 自定义注解

首发日期：2018-07-28

注解 Annotation 的介绍

• Annotation 是代码中的特殊标记，能够在编译、类加载、运行时被识别（需要设置），并根据不同的 Annotation 来执行不同的处理。
• Annotation 可以修饰包、类、构造器、函数、成员变量、局部变量的声明、参数等程序元素。Annotation 帮助这些元素来设置元数据，程序从元数据中获取信息来处理这些元素。

元数据可以描述代码间关系或者代码与其它资源的关系，比如说在 web.xml 中需要将请求路径跟处理请求的 servlet 对应起来，比如说在 Hibernate 中需要.hbm 文件来描述实体类与数据表之间的映射关系。元数据可以提供某些信息来协助我们程序的运行。

在 Java 中，Annotation 就可以帮我们在代码层面上去设置元数据，而不必需要去使用一些例如 web.xml 的文件来描述。

基本注解的用法

如何使用注解修饰元素：

• 通常来说，在修饰目标的上一行进行注解，比如。修饰成员变量也是如此。

常用的基本的 Annotation:

@Override ：指明下面修饰的函数必须是重写父类的函数的函数，如果修饰的函数不在父类中存在，那么会报错。

@Deprecated ：标明函数、类等元素已过时，效果是在使用已经过时的元素时会警告。

@SuppressWarnings：抑制修饰的元素发生警告（warning），效果是修饰过后，编译器不会提示警告。

@SafeVarargs【Java7 新增】：如果把一个没有定义泛型的集合，赋给一个有定义泛型的集合，会发生堆污染，会报错。@SafeVarargs 可以抑制这个报错。

@FunctionalInterface【Java8 新增】：用来限制修饰的接口必须是一个函数式接口，不然会报错。

元 Annotaion: 修饰注解的注解

• @Retention: 指定 Annotation 的保留方式，保留方式不同，会影响能被使用的位置。比如如果需要通过反射获取信息，那么应该允许运行时还能获取。
• @Retention(RetentionPolicy.CLASS): 默认值，代表把注解留在 class 文件中，程序运行后，JVM 将无法获取注解。【由于里面的成员变量名为 value，所以可以省去 参数名 ="xxx"，如果不是 value, 那么不可以省去！】
• @Retention(RetentionPolicy.RUNTIME): 代表把注解留在 class 文件中，程序运行后，JVM 可以通过反射来获取注解。
• @Retention(RetentionPolicy.SOURCE): 只留在源代码中，JVM 不会获取到注解。
• @Target: 限制 Annotaion 能修饰哪些元素
• @Target(ElemenetType.ANNOTATION_TYPE): 指定被修饰的 Annotaion 只能用来修饰 Annotaion
• @Target(ElemenetType.FIELD): 指定被修饰的 Annotaion 只能用来修饰成员变量
• @Target(ElemenetType.CONSTRUCTOR): 指定被修饰的 Annotaion 只能用来修饰构造器
• @Target(ElemenetType.METHOD): 指定被修饰的 Annotaion 只能用来修饰函数
• @Target(ElemenetType.LOCAL_VARIABLE): 指定被修饰的 Annotaion 只能用来修饰局部变量
• @Target(ElemenetType.PACKAGE): 指定被修饰的 Annotaion 只能用来修饰包
• @Target(ElemenetType.PARAMETER): 指定被修饰的 Annotaion 只能用来修饰参数
• @Target(ElemenetType.TYPE): 指定被修饰的 Annotaion 只能用来修饰类、接口（包括注解类型）或枚举定义
• @Documented: 指定 Annotaion 是否能包含到 javadoc 生成的文档中。
• @Inherited: 指定 Annotaion 具有继承性，父类定义了这个注解，那么子类也会继承这个注解。

自定义注解

• 自定义注解跟定义接口差不多，在 interface 的基础上加一个 @

• 当就是这么空，不写东西的时候，是一个标记型的注解，标记型的注解功能比较简单，通常只能用来标记特殊的元素从而进行处理。比如 Override 就是一个标记型的注解。

• 注解可以定义成员变量，这些成员变量以声明无形参函数的形式存在，返回值是变量的类型，函数名是变量的名字。注解上定义的成员变量只能是 String、数组、Class、枚举类、注解。成员变量可以提供更多的元数据信息。

定义了成员变量后，在使用的时候需要给成员变量赋值（成员变量名为 value 时，可以省去 value="xxx"，但是这个名字时，不可以省略）。在没有成员变量时，可以单写注解名，要赋值时就要用上括号。

• 如果某些成员变量不需要每次都赋值，可以给它设置默认值。成员变量可以有默认值，在变量的后面加上 default 默认值.

注解处理器：

对于 Java 自带的注解，Java 有自己的注解处理器去处理。但自定义的注解，需要自己去定义注解处理器，自己去调用注解处理器去处理。所以，注解处理器本质上也是一个普通函数，不过它的工作主要是处理注解罢了。

在学会怎么定义注解处理器之前先了解几个前置知识：

• 所有注解的父接口都是 Annotation。
• 一个注解，只有它的存在时间足够我们才能使用它，所以如果我们想使用注解处理器，注解首先需要使用 @Retention(RetentionPolicy.RUNTIME) 修饰。
• java.lang.reflect 包中存在一些能够实现反射功能的工具类。
• java.lang.reflect 包中有一个 AnnotationElement 接口, 它声明了一系列可以获取注解的函数，并且它有几个实现类，如下所见，所以你可以在类、构造函数等对象中调用声明好的函数来获取注解。。
• getAnnotation(注解.class): 获取对应类型的注解
• getAnnotations(): 获取所有注解
• getDeclaredAnnotations()：获取直接注解，忽略继承过来的注解。
• isAnnotationPresent(注解.class): 判断对应类型的注解是否存在

获取注解：

.... 其他对象就演示了。

操作注解：通常来说，都是处理注解带上的信息。

小例子

不知道你有没有了解过 org.junit.Test 这个东西，这个可以让你直接运行你想要运行的函数（可以称为单元测试？）。而不需要你创建一个 main() 去调用。

下面做一个示例，来实现类似的功能：

1. 创建注解：

2. 使用注解：

3. 调用注解处理器：【这里使用了 org.junit.Test 来调用，你也可以在 main() 中调用！】

结果是：

补充：

• 上面的小例子中并没有使用注解的成员变量，但事实上，使用成员变量也同样只是获取里面的信息来做更多处理罢了，这就依靠个人去应用了。