LogicalMessage (Java EE 5 SDK)

Java

Java EE 5 SDK

深圳电信培训中心.徐海蛟老师.


javax.xml.ws Interface LogicalMessage


public interface LogicalMessage

The LogicalMessage interface represents a protocol agnostic XML message and contains methods that provide access to the payload of the message.

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

方法摘要
 Source getPayload()
          Gets the message payload as an XML source, may be called multiple times on the same LogicalMessage instance, always returns a new Source that may be used to retrieve the entire message payload.
 Object getPayload(JAXBContext context)
          Gets the message payload as a JAXB object.
 void setPayload(Object payload, JAXBContext context)
          Sets the message payload
 void setPayload(Source payload)
          Sets the message payload
 

方法详细信息

getPayload

Source getPayload()
Gets the message payload as an XML source, may be called multiple times on the same LogicalMessage instance, always returns a new Source that may be used to retrieve the entire message payload.

If the returned Source is an instance of DOMSource, then modifications to the encapsulated DOM tree change the message payload in-place, there is no need to susequently call setPayload. Other types of Source provide only read access to the message payload.

返回:
The contained message payload; returns null if no payload is present in this message.

setPayload

void setPayload(Source payload)
Sets the message payload

参数:
payload - message payload
抛出异常:
WebServiceException - If any error during the setting of the payload in this message
UnsupportedOperationException - If this operation is not supported

getPayload

Object getPayload(JAXBContext context)
Gets the message payload as a JAXB object. Note that there is no connection between the returned object and the message payload, changes to the payload require calling setPayload.

参数:
context - The JAXBContext that should be used to unmarshall the message payload
返回:
The contained message payload; returns null if no payload is present in this message
抛出异常:
WebServiceException - If an error occurs when using a supplied JAXBContext to unmarshall the payload. The cause of the WebServiceException is the original JAXBException.

setPayload

void setPayload(Object payload,
                JAXBContext context)
Sets the message payload

参数:
payload - message payload
context - The JAXBContext that should be used to marshall the payload
抛出异常:
UnsupportedOperationException - If this operation is not supported
WebServiceException - If an error occurs when using the supplied JAXBContext to marshall the payload. The cause of the WebServiceException is the original JAXBException.

Java EE 5 SDK

深圳电信培训中心.徐海蛟老师.


提交错误或意见

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。深圳电信培训中心.徐海蛟老师教学参考.