javax.lang.model.element

Интерфейсный Элемент

Все Известные Подынтерфейсы:

ExecutableElement, PackageElement, Parameterizable, QualifiedNameable, TypeElement, TypeParameterElement, VariableElement

public interface Element

Представляет элемент программы, такой как пакет, класс, или метод. Каждый элемент представляет статическую, конструкцию на уровне языка (и не, например, конструкцию времени выполнения виртуальной машины).

Элементы должны быть сравнены, используя equals(Object) метод. Нет никакой гарантии, что любой определенный элемент будет всегда представляться тем же самым объектом.

Реализовывать операции, основанные на классе Element объект, или используют посетителя или используют результат getKind() метод. Используя instanceof не обязательно надежная идиома для того, чтобы определить эффективный класс объекта в этой иерархии моделирования, так как реализация может хотеть иметь единственную объектную многократную реализацию Element подынтерфейсы.

С тех пор:

1.6

См. Также:

Elements, TypeMirror

Сводка метода

Методы

Модификатор и Тип	Метод и Описание
<R,P> R	accept(ElementVisitor<R,P> v, P p) Применяет посетителя этого элемента.
TypeMirror	asType() Возвращает тип, определенный этим элементом.
boolean	equals(Object obj) Возвраты true если параметр представляет тот же самый элемент как this, или false иначе.
<A extends Annotation> A	getAnnotation(Class<A> annotationType) Возвраты аннотация этого элемента для указанного типа, если такая аннотация присутствует, еще null.
List<? extends AnnotationMirror>	getAnnotationMirrors() Возвращает аннотации, которые непосредственно присутствуют на этом элементе.
List<? extends Element>	getEnclosedElements() Возвращает элементы, которые являются, свободно разговор, непосредственно включенный этим элементом.
Элемент	getEnclosingElement() Возвращает самый внутренний элемент, в пределах которого этот элемент, свободно разговор, включенный.
ElementKind	getKind() Возвраты kind из этого элемента.
Set<Modifier>	getModifiers() Возвращает модификаторы этого элемента, исключая аннотации.
Имя	getSimpleName() Возвращает простое (неполное) имя этого элемента.
int	hashCode() Повинуется общему контракту Object.hashCode.

Деталь метода

asType

TypeMirror asType()

Возвращает тип, определенный этим элементом.

Универсальный элемент определяет семейство типов, не только один. Если это - универсальный элемент, формирующий прототип тип возвращается. Это - вызов элемента на переменных типа, соответствующих его собственным формальным параметрам типа. Например, для универсального элемента класса C<N extends Number>, параметризованный тип C<N> возвращается. Types у служебного интерфейса есть более общие методы для того, чтобы получить полный спектр типов, определенных элементом.

Возвраты:

тип определяется этим элементом

См. Также:

Types

getKind

ElementKind getKind()

Возвраты kind из этого элемента.

Возвраты:

вид этого элемента

getAnnotationMirrors

List<? extends AnnotationMirror> getAnnotationMirrors()

Возвращает аннотации, которые непосредственно присутствуют на этом элементе.

Чтобы получить наследованные аннотации также, использовать getAllAnnotationMirrors.

Возвраты:

аннотации, непосредственно существующие на этом элементе; пустой список, если нет ни одного

См. Также:

ElementFilter

getAnnotation

<A extends Annotation> A getAnnotation(Class<A> annotationType)

Возвраты аннотация этого элемента для указанного типа, если такая аннотация присутствует, еще null. Аннотация может быть или наследована или непосредственно существовать на этом элементе.

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

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

Введите Параметры:

A - тип аннотации

Параметры:

annotationType - Class объект, соответствующий типу аннотации

Возвраты:

аннотация этого элемента для указанной аннотации вводит если существующий на этом элементе, еще null

См. Также:

getAnnotationMirrors(), AnnotatedElement.getAnnotation(java.lang.Class<T>), EnumConstantNotPresentException, AnnotationTypeMismatchException, IncompleteAnnotationException, MirroredTypeException, MirroredTypesException

getModifiers

Set<Modifier> getModifiers()

Возвращает модификаторы этого элемента, исключая аннотации. Неявные модификаторы, такой как public и static модификаторы интерфейсных элементов, включаются.

Возвраты:

модификаторы этого элемента, или пустое множество, если нет ни одного

getSimpleName

Name getSimpleName()

Возвращает простое (неполное) имя этого элемента. Имя универсального типа не включает ссылки на свои формальные параметры типа. Например, простое имя элемента типа java.util.Set<E> "Set". Если этот элемент представляет неназванный пакет, пустое название возвращается. Если это представляет конструктора, имя"<init>"возвращается. Если это представляет статический инициализатор, имя"<clinit>"возвращается. Если это представляет анонимный класс или инициализатор экземпляра, пустое название возвращается.

Возвраты:

простое имя этого элемента

getEnclosingElement

Element getEnclosingElement()

Возвращает самый внутренний элемент, в пределах которого этот элемент, свободно разговор, включенный.

• Если этот элемент является тем, объявление которого лексически сразу включается в пределах объявления другого элемента, что другой элемент возвращается.
• Если это - высокоуровневый тип, его пакет возвращается.
• Если это - пакет, null возвращается.
• Если это - параметр типа, универсальный элемент параметра типа возвращается.

Возвраты:

элемент включения, или null если нет ни одного

См. Также:

Elements.getPackageOf(javax.lang.model.element.Element)

getEnclosedElements

List<? extends Element> getEnclosedElements()

Возвращает элементы, которые являются, свободно разговор, непосредственно включенный этим элементом. Класс или интерфейс, как полагают, включают поля, методы, конструкторов, и типы элемента, которые это непосредственно объявляет. Это включает любого (неявного) конструктора по умолчанию и неявное values и valueOf методы перечислимого типа. Пакет включает высокоуровневые классы и интерфейсы в пределах этого, но, как полагают, не включает подпакеты. Другие виды элементов, как в настоящий момент полагают, не включают элементов; однако, это может измениться как этот API, или язык программирования развивается.

Отметьте, что элементы определенных видов могут быть изолированы, используя методы в ElementFilter.

Возвраты:

включенные элементы, или пустой список, если ни один

См. Также:

Elements.getAllMembers(javax.lang.model.element.TypeElement)

См. Спецификацию языка Java™:

8.8.9 Конструктор по умолчанию, 8.9 Перечислений

равняется

boolean equals(Object obj)

Возвраты true если параметр представляет тот же самый элемент как this, или false иначе.

Отметьте, что идентификационные данные элемента включают неявное состояние, не непосредственно доступное от методов элемента, включая состояние о присутствии несвязанных типов. Объекты элемента, создаваемые различными реализациями этих интерфейсов, как должны ожидать, не будут равны, даже если "тот же самый" элемент будет смоделирован; это походит на неравенство Class объекты для того же самого файла класса загружались через различные загрузчики класса.

Переопределения:

equals в классе Object

Параметры:

obj - объект быть по сравнению с этим элементом

Возвраты:

true если указанный объект представляет тот же самый элемент как это

См. Также:

Object.hashCode(), HashMap

хэш-код

int hashCode()

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

Переопределения:

hashCode в классе Object

Возвраты:

значение хэш-кода для этого объекта.

См. Также:

equals(java.lang.Object)

принять

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

Применяет посетителя этого элемента.

Введите Параметры:

R - тип возврата методов посетителя

P - тип дополнительного параметра к методам посетителя

Параметры:

v - посетитель, работающий на этом элементе

p - дополнительный параметр посетителю

Возвраты:

определенный посетителем результат