javax.xml.transform.dom
類別 DOMResult

java.lang.Object
  javax.xml.transform.dom.DOMResult

所有已實作的介面：

Result

直接已知子類別：

SAAJResult

public class DOMResult
extends Object
implements Result

以 Document Object Model（DOM）階層樹的形式充當轉換結果階層樹的持有者。

如果未設置輸出 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 節點創建新輸出目標，此目標指定了子節點，其中結果節點為指定 System ID 且應該插入到該子節點之前。

DOMResult(Node node, String systemId)
使用 DOM 節點創建帶有指定 System ID 的新輸出目標。

方法摘要

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 節點創建帶有指定 System ID 的新輸出目標。

實際上，該節點應該是 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 節點創建新輸出目標，此目標指定了子節點，其中結果節點為指定 System ID 且應該插入到該子節點之前。

實際上，node 和 nextSibling 應該是 Document 節點、DocumentFragment 節點或 Element 節點。換句話說，應該是接受子級的節點。

使用 nextSibling 來指定應該插入的結果節點之後的子節點。如果 nextSibling 不是 node 的兄弟結點，則拋出 IllegalArgumentException。如果 node 為 null 且 nextSibling 不為 null，則拋出 IllegalArgumentException。如果 nextSibling 為 null，則行為將與調用 DOMResult(Node node, String systemId) 相同，即將結果節點追加為指定節點的最後一個子節點，並使用指定 System 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。

指定者：

介面 Result 中的 setSystemId

參數：

systemId - URI 字元串形式的系統標識符。

getSystemId

public String getSystemId()

獲取系統標識符。

如果沒有通過 DOMResult(Node node, String systemId)、DOMResult(Node node, Node nextSibling, String systemId) 或 setSystemId(String systemId) 設置 System ID，則將返回 null。

指定者：

介面 Result 中的 getSystemId

返回：

系統標識符。