JavaTM 2 Platform
Standard Ed. 5.0

接口 java.lang.annotation.Annotation
的使用

使用 Annotation 的软件包
java.lang 提供利用 Java 编程语言进行程序设计的基础类。 
java.lang.annotation 为 Java 编程语言注释设施提供库支持。 
java.lang.reflect 提供类和接口,以获取关于类和对象的反射信息。 
 

java.langAnnotation 的使用
 

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

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

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

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

java.lang.annotationAnnotation 的使用
 

实现 Annotationjava.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 对象。
 

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

java.lang.reflectAnnotation 的使用
 

类型参数类型为 Annotationjava.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)
           
 

返回 Annotationjava.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 对象表示的方法的形参上的注释。
 

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


JavaTM 2 Platform
Standard Ed. 5.0

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

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