Интерфейс ElementVisitor<R,P>

Параметры типа:

R - тип возвращаемого значения методами этого посетителя. Используйте Void для посетителей, которым не нужно возвращать результаты.

P - тип дополнительного параметра методов этого посетителя. Используйте Void для посетителей, которым не нужен дополнительный параметр.

Все известные реализующие классы:

AbstractElementVisitor14, AbstractElementVisitor6, AbstractElementVisitor7, AbstractElementVisitor8, AbstractElementVisitor9, ElementKindVisitor14, ElementKindVisitor6, ElementKindVisitor7, ElementKindVisitor8, ElementKindVisitor9, ElementScanner14, ElementScanner6, ElementScanner7, ElementScanner8, ElementScanner9, SimpleElementVisitor14, SimpleElementVisitor6, SimpleElementVisitor7, SimpleElementVisitor8, SimpleElementVisitor9

public interface ElementVisitor<R,P>

Примечание API:

ПРЕДУПРЕЖДЕНИЕ: Возможно, что к этому интерфейсу будут добавлены методы для поддержки новых, в настоящее время неизвестных, структур языка, добавленных в будущие версии языка программирования Java. Такие добавления уже произошли для поддержки функций языка, добавленных после введения этой API. Классы-посетители, напрямую реализующие этот интерфейс, могут быть несовместимы с будущими версиями платформы. Чтобы избежать этой несовместимости, реализации посетителей рекомендуется вместо этого расширять соответствующий абстрактный класс посетителя, который реализует этот интерфейс. Однако API обычно должна использовать этот интерфейс посетителя как тип для параметров, типов возвращаемых значений и т. д., а не один из абстрактных классов.

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

В пакете util существует несколько семейств классов, реализующих этот интерфейс посетителя. Семейства следуют шаблону именования в стиле FooVisitorN, где N указывает версию исходного кода, для которой подходит посетитель. В частности, FooVisitorN должен обрабатывать все конструкции языка, присутствующие в версии исходного кода N. Если в версии N + 1 (или последующих версиях) новых конструкций языка нет, FooVisitorN также может обрабатывать эту более позднюю версию исходного кода; в этом случае аннотация SupportedSourceVersion на классе FooVisitorN укажет более позднюю версию. При посещении элемента, представляющего конструкцию языка, введенную после версии исходного кода N, FooVisitorN будет выбрасывать UnknownElementException, если это поведение не переопределено.

При выборе члена семейства посетителей для наследования, наследование самого последнего члена увеличивает диапазон поддерживаемых версий исходного кода. При выборе семейства посетителей для наследования следует учесть их встроенные возможности:

• AbstractElementVisitorы: скелетные реализации посетителей.
• SimpleElementVisitorы: поддержка по умолчанию действий и значения по умолчанию для возврата.
• ElementKindVisitorы: методы посещения предоставляются на уровне категории некоторых категорий элементов, которые могут иметь более одного типа.
• ElementScannerы: сканеры — это посетители, которые обходят элемент и элементы вложенные им и связанные с ним.

С момента:

1.6