javax.xml.soap
類別 SAAJResult

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

所有已實作的介面：

Result

public class SAAJResult
extends DOMResult

以 SAAJ 階層樹的形式，充當 JAXP 轉換或 JAXB 編組結果的持有者。這些結果應通過使用 getResult() 方法存取。幾乎在所有情況下，都應避免使用 DOMResult.getNode() 方法。

從以下版本開始：

SAAJ 1.3

欄位摘要

從類別 javax.xml.transform.dom.DOMResult 繼承的欄位

FEATURE

從介面 javax.xml.transform.Result 繼承的欄位

PI_DISABLE_OUTPUT_ESCAPING, PI_ENABLE_OUTPUT_ESCAPING

建構子摘要

SAAJResult()
創建一個 SAAJResult，此類別將以支持預設 (SOAP 1.1) 協議的 SAAJ 階層樹的形式顯示結果。

SAAJResult(SOAPElement rootNode)
創建一個 SAAJResult，它會將結果編寫為指定 SOAPElement 的子節點。

SAAJResult(SOAPMessage message)
創建一個 SAAJResult，它會將結果寫入提供的 SOAPMessage 的 SOAPPart 中。

SAAJResult(String protocol)
創建一個 SAAJResult，它將以支持指定協議的 SAAJ 階層樹的形式顯示結果。

方法摘要

Node	getResult()

從類別 javax.xml.transform.dom.DOMResult 繼承的方法

getNextSibling, getNode, getSystemId, setNextSibling, setNode, setSystemId

從類別 java.lang.Object 繼承的方法

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

建構子詳細資訊

SAAJResult

public SAAJResult()
           throws SOAPException

創建一個 SAAJResult，此類別將以支持預設 (SOAP 1.1) 協議的 SAAJ 階層樹的形式顯示結果。

這種 SAAJResult 用在結果將被用作方法參數的情況下，其中的方法指帶有其型別（如 SOAPElement）取自 SAAJ API 的方法。當用於轉換時，結果被填充到內部創建的 SOAPMessage 的 SOAPPart 中。由 DOMResult.getNode() 返回的 SOAPPart 不能保證格式良好。

拋出：

SOAPException - 如果在創建 SOAPMessage 時出現問題

從以下版本開始：

SAAJ 1.3

SAAJResult

public SAAJResult(String protocol)
           throws SOAPException

創建一個 SAAJResult，它將以支持指定協議的 SAAJ 階層樹的形式顯示結果。DYNAMIC_SOAP_PROTOCOL 在此上下文中不明確，並會導致此建構子拋出 UnsupportedOperationException。

這種 SAAJResult 用在結果將被用作方法參數的情況下，其中的方法指帶有其型別（如 SOAPElement）取自 SAAJ API 的方法。當用於轉換時，結果被填充到內部創建的 SOAPMessage 的 SOAPPart 中。由 DOMResult.getNode() 返回的 SOAPPart 不能保證格式良好。

參數：

protocol - 所得 SAAJ 階層樹應支持的 SOAP 協議的名稱

拋出：

SOAPException - 如果無法創建支持指定協議的 SOAPMessage

從以下版本開始：

SAAJ 1.3

SAAJResult

public SAAJResult(SOAPMessage message)

創建一個 SAAJResult，它會將結果寫入提供的 SOAPMessage 的 SOAPPart 中。在正常情況下，將使用 DOM API 編寫這些結果，因此，如果用來創建 SOAPPart 的資料不是格式良好的，則不保證完成的 SOAPPart 格式良好。當在轉換中使用時，轉換之後 SOAPMessage 的有效性只有通過 SAAJ 規範之外的方式才能得到保證。

參數：

message - 訊息，該訊息的 SOAPPart 將會由於某些轉換或編組操作而被填充

從以下版本開始：

SAAJ 1.3

SAAJResult

public SAAJResult(SOAPElement rootNode)

創建一個 SAAJResult，它會將結果編寫為指定 SOAPElement 的子節點。在正常情況下，將使用 DOM API 編寫這些結果，因此可能使 SAAJ 階層樹結構無效。只有在傳入資料的有效性可以通過 SAAJ 規範之外的方式得到保證的情況下，才使用這種 SAAJResult。

參數：

rootNode - 將追加結果的根節點

從以下版本開始：

SAAJ 1.3

方法詳細資訊

getResult

public Node getResult()

返回：

在指定根 Node 下創建的結果 Tree。

從以下版本開始：

SAAJ 1.3