*##注解
*概念:说明程序的。给计算机看的
*注释:用文字描述程序的。给程序员看的。
*定义:注解(Annotation),也叫原数据。一种代码级别的说明。它是jdk1.5及以后版本引入的一个特性,与类、接口、枚举在同一个层次。它可以声明在包、类、字段、方法、局部变量、方法参数等的前面,用来对这些元素进行说明,注释。
*作用分类:
①编写文档:通过代码里标识的注解生成文档(生成doc文档)。
②代码分析:通过代码里标识的注解对代码进行分析(使用反射)。
③编译检查:通过代码里标识的注解让编译器能够实现基本的编译检查(Override)。
*jdk中预定义的一些注解:
*@Override:检测被该注解标注的方法是否继承自父类(接口)的。
*@Deprecated:该注解标注的内容已经过时。
*SuppressWarnings:压制警告。一般传参数all,表示压制所有警告。
例:@SuppressWarnings("all")
*自定义注解
*格式
元注解
public @interface 注解名{
属性列表
}
*本质:注解本质上就是一个接口,该接口默认继承Annotation{}接口。
*属性:接口中可以定义的成员方法。
*要求:
1、属性的返回值必须为以下几种类型
*基本数据类型
*String
*枚举
*注解
*以上类型的数组
2、定义了属性,在使用时需要给属性赋值
①如果定义属性时使用default关键字给属性默认初始化值,则使用注解时可以不进行属性的赋值。
②如果只有一个属性需要赋值,并且属性的名称是value,则value可以省略,直接定义值即可。
③数组赋值时使用{}包裹。如果数组中只有一个值,则{}可以省略。
*元注解:用于描述注解的注解。
*@Target:描述了注解能够作用的位置
*其参数为枚举类型的ElementType,其取值可以为:
*TYPE:可以作用于类上
*METHOD:可以作用于方法上
*FIELD:可以作用于成员变量上。
*@Retention:描述注解被保留的阶段
*例:Retention(RetentionPolicy.RUNTIME) 自定义注解一般常用此元注解,表示当前被描述的注解会保留到class字节码文件中,并被jvm读取到。
*@Documented:描述注解是否被抽取到api文档中。
*@Inherited:描述注解是否被子类继承。
*在程序中使用注解:获取注解中定义的属性值
1、获取注解定义的位置的对象(如Class,Method,Field等)。
2、获取指定的注解
*getAnnotation(定义位置的对象):其实就是在内存中生成了一个该注解接口的子类实现对象。重写了注解接口中的属性。
3、调用注解中的抽象方法获取配置的属性。
*小结:
1、大多数时候我们会使用注解,而不是自定义注解。
2、注解是给编译器和解析程序用的。
3、注解不是程序的一部分,可以理解为注解就是一个标签。