Annotation详解

2019-03-07

字数统计: 2.3k字 | 阅读时长: 8分

阅读量

虽然已经见过多次Annotation,也亲身自使用过自定义注解.但对此还是不慎寥寥.特整理文档于此,备忘一二.

Annotation是什么

Annotation中文翻译为注解.啥玩意呢?其实看着也不太明白.

官方解释如下:

Java注解用于为Java代码提供元数据。作为元数据，注解不直接影响你的代码执行，但也有一些
类型的注解实际上可以用于这一目的。Java注解是从Java5开始添加到Java 的。

懵吧,说实话看完之后还是各种似懂非懂.

看看百度百科怎么说的

java.lang.annotation，接口 Annotation。对于Annotation，是Java5的新特性，JDK5引入了
Metadata（元数据）很容易的就能够调用Annotations。Annotations提供一些本来不属于程序的数
据，比如：一段代码的作者或者告诉编译器禁止一些特殊的错误。An annotation 对代码的执行没有
什么影响。Annotations使用@annotation的形式应用于代码：类(class),属性(attribute),方法
(method)等等。一个Annotation出现在上面提到的开始位置，而且一般只有一行，也可以包含有任意
的参数。

综合以上的描述,大概可以看到Annotation其实说白了一般就是一行代码,可以包含任意参数.
Annotation能被用来为程序元素（类、方法、成员变量等）设置元数据。Annotaion不影响程序代码的执
行，无论增加、删除Annotation，代码都始终如一地执行。如果希望让程序中的Annotation起一定的作
用，只有通过解析工具或编译工具对Annotation中的信息进行解析和处理。

注意:以上的描述中总有意无意的说一个词叫做元数据,那么什么是元数据呢?

元数据是什么

元数据（Metadata）,又称中介数据、中继数据,为描述数据的数据（data about data）,主要是描
述数据属性（property）的信息,用来支持如指示存储位置、历史数据、资源查找、文件记录等功能.

示例如下：

1）编写文档：通过代码里标识的元数据生成文档

2）代码分析：通过代码里标识的元数据对代码进行分析

3）编译检查：通过代码里标识的元数据让编译器能实现基本的编译检查

Java平台元数据
注解Annotation就是java平台的元数据，是 J2SE5.0新增加的功能，该机制允许在Java 代码中添加自
定义注释，并允许通过反射（reflection），以编程方式访问元数据注释。通过提供为程序元素（类、方
法等）附加额外数据的标准方法，元数据功能具有简化和改进许多应用程序开发领域的潜在能力，其中包括
配置管理、框架实现和代码生成。

Annotation怎么用

简单的了解之后,我们先简单的写一个注解.

1
2
3

public @interface TestAnnotation {

}

如上所示,即使一个简单的注解.使用的话就直接在想要使用的类、方法、成员变量上直接使用即可.

@TestAnnotation
public class Demo {

}

注解通过@interface关键字进行定义,看着与接口的唯一区别是interface前多了个@符号.不过上面的
示例中的注解没有什么内容,无法有效的达到什么目的.那么为了具体使用它,我们必须先比较一下元注解的
概念.

元注解是什么

元注解是可以注解到注解上的注解，或者说元注解是一种基本注解，但是它能够应用到其它的注解上面.元注
解有@Retention、@Documented、@Target、@Inherited、@Repeatable5种。

@Retention
Retention 的英文意为保留期的意思。当@Retention 应用到一个注解上的时候，它解释说明了这个注解
的的存活时间。

它的取值如下：

1
2
3

RetentionPolicy.SOURCE 注解只在源码阶段保留,在编译器进行编译时它将被丢弃忽视。
RetentionPolicy.CLASS 注解只被保留到编译进行的时候,它不会被加载到JVM中。
RetentionPolicy.RUNTIME 注解可以保留到程序运行的时候,它会被加载进入到 JVM中，在程序运行时可以获取到它们。

具体使用如下

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

@Retention(RetentionPolicy.RUNTIME)
public @interface TestAnnotation {

}

说明TestAnnotation注解可以在程序运行时,获取到

@Documented
一个简单的Annotations标记注解，表示是否将注解信息添加在java文档中。

@Target
Target中文意思是目标,靶子.当使用了@Target时,说明对应的修饰注解是有指定目标的.

具体的取值范围如下:

