public interface ReqRespListener
From the standpoint of the sender, a message is sent via the SOAPConnection
method call
in
a point-to-point fashion. The method call
blocks, waiting until it gets a response message that it can
return. The sender may be a standalone client, or it may be deployed in a container.
The receiver, typically a service operating in a servlet, implements the ReqRespListener
method
onMessage
to specify how to respond to the requests it receives.
It is possible that a standalone client might use the method call
to send a message that does not
require a response. For such cases, the receiver must implement the method onMessage
such that it
returns a message whose only purpose is to unblock the call
method.
JAXMServlet
,
OnewayListener
,
SOAPConnection.call(javax.xml.soap.SOAPMessage, java.lang.Object)
Modifier and Type | Method and Description |
---|---|
javax.xml.soap.SOAPMessage |
onMessage(javax.xml.soap.SOAPMessage message)
Passes the given
SOAPMessage object to this ReqRespListener object and returns the
response. |
javax.xml.soap.SOAPMessage onMessage(javax.xml.soap.SOAPMessage message)
SOAPMessage
object to this ReqRespListener
object and returns the
response. This method is invoked behind the scenes, typically by the container (servlet or EJB container) after the
messaging provider delivers the message to the container.
It is expected that EJB Containers will deliver JAXM messages to EJB components using message driven Beans that
implement the javax.xml.messaging.ReqRespListener
interface.message
- the SOAPMessage
object to be passed to this ReqRespListener
objectnull
, then the original message is treated as a "oneway" message.Copyright (c) 2010, 2017 Oracle and/or its affiliates. All rights reserved.