Интерфейс ElementVisitorP>

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

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 и visitRecordComponent. Реализации методов по умолчанию, в свою очередь, вызовут visitUnknown, поведение, которое будет переопределено в конкретных посетителях, поддерживающих версию исходного кода с новой конструкцией языка.

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

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

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

С:

1.6