com.oreilly.servlet
Class DaemonHttpServlet

java.lang.Object
  HttpServlet
      com.oreilly.servlet.DaemonHttpServlet

Direct Known Subclasses:

RemoteDaemonHttpServlet

public abstract class DaemonHttpServlet
extends HttpServlet

A superclass for HTTP servlets that wish to accept raw socket connections. DaemonHttpServlet starts listening for client requests in its init() method and stops listening in its destroy() method. In between, for every connection it receives, it calls the abstract handleClient(Socket client) method. This method should be implemented by the servlet subclassing DaemonHttpServlet. The port on which the servlet is to listen is determined by the getSocketPort() method.

See Also:

RemoteDaemonHttpServlet

Field Summary

protected int

DEFAULT_PORT The default listening port (1313)

Constructor Summary

DaemonHttpServlet()

Method Summary

void	destroy() Halts the thread listening for socket connections.
protected int	getSocketPort() Returns the socket port on which the servlet will listen.
abstract void	handleClient(java.net.Socket client) Handles a new socket connection.
void	init(ServletConfig config) Begins a thread listening for socket connections.

Methods inherited from class java.lang.Object

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

Field Detail

DEFAULT_PORT

protected int DEFAULT_PORT

The default listening port (1313)

Constructor Detail

DaemonHttpServlet

public DaemonHttpServlet()

Method Detail

init

public void init(ServletConfig config)
          throws ServletException

Begins a thread listening for socket connections. Subclasses that override this method must be sure to first call super.init(config).

Parameters:

config - the servlet config

Throws:

ServletException - if a servlet exception occurs

getSocketPort

protected int getSocketPort()

Returns the socket port on which the servlet will listen. A servlet can change the port in three ways: by using the socketPort init parameter, by setting the DEFAULT_PORT variable before calling super.init(), or by overriding this method's implementation.

Returns:

the port number on which to listen

handleClient

public abstract void handleClient(java.net.Socket client)

Handles a new socket connection. Subclasses must define this method.

Parameters:

client - the client socket

destroy

public void destroy()

Halts the thread listening for socket connections. Subclasses that override this method must be sure to first call super.destroy().