compact3

javax.lang.model

Interface AnnotatedConstruct

All Known Subinterfaces:

ArrayType， DeclaredType， Element， ErrorType， ExecutableElement， ExecutableType， IntersectionType， NoType， NullType， PackageElement， Parameterizable， PrimitiveType， QualifiedNameable， ReferenceType， TypeElement， TypeMirror， TypeParameterElement， TypeVariable， UnionType， VariableElement， WildcardType

public interface AnnotatedConstruct

表示可以注释的结构。建设是一个 element或 type。元素上的注释是在声明上的，而类型的注释在类型名称的特定使用上。直接存在的，现在的，间接的，和相关的术语在这个接口中使用，精确地描述了哪些注释是由这里定义的方法返回的。

在下面的定义，诠释一已注释类型在。如果在是一个可重复的注释类型，含注释类型ATC。

注释一直接出现在构建C如果：

• 一是显式或隐式声明为应用于C

  通常，如果一个确切的注释类型在出现在表示C源代码，然后一显式声明为申请如果有在型目前C多注释，那么在是重复的注释类型，类型的ATC注释是隐式声明对C.

  源代码表示
• 对一表示出现在可执行文件输出为C，如RuntimeVisibleAnnotations或类文件RuntimeVisibleParameterAnnotations属性。

注释一是目前构建C如果：

• 一直接呈现在C.
• 没有注释的类型在直接出现在C，C是一个类，在是继承和一目前在C类

注释一间接在构建C如果：

• 在用含有注释类型ATC重复的注释类型。
• 式ATC注释直接出现在C和一是注释包含在调用类型ATC的直接呈现value标注方法的结果。

注释一与构建C如果相关：

• 一直接或间接对C.
• 没有注释的类型在直接或间接地存在于C，C是一个类，并在是继承和一与C类相关

从以下版本开始：

一点八

See The Java™ Language Specification:

9.6注释类型，9.6.3.3 @继承

方法摘要

Modifier and Type	Method and Description
<A extends Annotation> A	getAnnotation(类<A> annotationType) 如果这样的诠释是返回指定类型的这种构造的诠释，其他 null。
List<? extends AnnotationMirror>	getAnnotationMirrors() 返回直接存在于此结构上的注释。
<A extends Annotation> A[]	getAnnotationsByType(类<A> annotationType) 返回与此结构关联的注释。

方法详细信息

getAnnotationMirrors

List<? extends AnnotationMirror> getAnnotationMirrors()

返回直接存在于此结构上的注释。

结果

直接在这个结构上的注释；如果没有的话，一个空的列表

getAnnotation

<A extends Annotation> A getAnnotation(类<A> annotationType)

如果这样的诠释是返回指定类型的这种构造的诠释，其他 null。

此方法返回的注释可以包含一个元素的值的类型是类。这个值不能直接返回：查找和加载类的必要信息（如类装载器使用）不可用，并可能无法加载所有的类。试图读取一个类对象通过调用返回的注释相关的方法将导致一个MirroredTypeException，从中可提取出相应的TypeMirror。同样，试图读一Class[]-valued元素将导致MirroredTypesException。

Note: This method is unlike others in this and related interfaces. It operates on runtime reflective information — representations of annotation types currently loaded into the VM — rather than on the representations defined by and used throughout these interfaces. Consequently, calling methods on the returned annotation object can throw many of the exceptions that can be thrown when calling methods on an annotation object returned by core reflection. This method is intended for callers that are written to operate on a known, fixed set of annotation types.

参数类型

A的注释类型

参数

annotationType -对应的注释类型的 类对象

结果

这种结构的标注为指定的注释类型如果存在，否则 null

另请参见：

getAnnotationMirrors()， AnnotatedElement.getAnnotation(java.lang.Class<T>)， EnumConstantNotPresentException， AnnotationTypeMismatchException， IncompleteAnnotationException， MirroredTypeException， MirroredTypesException

See The Java™ Language Specification:

9.6.1注释类型的元素

getAnnotationsByType

<A extends Annotation> A[] getAnnotationsByType(类<A> annotationType)

返回与此结构关联的注释。如果没有与此结构相关联的批注，返回值是长度为0的数组。直接或间接存在于A结构C的注释的顺序计算，如果间接存在的注释C是直接存在于C的位置，他们的容器注释，在它们出现在容器注释的值元素的顺序。这种方法和 getAnnotation(Class)之间的区别是，该方法检测如果它的参数是一个可重复的注释类型，如果是这样的话，试图找到一个或更多的注释，通过“浏览”式容器标注。

此方法返回的注释可以包含一个元素的值的类型是类。这个值不能直接返回：查找和加载类的必要信息（如类装载器使用）不可用，并可能无法加载所有的类。试图读取一个类对象通过调用返回的注释相关的方法将导致一个MirroredTypeException，从中可提取出相应的TypeMirror。同样，试图读一Class[]-valued元素将导致MirroredTypesException。

Note: This method is unlike others in this and related interfaces. It operates on runtime reflective information — representations of annotation types currently loaded into the VM — rather than on the representations defined by and used throughout these interfaces. Consequently, calling methods on the returned annotation object can throw many of the exceptions that can be thrown when calling methods on an annotation object returned by core reflection. This method is intended for callers that are written to operate on a known, fixed set of annotation types.

参数类型

A的注释类型

参数

annotationType -对应的注释类型的 类对象

结果

如果此结构上存在指定的注释类型，则此结构的注释将是一个空数组

另请参见：

getAnnotationMirrors()， getAnnotation(Class)， AnnotatedElement.getAnnotationsByType(Class)， EnumConstantNotPresentException， AnnotationTypeMismatchException， IncompleteAnnotationException， MirroredTypeException， MirroredTypesException

See The Java™ Language Specification:

9.6注释类型，9.6.1注释类型的元素