javax.xml.transform.dom

クラス DOMResult

java.lang.Object

javax.xml.transform.dom.DOMResult

すべての実装されたインタフェース:

Result

直系の既知のサブクラス:

SAAJResult

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() デフォルトの引数なしのコンストラクタ。
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()

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

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

戻り値:

システム識別子。