Класс ElementScanner7<R,​P>

@SupportedSourceVersion(RELEASE_7)
public class ElementScanner7<R,P>
extends ElementScanner6<R,​P>

Посетитель для сканирования элементов программы с поведением по умолчанию, соответствующим RELEASE_7 версии исходного кода. Методы visitXyz в этом классе сканируют свои составные элементы, вызывая scan для своих вложенных элементов, параметров и т.д., как указано в спецификациях отдельных методов. Подкласс может контролировать порядок посещения элементов, переопределяя методы visitXyz. Обратите внимание, что клиенты сканера могут получить желаемое поведение, вызывая v.scan(e, p) вместо v.visit(e, p) для корневых объектов, которые их интересуют.

Когда подкласс переопределяет метод visitXyz, новый метод может заставить вложенные элементы быть отсканированными стандартным способом, вызвав super.visitXyz. Таким образом, конкретный посетитель может контролировать порядок обхода составных элементов относительно дополнительной обработки; например, последовательное вызов super.visitXyz в начале переопределенных методов даст обход в порядке обхода, и т.д. Если составные элементы должны быть обходятся в другом порядке, вместо вызова super.visitXyz, переопределенный метод посещения должен вызвать scan с элементами в нужном порядке.

Методы в этом классе могут быть переопределены в соответствии с их общим контрактом. Обратите внимание, что аннотирование методов в конкретных подклассах с @Override поможет гарантировать, что методы будут переопределены как предполагалось.

ПРЕДУПРЕЖДЕНИЕ: Интерфейс ElementVisitor реализованный этим классом, может иметь методы, добавленные в будущем, чтобы вместить новые, пока неизвестные, языковые структуры, добавленные в будущие версии языка программирования Java™. Поэтому к этому классу могут быть добавлены методы, имена которых начинаются с "visit"; чтобы избежать несовместимости, классы, которые расширяют этот класс, не должны объявлять какие-либо методы экземпляров с именами, начинающимися с "visit".

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

Подробное описание конструкторов

ElementScanner7

protected ElementScanner7()

Конструктор для конкретных подклассов; использует null в качестве значения по умолчанию.

ElementScanner7

protected ElementScanner7(R defaultValue)

Конструктор для конкретных подклассов; использует переданное значение в качестве значения по умолчанию.

Параметры:

defaultValue — значение по умолчанию

Подробное описание методов

visitVariable

public R visitVariable(VariableElement e,
                       P p)

Посещает элемент переменной.

Определено в:

visitVariable в интерфейсе ElementVisitor<R,​P>

Переопределяет:

visitVariable в классе ElementScanner6<R,​P>

Требования реализации:

Эта реализация сканирует вложенные элементы.

Параметры:

e — элемент для посещения

p — параметр, заданный посетителем

Возвращает:

результат сканирования