モジュール java.xml
パッケージ javax.xml.transform.dom

クラスDOMResult

java.lang.Object
javax.xml.transform.dom.DOMResult
すべての実装されたインタフェース:
Result
public class DOMResult
extends Object
implements Result
DOM (Document Object Model)ツリーの形式で、変換結果ツリーのホルダーとして動作します。

出力DOMソースが設定されていない場合、変換によって変換の結果のホルダーとしてDocumentノードが作成されます。このノードはgetNode()を使用して取得できます。

導入されたバージョン:
1.4

  • フィールドのサマリー

    フィールド 
    修飾子と型 フィールド 説明
    static String FEATURE
    この値を引数として渡したときにTransformerFactory.getFeature(java.lang.String)がtrueを返す場合、Transformerはこの型のResult出力をサポートします。

    インタフェース javax.xml.transform.Resultで宣言されたフィールド

    PI_DISABLE_OUTPUT_ESCAPING, PI_ENABLE_OUTPUT_ESCAPING

  • コンストラクタのサマリー

    コンストラクタ 
    コンストラクタ 説明
    DOMResult()
    デフォルトの引数なしのコンストラクタ。
    DOMResult​(Node node)
    DOMノードを使用して新しい出力ターゲットを作成します。
    DOMResult​(Node node, String systemId)
    DOMノードを使用して、指定されたシステム識別子を持つ新しい出力ターゲットを作成します。
    DOMResult​(Node node, Node nextSibling)
    DOMノードを使用して、結果ノードを挿入する直前の子ノードを指定する新しい出力ターゲットを作成します。
    DOMResult​(Node node, Node nextSibling, String systemId)
    DOMノードを使用して、結果ノードを挿入する位置の子ノードを指定する新しい出力ターゲットと、指定されたシステム識別子を作成します。

  • メソッドのサマリー

    修飾子と型 メソッド 説明
    Node getNextSibling()
    結果ノードが挿入される直前の子ノードを取得します。
    Node getNode()
    結果DOMツリーを含むノードを取得します。
    String getSystemId()
    システム識別子を取得します。
    void setNextSibling​(Node nextSibling)
    結果ノードが挿入される直前の子ノードを設定します。
    void setNode​(Node node)
    結果DOMツリーを含むノードを設定します。
    void setSystemId​(String systemId)
    ノードと関連付けて使用できるsystemIDを設定します。

    クラス java.lang.Objectで宣言されたメソッド

    clone、equals、finalize、getClass、hashCode、notify、notifyAll、toString、wait、wait、wait

  • フィールド詳細

  • コンストラクタの詳細

    • DOMResult

      public DOMResult()
      デフォルトの引数なしのコンストラクタ。

      node、siblingNode、およびsystemIdはnullに設定されます。

    • DOMResult

      public DOMResult​(Node node)
      DOMノードを使用して新しい出力ターゲットを作成します。

      実際には、ノードはDocumentノード、DocumentFragmentノード、またはElementノードです。 つまり、子を受け取るノードとなります。

      siblingNodeおよびsystemIdはnullに設定されます。

      パラメータ:
      node - 結果ツリーを含むDOMノード。

    • DOMResult

      public DOMResult​(Node node, String systemId)
      DOMノードを使用して、指定されたシステム識別子を持つ新しい出力ターゲットを作成します。

      実際には、ノードはDocumentノード、DocumentFragmentノード、またはElementノードです。 つまり、子を受け取るノードとなります。

      siblingNodeはnullに設定されます。

      パラメータ:
      node - 結果ツリーを含むDOMノード。
      systemId - このノードと関連付けて使用できるシステム識別子。

    • DOMResult

      public DOMResult​(Node node, Node nextSibling)
      DOMノードを使用して、結果ノードを挿入する直前の子ノードを指定する新しい出力ターゲットを作成します。

      実際には、nodeおよびnextSiblingはDocumentノード、DocumentFragmentノード、またはElementノードです。 つまり、子を受け取るノードとなります。

      nextSiblingを使用して、結果ノードが挿入される直前の子ノードを指定します。 nextSiblingがnodeの兄弟ウィジェットでない場合は、IllegalArgumentExceptionがスローされます。 nodeがnullで、nextSiblingがnullでない場合は、IllegalArgumentExceptionがスローされます。 nextSiblingがnullの場合は、DOMResult(Node node)の呼び出しと同じ動作になります。つまり、結果ノードが指定されたnodeの最後の子として追加されます。

      systemIdはnullに設定されます。

      パラメータ:
      node - 結果ツリーを含むDOMノード。
      nextSibling - 結果ノードが挿入される直前の子ノード。
      例外:
      IllegalArgumentException - nextSiblingがnodeの兄弟ウィジェットでないか、またはnodeがnullで、nextSiblingがnullでない場合。
      導入されたバージョン:
      1.5

    • DOMResult

      public DOMResult​(Node node, Node nextSibling, String systemId)
      DOMノードを使用して、結果ノードを挿入する位置の子ノードを指定する新しい出力ターゲットと、指定されたシステム識別子を作成します。

      実際には、nodeおよびnextSiblingはDocumentノード、DocumentFragmentノード、またはElementノードです。 つまり、子を受け取るノードとなります。

      nextSiblingを使用して、結果ノードが挿入される直前の子ノードを指定します。 nextSiblingがnodeの兄弟ウィジェットでない場合は、IllegalArgumentExceptionがスローされます。 nodeがnullで、nextSiblingがnullでない場合は、IllegalArgumentExceptionがスローされます。 nextSiblingがnullの場合は、DOMResult(Node node, String systemId)の呼出しと同じ動作になります。つまり、結果ノードが指定されたノードの最後の子として追加され、指定されたシステムIDが使用されます。

      パラメータ:
      node - 結果ツリーを含むDOMノード。
      nextSibling - 結果ノードが挿入される直前の子ノード。
      systemId - このノードと関連付けて使用できるシステム識別子。
      例外:
      IllegalArgumentException - nextSiblingがnodeの兄弟ウィジェットでないか、またはnodeがnullで、nextSiblingがnullでない場合。
      導入されたバージョン:
      1.5

  • メソッドの詳細

    • setNode

      public void setNode​(Node node)
      結果DOMツリーを含むノードを設定します。

      実際には、ノードはDocumentノード、DocumentFragmentノード、またはElementノードです。 つまり、子を受け取るノードとなります。

      nextSiblingがnullでなく、nodeがnextSiblingの親でない場合、IllegalStateExceptionがスローされます。 nodeがnullで、nextSiblingがnullでない場合はIllegalStateExceptionがスローされます。

      パラメータ:
      node - 変換の追加先のノード。
      例外:
      IllegalStateException - nextSiblingがnullでなく、nextSiblingがnodeの子でないか、またはnodeがnullで、nextSiblingがnullでない場合。

    • getNode

      public Node getNode()
      結果DOMツリーを含むノードを取得します。

      DOMResult(Node node)、DOMResult(Node node, String systeId)、DOMResult(Node node, Node nextSibling)、DOMResult(Node node, Node nextSibling, String systemId)、またはsetNode(Node node)を使用して設定されたノードがない場合、変換によってノードが設定され、変換完了時にこのメソッドから取得されます。 変換の前にこのメソッドを呼び出すとnullが返されます。

      戻り値:
      変換の追加先のノード。

    • setNextSibling

      public void setNextSibling​(Node nextSibling)
      結果ノードが挿入される直前の子ノードを設定します。

      nextSiblingを使用して、結果ノードが挿入される直前の子ノードを指定します。 nextSiblingがnodeの下位ノードでない場合は、IllegalArgumentExceptionがスローされます。 nodeがnullで、nextSiblingがnullでない場合は、IllegalStateExceptionがスローされます。 nextSiblingがnullの場合は、DOMResult(Node node)の呼び出しと同じ動作になります。つまり、結果ノードが指定されたnodeの最後の子として追加されます。

      パラメータ:
      nextSibling - 結果ノードが挿入される直前の子ノード。
      例外:
      IllegalArgumentException - nextSiblingがnodeの下位でない場合。
      IllegalStateException - nodeがnullで、nextSiblingがnullでない場合。
      導入されたバージョン:
      1.5

    • getNextSibling

      public Node getNextSibling()
      結果ノードが挿入される直前の子ノードを取得します。

      DOMResult(Node node, Node nextSibling)、DOMResult(Node node, Node nextSibling, String systemId)、またはsetNextSibling(Node nextSibling)によって設定されたノードがない場合、nullが返されます。

      戻り値:
      結果ノードが挿入される直前の子ノード。
      導入されたバージョン:
      1.5

    • setSystemId

      public void setSystemId​(String systemId)
      ノードと関連付けて使用できるsystemIDを設定します。
      定義:
      setSystemId、インタフェース: Result
      パラメータ:
      systemId - URI文字列としてのシステム識別子。

    • getSystemId

      public String getSystemId()
      システム識別子を取得します。

      DOMResult(Node node, String systemId)、DOMResult(Node node, Node nextSibling, String systemId)、またはsetSystemId(String systemId)によって設定されたシステムIDがない場合、nullが返されます。

      定義:
      getSystemId、インタフェース: Result
      戻り値:
      システム識別子。