org.eclipse.jetty.server
Class AbstractHttpConnection

java.lang.Object
  org.eclipse.jetty.io.AbstractConnection
      org.eclipse.jetty.server.AbstractHttpConnection

All Implemented Interfaces:

Connection

Direct Known Subclasses:

AsyncHttpConnection, BlockingHttpConnection, NestedConnection

public abstract class AbstractHttpConnection
extends AbstractConnection

A HttpConnection represents the connection of a HTTP client to the server and is created by an instance of a Connector. It's prime function is to associate Request and Response instances with a EndPoint.

A connection is also the prime mechanism used by jetty to recycle objects without pooling. The Request, Response, HttpParser, HttpGenerator and HttpFields instances are all recycled for the duraction of a connection. Where appropriate, allocated buffers are also kept associated with the connection via the parser and/or generator.

The connection state is held by 3 separate state machines: The request state, the response state and the continuation state. All three state machines must be driven to completion for every request, and all three can complete in any order.

The HttpConnection support protocol upgrade. If on completion of a request, the response code is 101 (switch protocols), then the org.eclipse.jetty.io.Connection request attribute is checked to see if there is a new Connection instance. If so, the new connection is returned from handle() and is used for future handling of the underlying connection. Note that for switching protocols that don't use 101 responses (eg CONNECT), the response should be sent and then the status code changed to 101 before returning from the handler. Implementors of new Connection types should be careful to extract any buffered data from (HttpParser)http.getParser()).getHeaderBuffer() and (HttpParser)http.getParser()).getBodyBuffer() to initialise their new connection.

Nested Class Summary

class	AbstractHttpConnection.Output
class	AbstractHttpConnection.OutputWriter

Field Summary

protected Connector	_connector
protected Generator	_generator
protected ServletInputStream	_in
protected AbstractHttpConnection.Output	_out
protected Parser	_parser
protected PrintWriter	_printWriter
protected Request	_request
protected HttpFields	_requestFields
protected Response	_response
protected HttpFields	_responseFields
protected Server	_server
protected HttpURI	_uri
protected AbstractHttpConnection.OutputWriter	_writer

Fields inherited from class org.eclipse.jetty.io.AbstractConnection

_endp

Constructor Summary

	AbstractHttpConnection(Connector connector, EndPoint endpoint, Server server) Constructor
protected	AbstractHttpConnection(Connector connector, EndPoint endpoint, Server server, Parser parser, Generator generator, Request request)

Method Summary

void	commitResponse(boolean last)
void	completeResponse()
void	flushResponse()
Object	getAssociatedObject()
Connector	getConnector()
static AbstractHttpConnection	getCurrentConnection()
Generator	getGenerator()
ServletInputStream	getInputStream() Get the inputStream from the connection.
int	getMaxIdleTime()
ServletOutputStream	getOutputStream()
Parser	getParser()
PrintWriter	getPrintWriter(String encoding)
Request	getRequest()
HttpFields	getRequestFields()
int	getRequests()
boolean	getResolveNames()
Response	getResponse()
HttpFields	getResponseFields()
Server	getServer()
abstract Connection	handle() Handle the connection.
protected void	handleRequest()
void	include()
void	included()
boolean	isConfidential(Request request)
boolean	isExpecting100Continues()
boolean	isExpecting102Processing()
boolean	isIdle()
boolean	isIncluding()
boolean	isIntegral(Request request) Find out if the request is INTEGRAL security.
boolean	isResponseCommitted()
boolean	isSuspended()
protected HttpParser	newHttpParser(Buffers requestBuffers, EndPoint endpoint, HttpParser.EventHandler requestHandler)
void	onClose() Called when the connection is closed
void	reset()
void	setAssociatedObject(Object associatedObject)
protected static void	setCurrentConnection(AbstractHttpConnection connection)
String	toString()

Methods inherited from class org.eclipse.jetty.io.AbstractConnection

getEndPoint, getTimeStamp, onIdleExpired

Methods inherited from class java.lang.Object

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

Field Detail

_connector

protected final Connector _connector

_server

protected final Server _server

_uri

protected final HttpURI _uri

_parser

protected final Parser _parser

_requestFields

