JavaTM 2 Platform
Standard Ed. 5.0

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() を使用して取得できます。


フィールドの概要
static String FEATURE
          この値を引数として渡したときに TransformerFactory.getFeature(java.lang.String)true を返す場合、Transformer はこの型の Result 出力をサポートします。
 
インタフェース javax.xml.transform.Result から継承されたフィールド
PI_DISABLE_OUTPUT_ESCAPING, PI_ENABLE_OUTPUT_ESCAPING
 
コンストラクタの概要
DOMResult()
          デフォルトの引数なしのコンストラクタ nodesiblingNode、および systemIdnull に設定されます。
DOMResult(Node node)
          DOM ノードを使用して新しい出力ターゲットを作成します。
DOMResult(Node node, Node nextSibling)
          DOM ノードを使用して、結果ノードを挿入する直前の子ノードを指定する新しい出力ターゲットを作成します。
DOMResult(Node node, Node nextSibling, String systemId)
          DOM ノードを使用して、結果ノードを挿入する位置の子ノードを指定する新しい出力ターゲットと、指定されたシステム識別子を作成します。
DOMResult(Node node, 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
 

フィールドの詳細

FEATURE

public static final String FEATURE

この値を引数として渡したときに TransformerFactory.getFeature(java.lang.String)true を返す場合、Transformer はこの型の Result 出力をサポートします。

関連項目:
定数フィールド値
コンストラクタの詳細

DOMResult

public DOMResult()

デフォルトの引数なしのコンストラクタ

nodesiblingNode、および systemIdnull に設定されます。


DOMResult

public DOMResult(Node node)

DOM ノードを使用して新しい出力ターゲットを作成します。

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

siblingNode および systemIdnull に設定されます。

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

DOMResult

public DOMResult(Node node,
                 String systemId)

DOM ノードを使用して、指定されたシステム識別子を持つ新しい出力ターゲットを作成します。

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

siblingNodenull に設定されます。

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

DOMResult

public DOMResult(Node node,
                 Node nextSibling)

DOM ノードを使用して、結果ノードを挿入する直前の子ノードを指定する新しい出力ターゲットを作成します。

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

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

systemIdnull に設定されます。

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

DOMResult

public DOMResult(Node node,
                 Node nextSibling,
                 String systemId)

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

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

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

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

setNode

public void setNode(Node node)

結果 DOM ツリーを含むノードを設定します。

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

nextSiblingnull でなく、nodenextSibling の親でない場合、IllegalStateException がスローされます。nodenullnextSiblingnull でない場合、IllegalStateException がスローされます。

パラメータ:
node - 変換の追加先のノード
例外:
IllegalStateException - nextSiblingnull でなく、nextSiblingnode の子でない場合
IllegalStateException - nodenull で、nextSiblingnull でない場合

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

パラメータ:
nextSibling - 結果ノードが挿入される直前の子ノード
例外:
IllegalArgumentException - nextSiblingnode の下位でない場合
IllegalStateException - nodenull で、nextSiblingnull でない場合
導入されたバージョン:
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 を設定します。

定義:
インタフェース Result 内の setSystemId
パラメータ:
systemId - URI 文字列としてのシステム識別子

getSystemId

public String getSystemId()

システム識別子を取得します。

DOMResult(Node node, String systemId)DOMResult(Node node, Node nextSibling, String systemId)、または setSystemId(String systemId) を使用して設定されたシステム識別子がない場合は、null が返されます。

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

JavaTM 2 Platform
Standard Ed. 5.0

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java 2 SDK SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。