Module jdk.xml.dom

软件包 org.w3c.dom.xpath

Interface XPathExpression

public interface XPathExpression

XPathExpression接口表示解析和解析的XPath表达式。

另见Document Object Model (DOM) Level 3 XPath Specification 。

方法摘要

Modifier and Type	方法	描述
Object	evaluate(Node contextNode, short type, Object result)	评估此XPath表达式并返回结果。

方法详细信息

evaluate

Object evaluate(Node contextNode,
                short type,
                Object result)
         throws XPathException,
                DOMException

评估此XPath表达式并返回结果。

参数

contextNode -该 context是用于通过浇铸获得的XPathEvaluator的这个XPath expression.If的评估上下文节点 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：节点来自创建此XPathExpression的XPathEvaluator不支持的文档。
NOT_SUPPORTED_ERR：节点不是作为XPath上下文节点允许的类型，或者该XPathExpression不允许请求类型。