JavaTM Platform
Standard Ed. 6

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,它会将结果写入提供的 SOAPMessageSOAPPart 中。
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 的方法。当用于转换时,结果被填充到内部创建的 SOAPMessageSOAPPart 中。由 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 的方法。当用于转换时,结果被填充到内部创建的 SOAPMessageSOAPPart 中。由 DOMResult.getNode() 返回的 SOAPPart 不能保证格式良好。

参数:
protocol - 所得 SAAJ 树应支持的 SOAP 协议的名称
抛出:
SOAPException - 如果无法创建支持指定协议的 SOAPMessage
从以下版本开始:
SAAJ 1.3

SAAJResult

public SAAJResult(SOAPMessage message)
创建一个 SAAJResult,它会将结果写入提供的 SOAPMessageSOAPPart 中。在正常情况下,将使用 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

JavaTM Platform
Standard Ed. 6

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

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