org.ws4d.java.communication.protocol.http.server

Class HTTPServer

java.lang.Object

org.ws4d.java.communication.protocol.http.server.HTTPServer

public class HTTPServer
extends java.lang.Object

This class allows the creation of an HTTP server to handle incoming HTTP requests.

Method Summary

Modifier and Type	Method and Description
static HTTPServer	get(HTTPBinding binding, boolean keepAlive, java.util.List supportedMethods, boolean create) Returns a HTTP server for the given address and port.
HTTPBinding	getBinding()
IPAddress	getIPAddress()
int	getPort()
void	register(java.lang.String path, ContentType type, HTTPRequestHandler handler) Registers a relative HTTP path and a content type with a given HTTPRequestHandler.
void	register(java.lang.String path, HTTPRequestHandler handler) Registers a relative HTTP path with a given HTTPRequestHandler.
void	setChunkedInAllowed(boolean chunkedInAllowed)
static void	stopALLServers(java.lang.String comManId)
HTTPRequestHandler	unregister(HTTPBinding binding, java.lang.String path) Removes registration of a relative HTTP path for a HTTPRequestHandler.
HTTPRequestHandler	unregister(HTTPBinding binding, java.lang.String path, ContentType type) Removes registration of a relative HTTP path and content type for a HTTP handler.
HTTPRequestHandler	unregister(java.lang.String path) Removes registration of a relative HTTP path for a HTTPRequestHandler, but will not shut down the HTTP server when the last handler was removed.
protected void	unregisterAllDeadTimeouts()
protected void	unregisterAllTimeouts()
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(java.lang.String comManId)

get

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

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

The HTTP server is started at creation time.

Parameters:

binding - the address of the HTTP server.

keepAlive -

Returns:

a new HTTP server.

Throws:

java.io.IOException - Throws exception if the port could not be opened at the given address.

unregisterAndStop

public void unregisterAndStop()
                       throws java.io.IOException

Throws:

java.io.IOException

unregisterAllTimeouts

protected void unregisterAllTimeouts()

unregisterAllDeadTimeouts

protected void unregisterAllDeadTimeouts()

register

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

Registers a relative HTTP path with a given HTTPRequestHandler.

Parameters:

path - the HTTP path.

handler - the HTTP handler which should handle the request.

Throws:

java.io.IOException

register

public void register(java.lang.String path,
                     ContentType type,
                     HTTPRequestHandler handler)
              throws java.io.IOException

Registers a relative HTTP path and a content type with a given HTTPRequestHandler.

Parameters:

path - the HTTP path.

type - the HTTP content type.

handler - the HTTP handler which should handle the request.

Throws:

java.io.IOException

unregister

public HTTPRequestHandler unregister(java.lang.String path)

Removes registration of a relative HTTP path for a HTTPRequestHandler, but will not shut down the HTTP server when the last handler was removed.

Parameters:

path -

Returns:

unregister

public HTTPRequestHandler unregister(HTTPBinding binding,
                                     java.lang.String path)

Removes registration of a relative HTTP path for a HTTPRequestHandler.

Parameters:

path - the HTTP path.

Returns:

the removed HTTPRequestHandler.

unregister

public HTTPRequestHandler unregister(HTTPBinding binding,
                                     java.lang.String path,
                                     ContentType type)

Removes registration of a relative HTTP path and content type for a HTTP handler.

Parameters:

path - the HTTP path.

type - the HTTP content type.

Returns:

the removed HTTPRequestHandler.

getPort

public int getPort()

Returns:

the port

getIPAddress

public IPAddress getIPAddress()

getBinding

public HTTPBinding getBinding()

setChunkedInAllowed

public void setChunkedInAllowed(boolean chunkedInAllowed)