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

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

protected ElementScanner8()

protected ElementScanner8(R defaultValue)