モジュール jdk.xml.dom

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

インタフェースXPathExpression

public interface XPathExpression

XPathExpressionインタフェースは、解析および解決されたXPath式を表します。

「ドキュメント・オブジェクト・モデル(DOM)レベル3 XPath仕様」も参照してください。

導入されたバージョン:

1.4、DOMレベル3

メソッドのサマリー

修飾子と型	メソッド	説明
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 expression.Ifを評価するためのコンテキスト・ノードです。XPathEvaluatorは、Documentをキャストすることで取得され、同じドキュメントによって所有され、Document, Element, Attribute, Text, CDATASection, Comment, ProcessingInstructionまたはXPathNamespace node.Ifのコンテキストである必要があります。nodeは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で許可されていません。