Интерфейс 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 вместо их контейнерной аннотации и располагались в том порядке, в котором они указаны в элементе value контейнерной аннотации. Этот метод отличается от метода getAnnotation(Class) тем, что проверяет, является ли его аргумент повторяемым интерфейсом аннотации, и, если это так, пытается найти одну или несколько аннотаций этого типа, «просматривая» контейнерную аннотацию.

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

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