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

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