注解也叫元数据,例如常见的@Override和@Deprecated,注解是JDK1.5版本开始引入的一个特性,用于对代码进行说明
一般注解可以分为三类:
、一类是java自带的标准注解,包括@Override、@Deprecated和@SuppressWarnings,分别用于表明重写某个方法,表明某个方法或类过时、表明要忽略的警告,这些注解标明后编译器会进行检查。
、 一类为元注解,用于对注解的注解,包括@Retention、用于表明注解被保留的阶段。@Target、用于表明注解使用的范围@Inherited、用于表明可以被继承@Decumented、用于表明是否可以生成文档。
、 一类为自定义注解,可以根据自己的需求定义注解,并用元注解对自己的注解进行注解。
注解的使用非常简单,只需要在需要注解的地方加上注解就可以了。
自定义注解:
、创建一个Log注解作用于类,保留到运行时,默认值为default
@Target({ElementType.Type})
@Retention({RetentionPolicy.RUNTIME})
public @interface Log{
String value() default "default";
}
、 创建LogMethod注解,声明作用于方法并保留到运行时。
public @interface LogMethod{
String value();
}
、测试类,运行后输出"default"和"执行test-method方法"两个字符串
@Log()
public class Test{
@LogMeth('执行test-method方法')
public void testMethod(){
}
public static void main(String[] args){
Test t= Test.class.getAnnotation(Log.class);
System.out.println(t.value()); //输出 "default"
TestMethod tm = Test.class.getDeclaredMethod("testMethod",null).getAnnotation(LogMethod.class);
System.out.println(tm.value()); //输出 “执行test-method方法”
}
}
从java源码到class字节码是由编译器完成的,编译器会对java源码进行解析并生成class文件,而注解也是在编译时由编译器进行处理的,编译器会对注解的进行处理并加到class结构中,根据jvm规范,class文件结构是严格有序的格式,唯一可以附加信息到class结构中的方式就是保存到class结构的attribute属性中,类,方法,变量在class结构中都有自己的特定的表结构,而且各自都有自己的属性,而对于注解,作用的范围也可以不同,这时编译器就要根据对对应的将注解信息保存到类,方法,变量的自己的属性上。
在我们的Test 类被编译后,对应的class文件中会包含一个RuntimeVisibleAnnotations属性,由于这个注解是作用在类上,所以此属性被添加类的属性集合上,即Test注解的键值对value=default(由于没有添加输入的数据,所以使用默认值default)会被记录起来。 当jvm加载Test.class文件字节码时,就会将RuntimeVisibleAnnotations属性保存到Test的class对象中,于是就可以通过Test.class.getAnnotation(Log.class)获取到Log注解对象,进而再通过Log注解对象获取到Log里面保存的数据,value字符串
---Log注解对象是什么?其实注解被编译后的本质就是一个继承Annotation接口的接口,所以@Log其实就是“public interface Log extends Annotation” ,当我们通过Test.class.getAnnotation(Log.class)执行时,JDK会通过动态代理生成一个实现了Log接口的对象,并把RuntimeVisbleAnnotations属性值设置进此对象中,此对象即为Log注解对象,通过它的value()方法就可以获取到注解值。