org.reficio.ws.server.core

Class SoapServer

java.lang.Object

org.reficio.ws.server.core.SoapServer

@ThreadSafe
public final class SoapServer
extends Object

SOAP server enables the user to handle a SOAP communication on a purely XML level. It supports plain HTTP as well as HTTPS communication. When it comes to SOAP it supports SOAP 1.1 and 1.2 This class may throw an unchecked @see org.reficio.ws.server.SoapServerException

Since:

1.0.0

Author:

Tom Bujok

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	SoapServer.Builder Builder to construct a properly populated SoapServer

Method Summary

Modifier and Type	Method and Description
static SoapServer.Builder	builder()
void	destroy() Stops the SOAP server and deallocates resources
List<String>	getRegisteredContextPaths()
boolean	isFailed()
boolean	isNotRunning()
boolean	isRunning()
boolean	isStarted()
boolean	isStarting()
boolean	isStopped()
boolean	isStopping()
void	registerRequestResponder(String contextPath, RequestResponder responder) Registers responder under specified context path.
void	start() Starts the SOAP server
void	stop() Stops the SOAP server (does not release the allocated resources)
void	unregisterRequestResponder(String contextPath) Unregisters responder from the specified context path

Methods inherited from class java.lang.Object

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

Method Detail

start

public void start()

Starts the SOAP server

isRunning

public boolean isRunning()

isStarted

public boolean isStarted()

isStarting

public boolean isStarting()

isStopping

public boolean isStopping()

isStopped

public boolean isStopped()

isNotRunning

public boolean isNotRunning()

isFailed

public boolean isFailed()

stop

public void stop()

Stops the SOAP server (does not release the allocated resources)

destroy

public void destroy()

Stops the SOAP server and deallocates resources

registerRequestResponder

public void registerRequestResponder(String contextPath,
                                     RequestResponder responder)
                              throws ServiceRegistrationException

Registers responder under specified context path. Only one responder may be registered under one context path.

Parameters:

contextPath -

responder -

Throws:

ServiceRegistrationException - thrown if a registration error occurs - for example duplicate responder registered

unregisterRequestResponder

public void unregisterRequestResponder(String contextPath)
                                throws ServiceRegistrationException

Unregisters responder from the specified context path

Parameters:

contextPath -

Throws:

ServiceRegistrationException - thrown if an unregistration error occurs - for example no responder registerd

getRegisteredContextPaths

public List<String> getRegisteredContextPaths()

Returns:

a list of registered context paths

builder

public static SoapServer.Builder builder()

Returns:

a new instance of a SoapServer Builder