Интерфейс SourcePositions

Все известные подинтерфейсы:: DocSourcePositions

public interface SourcePositions

Предоставляет методы для получения позиции дерева в CompilationUnit. Позиция определяется как простое смещение в символах от начала CompilationUnit, где первый символ находится по смещению 0.

С версии:: 1.6

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

Модификатор и тип	Метод	Описание
`long`	`getEndPosition(CompilationUnitTree file, Tree tree)`	Возвращает конечную позицию дерева в файле.
`long`	`getStartPosition(CompilationUnitTree file, Tree tree)`	Возвращает начальную позицию дерева в файле.

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

getStartPosition

long getStartPosition(CompilationUnitTree file, Tree tree)

Возвращает начальную позицию дерева в файле. Если дерево не найдено в файле или начальная позиция недоступна, возвращает Diagnostic.NOPOS. Возвращаемая позиция должна находиться в начале фрагмента, представленного этим деревом, то есть для любого поддерева этого дерева должно выполняться следующее:

getStartPosition(file, tree) <= getStartPosition(file, subtree) или
getStartPosition(file, tree) == NOPOS или
getStartPosition(file, subtree) == NOPOS

Параметры:: file — CompilationUnit, в котором нужно найти дерево; tree — дерево, позиция которого требуется определить
Возвращает:: начальную позицию дерева

getEndPosition

long getEndPosition(CompilationUnitTree file, Tree tree)

Возвращает конечную позицию дерева в файле. Если дерево не найдено в файле или конечная позиция недоступна, возвращает Diagnostic.NOPOS. Возвращаемая позиция должна находиться в конце фрагмента, представленного этим деревом, то есть для любого поддерева этого дерева должно выполняться следующее:

getEndPosition(file, tree) >= getEndPosition(file, subtree) или
getEndPosition(file, tree) == NOPOS или
getEndPosition(file, subtree) == NOPOS

Кроме того, должно выполняться следующее:

getStartPosition(file, tree) <= getEndPosition(file, tree) или
getStartPosition(file, tree) == NOPOS или
getEndPosition(file, tree) == NOPOS

Параметры:: file — CompilationUnit, в котором нужно найти дерево; tree — дерево, позиция которого требуется определить
Возвращает:: конечную позицию дерева

© 1993, 2025, 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/25/docs/api/jdk.compiler/com/sun/source/util/SourcePositions.html