【Java】Annotation 注解

Annotation 注解

注解是一种元数据 MetaData,从JDK5开始

在Java代码中是一个特殊的标记，可以在编译，类加载，运行时读取，执行对应的处理

程序可以在不改变原有逻辑的基础上嵌入一些补充信息，代码分析工具，开发工具，部署工具通过补充信息

进行验证和部署

注解可以使用在任何写代码的地方：

- 包

- 类

- 构造器

- 方法

- 成员变量

- 参数

- 局部变量的声明

信息被保存在 KV对中

在我们学过的J2SE中,注解的使用目的很简单，只是为了标记功能

- 标记过时方法和字段 @Deprecated

- 标记编译器警告忽略 @SuppressWarnings

- 标记方法是重写父类的方法 @Override

EE/Andriod 的用途更为强大，用来配置程序的切面，配置注入参数信息

在以后的发展中，注解将会越来越重要，现阶段的框架就是

注解 + 反射 + 设计模式 

摆脱繁琐的XML配置

文档注解 Document Annotation

@author 声明开发者名字，多个开发者使用逗号分隔　　- @author 张三，李四，王五

@version 开发版本　　-@version 1.0

@see 相关资料地址

@since 从哪个版本开始有的

@param 对参数的说明

@return 对返回值的说明

@exception 对可能抛出的异常的说明

编译检查注解 CompileCheck Annotation

- JDK内置的三个基本注解

@Override 标记为重写的父类方法，仅标记方法

@Deprecated 比较为已过时的方法，但是不妨碍调用，可标记在类和方法上

@SuppressWarnings 抑制编译器警告，对波浪警告提示烦了？试试这个玩意儿

自定义注解实现

public @interface MyAnnotation { // 声明类一样声明注解 @interface

    // 注解的成员属性 定义在午餐方法中声明 属性只能声明默认的 protected public 这三种
    
    // 方法名即是属性的标识名，方法的返回类型就是属性的数据类型
    
    // 类型可以声明为 8个基本类型、类类型、枚举类型、注解类型？、和前面数据类型的数组
    
    // 可以声明default 为遍历指定初始值
    
    // 只有一个，且是最重要的参数 可使用value表示、 在注解的时候可以不用写 value = ? 直接写值即可
    
    // 定义的注解有配置参数，则必须指定参数值，也就是要赋值 除非存在默认初始值
    
    // 自定义注解必须配上注解的信息处理流程才有意义？
    String name();
}

// 使用注解
@MyAnnotation(name = "hello")
class AC{
    
}

声明default 默认可不需要赋值，适用于默认配置，我不想配置也可以用

- 注解声明为@interface

- 内部定义成员，不是方法！！！ 通常使用value表示

- 可以default声明默认值

- 自定义注解如果没有成员，那么只是一个标记注解

JDK元注解 Meta - Annotation

- 用于注解注解的注解【给注解上注解！】

4个标准元注解 

@Retention

@Target

@Documented

@Inherited

元数据？对现有数据的一个修饰 String name = "阿伟"

最重要的是阿伟这个值，元数据只是对他的修饰，

name是值的标识，String是值的类型，这些被称为元数据

所以也就是说，元注解是对注解的修饰规范

@Retention　　注解的生命周期

该注解包含一个RetentionPolicy保留策略的枚举类

用于标注注解的保留策略

枚举项：

- RetentionPolicy.SOURCE 保留在源码中，编译和运行丢弃

- RetentionPolicy.CLASS 保留在字节码中，JVM运行丢弃 ，这是默认的保留策略

- RetentionPolicy.RUNTIME 运行保留，程序可以反射获取注解信息

@Target　　可注解的位置

该注解包含一个元素类型的枚举类数组

用于标注注解的可标注位置

枚举项：

- TYPE 

- FIELD

- METHOD

- PARAMETER

- CONSTRUCTOR

- LOCAL_VARIABLE

- ANNOTATION_TYPE

- PACKAGE

- TYPE_PARAMETER　　JDK8特性　　可注解类类型 

- TYPE_USE　　JDK8特性　　注解使用类类型

@Documented　　可生成文档的

被注解的注解类可以被JavaDoc识别，并提取生成文档

@Inherited　　可继承的

给自定义的注解类注解，自定义注解具有可继承性，

当一个父类注解了自定义注解，其子类继承了父类也会拥有该注解

JDK8　　

可重复注解？

类型注解？

重复注解意思是我们希望在一个地方可以使用多次一样的注解

但是很明显这不允许！

JDK8之前采用注解数组的办法实现兼容

在注解时使用此注解

JDK8增加了一个新的注解，用于这种情形

@Repeatable　　可重复的

要注意的是两者的注解的@Retention生命周期、@Target可标注的位置必须一致，还有@Inherited