JAVA注解

概念

• 注解(Annotation)又叫标注，是从Java5开始增加的一种引用数据类型。

• 注解本质上就是代码中的特殊标记，通过这些标记可以在编译、类加载、 以及运行时执行指定的处理。

格式

• 访问修饰符 @interface 注解名称 {

　　注解成员;

}

• 自定义注解自动继承java.lang.annotation.Annotation接口。

• 通过@注解名称的方式可以修饰包、类、 成员方法、成员变量、构造方 法、参数、局部变量的声明等。

使用方式

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

如果注解只有一个参数成员，建议使用参数名为value，而类型只能是八 种基本数据类型、String类型、Class类型、enum类型及Annotation类型。

元注解概念

• 元注解是可以注解到注解上的注解，或者说元注解是一种基本注解，但 是它能够应用到其它的注解上面。

• 元注解主要有 @Retention、@Documented、@Target、@Inherited、 @Repeatable。

元注解@Retention

• @Retention 应用到一个注解上用于说明该注解的的生命周期，取值如下:

 • RetentionPolicy.SOURCE 注解只在源码阶段保留，在编译器进行编译时 它将被丢弃忽视。

• RetentionPolicy.CLASS 注解只被保留到编译进行的时候，它并不会被加 载到 JVM 中，默认方式。

• RetentionPolicy.RUNTIME 注解可以保留到程序运行的时候，它会被加载 进入到 JVM 中，所以在程序运行时可以获取到它们

元注解@Documented

使用javadoc工具可以从程序源代码中抽取类、方法、成员等注释形成一 个和源代码配套的API帮助文档，而该工具抽取时默认不包括注解内容。 • @Documented用于指定被该注解将被javadoc工具提取成文档。

定义为@Documented的注解必须设置Retention值为RUNTIME。

元注解@Inherited

@Target用于指定被修饰的注解能用于哪些元素的修饰，取值如下:

 元注解@Inherited

@Inherited并不是说注解本身可以继承，而是说如果一个超类被该注解标 记过的注解进行注解时，如果子类没有被任何注解应用时，则子类就继 承超类的注解。

 元注解@Repeatable

• @Repeatable表示自然可重复的含义，从Java8开始增加的新特性。

• 从Java8开始对元注解@Target的参数类型ElementType枚举值增加了两个:

• 其中ElementType.TYPE_PARAMETER 表示该注解能写在类型变量的声明 语句中，如:泛型。

• 其中ElementType.TYPE_USE 表示该注解能写在使用类型的任何语句中。

预制注解就是Java语言自身提供的注解，具体如下:

常用的预制注解如下: