注解
-
概念:说明程序。
-
定义:注解(Annotation),也叫元数据。一种代码级别的说明。它是JDK1.5以后版本引入的一个特性与类、接口、枚举在同一层次。它可以声明在包、类、字段、方法、局部变量、方法参数的前面、用来对这些元素进行说明,注释。
-
功能分类:
- 编写文档:通过代码中标识的元数据生成文档
- 代码分析:通过代码中标识的元数据对代码进行分析
- 编译检查:通过代码中标识的元数据让编译器能够实现基本的编译检查
-
JDK中预定义的一些注解
- @Override:用来检测该注解标注的方法是否继承自父类
- @Deprecated:该注解标注的内容,表示已过时
- @SuppressWarnings:压制警告
-
自定义注解
- 格式:
- 元注解
- public @interface 注解名称{}
- 本质:一个接口
- 属性:接口中可以定义个成员方法
- 要求:
- 属性的返回值类型
- 基本数据类型
- String
- 枚举
- 注解
- 以上类型数组
- 定义了属性,需要在使用时赋值
- 如果定义属性时,使用default关键字给属性默认的初始化值,则使用注解时,可以不进行属性的赋值。
- 如果只有一个属性需要赋值,并且属性的名称是value,则value可以省略,直接定义即可。
- 使用数组赋值时,值使用{}包裹,如果数组中只有一个只,则可以将{}省略
- 属性的返回值类型
- 要求:
- 元注解:用于描述注解的注解
- @Target:描述注解可以作用的位置
- ElementType取值
- TYPE:可以作用于类上
- METHOD:可以作用于方法上
- FIELD:可以作用于成员变量上
- ElementType取值
- @Retention:描述注解被保留的阶段
- RetentionPolicy取值
- RUNTIME:当前被描述的注解,会保留到class字节码文件中,并被JVM读取到
- RetentionPolicy取值
- @Documented:描述注解是否被抽取到api文档中
- @Inherited:描述注解是否被子类继承
- @Target:描述注解可以作用的位置
- 格式:
-
在程序中使用注解