模块 jdk.xml.dom
包 org.w3c.dom.xpath

接口 XPathExpression

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

另见 文档对象模型 (DOM) 级别 3 XPath 规范 。

  • 方法总结

    修饰符和类型
    方法
    描述
    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：节点来自创建此 XPathExpression 的 XPathEvaluator 不支持的文档。
      NOT_SUPPORTED_ERR：节点不是允许作为 XPath 上下文节点的类型，或者此 XPathExpression 不允许请求类型。