org.apache.http.nio.protocol
Interface HttpRequestExecutionHandler

public interface HttpRequestExecutionHandler

HTTP request execution handler can be used by client-side protocol handlers to trigger the submission of a new HTTP request and the processing of an HTTP response.

Author:

Oleg Kalnichevski

Method Summary

void	handleResponse(org.apache.http.HttpResponse response, org.apache.http.protocol.HttpContext context) Triggered when an HTTP response is ready to be processed.
void	initalizeContext(org.apache.http.protocol.HttpContext context, java.lang.Object attachment) Triggered when a new connection has been established and the HTTP context needs to be initialized.
org.apache.http.HttpRequest	submitRequest(org.apache.http.protocol.HttpContext context) Triggered when the underlying connection is ready to send a new HTTP request to the target host.

Method Detail

initalizeContext

public void initalizeContext(org.apache.http.protocol.HttpContext context,
                             java.lang.Object attachment)

Triggered when a new connection has been established and the HTTP context needs to be initialized.

The attachment object is the same object which was passed to the connecting I/O reactor when the connection request was made. The attachment may optionally contain some state information required in order to correctly initalize the HTTP context.

Parameters:

context - the actual HTTP context

attachment - the object passed to the connecting I/O reactor upon the request for a new connection.

See Also:

ConnectingIOReactor#connect(java.net.SocketAddress, java.net.SocketAddress, Object)

submitRequest

public org.apache.http.HttpRequest submitRequest(org.apache.http.protocol.HttpContext context)

Triggered when the underlying connection is ready to send a new HTTP request to the target host. This method may return null if the client is not yet ready to send a request. In this case the connection will remain open and can be activated at a later point.

Parameters:

context - the actual HTTP context

Returns:

an HTTP request to be sent or null if no request needs to be sent

handleResponse

public void handleResponse(org.apache.http.HttpResponse response,
                           org.apache.http.protocol.HttpContext context)

Triggered when an HTTP response is ready to be processed.

Parameters:

response - the HTTP response to be processed

context - the actual HTTP context