モジュール jdk.xml.dom

パッケージ org.w3c.dom.xpath

インタフェース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は、DocumentをキャストすることによってXPathEvaluatorが取得されたこのXPath expression.Ifを評価するためのコンテキスト・ノードです。このノードは、同じドキュメントによって所有され、Document、Element、Attribute、Text、CDATASection、Comment、ProcessingInstructionである必要があります。または、XPathNamespace node.Ifコンテキスト・ノードがTextまたはCDATASectionの場合、XPathで表示される論理テキスト・ノード全体として解釈されます。ただし、ノードが空の場合、XPathコンテキストとして機能しない可能性があります。

type - 特定のtypeが指定されている場合、結果はXPath変換に依存する指定された型を戻すように強制され、必要な強制が不可能な場合は失敗します。 これは、XPathResultの型コードの1つである必要があります。

result - resultは、このメソッドによって再利用および返される特定の結果オブジェクトを指定します。 これがnullとして指定されている場合、または実装が指定された結果を再利用しない場合、新しい結果オブジェクトが構築され、returned.For XPath 1.0の結果が得られる場合、このオブジェクトはXPathResult型になります。

戻り値:

XPath expression.For XPath 1.0の結果を評価した結果、このオブジェクトはXPathResult型になります。

例外:

XPathException - TYPE_ERR: 結果を変換して、指定された型を返すことができない場合に呼び出されます。

DOMException - WRONG_DOCUMENT_ERR: ノードは、このXPathExpressionを作成したXPathEvaluatorでサポートされていないドキュメントからのものです。
NOT_SUPPORTED_ERR: ノードがXPathコンテキスト・ノードとして許可されているタイプでないか、このXPathExpressionによってリクエスト・タイプが許可されていません。