public interface LogicalMessage
The LogicalMessage
interface represents a protocol agnostic XML message and contains methods that provide access to the payload of the message.
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.
null
if no payload is present in this message.void setPayload(Source payload)
Sets the message payload
payload
- message payloadWebServiceException
- If any error during the setting of the payload in this messageUnsupportedOperationException
- If this operation is not supportedObject 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 payloadnull
if no payload is present in this messageWebServiceException
- If an error occurs when using a supplied JAXBContext to unmarshall the payload. The cause of the WebServiceException is the original JAXBException.void setPayload(Object payload, JAXBContext context)
Sets the message payload
payload
- message payloadcontext
- The JAXBContext that should be used to marshall the payloadUnsupportedOperationException
- 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.
© 1993–2017, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.