注解声明
@target
说明的是Annotation所修饰的对象范围,常用的可选值有 TYPE,FIELD,METHOD,PARAMETER
@Retention
定义 Annotation 生命周期。可选值 source、class和runtime。
source仅出现在源代码中,编译时丢弃,如lombok的@DATA注解;
class 编译在class文件中,被虚拟机忽略;
runtime 被装载时将被读取。
@Documented
定义是否可以被例如javadoc此类的工具文档化。
@Inherited
阐述了某个被标注的类型是被继承的。如果一个使用了@Inherited修饰的annotation类型被用于一个class,则这个annotation将被用于该class的子类。
注解处理器
程序通过反射获取了某个类的AnnotatedElement对象之后,程序就可以调用该对象的如下四个个方法来访问Annotation信息:
方法1
T getAnnotation(Class annotationClass): 返回该程序元素上存在的、指定类型的注解,如果该类型注解不存在,则返回null。
方法2:
Annotation[] getAnnotations():返回该程序元素上存在的所有注解。
方法3:
boolean is AnnotationPresent(Class<?extends Annotation> annotationClass):判断该程序元素上是否包含指定类型的注解,存在则返回true,否则返回false.
方法4:
Annotation[] getDeclaredAnnotations():返回直接存在于此元素上的所有注释。与此接口中的其他方法不同,该方法将忽略继承的注释。(如果没有注释直接存在于此元素上,则返回长度为零的一个数组。)该方法的调用者可以随意修改返回的数组;这不会对其他调用者返回的数组产生任何影响