Java Annotation 学习整理

Java Annotation 学习整理
JDK自带Annotation
@Override, @Deprecated, @SuppressWarnings

Annotation属性值大致有三种：基本类型、数组类型、枚举类型
public @interface UserdefinedAnnotation {
int value();
String name();
String address();
}
value属性名是annotation默认的一个属性名，声明的时候可以省略。

Annotation的枚举标记
@Retention
RetentionPolicy
CLASS 编译器将把注释记录在类文件中，但在运行时 VM 不需要保留注释。
RUNTIME 编译器将把注释记录在类文件中，在运行时 VM 将保留注释，因此可以反射性地读取。
SOURCE 编译器要丢弃的注释

@Target
ElementType
ANNOTATION_TYPE
          注释类型声明
CONSTRUCTOR
          构造方法声明
FIELD
          字段声明（包括枚举常量）
LOCAL_VARIABLE
          局部变量声明
METHOD
          方法声明
PACKAGE
          包声明
PARAMETER
          参数声明
TYPE
          类、接口（包括注释类型）或枚举声明

@Document
告诉JDK让它也将annotation生成到doc中去。

@Inherited
Annotation标记也可以继承。

反射API接口AnnotatedElement
在jdk5.0以后java反射包增加了这样一个接口，主要是用来对annotation进行操作的，其中AccessibleObject, Class, Constructor, Field, Method, Package都对其进行了实现继承。总共有以下四个方法：
<T extends Annotation>
T
getAnnotation(Class<T> annotationType)
          如果存在该元素的指定类型的注释，则返回这些注释，否则返回 null。
Annotation[]
getAnnotations()
          返回此元素上存在的所有注释。
Annotation[]
getDeclaredAnnotations()
          返回直接存在于此元素上的所有注释。
boolean isAnnotationPresent(Class<? extends Annotation> annotationType)
          如果指定类型的注释存在于此元素上，则返回 true，否则返回 false。