In payload mode , also called message payload mode,
a Dispatch
object works with only the payload of a message. For example, a
Dispatch
object working in payload mode works only with the body of a SOAP
message. The binding layer processes any binding level wrappers and headers. When a result
is returned from invoke()
the binding level wrappers and headers are already
striped away and only the body of the message is left.
Note: When working with a binding that does not use special wrappers, such as the Artix ESB
XML binding, payload mode and message mode provide the same results.
You specify that a Dispatch
object uses payload mode by providing the
value java.xml.ws.Service.Mode.PAYLOAD
when creating the Dispatch
object.