public interface LogicalMessage
The
LogicalMessage
interface represents a
protocol agnostic XML message and contains methods that
provide access to the payload of the message.-
Method Summary
Modifier and TypeMethodDescriptionGets the message payload as an XML source, may be called multiple times on the same LogicalMessage instance, always returns a newSource
that may be used to retrieve the entire message payload.getPayload
(jakarta.xml.bind.JAXBContext context) Gets the message payload as a Jakarta XML Binding object.void
setPayload
(Object payload, jakarta.xml.bind.JAXBContext context) Sets the message payloadvoid
setPayload
(Source payload) Sets the message payload
-
Method Details
-
getPayload
Source getPayload()Gets the message payload as an XML source, may be called multiple times on the same LogicalMessage instance, always returns a newSource
that may be used to retrieve the entire message payload.If the returned
Source
is an instance ofDOMSource
, then modifications to the encapsulated DOM tree change the message payload in-place, there is no need to subsequently callsetPayload
. Other types ofSource
provide only read access to the message payload.- Returns:
- The contained message payload; returns
null
if no payload is present in this message.
-
setPayload
Sets the message payload- Parameters:
payload
- message payload- Throws:
WebServiceException
- If any error during the setting of the payload in this messageUnsupportedOperationException
- If this operation is not supported
-
getPayload
Gets the message payload as a Jakarta XML Binding object. Note that there is no connection between the returned object and the message payload, changes to the payload require callingsetPayload
.- Parameters:
context
- The JAXBContext that should be used to unmarshall the message payload- Returns:
- The contained message payload; returns
null
if no payload is present in this message - Throws:
WebServiceException
- If an error occurs when using a supplied JAXBContext to unmarshall the payload. The cause of the WebServiceException is the original JAXBException.
-
setPayload
Sets the message payload- Parameters:
payload
- message payloadcontext
- The JAXBContext that should be used to marshall the payload- Throws:
UnsupportedOperationException
- If this operation is not supportedWebServiceException
- If an error occurs when using the supplied JAXBContext to marshall the payload. The cause of the WebServiceException is the original JAXBException.
-