Интерфейс XPathExpression
public interface XPathExpression
Интерфейс
XPathExpression представляет собой разобранное и разрешенное выражение XPath. См. также Спецификацию XPath уровня 3 для Document Object Model (DOM).
- С:
- 1.4, DOM Level 3
Краткое описание методов
Подробное описание методов
evaluate
Object evaluate(Node contextNode, short type, Object result) throws XPathException, DOMException
Вычисляет это выражение XPath и возвращает результат.
- Параметры:
-
contextNode- Узел контекста для вычисления этого выражения 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: Узел принадлежит документу, который не поддерживается XPathEvaluator, создавшим этотXPathExpression.
NOT_SUPPORTED_ERR: Узел не является типом, разрешённым как узел контекста 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://download.java.net/java/early_access/jdk24/docs/api/jdk.xml.dom/org/w3c/dom/xpath/XPathExpression.html