compact3

javax.lang.model

Интерфейс AnnotatedConstruct

Все Известные Подынтерфейсы:

ArrayType, DeclaredType, Элемент, ErrorType, ExecutableElement, ExecutableType, IntersectionType, NoType, NullType, PackageElement, Parameterizable, PrimitiveType, QualifiedNameable, ReferenceType, TypeElement, TypeMirror, TypeParameterElement, TypeVariable, UnionType, VariableElement, WildcardType

public interface AnnotatedConstruct

Представляет конструкцию, которая может быть аннотирована. Конструкция является или элементом или типом. Аннотации на элемент находятся на объявлении, тогда как аннотации на тип находятся на определенном использовании имени типа. Термины, непосредственно существующие и существующие, используются всюду по этому интерфейсу, чтобы описать точно, какие аннотации возвращаются методами:

Аннотация A непосредственно присутствует на конструкции E, если E аннотируется, и:

• для вызова getAnnotation(Class<T>) или getAnnotationMirrors(), Аннотации Э содержат A.
• для вызова getAnnotationsByType(Class<T>), Аннотации Э или содержат A или, если тип A повторим, содержите точно одну аннотацию, элемент значения которой содержит A и чей тип является содержанием типа аннотации типа А.

Аннотация A присутствует на конструкции E если также:

• A непосредственно присутствует на E; или
• A непосредственно не присутствует на E, и E является элементом, представляющим class, и тип А является наследуемым, и A присутствует на элементе, представляющем суперкласс E.

С тех пор:

1.8

См. Спецификацию языка Java™:

9.6 Типы аннотации, 9.6.3.3 @Inherited

Сводка метода

Модификатор и Тип	Метод и Описание
<A extends Annotation> A	getAnnotation(Class<A> annotationType) Возвраты аннотация этой конструкции указанного типа, если такая аннотация присутствует, еще null.
List<? extends AnnotationMirror>	getAnnotationMirrors() Возвращает аннотации, которые непосредственно присутствуют на этой конструкции.
<A extends Annotation> A[]	getAnnotationsByType(Class<A> annotationType) Аннотации возвратов, которые присутствуют на этой конструкции.

Деталь метода

getAnnotationMirrors

List<? extends AnnotationMirror> getAnnotationMirrors()

Возвращает аннотации, которые непосредственно присутствуют на этой конструкции.

Возвраты:

аннотации, непосредственно существующие на этой конструкции; пустой список, если нет ни одного

getAnnotation

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

Возвраты аннотация этой конструкции указанного типа, если такая аннотация присутствует, еще null.

Аннотация, возвращенная этим методом, могла содержать элемент, значение которого имеет тип Class. Это значение не может быть возвращено непосредственно: информация, необходимая, чтобы расположиться и загрузить class (такой как загрузчик class, чтобы использовать), не доступна, и class не мог бы быть загружаемым вообще. Попытка считать a Class объект, вызывая соответствующий метод на возвращенную аннотацию приведет к a MirroredTypeException, от которого соответствие TypeMirror может быть извлечен. Точно так же пытаясь считать a Class[]- оцененный элемент приведет к a MirroredTypesException.

Отметьте: Этот метод непохож на других в этом и связанных интерфейсах. Это управляет на времени выполнения отражающей информацией — представлениями типов аннотации, в настоящий момент загруженных в VM — а не на представлениях, определенных и используемый всюду по этим интерфейсам. Следовательно, вызов методов на возвращенном объекте аннотации может выдать многие из исключений, которые могут быть брошены, вызывая методы на объекте аннотации, возвращенном базовым отражением. Этот метод предназначается для вызывающих сторон, которые пишутся, чтобы работать на известном, фиксированном наборе типов аннотации.

Введите Параметры:

A - тип аннотации

Параметры:

annotationType - Class объект, соответствующий типу аннотации

Возвраты:

этот элемент или аннотация использования типа для указанной аннотации вводит если существующий на этом элементе, еще null

См. Также:

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

См. Спецификацию языка Java™:

9.6.1 Элементы Типа аннотации

getAnnotationsByType

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

Аннотации возвратов, которые присутствуют на этой конструкции. Если нет никакого подарка аннотаций на этой конструкции, возвращаемое значение является массивом длины 0. Различие между этим методом и getAnnotation(Class) тот этот метод, обнаруживает, если его параметр является повторимым типом аннотации, и если так, пытается найти одну или более аннотаций того типа, "просматривая" контейнерную аннотацию.

Аннотации, возвращенные этим методом, могли содержать элемент, значение которого имеет тип Class. Это значение не может быть возвращено непосредственно: информация, необходимая, чтобы расположиться и загрузить class (такой как загрузчик class, чтобы использовать), не доступна, и class не мог бы быть загружаемым вообще. Попытка считать a Class объект, вызывая соответствующий метод на возвращенную аннотацию приведет к a MirroredTypeException, от которого соответствие TypeMirror может быть извлечен. Точно так же пытаясь считать a Class[]- оцененный элемент приведет к a MirroredTypesException.

Отметьте: Этот метод непохож на других в этом и связанных интерфейсах. Это управляет на времени выполнения отражающей информацией — представлениями типов аннотации, в настоящий момент загруженных в VM — а не на представлениях, определенных и используемый всюду по этим интерфейсам. Следовательно, вызов методов на возвращенном объекте аннотации может выдать многие из исключений, которые могут быть брошены, вызывая методы на объекте аннотации, возвращенном базовым отражением. Этот метод предназначается для вызывающих сторон, которые пишутся, чтобы работать на известном, фиксированном наборе типов аннотации.

Введите Параметры:

A - тип аннотации

Параметры:

annotationType - Class объект, соответствующий типу аннотации

Возвраты:

аннотации этого элемента для указанной аннотации вводят если существующий на этом элементе, еще пустой массив

См. Также:

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

См. Спецификацию языка Java™:

9.6 Типы аннотации, 9.6.1 Элементов Типа Аннотации