Интерфейс XPathExpression
public interface XPathExpression
Интерфейс XPathExpression представляет собой разобранное и разрешенное выражение XPath.
См. также Спецификацию XPath уровня 3 Document Object Model (DOM).
Методы
| Модификатор и тип | Метод | Описание |
|---|---|---|
Object | evaluate(Node contextNode,
short type,
Object result) | Вычисляет это выражение XPath и возвращает результат. |
Методы
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: Узел принадлежит документу, который не поддерживается XPathEvaluator, который создал этотXPathExpression.
NOT_SUPPORTED_ERR: Узел не является типом, разрешенным в качестве узла контекста XPath или запрашиваемый тип не разрешен этимXPathExpression.
© 1993, 2020, 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/11/docs/api/jdk.xml.dom/org/w3c/dom/xpath/XPathExpression.html