Пакет javax.lang.model.element

Интерфейсы, используемые, чтобы смоделировать элементы языка программирования Java.

См.: Описание

Сводка интерфейса

Интерфейс	Описание
AnnotationMirror	Представляет аннотацию.
AnnotationValue	Представляет значение элемента типа аннотации.
AnnotationValueVisitor <R, P>	Посетитель значений аннотации вводит элементы, используя разновидность шаблона разработки посетителя.
Элемент	Представляет элемент программы, такой как пакет, class, или метод.
ElementVisitor <R, P>	Посетитель элементов программы, в стиле шаблона разработки посетителя.
ExecutableElement	Представляет метод, конструктора, или инициализатор (статичный или экземпляр) class или интерфейса, включая элементы типа аннотации.
Имя	Неизменная последовательность символов.
PackageElement	Представляет элемент программы пакета.
Parameterizable	mixin взаимодействует через интерфейс для элемента, у которого есть параметры типа.
QualifiedNameable	mixin взаимодействует через интерфейс для элемента, у которого есть полностью определенное имя.
TypeElement	Представляет class или элемент программы интерфейса.
TypeParameterElement	Представляет формальный параметр типа универсального class, интерфейса, метода, или элемента конструктора.
VariableElement	Представляет поле, enum постоянный, метод или параметр конструктора, локальная переменная, переменная ресурса, или параметр исключения.

Перечислимая Сводка

Перечисление	Описание
ElementKind	kind из элемента.
Модификатор	Представляет модификатор на элементе программы, таком как class, метод, или поле.
NestingKind	Вид вложения элемента типа.

Сводка исключения

Исключение	Описание
UnknownAnnotationValueException	Указывает, что встретились с неизвестным видом значения аннотации.
UnknownElementException	Указывает, что встретились с неизвестным видом элемента.

Пакет javax.lang.model.element Описание

Интерфейсы, используемые, чтобы смоделировать элементы языка программирования Java. Термин "элемент" в этом пакете используется, чтобы обратиться к элементам программы, объявленным объектам, которые составляют программу. Элементы включают классы, интерфейсы, методы, конструкторов, и поля. Интерфейсы в этом пакете не моделируют структуру программы в теле метода; например нет никакого представления a for цикл или try-finally блок. Однако, интерфейсы могут смоделировать некоторые структуры, только появляющиеся в телах метода, таких как локальные переменные и анонимные классы.

Когда использующийся в контексте обработки аннотации, точная модель представляемого элемента должна быть возвращена. Поскольку это - модель языка, исходный код обеспечивает основанное на вере (ссылка) представление рассматриваемой конструкции, а не представление в исполнимом выводе как файл class. Исполнимый вывод может служить основанием для того, чтобы создать элемент моделирования. Однако, процесс преобразования исходного кода к исполнимому выводу, возможно, не разрешает восстанавливать некоторые аспекты представления исходного кода. Например, аннотации с источник задержание не могут быть восстановлены с файлов class, и файлы class не могли бы быть в состоянии обеспечить исходную информацию о положении. Имена параметров, возможно, не восстанавливаемы от файлов class. Модификаторы на элементе могут отличаться в некоторых случаях включая:

• strictfp на class или интерфейсе
• final на параметре
• protected, private, и static на классах и интерфейсах

Дополнительно, синтетические конструкции в файле class, такие как методы средства доступа, используемые в реализации вложенных классов и мостовых методов, используемых в реализации ковариантных возвратов, являются артефактами преобразования за пределами этой модели.

Во время обработки аннотации, работающей на неполных или ошибочных программах, необходимо; однако, есть меньше гарантий о природе получающейся модели. Если исходный код не синтаксически правильно построен или имеет некоторую другую неисправимую ошибку, которая не могла бы быть удалена генерацией новых типов, модель может или не может быть обеспечена как качество проблемы реализации. Если программа синтаксически допустима, но ошибочна некоторым другим способом, у любой возвращенной модели должно быть не меньше информации, чем если бы все тела метода в программе были заменены "throw new RuntimeException();". Если программа отсылает к недостающему типу XYZ, возвращенная модель должна содержать не меньше информации, чем если бы объявление типа XYZ, как предполагалось, было "class XYZ {}", "interface XYZ {}", "enum XYZ {}", или "@interface XYZ {}". Если программа относится к недостающему типу XYZ<K1, ... ,Kn>, возвращенная модель должна содержать не меньше информации, чем если бы объявление XYZ, как предполагалось, было "class XYZ<T1, ... ,Tn> {}" или "interface XYZ<T1, ... ,Tn> {}"

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

Если иначе не определено, методы в этом пакете бросят a NullPointerException если дано a null параметр.

С тех пор:

1.6