インターフェース XPathExpression
public interface XPathExpression
プリコンパイルされた XPath 式の契約を定義します。具体的なインスタンスは、
XPathExpressionFactory
を介して取得できます。 このインターフェースの実装はプリコンパイルされているため、XPathOperations
実装で使用される XPath 式よりも高速ですが、柔軟性が低くなります。
- 導入:
- 1.0.0
- 作成者:
- Arjen Poutsma
メソッドのサマリー
修飾子と型メソッド説明<T> ListSE<T>
evaluate
(NodeSE node, NodeMapper<T> nodeMapper) 指定された式を評価し、各結果Node
SE オブジェクトをNodeMapper
を介して Java オブジェクトにマッピングします。boolean
evaluateAsBoolean
(NodeSE node) 指定された式をboolean
として評価します。evaluateAsNode
(NodeSE node) 指定された式をNode
SE として評価します。evaluateAsNodeList
(NodeSE node) 指定された式を評価し、それに準拠するすべてのNode
SE オブジェクトを返します。double
evaluateAsNumber
(NodeSE node) 指定された式を数値(double
)として評価します。<T> T
evaluateAsObject
(NodeSE node, NodeMapper<T> nodeMapper) 指定された式を評価し、単一のNode
SE 結果をNodeMapper
を介して Java オブジェクトにマッピングします。evaluateAsString
(NodeSE node) 指定された式を文字列として評価します。
メソッドの詳細
evaluateAsBoolean
指定された式をboolean
として評価します。式のブール評価を返します。無効な場合はfalse
を返します。戻り値は、XPath 仕様で定義されている
boolean()
関数に従って決定されます。つまり、ゼロノードを選択する式はfalse
を返し、1 つ以上のノードを選択する式はtrue
を返します。文字列を返す式は、空の文字列の場合はfalse
を返し、他のすべての文字列の場合はtrue
を返します。数値を返す式は、ゼロの場合はfalse
を返し、ゼロ以外の数値の場合はtrue
を返します。- パラメーター:
node
- 出発点- 戻り値:
- 評価の結果
- 例外:
XPathException
- XPath エラーの場合- 関連事項:
evaluateAsNode
指定された式をNode
SE として評価します。式の評価を返します。無効な場合はnull
を返します。- パラメーター:
node
- 出発点- 戻り値:
- 評価の結果
- 例外:
XPathException
- XPath エラーの場合- 関連事項:
evaluateAsNodeList
指定された式を評価し、それに準拠するすべてのNode
SE オブジェクトを返します。結果が見つからなかった場合は、空のリストを返します。- パラメーター:
node
- 出発点- 戻り値:
- 式によって選択される
Node
のリスト - 例外:
XPathException
- XPath エラーの場合- 関連事項:
evaluateAsNumber
指定された式を数値(double
)として評価します。式の数値評価を返します。無効な場合はDouble.NaN
SE を返します。戻り値は、XPath 仕様で定義されている
number()
関数に従って決定されます。これは、式が複数のノードを選択した場合、最初のノードの数値を返すことを意味します。- パラメーター:
node
- 出発点- 戻り値:
- 評価の結果
- 例外:
XPathException
- XPath エラーの場合- 関連事項:
evaluateAsString
指定された式を文字列として評価します。結果が見つからなかった場合はnull
を返します。戻り値は、XPath 仕様で定義されている
string()
関数に従って決定されます。これは、式が複数のノードを選択した場合、最初のノードの文字列値を返すことを意味します。- パラメーター:
node
- 出発点- 戻り値:
- 評価の結果
- 例外:
XPathException
- XPath エラーの場合- 関連事項:
evaluateAsObject
指定された式を評価し、単一のNode
SE 結果をNodeMapper
を介して Java オブジェクトにマッピングします。- パラメーター:
node
- 出発点nodeMapper
- ノードごとに 1 つのオブジェクトをマップするオブジェクト- 戻り値:
- 単一のマッピングされたオブジェクト
- 例外:
XPathException
- XPath エラーの場合- 関連事項:
evaluate
指定された式を評価し、各結果Node
SE オブジェクトをNodeMapper
を介して Java オブジェクトにマッピングします。- パラメーター:
node
- 出発点nodeMapper
- ノードごとに 1 つのオブジェクトをマップするオブジェクト- 戻り値:
- マップされたオブジェクトを含む結果リスト
- 例外:
XPathException
- XPath エラーの場合- 関連事項: