Java Web Services in a Nutshell

Name

OnewayListener

Synopsis

public interface OnewayListener {
// Public Instance Methods
    public abstract void onMessage(javax.xml.soap.SOAPMessage message);
}

The OnewayListener interface is implemented by a JAXMServlet subclass that receives a SOAP message but does not wish to return an immediate response. The onMessage( ) method is called whenever a message is received and is provided with a SOAPMessage object created from that message as its only argument. The implementation may handle the message immediately or defer its processing to a more convenient time.

A JAXM client that implements this interface and wishes to return a reply message must create the message using the MessageFactory of the JAXM profile that it is using, set the destination address using a profile-specific method, and then call the ProviderConnection send( ) method. See the description of the JAXMServlet for information on obtaining an appropriate MessageFactory.