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) 2011, Oracle and/or its affiliates. All rights reserved.