インターフェース XPathExpression


public interface XPathExpression
プリコンパイルされた XPath 式の契約を定義します。具体的なインスタンスは、XPathExpressionFactory を介して取得できます。

このインターフェースの実装はプリコンパイルされているため、XPathOperations 実装で使用される XPath 式よりも高速ですが、柔軟性が低くなります。

導入:
1.0.0
作成者:
Arjen Poutsma
  • メソッドの詳細

    • evaluateAsBoolean

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

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

      パラメーター:
      node - 出発点
      戻り値:
      評価の結果
      例外:
      XPathException - XPath エラーの場合
      関連事項:
    • evaluateAsNode

      NodeSE evaluateAsNode(NodeSE node) throws XPathException
      指定された式を NodeSE として評価します。式の評価を返します。無効な場合は null を返します。
      パラメーター:
      node - 出発点
      戻り値:
      評価の結果
      例外:
      XPathException - XPath エラーの場合
      関連事項:
    • evaluateAsNodeList

      ListSE<NodeSE> evaluateAsNodeList(NodeSE node) throws XPathException
      指定された式を評価し、それに準拠するすべての NodeSE オブジェクトを返します。結果が見つからなかった場合は、空のリストを返します。
      パラメーター:
      node - 出発点
      戻り値:
      式によって選択される Node のリスト
      例外:
      XPathException - XPath エラーの場合
      関連事項:
    • evaluateAsNumber

      double evaluateAsNumber(NodeSE node) throws XPathException
      指定された式を数値(double)として評価します。式の数値評価を返します。無効な場合は Double.NaNSE を返します。

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

      パラメーター:
      node - 出発点
      戻り値:
      評価の結果
      例外:
      XPathException - XPath エラーの場合
      関連事項:
    • evaluateAsString

      StringSE evaluateAsString(NodeSE node) throws XPathException
      指定された式を文字列として評価します。結果が見つからなかった場合は null を返します。

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

      パラメーター:
      node - 出発点
      戻り値:
      評価の結果
      例外:
      XPathException - XPath エラーの場合
      関連事項:
    • evaluateAsObject

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

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