java.lang.Object | ||
↳ | org.apache.http.nio.protocol.NHttpHandlerBase | |
↳ | org.apache.http.nio.protocol.AsyncNHttpServiceHandler |
Fully asynchronous HTTP server side protocol handler implementation that
implements the essential requirements of the HTTP protocol for the server
side message processing as described by RFC 2616. It is capable of processing
HTTP requests with nearly constant memory footprint. Only HTTP message heads
are stored in memory, while content of message bodies is streamed directly
from the entity to the underlying channel (and vice versa)
ConsumingNHttpEntity
and ProducingNHttpEntity
interfaces.
ProducingNHttpEntity
. Doing so will allow the
entity to be written out asynchronously. If entities supplied for writing do
not implement ProducingNHttpEntity
, a delegate is added that buffers
the entire contents in memory. Additionally, the buffering might take place
in the I/O thread, which could cause I/O to block temporarily. For best
results, ensure that all entities set on HttpResponses from
NHttpRequestHandler
s implement ProducingNHttpEntity
.
If incoming requests enclose a content entity, NHttpRequestHandler
s
are expected to return a ConsumingNHttpEntity
for reading the
content. After the entity is finished reading the data,
handle(HttpRequest, HttpResponse, NHttpResponseTrigger, HttpContext)
is called to generate a response.
Individual NHttpRequestHandler
s do not have to submit a response
immediately. They can defer transmission of the HTTP response back to the
client without blocking the I/O thread and to delegate the processing the
HTTP request to a worker thread. The worker thread in its turn can use an
instance of NHttpResponseTrigger
passed as a parameter to submit
a response as at a later point of time once the response becomes available.
Nested Classes | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
AsyncNHttpServiceHandler.ServerConnState |
[Expand]
Inherited Constants | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
From class
org.apache.http.nio.protocol.NHttpHandlerBase
|
Fields | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
expectationVerifier | |||||||||||
handlerResolver | |||||||||||
responseFactory |
[Expand]
Inherited Fields | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
From class
org.apache.http.nio.protocol.NHttpHandlerBase
|
Public Constructors | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Public Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Triggered when the connection is closed.
| |||||||||||
Triggered when a new incoming connection is created.
| |||||||||||
Triggered when an HTTP protocol violation occurs while receiving
an HTTP request.
| |||||||||||
Triggered when an I/O error occurs while reading from or writing
to the underlying channel.
| |||||||||||
Triggered when the underlying channel is ready for reading a
new portion of the request entity through the corresponding
content decoder.
| |||||||||||
Triggered when the underlying channel is ready for writing a
next portion of the response entity through the corresponding
content encoder.
| |||||||||||
Triggered when a new HTTP request is received.
| |||||||||||
Triggered when the connection is ready to accept a new HTTP response.
| |||||||||||
Triggered when no input is detected on this connection over the
maximum period of inactivity.
|
Protected Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Signals that this response has been fully sent.
|
[Expand]
Inherited Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
From class
org.apache.http.nio.protocol.NHttpHandlerBase
| |||||||||||
From class
java.lang.Object
| |||||||||||
From interface
org.apache.http.nio.NHttpServiceHandler
|
Triggered when the connection is closed.
conn | closed HTTP connection. |
---|
Triggered when a new incoming connection is created.
conn | new incoming connection HTTP connection. |
---|
Triggered when an HTTP protocol violation occurs while receiving an HTTP request.
conn | HTTP connection that caused an HTTP protocol violation |
---|---|
httpex | HTTP protocol violation exception |
Triggered when an I/O error occurs while reading from or writing to the underlying channel.
conn | HTTP connection that caused an I/O error |
---|---|
ex | I/O exception |
Triggered when the underlying channel is ready for reading a new portion of the request entity through the corresponding content decoder.
If the content consumer is unable to process the incoming content, input event notifications can be temporarily suspended usingIOControl
interface.conn | HTTP connection that can produce a new portion of the incoming request content. |
---|---|
decoder | The content decoder to use to read content. |
Triggered when the underlying channel is ready for writing a next portion of the response entity through the corresponding content encoder.
If the content producer is unable to generate the outgoing content, output event notifications can be temporarily suspended usingIOControl
interface.conn | HTTP connection that can accommodate a new portion of the outgoing response content. |
---|---|
encoder | The content encoder to use to write content. |
Triggered when a new HTTP request is received. The connection passed as a parameter to this method is guaranteed to return a valid HTTP request object.
If the request received encloses a request entity this method will be followed a series ofinputReady(NHttpServerConnection, ContentDecoder)
calls
to transfer the request content.conn | HTTP connection that contains a new HTTP request |
---|
Triggered when the connection is ready to accept a new HTTP response. The protocol handler does not have to submit a response if it is not ready.
conn | HTTP connection that contains an HTTP response |
---|
Triggered when no input is detected on this connection over the maximum period of inactivity.
conn | HTTP connection that caused timeout condition. |
---|
Signals that this response has been fully sent. This will be called after submitting the response to a connection, if there is no entity in the response. If there is an entity, it will be called after the entity has completed.