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.