Package org.apache.http.client

Interface RequestDirector

All Known Implementing Classes:

DefaultRequestDirector

public interface RequestDirector

A client-side request director. The director decides which steps are necessary to execute a request. It establishes connections and optionally processes redirects and authentication challenges. The director may therefore generate and send a sequence of requests in order to execute one initial request.
Note: It is most likely that implementations of this interface will allocate connections, and return responses that depend on those connections for reading the response entity. Such connections MUST be released, but that is out of the scope of a request director.

Since:

4.0

Version:

$Revision: 676020 $

Author:

Roland Weber

Method Summary

Modifier and Type	Method	Description
HttpResponse	execute(HttpHost target, HttpRequest request, HttpContext context)	Executes a request.

Method Details

execute

HttpResponse execute(HttpHost target,
HttpRequest request,
HttpContext context)
              throws HttpException,
IOException

Executes a request.
Note: For the time being, a new director is instantiated for each request. This is the same behavior as for HttpMethodDirector in HttpClient 3.

Parameters:

target - the target host for the request. Implementations may accept null if they can still determine a route, for example to a default target or by inspecting the request.

request - the request to execute

context - the context for executing the request

Returns:

the final response to the request. This is never an intermediate response with status code 1xx.

Throws:

HttpException - in case of a problem

IOException - in case of an IO problem or if the connection was aborted