Класс ElementScanner8

@SupportedSourceVersion(value=RELEASE_8)
public class ElementScanner8<R,P>
extends ElementScanner7<R,P>

Посетитель для сканирования элементов программы с поведением по умолчанию, подходящим для RELEASE_8 версии исходного кода. Методы 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. Новый класс посетителя сканера элементов также будет введён для соответствия новому уровню языка; этот посетитель будет иметь другое поведение по умолчанию для метода посещения. При введении нового посетителя, весь или части этого посетителя могут быть устаревшими.

Конструкторы

ElementScanner8

protected ElementScanner8()

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

ElementScanner8

protected ElementScanner8(R defaultValue)

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

Параметры:

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