クラス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(String)が引数としてこの値を渡したときにtrueを返す場合、TransformerはこのタイプのResult出力をサポートします。

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

PI_DISABLE_OUTPUT_ESCAPING, PI_ENABLE_OUTPUT_ESCAPING

修飾子と型	フィールド	説明
static final String	PI_DISABLE_OUTPUT_ESCAPING	結果ツリーが出力エスケープを無効にする場合は、送られた処理命令の名前です。
static final String	PI_ENABLE_OUTPUT_ESCAPING	PI_DISABLE_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を設定します。

クラスオブジェクトで宣言されたメソッド

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

修飾子と型	メソッド	説明
protected Object	clone()	このオブジェクトのコピーを作成して、返します。
boolean	equals(Object obj)	このオブジェクトと他のオブジェクトが等しいかどうかを示します。
protected void	finalize()	削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。 最終決定は非推奨であり、将来のリリースで削除される可能性があります。
final Class<?>	getClass()	このObjectの実行時クラスを返します。
int	hashCode()	このオブジェクトに対するハッシュ・コード値を返します。
final void	notify()	このオブジェクトのモニターで待機中のスレッドを1つ再開します。
final void	notifyAll()	このオブジェクトのモニターで待機中のすべてのスレッドを再開します。
String	toString()	オブジェクトの文字列表現を返します。
final void	wait()	現在のスレッドが目覚めるまで待機します。通常、notifiedまたはinterruptedです。
final void	wait(long timeoutMillis)	現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。
final void	wait(long timeoutMillis, int nanos)	現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。

フィールド詳細

FEATURE

public static final String FEATURE

TransformerFactory.getFeature(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

戻り値:

システム識別子。