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

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

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。