1 注解的概念

1.1 注解的定义

XML 长期以来,都是JAVA的常用的配置方式,效率高,但是随着项目越来越庞大,XML的内容也越来越复杂,维护成本变高,耦合度也高
Annotation 为了规避XML的维护成本,提供便捷性,便于开发维护,耦合度也低,但牺牲了一定效率。
Java注解又称Java标注,是Java语言5.0版本开始支持加入源代码的特殊语法元数据。为我们在代码中添加信息提供了一种形式化的方法,使我们可以在稍后某个时刻非常方便的使用这些数据。
Java语言中的类、方法、变量、参数和包等都可以被标注。和Javadoc不同,Java标注可以通过反射获取注解内容。在编译器生成类文件时,注解可以被嵌入到字节码中。Java虚拟机可以保留注解内容,在运行时可以获取到注解内容。

1.2 注解的本质

java.lang.annotation.Annotation 接口中有这么一句话,用来描述『注解』

  1. The common interface extended by all annotation types
  2. 所有的注解类型都继承自这个普通的接口(Annotation

没错,注解的本质就是一个继承了 Annotation 接口的接口。有关这一点,你可以去反编译任意一个注解类,你会得到结果的

  1. 一个注解准确意义上来说,只不过是一种特殊的注释而已,如果没有解析它的代码,它可能连注释都不如

而解析一个类或者方法的注解往往有两种形式,一种是编译期直接的扫描,一种是运行期反射。反射的事情我们待会说,而编译器的扫描指的是编译器在对 java 代码编译字节码的过程中会检测到某个类或者方法被一些注解修饰,这时它就会对于这些注解进行某些处理。
典型的就是注解 @Override,一旦编译器检测到某个方法被修饰了 @Override 注解,编译器就会检查当前方法的方法签名是否真正重写了父类的某个方法,也就是比较父类中是否具有一个同样的方法签名。
这一种情况只适用于那些编译器已经熟知的注解类,比如 JDK 内置的几个注解,而你自定义的注解,编译器是不知道你这个注解的作用的,当然也不知道该如何处理,往往只是会根据该注解的作用范围来选择是否编译进字节码文件,仅此而已。

解析一个类或者方法的注解往往有两种形式,一种是编译期直接的扫描,一种是运行期反射。反射的事情我们待会说,而编译器的扫描指的是编译器在对 java 代码编译字节码的过程中会检测到某个类或者方法被一些注解修饰,这时它就会对于这些注解进行某些处理。
典型的就是注解 @Override,一旦编译器检测到某个方法被修饰了 @Override 注解,编译器就会检查当前方法的方法签名是否真正重写了父类的某个方法,也就是比较父类中是否具有一个同样的方法签名。
这一种情况只适用于那些编译器已经熟知的注解类,比如 JDK 内置的几个注解,而你自定义的注解,编译器是不知道你这个注解的作用的,当然也不知道该如何处理,往往只是会根据该注解的作用范围来选择是否编译进字节码文件,仅此而已。

2 内置注解

Java 定义了一套注解,共有 7 个,3 个在 java.lang 中,剩下 4 个在 java.lang.annotation 中。
1、作用在代码的注解是

  • @Override - 检查该方法是否是重写方法。如果发现其父类,或者是引用的接口中并没有该方法时,会报编译错误。
  • @Deprecated - 标记过时方法。如果使用该方法,会报编译警告。
  • @SuppressWarnings - 指示编译器去忽略注解中声明的警告。

2、作用在其他注解的注解(或者说元注解)是:

  • @Retention - 标识这个注解怎么保存,是只在代码中,还是编入class文件中,或者是在运行时可以通过反射访问。
  • @Documented - 标记这些注解是否包含在用户文档中。
  • @Target - 标记这个注解应该是哪种 Java 成员。
  • @Inherited - 标记这个注解是继承于哪个注解类(默认 注解并没有继承于任何子类)

3、从 Java 7 开始,额外添加了 3 个注解:

  • @SafeVarargs - Java 7 开始支持,忽略任何使用参数为泛型变量的方法或构造函数调用产生的警告。
  • @FunctionalInterface - Java 8 开始支持,标识一个匿名函数或函数式接口。
  • @Repeatable - Java 8 开始支持,标识某注解可以在同一个声明上使用多次。

    3 元注解

    1、@Retention
    @Retention annotation指定标记注释的存储方式:

  • RetentionPolicy.SOURCE - 标记的注释仅保留在源级别中,并由编译器忽略。

  • RetentionPolicy.CLASS - 标记的注释在编译时由编译器保留,但Java虚拟机(JVM)会忽略。
  • RetentionPolicy.RUNTIME - 标记的注释由JVM保留,因此运行时环境可以使用它。

2、@Documented
@Documented 注释表明,无论何时使用指定的注释,都应使用Javadoc工具记录这些元素。(默认情况下,注释不包含在Javadoc中。)有关更多信息,请参阅 Javadoc工具页面。
3、@Target
@Target 注释标记另一个注释,以限制可以应用注释的Java元素类型。目标注释指定以下元素类型之一作为其值

  • ElementType.TYPE 可以应用于类的任何元素。
  • ElementType.FIELD 可以应用于字段或属性。
  • ElementType.METHOD 可以应用于方法级注释。
  • ElementType.PARAMETER 可以应用于方法的参数。
  • ElementType.CONSTRUCTOR 可以应用于构造函数。
  • ElementType.LOCAL_VARIABLE 可以应用于局部变量。
  • ElementType.ANNOTATION_TYPE 可以应用于注释类型。
  • ElementType.PACKAGE 可以应用于包声明。
  • ElementType.TYPE_PARAMETER
  • ElementType.TYPE_USE

4、@Inherited
@Inherited 注释表明注释类型可以从超类继承。当用户查询注释类型并且该类没有此类型的注释时,将查询类的超类以获取注释类型(默认情况下不是这样)。此注释仅适用于类声明。
5、@Repeatable
Repeatable Java SE 8中引入的,@Repeatable注释表明标记的注释可以多次应用于相同的声明或类型使用(即可以重复在同一个类、方法、属性等上使用)。

4 自定义注解

  1. @Target(value = {ElementType.FIELD, ElementType.METHOD})
  2. @Retention(value = RetentionPolicy.RUNTIME)
  3. public @interface TestAnnotation {
  4. String value();
  5. }
  1. public class MainAnnotation {
  2. @TestAnnotation("hello")
  3. public static void main(String[] args) {
  4. TestAnnotation testAnnotation = null;
  5. try {
  6. testAnnotation = MainAnnotation.class.getMethod("main", String[].class).getAnnotation(TestAnnotation.class);
  7. } catch (NoSuchMethodException e) {
  8. e.printStackTrace();
  9. }
  10. System.out.println(testAnnotation.value());
  11. }
  12. }

输出:

  1. hello