Package org.apache.http.impl.nio

Class DefaultNHttpServerConnection

java.lang.Object

org.apache.http.impl.nio.NHttpConnectionBase

org.apache.http.impl.nio.DefaultNHttpServerConnection

All Implemented Interfaces:

Closeable, AutoCloseable, HttpConnection, HttpInetConnection, IOControl, NHttpConnection, NHttpServerConnection, NHttpServerIOTarget, SessionBufferStatus, SocketAccessor

public class DefaultNHttpServerConnection
extends NHttpConnectionBase
implements NHttpServerIOTarget

Default implementation of the NHttpServerConnection interface.

Since:

4.0

Field Summary

Fields inherited from interface org.apache.http.nio.NHttpConnection

ACTIVE, CLOSED, CLOSING

Constructor Summary

Constructors

Constructor	Description
DefaultNHttpServerConnection(IOSession session, int buffersize)
DefaultNHttpServerConnection(IOSession session, int buffersize, int fragmentSizeHint, ByteBufferAllocator allocator, CharsetDecoder chardecoder, CharsetEncoder charencoder, MessageConstraints constraints, ContentLengthStrategy incomingContentStrategy, ContentLengthStrategy outgoingContentStrategy, NHttpMessageParserFactory<HttpRequest> requestParserFactory, NHttpMessageWriterFactory<HttpResponse> responseWriterFactory)	Creates new instance DefaultNHttpServerConnection given the underlying I/O session.
DefaultNHttpServerConnection(IOSession session, int buffersize, CharsetDecoder chardecoder, CharsetEncoder charencoder, MessageConstraints constraints)
DefaultNHttpServerConnection(IOSession session, HttpRequestFactory requestFactory, ByteBufferAllocator allocator, HttpParams params)	Deprecated. (4.3) use DefaultNHttpServerConnection(IOSession, int, int, ByteBufferAllocator, CharsetDecoder, CharsetEncoder, MessageConstraints, ContentLengthStrategy, ContentLengthStrategy, NHttpMessageParserFactory, NHttpMessageWriterFactory)

Method Summary

Modifier and Type	Method	Description
void	consumeInput(NHttpServerEventHandler handler)
void	consumeInput(NHttpServiceHandler handler)	Triggered when the connection is ready to consume input.
boolean	isResponseSubmitted()	Returns true if an HTTP response has been submitted to the client.
void	produceOutput(NHttpServerEventHandler handler)
void	produceOutput(NHttpServiceHandler handler)	Triggered when the connection is ready to produce output.
void	resetInput()	Resets output state.
void	resetOutput()	Resets input state.
void	submitResponse(HttpResponse response)	Submits {link @HttpResponse} to be sent to the client.

Methods inherited from class org.apache.http.impl.nio.NHttpConnectionBase

close, getContext, getHttpRequest, getHttpResponse, getLocalAddress, getLocalPort, getMetrics, getRemoteAddress, getRemotePort, getSocket, getSocketTimeout, getStatus, hasBufferedInput, hasBufferedOutput, isOpen, isStale, requestInput, requestOutput, setSocketTimeout, shutdown, suspendInput, suspendOutput, toString

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.apache.http.HttpConnection

close, getMetrics, getSocketTimeout, isOpen, isStale, setSocketTimeout, shutdown

Methods inherited from interface org.apache.http.nio.IOControl

requestInput, requestOutput, shutdown, suspendInput, suspendOutput

Methods inherited from interface org.apache.http.nio.NHttpConnection

getContext, getHttpRequest, getHttpResponse, getStatus

Constructor Details

DefaultNHttpServerConnection

@Deprecated
public DefaultNHttpServerConnection(IOSession session,
 HttpRequestFactory requestFactory,
 ByteBufferAllocator allocator,
 HttpParams params)

Deprecated.

(4.3) use DefaultNHttpServerConnection(IOSession, int, int, ByteBufferAllocator, CharsetDecoder, CharsetEncoder, MessageConstraints, ContentLengthStrategy, ContentLengthStrategy, NHttpMessageParserFactory, NHttpMessageWriterFactory)

