モジュール 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 final 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

フィールド詳細

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

戻り値:

システム識別子。