se.entra.phantom.server

Interface WebServerInterface

All Known Implementing Classes:

HttpWebServer

public interface WebServerInterface

This interface is implemented by the Web Server to respond to a HTTP request.

The first character the HTTP request string is passed to the onClientRequest routine. The rest of the string is read from the socket.

The implementor of the WebServerInterface should close the socket as soon as possible and then stop the execution of e.g. the thread in order to release resources and memory to the Server.

Method Summary

Modifier and Type	Method and Description
void	dispose() This method is called when the web server interface is disposed of.
void	initialize(ClientSessionManager csm) This method is called just after creation of the web server interface.
void	onClientRequest(ServerSocketInterface ssi, ISocket socket, int firstChar, String id) This method is called whenever a web server request is called from a client.

Method Detail

initialize

void initialize(ClientSessionManager csm)
         throws IOException

This method is called just after creation of the web server interface.

Throws:

IOException - if there is a problem in loading the web server.

onClientRequest

void onClientRequest(ServerSocketInterface ssi,
                     ISocket socket,
                     int firstChar,
                     String id)
              throws IOException

This method is called whenever a web server request is called from a client. When this method is called, it must release control back to the calling thread immediately, otherwise new client connections or HTTP requests will be blocked. The best way to handle this is to start a new thread directly and then return control to the calling thread.

Throws:

IOException - if there is a problem in requesting the data from the server.

dispose

void dispose()

This method is called when the web server interface is disposed of.