Интерфейс 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.

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