ElementType.ANNOTATION_TYPE 可以给一个注解进行注解
ElementType.CONSTRUCTOR     可以给构造方法进行注解
ElementType.FIELD           可以给属性进行注解
ElementType.LOCAL_VARIABLE  可以给局部变量进行注解
ElementType.METHOD          可以给方法进行注解
ElementType.PACKAGE         可以给一个包进行注解
ElementType.PARAMETER       可以给一个方法内的参数进行注解
ElementType.TYPE            可以给一个类型进行注解，比如类、接口、枚举

一旦加有@Traget的标签被使用到了错误位置,会在编译期直接报错.

@Inherited
@Inherited指定被它修饰的Annotation将具有继承性——如果某个类使用了@Xxx注解（定义该
Annotation时使用了@Inherited修饰）修饰，则其子类将自动被@Xxx修饰。
@Repeatable
Repeatable 自然是可重复的意思。@Repeatable 是 Java 1.8 才加进来的，所以算是一个新的特性。

什么样的注解会多次应用呢？通常是注解的值可以同时取多个。

举个例子，一个人他既是程序员又是产品经理,同时他还是个画家.

@interface Persons {
	Person[] value();
}

@Repeatable(Persons.class)
@interface Person{
	String role default "";
}

@Person(role="artist")
@Person(role="coder")
@Person(role="PM")
public class SuperMan{
	
}

看着感觉很怪,也难以理解.先顺着往下看.

注解的属性

注解的属性也叫做成员变量。注解只有成员变量，没有方法。注解的成员变量在注解的定义中以“无形参的方
法”形式来声明，其方法名定义了该成员变量的名字，其返回值定义了该成员变量的类型。

@Retention(RetentionPolicy.RUNTIME)
public @interface TestAnnotation {

    int id();
    String name();
}

上面的代码定义了TestAnnotation注解下的两个属性,id与name.

但是在使用的时候也要同步的在注解内为对应的属性赋上值.

@TestAnnotation(id = 2, name = "yannis")
public class Demo {

    public void get_answer(){
    }
}

注意，在注解中定义属性时它的类型必须是8种基本数据类型外加类、接口、注解及它们的数组。

注解的属性可以有默认值,默认值使用default指定.

@Retention(RetentionPolicy.RUNTIME)
public @interface TestAnnotation {

    int id() default 1;
    String name() default "yannis";
}

若是注解内的属性已经指明了默认值,则使用他们的时候可以不需要在注解上为对应的属性赋值.

1	@TestAnnotation

1	@TestAnnotation()

1	@TestAnnotation(id = 2, name = "yannis")

如上三种皆可以.

特殊情况,若注解内仅有一个属性value,则在使用的时候,可以不指定属性名.

@Retention(RetentionPolicy.RUNTIME)
public @interface TestAnnotation {

    int value();
}

@TestAnnotation(2)
public class Demo {

}

注解的原理

注解本质是一个继承了 Annotation 的特殊接口，其具体实现类是 Java 运行时生成的动态代理类。而
我们通过反射获取注解时，返回的是 Java 运行时生成的动态代理对象 $Proxy1。通过代理对象调用自定
义注解（接口）的方法，会最终调用 AnnotationInvocationHandler 的 invoke 方法。该方法会从
memberValues 这个 Map 中索引出对应的值。而 memberValues 的来源是 Java 常量池。
——摘自《注解Annotation实现原理与自定义注解例子》

注解的使用

注解在创建完之后,永远不会主动干预代码行为,所以为了更好的利用注解,需要使用反射,获取相关注解.
首先可以通过 Class 对象的 isAnnotationPresent() 方法判断它是否应用了某个注解

1	public boolean isAnnotationPresent(Class<? extends Annotation> annotationClass) {}

然后通过 getAnnotation() 方法来获取 Annotation 对象。

1	public <A extends Annotation> A getAnnotation(Class<A> annotationClass) {}

或者是 getAnnotations() 方法。

1	public Annotation[] getAnnotations() {}

前一种方法返回指定类型的注解，后一种方法返回注解到这个元素上的所有注解。

如果获取到的 Annotation 如果不为 null，则就可以调用它们的属性方法了。比如

@TestAnnotation
public class Demo {

    public static void main(String[] args) {
        boolean hasAnnotationFlag = Demo.class.isAnnotationPresent(TestAnnotation.class);
        if(hasAnnotationFlag){
            TestAnnotation testAnnotation = Demo.class.getAnnotation(TestAnnotation.class);
            System.out.println(testAnnotation.id());
            System.out.println(testAnnotation.name());
        }
    }
}

至此关于注解的说明告一段落,后续若有其他的,再补充.
参考: https://blog.csdn.net/briblue/article/details/73824058
https://www.jianshu.com/p/4b79ce0b628c
https://www.jianshu.com/p/f90504e1d127