Package jakarta.xml.messaging
Interface ReqRespListener
-
@Deprecated public interface ReqRespListener
Deprecated.since 6.2, will be removed without replacementA marker interface for components that are intended to be consumers of request-response messages. In the request-response style of messaging, sending a request and receiving the response are both done in a single operation. This means that the client sending the request cannot do anything else until after it has received the response.From the standpoint of the sender, a message is sent via the
SOAPConnection
methodcall
in a point-to-point fashion. The methodcall
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
methodonMessage
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 methodonMessage
such that it returns a message whose only purpose is to unblock thecall
method.- See Also:
JAXMServlet
,OnewayListener
,SOAPConnection.call(jakarta.xml.soap.SOAPMessage, java.lang.Object)
-
-
Method Summary
All Methods Instance Methods Abstract Methods Deprecated Methods Modifier and Type Method Description jakarta.xml.soap.SOAPMessage
onMessage(jakarta.xml.soap.SOAPMessage message)
Deprecated.Passes the givenSOAPMessage
object to thisReqRespListener
object and returns the response.
-
-
-
Method Detail
-
onMessage
jakarta.xml.soap.SOAPMessage onMessage(jakarta.xml.soap.SOAPMessage message)
Deprecated.Passes the givenSOAPMessage
object to thisReqRespListener
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 thejakarta.xml.messaging.ReqRespListener
interface.- Parameters:
message
- theSOAPMessage
object to be passed to thisReqRespListener
object- Returns:
- the response. If this is
null
, then the original message is treated as a "oneway" message.
-
-