模块 jdk.xml.dom

软件包 org.w3c.dom.xpath

Interface XPathExpression

public interface XPathExpression

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

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

方法摘要

变量和类型	方法	描述
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 node.If上下文节点是一个 Text或 CDATASection ，那么上下文被解释为通过使用XPath作为看到的，除非该节点是在这种情况下它可能不作为XPath的上下文空整个逻辑文本节点。

type - 如果指定了特定的type ，则结果将被强制转换为依赖于XPath转换返回指定的类型，如果无法进行所需的强制，则会失败。 这必须是XPathResult的类型代码之一。

result - result指定可由此方法重用和返回的特定结果对象。 如果将其指定为null或实现未重用指定的结果，则将构造并返回新的结果对象。对于XPath 1.0结果，此对象的类型为XPathResult 。

结果

评估XPath表达式的结果。对于XPath 1.0结果，此对象的类型为 XPathResult 。

异常

XPathException - TYPE_ERR：如果无法转换结果以返回指定类型，则 XPathException异常。

DOMException - WRONG_DOCUMENT_ERR：节点来自创建此XPathExpression的XPathEvaluator不支持的文档。
NOT_SUPPORTED_ERR：节点不是允许作为XPath上下文节点的类型，或者此XPathExpression不允许请求类型。