Интерфейс TypeMirror

TypeKind getKind()

Возвращает kind этого типа.

• Видом примитивного типа является один из видов, для которых TypeKind.isPrimitive() возвращает true.
• Видом типа null является NULL.
• Видом типа массива является ARRAY.
• Видом объявленного типа является DECLARED.
• Видом типа ошибки является ERROR.
• Видом переменной типа является TYPEVAR.
• Видом типа с подстановочным знаком является WILDCARD.
• Видом исполняемого типа является EXECUTABLE.
• Видом псевдотипа является один из следующих: VOID, PACKAGE, MODULE или NONE.
• Видом объединенного типа является UNION.
• Видом пересекающегося типа является INTERSECTION.

boolean equals(Object obj)

Соответствует общему контракту Object.equals. Однако этот метод не указывает, представляют ли два типа один и тот же тип. Для семантического сравнения типов на равенство следует использовать Types.isSameType(TypeMirror, TypeMirror). Результаты t1.equals(t2) и Types.isSameType(t1, t2) могут различаться.

int hashCode()

Соответствует общему контракту Object.hashCode.

String toString()

Возвращает информативное строковое представление этого типа. По возможности строка должна иметь форму, подходящую для представления этого типа в исходном коде. Все имена, включенные в результат, по возможности указываются с квалификаторами.

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

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

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

Обратите внимание, что все аннотации, возвращаемые этим методом, являются аннотациями типов.

<R,P> R accept(TypeVisitor<R,P> v, P p)

Применяет посетитель к этому типу.