パッケージ org.springframework.xml.xpath

インターフェース XPathOperations

すべての既知の実装クラス:
AbstractXPathTemplate、JaxenXPathTemplate、Jaxp13XPathTemplate
public interface XPathOperations
さまざまな XPathTemplates によって実装される XPath 操作の基本セットを指定するインターフェース。多数の評価方法が含まれています。

このインターフェースを実装するテンプレートは、プリコンパイルされた XPath 式を使用しません。最適なパフォーマンスを得るには、XPathExpressionFactory または XPathExpressionFactoryBean の使用を検討してください。ただし、柔軟性は低くなります。

導入:
1.0.0
作成者:
Arjen Poutsma
関連事項:

  • メソッドの詳細

    • evaluateAsBoolean

      boolean evaluateAsBoolean(StringSE expression, SourceSE context) throws XPathException
      指定された式を boolean として評価します。式のブール評価を返します。無効な場合は false を返します。

      戻り値は、XPath 仕様で定義されている boolean() 関数に従って決定されます。つまり、ゼロノードを選択する式は false を返し、1 つ以上のノードを選択する式は true を返します。文字列を返す式は、空の文字列の場合は false を返し、他のすべての文字列の場合は true を返します。数値を返す式は、ゼロの場合は false を返し、ゼロ以外の数値の場合は true を返します。

      パラメーター:
      expression - XPath 式
      context - コンテキストの開始点
      戻り値:
      評価の結果
      例外:
      XPathException - XPath エラーの場合
      関連事項:

    • evaluateAsNode

      NodeSE evaluateAsNode(StringSE expression, SourceSE context) throws XPathException
      指定された式を NodeSE として評価します。式の評価を返します。無効な場合は null を返します。
      パラメーター:
      expression - XPath 式
      context - コンテキストの開始点
      戻り値:
      評価の結果
      例外:
      XPathException - XPath エラーの場合
      関連事項:

    • evaluateAsNodeList

      ListSE<NodeSE> evaluateAsNodeList(StringSE expression, SourceSE context) throws XPathException
      指定された式を NodeSE オブジェクトのリストとして評価します。式の評価を返します。結果が見つからない場合は空のリストを返します。
      パラメーター:
      expression - XPath 式
      context - コンテキストの開始点
      戻り値:
      評価の結果
      例外:
      XPathException - XPath エラーの場合
      関連事項:

    • evaluateAsDouble

      double evaluateAsDouble(StringSE expression, SourceSE context) throws XPathException
      指定された式を double として評価します。式の評価を返します。無効な場合は Double.NaNSE を返します。

      戻り値は、XPath 仕様で定義されている number() 関数に従って決定されます。これは、式が複数のノードを選択した場合、最初のノードの数値を返すことを意味します。

      パラメーター:
      expression - XPath 式
      context - コンテキストの開始点
      戻り値:
      評価の結果
      例外:
      XPathException - XPath エラーの場合
      関連事項:

    • evaluateAsString

      StringSE evaluateAsString(StringSE expression, SourceSE context) throws XPathException
      指定された式を StringSE として評価します。式の評価を返します。無効な場合は null を返します。

      戻り値は、XPath 仕様で定義されている string() 関数に従って決定されます。これは、式が複数のノードを選択した場合、最初のノードの文字列値を返すことを意味します。

      パラメーター:
      expression - XPath 式
      context - コンテキストの開始点
      戻り値:
      評価の結果
      例外:
      XPathException - XPath エラーの場合
      関連事項:

    • evaluateAsObject

      <T> T evaluateAsObject(StringSE expression, SourceSE context, NodeMapper<T> nodeMapper) throws XPathException
      指定された式を評価し、単一の NodeSE 結果を NodeMapper を介して Java オブジェクトにマッピングします。
      パラメーター:
      expression - XPath 式
      context - コンテキストの開始点
      nodeMapper - ノードごとに 1 つのオブジェクトをマップするオブジェクト
      戻り値:
      単一のマッピングされたオブジェクト
      例外:
      XPathException - XPath エラーの場合
      関連事項:

    • evaluate

      <T> ListSE<T> evaluate(StringSE expression, SourceSE context, NodeMapper<T> nodeMapper) throws XPathException
      指定された式を評価し、各結果 NodeSE オブジェクトを NodeMapper を介して Java オブジェクトにマッピングします。
      パラメーター:
      expression - XPath 式
      context - コンテキストの開始点
      nodeMapper - ノードごとに 1 つのオブジェクトをマップするオブジェクト
      戻り値:
      マップされたオブジェクトを含む結果リスト
      例外:
      XPathException - XPath エラーの場合
      関連事項:

    • evaluate

      void evaluate(StringSE expression, SourceSE context, NodeCallbackHandler callbackHandler) throws XPathException
      指定された式を評価し、結果の NodeSE オブジェクトをノードごとに NodeCallbackHandler で処理します。
      パラメーター:
      expression - XPath 式
      context - コンテキストの開始点
      callbackHandler - 結果を 1 行ずつ抽出するオブジェクト
      例外:
      XPathException - XPath エラーの場合
      関連事項: