接口 java.lang.annotation.Annotation 的使用 (Java 2 Platform SE 5.0) - JavaTM 2 Platform Standard Edition 5.0 API 规范中文版

java.lang 中 Annotation 的使用

 

实现 Annotation 的 java.lang 中的类
interface	Deprecated           用 @Deprecated 注释的程序元素，不鼓励程序员使用这样的元素，通常是因为它很危险或存在更好的选择。
interface	Override           表示一个方法声明打算重写超类中的另一个方法声明。
interface	SuppressWarnings           指示应该在注释元素（以及包含在该注释元素中的所有程序元素）中取消显示指定的编译器警告。

 

类型参数类型为 Annotation 的 java.lang 中的方法
<A extends Annotation> A	Class.getAnnotation(Class<A> annotationClass)           如果存在该元素的指定类型的注释，则返回这些注释，否则返回 null。
<A extends Annotation> A	Package.getAnnotation(Class<A> annotationClass)

 

返回 Annotation 的 java.lang 中的方法
Annotation[]	Class.getAnnotations()           返回此元素上存在的所有注释。
Annotation[]	Package.getAnnotations()
Annotation[]	Class.getDeclaredAnnotations()           返回直接存在于此元素上的所有注释。
Annotation[]	Package.getDeclaredAnnotations()

 

类型变量类型为 Annotation 的 java.lang 中的方法参数
boolean	Class.isAnnotationPresent(Class<? extends Annotation> annotationClass)           如果指定类型的注释存在于此元素上，则返回 true，否则返回 false。
boolean	Package.isAnnotationPresent(Class<? extends Annotation> annotationClass)

 

java.lang.annotation 中 Annotation 的使用

 

实现 Annotation 的 java.lang.annotation 中的类
interface	Documented           指示某一类型的注释将通过 javadoc 和类似的默认工具进行文档化。
interface	Inherited           指示注释类型被自动继承。
interface	Retention           指示注释类型的注释要保留多久。
interface	Target           指示注释类型所适用的程序元素的种类。

 

返回变量类型为 Annotation 的类型的 java.lang.annotation 中的方法
Class<? extends Annotation>	Annotation.annotationType()           返回此 annotation 的注释类型。
Class<? extends Annotation>	IncompleteAnnotationException.annotationType()           返回带有缺少元素的注释类型的 Class 对象。

 

类型变量类型为 Annotation 的 java.lang.annotation 中的构造方法参数
IncompleteAnnotationException(Class<? extends Annotation> annotationType, String elementName)           构造一个指示指定注释类型中缺少指定元素的 IncompleteAnnotationException。

 

java.lang.reflect 中 Annotation 的使用

 

类型参数类型为 Annotation 的 java.lang.reflect 中的方法
<T extends Annotation> T	AnnotatedElement.getAnnotation(Class<T> annotationType)           如果存在该元素的指定类型的注释，则返回这些注释，否则返回 null。
<T extends Annotation> T	AccessibleObject.getAnnotation(Class<T> annotationClass)
<T extends Annotation> T	Field.getAnnotation(Class<T> annotationClass)
<T extends Annotation> T	Method.getAnnotation(Class<T> annotationClass)
<T extends Annotation> T	Constructor.getAnnotation(Class<T> annotationClass)

 

返回 Annotation 的 java.lang.reflect 中的方法
Annotation[]	AnnotatedElement.getAnnotations()           返回此元素上存在的所有注释。
Annotation[]	AccessibleObject.getAnnotations()
Annotation[]	AnnotatedElement.getDeclaredAnnotations()           返回直接存在于此元素上的所有注释。
Annotation[]	AccessibleObject.getDeclaredAnnotations()
Annotation[]	Field.getDeclaredAnnotations()
Annotation[]	Method.getDeclaredAnnotations()
Annotation[]	Constructor.getDeclaredAnnotations()
Annotation[][]	Method.getParameterAnnotations()           返回表示按照声明顺序对此 Method 对象所表示方法的形参进行注释的那个数组的数组。
Annotation[][]	Constructor.getParameterAnnotations()           按照声明顺序返回一组数组，这些数组表示通过此 Method 对象表示的方法的形参上的注释。

 

类型变量类型为 Annotation 的 java.lang.reflect 中的方法参数
boolean	AnnotatedElement.isAnnotationPresent(Class<? extends Annotation> annotationType)           如果指定类型的注释存在于此元素上，则返回 true，否则返回 false。
boolean	AccessibleObject.isAnnotationPresent(Class<? extends Annotation> annotationClass)

 

版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。