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.

Since:

JAX-WS 2.0

Method Summary

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

Method Detail

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.

Returns:

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

setPayload

void setPayload(Source payload)

Sets the message payload

Parameters:

payload - message payload

Throws:

WebServiceException - If any error during the setting of the payload in this message

UnsupportedOperationException - If this operation is not supported