java注解
java注解
java代码的3个阶段
java注解图解
1、定义：
注解（Annotation），也叫元数据。一种代码级别的说明。它是JDK1.5及以后版本引入的一个特性，与类、接口、枚举是在同一个层次。它可以声明在包、类、字段、方法、局部变量、方法参数等的前面，用来对这些元素进行说明，注释。
概念描述：
JDK1.5之后的新特性
说明程序的
使用注解：@注解名称
2、作用分类：
①编写文档：通过代码里标识的注解生成文档【生成文档doc文档】
②代码分析：通过代码里标识的注解对代码进行分析【使用反射】
③编译检查：通过代码里标识的注解让编译器能够实现基本的编译检查【Override】
3、JDK中预定义的一些注解
@Override ：检测被该注解标注的方法是否是继承自父类(接口)的
@Deprecated：该注解标注的内容，表示已过时
@SuppressWarnings：压制警告。一般传递参数all @SuppressWarnings("all")
4、自定义注解
4.1、格式：
元注解
public @interface 注解名称{
属性列表;
}
@interface用于定义注解接口，接口中只能定义成员变量，且定义的成员变量必须以（）结尾，可以有default关键字来指定默认值，如果没有default，则在使用注解时必须赋值。
4.2、本质：
注解本质上就是一个接口，该接口默认继承Annotation接口
public interface MyAnno extends java.lang.annotation.Annotation {}
4.3、属性：
接口中的抽象方法
要求：
1. 属性的返回值类型有下列取值
- 基本数据类型
- String
- 枚举
- 注解
- 以上类型的数组
2. 定义了属性，在使用时需要给属性赋值
- 如果定义属性时，使用default关键字给属性默认初始化值，则使用注解时，可以不进行属性的赋值。
- 如果只有一个属性需要赋值，并且属性的名称是value，则value可以省略，直接定义值即可。
- 数组赋值时，值使用{}包裹。如果数组中只有一个值，则{}可以省略
4.4、元注解：
用于描述注解的注解(@Target、@Retention、@Inherited、@Documented)
@Target：描述注解能够作用的位置
- @Target(ElementType.TYPE) //作用于类、接口、枚举，但不能是注解
- @Target(ElementType.FIELD) //作用于 字段、枚举
- @Target(ElementType.METHOD) //作用于 方法、不能是构造方法
- @Target(ElementType.PARAMETER) //作用于 方法的参数
- @Target(ElementType.CONSTRUCTOR) //作用于 构造函数
- @Target(ElementType.LOCAL_VARIABLE) // 局部变量，作用于本地变量或者catch语句
- @Target(ElementType.ANNOTATION_TYPE) //作用于 注解
- @Target(ElementType.PACKAGE) / /作用于 包
@Retention：描述注解的生命周期
- @Retention(RetentionPolicy.SOURCE) //注解仅存在于源码中，在class字节码文件中不包含
- @Retention(RetentionPolicy. CLASS) // 默认的保留策略，注解会在class字节码文件中存在，但运行时无法获得
- @Retention(RetentionPolicy.RUNTIME) // 在运行时可以通过反射获取到，JVM会读取注解，同时保存在class文件中
@Documented：描述注解是否被抽取到api文档中
@Inherited：描述注解是否被子类继承
