org.apache.river.jeri.internal.http

Class HttpServerConnection

java.lang.Object

org.apache.river.jeri.internal.http.HttpServerConnection

All Implemented Interfaces:

TimedConnection

public abstract class HttpServerConnection
extends Object
implements TimedConnection

Class representing a server-side HTTP connection used to receive and dispatch incoming HTTP requests.

Author:

Sun Microsystems, Inc.

Constructor Summary

Constructors

Constructor and Description
HttpServerConnection(Socket sock, RequestDispatcher dispatcher, HttpServerManager manager) Creates new HttpServerConnection on top of given socket.

Method Summary

Modifier and Type	Method and Description
protected void	busy() Upcall indicating that connection is about to become busy.
protected InvocationConstraints	checkConstraints(InvocationConstraints constraints) Checks that the specified requirements are either fully or partially satisfied by the constraints actually in force for this connection, and returns any constraints that must be fully or partially implemented by higher layers in order to fully satisfy all of the specified requirements.
protected void	checkPermissions() Verifies that calling context has sufficient security permissions to receive a request on this connection.
protected void	idle() Upcall indicating that connection has become idle.
protected abstract void	populateContext(Collection context) Populates the given context collection with context information representing this connection.
boolean	shutdown(boolean force) Attempts to shut down connection, returning true if connection is closed.
protected void	start() Starts request dispatch thread.

Methods inherited from class java.lang.Object

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

Constructor Detail

HttpServerConnection

public HttpServerConnection(Socket sock,
                            RequestDispatcher dispatcher,
                            HttpServerManager manager)
                     throws IOException

Creates new HttpServerConnection on top of given socket.

Throws:

IOException

Method Detail

start

protected void start()

Starts request dispatch thread. Throws IllegalStateException if connection has already been started, or is closed.

checkPermissions

protected void checkPermissions()

Verifies that calling context has sufficient security permissions to receive a request on this connection.

checkConstraints

protected InvocationConstraints checkConstraints(InvocationConstraints constraints)
                                          throws UnsupportedConstraintException

Checks that the specified requirements are either fully or partially satisfied by the constraints actually in force for this connection, and returns any constraints that must be fully or partially implemented by higher layers in order to fully satisfy all of the specified requirements.

Throws:

UnsupportedConstraintException

populateContext

protected abstract void populateContext(Collection context)

Populates the given context collection with context information representing this connection.

idle

protected void idle()

Upcall indicating that connection has become idle. Subclasses may override this method to perform an appropriate action, such as scheduling an idle timeout.

busy

protected void busy()

Upcall indicating that connection is about to become busy. Subclasses may override this method to perform an appropriate action, such as cancelling an idle timeout.

shutdown

public boolean shutdown(boolean force)

Attempts to shut down connection, returning true if connection is closed. If force is true, connection is always shut down; if force is false, connection is only shut down if idle.

Specified by:

shutdown in interface TimedConnection