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

クラスDOMResult

  • すべての実装されたインタフェース:
    Result
    直系の既知のサブクラス:
    SAAJResult

    public class DOMResult
extends Object
implements Result
    DOM (Document Object Model)ツリーの形式で、変換結果ツリーのホルダーとして動作します。

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

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

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

      コンストラクタ 
      コンストラクタ 説明
      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ノードを使用して、結果ノードを挿入する位置の子ノードを指定する新しい出力ターゲットと、指定されたシステム識別子を作成します。

    • コンストラクタの詳細

      • 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でない場合。

      • 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

      • setSystemId

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