Интерфейс XPathExpression
public interface XPathExpression
Интерфейс
XPathExpression представляет собой разобранное и разрешённое XPath-выражение. См. также Спецификацию XPath для объектной модели документа (DOM) уровня 3.
- Начиная с:
- 1.4, DOM уровня 3
Краткое описание методов
Подробное описание методов
evaluate
Object evaluate(Node contextNode, short type, Object result) throws XPathException, DOMException
Вычисляет это XPath-выражение и возвращает результат.
- Параметры:
-
contextNode—contextявляется контекстным узлом для вычисления этого XPath-выражения. Если XPathEvaluator был получен приведением типаDocument, этот узел должен принадлежать тому же документу и быть узлом типаDocument,Element,Attribute,Text,CDATASection,Comment,ProcessingInstructionилиXPathNamespace. Если контекстный узел являетсяTextилиCDATASection, то контекст интерпретируется как целый логический текстовый узел в представлении XPath, если только узел не пуст; пустой узел не может использоваться в качестве контекста XPath. -
type— если указан конкретныйtype, результат будет приведён к указанному типу с использованием преобразований XPath; вызов завершится ошибкой, если требуемое преобразование невозможно. Это должен быть один из кодов типовXPathResult. -
result—resultзадаёт конкретный объект результата, который может быть повторно использован и возвращён этим методом. Если указано значениеnullили реализация не повторно использует заданный результат, будет создан и возвращён новый объект результата. Для результатов XPath 1.0 этот объект будет иметь типXPathResult. - Возвращает:
- Результат вычисления XPath-выражения. Для результатов XPath 1.0 этот объект будет иметь тип
XPathResult. - Выбрасывает:
-
XPathException— TYPE_ERR: возникает, если результат невозможно преобразовать к указанному типу. -
DOMException— WRONG_DOCUMENT_ERR: узел Node принадлежит документу, который не поддерживается XPathEvaluator, создавшим этотXPathExpression.
NOT_SUPPORTED_ERR: узел Node имеет тип, который не допускается в качестве контекстного узла XPath, либо запрошенный тип не допускается этимXPathExpression.
© 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.xml.dom/org/w3c/dom/xpath/XPathExpression.html