Интерфейс AnnotatedConstruct

List<? extends AnnotationMirror> getAnnotationMirrors()

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

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

Возвращает аннотацию данного конструкта указанного типа, если такая аннотация присутствует, в противном случае null.

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

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

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

Возвращает аннотации, ассоциированные с этим конструктом. Если с этим конструктом нет ассоциированных аннотаций, возвращаемое значение — массив длиной 0. Порядок аннотаций, которые прямо или косвенно присутствуют в конструкте C, вычисляется так, как будто косвенно присутствующие аннотации на C присутствуют прямо на C вместо их контейнерной аннотации, в том порядке, в котором они появляются в элементе значения контейнерной аннотации. Разница между этим методом и getAnnotation(Class) заключается в том, что этот метод определяет, является ли его аргумент повторяющимся интерфейсом аннотации, и если да, то пытается найти одну или несколько аннотаций этого типа, «посмотрев через» контейнерную аннотацию.

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

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