Module jdk.xml.dom
Package org.w3c.dom.xpath

Interface XPathExpression

public interface XPathExpression
XPathExpression接口表示一个解析和解析后的XPath表达式。

另请参阅文档对象模型（DOM）Level 3 XPath规范。

  • Method Summary

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

  • Method Details

    • 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允许。