-
public interface LogicalMessage
TheLogicalMessage
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
Methods Modifier and Type Method and Description 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.Object
getPayload(JAXBContext context)
Gets the message payload as a JAXB object.void
setPayload(Object payload, JAXBContext context)
Sets the message payloadvoid
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 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 susequently 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
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 messageUnsupportedOperationException
- 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 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
void setPayload(Object payload, JAXBContext context)
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.
-
-
Document created the 11/06/2005, last modified the 04/03/2020
Source of the printed document:https://www.gaudry.be/en/java-api-rf-javax/xml/ws/LogicalMessage.html
The infobrol is a personal site whose content is my sole responsibility. The text is available under CreativeCommons license (BY-NC-SA). More info on the terms of use and the author.
References
These references and links indicate documents consulted during the writing of this page, or which may provide additional information, but the authors of these sources can not be held responsible for the content of this page.
The author This site is solely responsible for the way in which the various concepts, and the freedoms that are taken with the reference works, are presented here. Remember that you must cross multiple source information to reduce the risk of errors.