Java学习——注解

摘要：本文主要介绍了Java开发常用的注解，以及如何自定义注解。

部分内容来自以下博客：

https://www.cnblogs.com/Qian123/p/5256084.html

https://www.cnblogs.com/xd502djj/p/2610040.html

https://www.cnblogs.com/peida/p/3036689.html

什么是注解以及为什么要使用注解

从JDK1.5开始，JAVA增加了对元数据（描述数据属性的信息）的支持。其实说白就是代码里的特殊标志，这些标志可以在编译，类加载，运行时被读取，并执行相应的处理，以便于其他工具补充信息或者进行部署。

注解的分类

按运行机制

源码注解，这种注解只在源码阶段存在存在。

编译注解，注解不但在源码中存在，而且在class文件中也存在，JDK自带的注解就是属于这种类型的注解。

运行时注解，即便到在运行阶段仍然起作用的注解，第三方提供的注解大部分是属于这种类型的注解。

按来源分类

JDK自带的注解。

第三方的注解。

自定义注解。

按功能分类

普通注解，对程序和代码进行标注的注解。

元注解，对注解标记的注解。

Java中常见的注解

JDK自带注解

@Override：表示覆盖或重写父类的方法。

@Deprecated：表示该方法已经过时了，不建议使用。

@SuppressWarnings：表示忽略指定警告。

第三方注解

有很多第三方框架会有自己的注解，比如Spring框架中的@AutoWired注解。

自定义注解

开发者自己定义的注解。

元注解

元注解的作用就是负责注解其他注解。

@Target

作用：

用于描述注解的使用范围，即被描述的注解可以用在什么地方。

取值：

ElementType.PACKAGE：包。

ElementType.TYPE：接口、类、枚举。

ElementType.FIELD：字段、枚举的常量。

ElementType.METHOD：方法。

ElementType.PARAMETER：方法参数。

ElementType.CONSTRUCTOR：构造函数。

ElementType.LOCAL_VARIABLE：局部变量。

ElementType.ANNOTATION_TYPE：注解。

@Retention

作用：

用于描述注解的生命周期，即被描述的注解在什么范围内有效。

取值：

RetentionPolicy.SOURCE：注解仅存在于源码中，在class字节码文件中不包含。

RetentionPolicy.CLASS：默认的保留策略，注解会在class字节码文件中存在，但运行时无法获得。

RetentionPolicy.RUNTIME：注解会在class字节码文件中存在，在运行时可以通过反射获取到。

@Inherited

作用：

用于说明这个注解是可以被继承的。如果一个使用了@Inherited修饰的注解类型被用于一个class，则这个注解将被用于该class的子类。

注意：

@Inherited是会被注解标记的class的子类所继承。类并不从它所实现的接口继承注解，方法并不从它所重载的方法继承注解。

当@Inherited的注解的@Retention是RetentionPolicy.RUNTIME时，反射API会增强这种继承性。如果我们使用反射去查询一个@Inherited的注解时，反射代码检查将展开工作：检查class和其父类，直到发现指定的注解，或者到达类继承结构的顶层。

@Documented

作用：

用于描述注解可以被放到文档里。

自定义注解

使用@interface自定义注解时，自动继承了java.lang.annotation.Annotation接口，由编译程序自动完成其他细节。在定义注解时，不能继承其他的注解或接口。

@interface用来声明一个注解，其中的每一个方法实际上是声明了一个配置参数。方法的名称就是参数的名称，返回值类型就是参数的类型（返回值类型只能是基本类型、Class、String、Enum）。可以通过default来声明参数的默认值。

自定义注解格式

 public @interface 注解名称 {
     // 若干参数
     修饰符 类型 名称() default 默认值;
 }

注解参数

修饰符：

只能用public或默认（default）这两个访问权限修饰符。

类型：

只能用byte、short、char、int、long、float、double、boolean八种基本数据类型和String、Enum、Class、Annotations等数据类型，以及这一些类型的数组。

名称：

可以自定义，如果只有一个参数成员，最好把参数名称设为value，不要忘了后加小括号。

default 默认值：

注解元素必须有确定的值，要么在定义注解的默认值中指定，要么在使用注解时指定，非基本类型的注解元素的值不可为null。因此，使用空字符串或0作为默认值是一种常用的做法。这个约束使得处理器很难表现一个元素的存在或缺失的状态，因为每个注解的声明中，所有元素都存在，并且都具有相应的值，为了绕开这个约束，我们只能定义一些特殊的值，例如空字符串或者负数，表示某个元素不存在，在定义注解时，这已经成为一个习惯用法。

自定义注解并使用

自定义注解代码如下：

 @Target({ElementType.METHOD, ElementType.PACKAGE, ElementType.TYPE})
 @Retention(RetentionPolicy.SOURCE)
 @Documented
 @Inherited
 public @interface TestAnnotation {
     public String value() default "";
     public String name();
     public int age();
 }

使用注解的代码如下：

 @TestAnnotation(age = 0, name = "")
 public class Demo {
     public static void main(String[] args) {
         System.out.println();
     }
 }