JavaTM Platform
Standard Ed. 6

javax.xml.ws
接口 LogicalMessage


public interface LogicalMessage

LogicalMessage 接口表示协议无关的 (protocol agnostic) XML 消息,并包含一些方法提供对消息负载的访问。

从以下版本开始:
JAX-WS 2.0

方法摘要
 Source getPayload()
          以 XML 源的形式获取消息负载,可以在相同的 LogicalMessage 实例上多次调用,总是返回可以用来检索整个消息负载的新的 Source。
 Object getPayload(JAXBContext context)
          以 JAXB 对象的形式获取消息负载。
 void setPayload(Object payload, JAXBContext context)
          设置消息负载
 void setPayload(Source payload)
          设置消息负载
 

方法详细信息

getPayload

Source getPayload()
以 XML 源的形式获取消息负载,可以在相同的 LogicalMessage 实例上多次调用,总是返回可以用来检索整个消息负载的新的 Source。

如果返回的 Source 是 DOMSource 的实例,则对封装的 DOM 树的修改现场更改消息负载,不需要随后调用 setPayload。其他类型的 Source 只提供对消息负载的读取访问。

返回:
所含的消息负载;如果此消息中没有净荷,则返回 null。

setPayload

void setPayload(Source payload)
设置消息负载

参数:
payload - 消息负载
抛出:
WebServiceException - 如果在此消息中设置净荷过程中发生任何错误
UnsupportedOperationException - 如果不支持该操作

getPayload

Object getPayload(JAXBContext context)
以 JAXB 对象的形式获取消息负载。注意,返回的对象和消息负载之间没有任何连接,更改净荷需要调用 setPayload

参数:
context - 应该用来解组消息负载的 JAXBContext
返回:
所含的消息负载;如果此消息中没有净荷,则返回 null
抛出:
WebServiceException - 如果使用提供的 JAXBContext 解组净荷时发生错误。WebServiceException 的 cause 是初始 JAXBException。

setPayload

void setPayload(Object payload,
                JAXBContext context)
设置消息负载

参数:
payload - 消息负载
context - 应该用来对净荷进行编组的 JAXBContext
抛出:
UnsupportedOperationException - 如果不支持此操作
WebServiceException - 如果在使用提供的 JAXBContext 对净荷进行编组时发生错误。WebServiceException 的 cause 是初始 JAXBException。

JavaTM Platform
Standard Ed. 6

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

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