AbstractHttpConnection (Jetty :: Server Core 8.1.1.v20120215 API)

Overview

Package

Class

Use

Tree

Deprecated

Index

Help

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

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

public abstract class AbstractHttpConnection
extends AbstractConnection
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 javax.servlet.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)`
`protected`	`AbstractHttpConnection(Connector connector, EndPoint endpoint, Server server, Parser parser, Generator generator, Request request)`

Method Summary
`void`	`commitResponse(boolean last)`
`void`	`completeResponse()`
`protected void`	`content(Buffer buffer)`
`void`	`flushResponse()`
`Object`	`getAssociatedObject()`
`Connector`	`getConnector()`
`static AbstractHttpConnection`	`getCurrentConnection()`
`Generator`	`getGenerator()`
`javax.servlet.ServletInputStream`	`getInputStream()` Get the inputStream from the connection.
`int`	`getMaxIdleTime()`
`javax.servlet.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()`
`protected void`	`handleRequest()`
`protected void`	`headerComplete()`
`void`	`include()`
`void`	`included()`
`boolean`	`isConfidential(Request request)` Find out if the request supports CONFIDENTIAL security.
`boolean`	`isExpecting100Continues()`
`boolean`	`isExpecting102Processing()`
`boolean`	`isIdle()`
`boolean`	`isIncluding()`
`boolean`	`isIntegral(Request request)` Find out if the request supports INTEGRAL security.
`boolean`	`isResponseCommitted()`
`boolean`	`isSuspended()`
`void`	`messageComplete(long contentLength)`
`protected HttpGenerator`	`newHttpGenerator(Buffers responseBuffers, EndPoint endPoint)`
`protected HttpParser`	`newHttpParser(Buffers requestBuffers, EndPoint endpoint, HttpParser.EventHandler requestHandler)`
`void`	`onClose()`
`protected void`	`parsedHeader(Buffer name, Buffer value)`
`void`	`reset()`
`void`	`setAssociatedObject(Object associatedObject)`
`protected static void`	`setCurrentConnection(AbstractHttpConnection connection)`
`protected void`	`startRequest(Buffer method, Buffer uri, Buffer version)`
`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 volatile javax.servlet.ServletInputStream _in

_generator

protected final Generator _generator

_responseFields

protected final HttpFields _responseFields

_response

protected final Response _response

_out

protected volatile AbstractHttpConnection.Output _out

_writer

protected volatile AbstractHttpConnection.OutputWriter _writer

_printWriter

protected volatile PrintWriter _printWriter

Constructor Detail