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. 属性的返回值类型有下列取值

1. 基本数据类型
2. String
3. 枚举
4. 注解
5. 以上类型的数组

2. 定义了属性，在使用时需要给属性赋值

1.  如果定义属性时，使用default关键字给属性默认初始化值，则使用注解时，可以不进行属性的赋值。
2.  如果只有一个属性需要赋值，并且属性的名称是value，则value可以省略，直接定义值即可。
3.  数组赋值时，值使用{}包裹。如果数组中只有一个值，则{}可以省略

4.4、元注解：

用于描述注解的注解(@Target、@Retention、@Inherited、@Documented)

@Target：描述注解能够作用的位置

1. @Target(ElementType.TYPE) //作用于类、接口、枚举，但不能是注解
2. @Target(ElementType.FIELD) //作用于 字段、枚举
3. @Target(ElementType.METHOD) //作用于 方法、不能是构造方法
4. @Target(ElementType.PARAMETER) //作用于 方法的参数
5. @Target(ElementType.CONSTRUCTOR) //作用于 构造函数
6. @Target(ElementType.LOCAL_VARIABLE) // 局部变量，作用于本地变量或者catch语句
7. @Target(ElementType.ANNOTATION_TYPE) //作用于 注解
8. @Target(ElementType.PACKAGE) / /作用于 包

@Retention：描述注解的生命周期

1. @Retention(RetentionPolicy.SOURCE) //注解仅存在于源码中，在class字节码文件中不包含
2. @Retention(RetentionPolicy. CLASS) // 默认的保留策略，注解会在class字节码文件中存在，但运行时无法获得
3. @Retention(RetentionPolicy.RUNTIME) // 在运行时可以通过反射获取到，JVM会读取注解，同时保存在class文件中

@Documented：描述注解是否被抽取到api文档中
@Inherited：描述注解是否被子类继承