Java 接口 java.lang.annotation.Annotation 的使用（JDK5）

138 阅读 0 评论 0 点赞

使用

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

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)`