Top Description Methods
org.apache.http.impl.execchain

public Interface ClientExecChain

Known Direct Implementers
org.apache.http.impl.execchain.MainClientExec, org.apache.http.impl.execchain.MinimalClientExec, org.apache.http.impl.execchain.ProtocolExec, org.apache.http.impl.execchain.RedirectExec, org.apache.http.impl.execchain.RetryExec, org.apache.http.impl.execchain.ServiceUnavailableRetryExec, org.apache.http.impl.execchain.BackoffStrategyExec
Imports
java.io.IOException, org.apache.http.HttpException, org.apache.http.client.methods.CloseableHttpResponse, .HttpExecutionAware, .HttpRequestWrapper, org.apache.http.client.protocol.HttpClientContext, org.apache.http.conn.routing.HttpRoute

This interface represents an element in the HTTP request execution chain. Each element can either be a decorator around another element that implements a cross cutting aspect or a self-contained executor capable of producing a response for the given request.

Important Note

please note it is required for decorators that implement post execution aspects or response post-processing of any sort to release resources associated with the response by calling CloseableHttpResponse#close() methods in case of an I/O, protocol or runtime exception, or in case the response is not propagated to the caller.

Since
4.3

Method Summary

Modifier and TypeMethod and Description
public CloseableHttpResponse

Returns:

HTTP response either received from the opposite endpoint or generated locally.
execute
(HttpRoute
connection route.
route
,
HttpRequestWrapper
current request.
request
,
HttpClientContext
current HTTP context.
clientContext
,
HttpExecutionAware
receiver of notifications of blocking I/O operations.
execAware
)

Executes th request either by transmitting it to the target server or by passing it onto the next executor in the request execution chain.

Method Detail

executeback to summary
public CloseableHttpResponse execute(HttpRoute route, HttpRequestWrapper request, HttpClientContext clientContext, HttpExecutionAware execAware) throws IOException, HttpException

Executes th request either by transmitting it to the target server or by passing it onto the next executor in the request execution chain.

Parameters
route:HttpRoute

connection route.

request:HttpRequestWrapper

current request.

clientContext:HttpClientContext

current HTTP context.

execAware:HttpExecutionAware

receiver of notifications of blocking I/O operations.

Returns:CloseableHttpResponse

HTTP response either received from the opposite endpoint or generated locally.

Exceptions
IOException:
in case of a I/O error. (this type of exceptions are potentially recoverable).
HttpException:
in case of an HTTP protocol error (usually this type of exceptions are non-recoverable).