Java：注解Annotation（元数据）

---

本文内容：

• 注解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()中调用！】

结果是：

补充：

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

---