注解
啥是注解?
首先对于码农来说,注释是给人看的。Counterpart 注解就是给计算机看的。
注解主要有以下三种作用:
- 编写文档: 可以用来生成Doc文档,具体例子看看库里牛掰的代码就行。
- 代码分析: 利用反射,在一定程度上替代配置文件
- 编译检查: 实现编译时检查,例如(@Override)
下面介绍一下JDK中常用的几个注解:
- @Override:检查被该注解修饰的方法是否是继承自父类
- @Deprecated:用来标注过期不用的方法。(修饰方法后在方法名上会有一条横线)
- @Suppresswarning:用来压制警告(常用参数:“all”)
注解咋写?
格式:
//元注解
@Target(Element.TYPE)
public @interface Pro{ //注解名称叫Pro
int age(); //注解属性
}
本质:
通过反编译注解发现,注解的本质就是一个继承了Annotation接口的接口。。。
//反编译注解后:
public interface 注解名称 extends java.lang.annotation.Annotation{}
属性:
注解的属性其实就是定义在内部的抽象方法,属性有以下几个要求
- 属性的返回值类型只能是:
- 基本数据类型
- String
- 枚举
- 注解
- 以上类型的数组
- 在使用注解的时候需要给内部没有default值的属性赋值。另外如果只有一个属性,并且该属性的名称为value,则在赋值的时候不需要带属性名称。
- 对数组属性进行赋值的时候需要大括号{}包起来。
//定义注解
public @interface Pro1{
int age(); //注解属性
String[] name();
}
public @interface Pro2{
int value(); //注解属性
}
//使用注解
@Pro1(age = 12,name = {qq,ww,ee})
public Person(){}
@Pro2(11)
public Person(){}
常用元注解
注解的参数咋用有些啥用直接点进注解的源码看就行了。。
@Target:描述注解能够作用的位置
@Retention:描述注解能够保留的阶段
可选参数 | 是否保留到字节码中 | 是否会被JVM读取 |
---|---|---|
SOURCE | 否 | 否 |
CLASS | 是 | 否 |
RUNTIME | 是 | 是 |
@Documented:描述注解是否能被抽取到api文档中
@Inherited:父类的注解是否能继承给子类
注解的解析(如何获取注解的属性)
使用描述: 将注解放到类的前头,咋在类中使用注解的属性值?
步骤:
@Pro1(age = 11,name = "laoxu")
public Person(){
...//点点点内容下面说
}
- 获取被修饰类的字节码对象
Class<Person> per = Person.class;
- 获取类的注解对象:
Pro1 an = per.getAnnotation(Pro1.class);
这一步相当于是有两个操作:
第一:创建了一个类(就叫X类吧)实现了Pro1接口,并覆盖了Pro1中的方法(属性)
//虚拟的写一下
public class X implements Pro1(){
@Override
public int age(){
return "11";
}
@Override
public String name(){
return "laoxu";
}
}
第二:对X创建了一个实例an
- 通过对象的方法进行属性的赋值就OK了
int age = an.age();
int name = an.name();