Spec-Zone.ru › OpenJDK 21

Класс ElementScanner6<R,P>

java.lang.Object
javax.lang.model.util.AbstractElementVisitor6<R,P>
javax.lang.model.util.ElementScanner6<R,P>
Type Parameters:
R - тип возвращаемого значения методами этого посетителя. Используйте Void для посетителей, которым не нужно возвращать результаты.
P - тип дополнительного параметра методов этого посетителя. Используйте Void для посетителей, которым не нужен дополнительный параметр.
Все реализованные интерфейсы:
ElementVisitor<R,P>
Прямые известные подклассы:
ElementScanner7
@SupportedSourceVersion(RELEASE_6) public class ElementScanner6<R,P> extends AbstractElementVisitor6<R,P>
Посетитель сканирования элементов программы с поведением по умолчанию, подходящим для RELEASE_6 версии исходного кода. Методы visitXyz в этом классе сканируют свои составные элементы, вызывая scan для своих вложенных элементов, параметров и т. д., как указано в спецификациях отдельных методов. Подкласс может управлять порядком посещения элементов, переопределяя методы visitXyz. Обратите внимание, что клиенты сканера могут получить желаемое поведение, вызвав v.scan(e, p) вместо v.visit(e, p) на корневых объектах интереса.

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

Примечание API:
Методы этого класса могут быть переопределены в соответствии с их общим контрактом.

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

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

С:
1.6
См. также:
  • ElementScanner7
  • ElementScanner8
  • ElementScanner9
  • ElementScanner14

Краткое описание полей

Модификатор и тип Поле Описание
protected final R DEFAULT_VALUE
Указанное значение по умолчанию.

Краткое описание конструкторов

ElementScanner6()
ElementScanner6(R defaultValue)
Модификатор Конструктор Описание
protected
Устарел.
Версия 6 устарела; обновите до посетителя для более новой версии.
protected
Устарел.
Версия 6 устарела; обновите до посетителя для более новой версии.

Краткое описание методов

Модификатор и тип Метод Описание
final R scan(Iterable<? extends Element> iterable, P p)
Итерирует по заданным элементам и вызывает scan(Element, P) для каждого.
final R scan(Element e)
Метод-утилита, эквивалентный v.scan(e, null).
R scan(Element e, P p)
Обрабатывает элемент, вызывая e.accept(this, p); этот метод может быть переопределен подклассами.
R visitExecutable(ExecutableElement e, P p)
Посещает элемент исполняемого кода.
R visitPackage(PackageElement e, P p)
Посещает элемент пакета.
R visitType(TypeElement e, P p)
Посещает элемент типа.
R visitTypeParameter(TypeParameterElement e, P p)
Посещает элемент параметра типа.
R visitVariable(VariableElement e, P p)
Посещает элемент переменной.

Методы, объявленные в классе javax.lang.model.util.AbstractElementVisitor6

visit, visit, visitModule, visitRecordComponent, visitUnknown

Методы, объявленные в классе java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Подробное описание полей

DEFAULT_VALUE

protected final R DEFAULT_VALUE
Указанное значение по умолчанию.

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

ElementScanner6

@Deprecated(since="9") protected ElementScanner6()
Устаревший.
Релиз 6 устарел; обновите на посетителя для более нового уровня выпуска.
Конструктор для конкретных подклассов; использует null для значения по умолчанию.

ElementScanner6

@Deprecated(since="9") protected ElementScanner6(R defaultValue)
Устаревший.
Релиз 6 устарел; обновите на посетителя для более нового уровня выпуска.
Конструктор для конкретных подклассов; использует аргумент в качестве значения по умолчанию.
Параметры:
defaultValue - значение по умолчанию

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

scan

public final R scan(Iterable<? extends Element> iterable, P p)
Итерирует по заданным элементам и вызывает scan(Element, P) для каждого из них. Возвращает результат последнего вызова scan или DEFAULT_VALUE для пустого итерируемого объекта.
Параметры:
iterable - сканируемые элементы
p - дополнительный параметр
Возвращает:
сканирование последнего элемента или DEFAULT_VALUE если элементов нет

scan

public R scan(Element e, P p)
Обрабатывает элемент, вызывая e.accept(this, p); этот метод может быть переопределён подклассами.
Параметры:
e - сканируемый элемент
p - параметр, указанный сканером
Возвращает:
результат посещения e.

scan

public final R scan(Element e)
Метод-утилита, эквивалентный v.scan(e, null).
Параметры:
e - сканируемый элемент
Возвращает:
результат сканирования e.

visitPackage

public R visitPackage(PackageElement e, P p)
Посещает элемент пакета.
Требования к реализации:
Эта реализация сканирует вложенные элементы.
Параметры:
e - элемент для посещения
p - параметр, указанный посетителем
Возвращает:
результат сканирования

visitType

public R visitType(TypeElement e, P p)
Посещает элемент типа.
Требования к реализации:
Эта реализация сканирует вложенные элементы. Обратите внимание, что параметры типа не сканируются этой реализацией, так как параметры типа не считаются вложенными элементами типа.
Параметры:
e - элемент для посещения
p - параметр, указанный посетителем
Возвращает:
результат сканирования

visitVariable

public R visitVariable(VariableElement e, P p)
Посещает элемент переменной.
Требования к реализации:
Эта реализация сканирует вложенные элементы, за исключением случаев, когда элемент является RESOURCE_VARIABLE, в этом случае вызывается visitUnknown.
Параметры:
e - элемент для посещения
p - параметр, указанный посетителем
Возвращает:
результат сканирования

visitExecutable

public R visitExecutable(ExecutableElement e, P p)
Посещает элемент исполняемого кода.
Требования к реализации:
Эта реализация сканирует параметры. Обратите внимание, что параметры типа не сканируются этой реализацией.
Параметры:
e - элемент для посещения
p - параметр, указанный посетителем
Возвращает:
результат сканирования

visitTypeParameter

public R visitTypeParameter(TypeParameterElement e, P p)
Посещает элемент параметра типа.
Требования к реализации:
Эта реализация сканирует вложенные элементы.
Параметры:
e - элемент для посещения
p - параметр, указанный посетителем
Возвращает:
результат сканирования

© 1993, 2023, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/21/docs/api/java.compiler/javax/lang/model/util/ElementScanner6.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API