Интерфейс AnnotationValueVisitorP>

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

R - тип возвращаемого значения методов этого посетителя

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

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

AbstractAnnotationValueVisitor14, AbstractAnnotationValueVisitor6, AbstractAnnotationValueVisitor7, AbstractAnnotationValueVisitor8, AbstractAnnotationValueVisitor9, SimpleAnnotationValueVisitor14, SimpleAnnotationValueVisitor6, SimpleAnnotationValueVisitor7, SimpleAnnotationValueVisitor8, SimpleAnnotationValueVisitor9

public interface AnnotationValueVisitor<R,P>

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

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

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

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

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

• AbstractAnnotationValueVisitorы: Скелетные реализации посетителя.
• SimpleAnnotationValueVisitorы: Поддержка действий по умолчанию и значения возвращаемого значения по умолчанию.

С момента:

1.6