Интерфейс TypeMirror

TypeKind getKind()

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

• Вид примитивного типа — один из видов, для которых TypeKind.isPrimitive() возвращает true.
• Вид нулевого типа — 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)

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