Creates a new instance of this class given the underlying I/O session.

Parameters:

session - the underlying I/O session.

requestFactory - HTTP request factory.

allocator - byte buffer allocator.

params - HTTP parameters.

DefaultNHttpServerConnection

public DefaultNHttpServerConnection(IOSession session,
 int buffersize,
 int fragmentSizeHint,
 ByteBufferAllocator allocator,
 CharsetDecoder chardecoder,
 CharsetEncoder charencoder,
 MessageConstraints constraints,
 ContentLengthStrategy incomingContentStrategy,
 ContentLengthStrategy outgoingContentStrategy,
 NHttpMessageParserFactory<HttpRequest> requestParserFactory,
 NHttpMessageWriterFactory<HttpResponse> responseWriterFactory)

Creates new instance DefaultNHttpServerConnection given the underlying I/O session.

Parameters:

session - the underlying I/O session.

buffersize - buffer size. Must be a positive number.

fragmentSizeHint - fragment size hint.

allocator - memory allocator. If null HeapByteBufferAllocator.INSTANCE will be used.

chardecoder - decoder to be used for decoding HTTP protocol elements. If null simple type cast will be used for byte to char conversion.

charencoder - encoder to be used for encoding HTTP protocol elements. If null simple type cast will be used for char to byte conversion.

constraints - Message constraints. If null MessageConstraints.DEFAULT will be used.

incomingContentStrategy - incoming content length strategy. If null DisallowIdentityContentLengthStrategy.INSTANCE will be used.

outgoingContentStrategy - outgoing content length strategy. If null StrictContentLengthStrategy.INSTANCE will be used.

requestParserFactory - request parser factory. If null DefaultHttpRequestParserFactory.INSTANCE will be used.

responseWriterFactory - response writer factory. If null DefaultHttpResponseWriterFactory.INSTANCE will be used.

Since:

4.3

DefaultNHttpServerConnection

public DefaultNHttpServerConnection(IOSession session,
 int buffersize,
 CharsetDecoder chardecoder,
 CharsetEncoder charencoder,
 MessageConstraints constraints)

Since:

4.3

DefaultNHttpServerConnection

public DefaultNHttpServerConnection(IOSession session,
 int buffersize)

Since:

4.3

Method Details

resetInput

public void resetInput()

Description copied from interface: NHttpServerConnection

Resets output state. This method can be used to prematurely terminate processing of the incoming HTTP request.

Specified by:

resetInput in interface NHttpServerConnection

resetOutput

public void resetOutput()

Description copied from interface: NHttpServerConnection

Resets input state. This method can be used to prematurely terminate processing of the outgoing HTTP response.

Specified by:

resetOutput in interface NHttpServerConnection

consumeInput

public void consumeInput(NHttpServerEventHandler handler)

produceOutput

public void produceOutput(NHttpServerEventHandler handler)

submitResponse

public void submitResponse(HttpResponse response)
                    throws IOException,
HttpException

Description copied from interface: NHttpServerConnection

Submits {link @HttpResponse} to be sent to the client.

Specified by:

submitResponse in interface NHttpServerConnection

Parameters:

response - HTTP response

Throws:

IOException - if I/O error occurs while submitting the response

HttpException - if the HTTP response violates the HTTP protocol.

isResponseSubmitted

public boolean isResponseSubmitted()

Description copied from interface: NHttpServerConnection

Returns true if an HTTP response has been submitted to the client.

Specified by:

isResponseSubmitted in interface NHttpServerConnection

Returns:

true if an HTTP response has been submitted, false otherwise.

consumeInput

public void consumeInput(NHttpServiceHandler handler)

Description copied from interface: NHttpServerIOTarget

Triggered when the connection is ready to consume input.

Specified by:

consumeInput in interface NHttpServerIOTarget

Parameters:

handler - the server protocol handler.

produceOutput

public void produceOutput(NHttpServiceHandler handler)

Description copied from interface: NHttpServerIOTarget

Triggered when the connection is ready to produce output.

Specified by:

produceOutput in interface NHttpServerIOTarget

Parameters:

handler - the server protocol handler.