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

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

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

<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)

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