protected final HttpFields _requestFields

_request

protected final Request _request

_in

protected ServletInputStream _in

_generator

protected final Generator _generator

_responseFields

protected final HttpFields _responseFields

_response

protected final Response _response

_out

protected AbstractHttpConnection.Output _out

_writer

protected AbstractHttpConnection.OutputWriter _writer

_printWriter

protected PrintWriter _printWriter

Constructor Detail

AbstractHttpConnection

public AbstractHttpConnection(Connector connector,
                              EndPoint endpoint,
                              Server server)

Constructor

AbstractHttpConnection

protected AbstractHttpConnection(Connector connector,
                                 EndPoint endpoint,
                                 Server server,
                                 Parser parser,
                                 Generator generator,
                                 Request request)

Method Detail

getCurrentConnection

public static AbstractHttpConnection getCurrentConnection()

setCurrentConnection

protected static void setCurrentConnection(AbstractHttpConnection connection)

newHttpParser

protected HttpParser newHttpParser(Buffers requestBuffers,
                                   EndPoint endpoint,
                                   HttpParser.EventHandler requestHandler)

getParser

public Parser getParser()

Returns:

the parser used by this connection

getRequests

public int getRequests()

Returns:

the number of requests handled by this connection

getServer

public Server getServer()

getAssociatedObject

public Object getAssociatedObject()

Returns:

Returns the associatedObject.

setAssociatedObject

public void setAssociatedObject(Object associatedObject)

Parameters:

associatedObject - The associatedObject to set.

getConnector

public Connector getConnector()

Returns:

Returns the connector.

getRequestFields

public HttpFields getRequestFields()

Returns:

Returns the requestFields.

getResponseFields

public HttpFields getResponseFields()

Returns:

Returns the responseFields.

isConfidential

public boolean isConfidential(Request request)

Returns:

The result of calling getConnector().isCondidential(request), or false if there is no connector.

isIntegral

public boolean isIntegral(Request request)

Find out if the request is INTEGRAL security.

Parameters:

request -

Returns:

true if there is a connector and it considers request to be integral

getResolveNames

public boolean getResolveNames()

Returns:

false (this method is not yet implemented)

getRequest

public Request getRequest()

Returns:

Returns the request.

getResponse

public Response getResponse()

Returns:

Returns the response.

getInputStream

public ServletInputStream getInputStream()
                                  throws IOException

Get the inputStream from the connection.

If the associated response has the Expect header set to 100 Continue, then accessing the input stream indicates that the handler/servlet is ready for the request body and thus a 100 Continue response is sent.

Returns:

The input stream for this connection. The stream will be created if it does not already exist.

Throws:

IOException

getOutputStream

public ServletOutputStream getOutputStream()

Returns:

The output stream for this connection. The stream will be created if it does not already exist.

getPrintWriter

public PrintWriter getPrintWriter(String encoding)

Returns:

A PrintWriter wrapping the output stream. The writer is created if it does not already exist.

isResponseCommitted

public boolean isResponseCommitted()

reset

public void reset()

handleRequest

protected void handleRequest()
                      throws IOException

Throws:

IOException

handle

public abstract Connection handle()
                           throws IOException

Description copied from interface: Connection

Handle the connection.

Returns:

The Connection to use for the next handling of the connection. This allows protocol upgrades and support for CONNECT.

Throws:

IOException

commitResponse

public void commitResponse(boolean last)
                    throws IOException

Throws:

IOException

completeResponse

public void completeResponse()
                      throws IOException

Throws:

IOException

flushResponse

public void flushResponse()
                   throws IOException

Throws:

IOException

getGenerator

public Generator getGenerator()

isIncluding

public boolean isIncluding()

include

public void include()

included

public void included()

isIdle

public boolean isIdle()

isSuspended

public boolean isSuspended()

See Also:

Connection.isSuspended()

onClose

public void onClose()

Description copied from interface: Connection

Called when the connection is closed

isExpecting100Continues

public boolean isExpecting100Continues()

isExpecting102Processing

public boolean isExpecting102Processing()

getMaxIdleTime

public int getMaxIdleTime()

toString

public String toString()

Overrides:

toString in class AbstractConnection