org.ws4d.java.communication.protocol.soap.server

Class SOAPServer

java.lang.Object

org.ws4d.java.communication.protocol.soap.server.SOAPServer

public class SOAPServer
extends java.lang.Object

This class allows the creation of a SOAP Server to handle incoming SOAP message requests.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	SOAPServer.SOAPHandler The default HTTP handler which handles SOAP-over-HTTP requests.

Method Summary

Modifier and Type	Method and Description
static SOAPServer	get(HTTPBinding binding, boolean keepAlive, java.util.List supportedMethods, boolean create) Returns a SOAP server and the underlying HTTP server for the given address and port.
HTTPServer	getHTTPServer() Returns the underlying HTTP server.
void	register(java.lang.String path, SOAPServer.SOAPHandler handler) Registers a HTTP path for a given MessageReceiver.
static void	stopALLServers()
MessageReceiver	unregister(HTTPBinding binding) Removes the registration of a MessageReceiver for a given HTTP path.
void	unregisterAndStop()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

stopALLServers

public static void stopALLServers()

get

public static SOAPServer get(HTTPBinding binding,
                             boolean keepAlive,
                             java.util.List supportedMethods,
                             boolean create)
                      throws java.io.IOException

Returns a SOAP server and the underlying HTTP server for the given address and port. If no server exists, a new server will be created.

Parameters:

address - the host address for the underlying HTTP server.

port - the port for the underlying HTTP server.

Returns:

the new SOAP server.

Throws:

java.io.IOException - Throws exception if the HTTP server could not listen to the given address and port.

unregisterAndStop

public void unregisterAndStop()
                       throws java.io.IOException

Throws:

java.io.IOException

register

public void register(java.lang.String path,
                     SOAPServer.SOAPHandler handler)
              throws java.io.IOException

Registers a HTTP path for a given MessageReceiver.

The receiver will receive incoming SOAP messages which match the HTTP path.

Parameters:

path - HTTP path.

receiver - the SOAP message receiver

Throws:

java.io.IOException

unregister

public MessageReceiver unregister(HTTPBinding binding)

Removes the registration of a MessageReceiver for a given HTTP path.

Parameters:

defaultPath - the HTTP path.

Returns:

the removed MessageReceiver.

getHTTPServer

public HTTPServer getHTTPServer()

Returns the underlying HTTP server.

Returns:

the HTTP server.