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

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