Added in API level 1

public class

DefaultRequestDirector

extends Object
implements RequestDirector

java.lang.Object
↳	org.apache.http.impl.client.DefaultRequestDirector

This class is deprecated.
Please use openConnection() instead. Please visit this webpage for further details.

Class Overview

Default implementation of RequestDirector.
This class replaces the HttpMethodDirector in HttpClient 3.

Summary

Fields
protected final ClientConnectionManager	connManager	The connection manager.
protected final HttpProcessor	httpProcessor	The HTTP protocol processor.
protected final ConnectionKeepAliveStrategy	keepAliveStrategy	The keep-alive duration strategy.
protected ManagedClientConnection	managedConn	The currently allocated connection.
protected final HttpParams	params	The HTTP parameters.
protected final RedirectHandler	redirectHandler	The redirect handler.
protected final HttpRequestExecutor	requestExec	The request executor.
protected final HttpRequestRetryHandler	retryHandler	The request retry handler.
protected final ConnectionReuseStrategy	reuseStrategy	The connection re-use strategy.
protected final HttpRoutePlanner	routePlanner	The route planner.

Public Constructors
	DefaultRequestDirector(HttpRequestExecutor requestExec, ClientConnectionManager conman, ConnectionReuseStrategy reustrat, ConnectionKeepAliveStrategy kastrat, HttpRoutePlanner rouplan, HttpProcessor httpProcessor, HttpRequestRetryHandler retryHandler, RedirectHandler redirectHandler, AuthenticationHandler targetAuthHandler, AuthenticationHandler proxyAuthHandler, UserTokenHandler userTokenHandler, HttpParams params)

Public Methods
HttpResponse	execute(HttpHost target, HttpRequest request, HttpContext context) Executes a request.

Protected Methods
HttpRequest	createConnectRequest(HttpRoute route, HttpContext context) Creates the CONNECT request for tunnelling.
boolean	createTunnelToProxy(HttpRoute route, int hop, HttpContext context) Creates a tunnel to an intermediate proxy.
boolean	createTunnelToTarget(HttpRoute route, HttpContext context) Creates a tunnel to the target server.
HttpRoute	determineRoute(HttpHost target, HttpRequest request, HttpContext context) Determines the route for a request.
void	establishRoute(HttpRoute route, HttpContext context) Establishes the target route.
RoutedRequest	handleResponse(RoutedRequest roureq, HttpResponse response, HttpContext context) Analyzes a response to check need for a followup.
void	releaseConnection() Returns the connection back to the connection manager and prepares for retrieving a new connection during the next request.
void	rewriteRequestURI(RequestWrapper request, HttpRoute route)

[Expand]

Inherited Methods

From class java.lang.Object

Object	clone() Creates and returns a copy of this `Object`.
boolean	equals(Object o) Compares this instance with the specified object and indicates if they are equal.
void	finalize() Invoked when the garbage collector has detected that this instance is no longer reachable.
final Class<?>	getClass() Returns the unique instance of `Class` that represents this object's class.
int	hashCode() Returns an integer hash code for this object.
final void	notify() Causes a thread which is waiting on this object's monitor (by means of calling one of the `wait()` methods) to be woken up.
final void	notifyAll() Causes all threads which are waiting on this object's monitor (by means of calling one of the `wait()` methods) to be woken up.
String	toString() Returns a string containing a concise, human-readable description of this object.
final void	wait() Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object.
final void	wait(long millis, int nanos) Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object or until the specified timeout expires.
final void	wait(long millis) Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object or until the specified timeout expires.

From interface org.apache.http.client.RequestDirector

Fields

protected final ClientConnectionManager connManager

Added in API level 1

The connection manager.

protected final HttpProcessor httpProcessor

Added in API level 1

The HTTP protocol processor.

protected final ConnectionKeepAliveStrategy keepAliveStrategy

Added in API level 1

The keep-alive duration strategy.

protected ManagedClientConnection managedConn

Added in API level 1

The currently allocated connection.

protected final HttpParams params

Added in API level 1

The HTTP parameters.

protected final RedirectHandler redirectHandler

Added in API level 1

The redirect handler.

protected final HttpRequestExecutor requestExec

Added in API level 1

The request executor.

protected final HttpRequestRetryHandler retryHandler

Added in API level 1

The request retry handler.

protected final ConnectionReuseStrategy reuseStrategy

Added in API level 1

The connection re-use strategy.

protected final HttpRoutePlanner routePlanner

Added in API level 1

The route planner.

Public Constructors

public DefaultRequestDirector (HttpRequestExecutor requestExec, ClientConnectionManager conman, ConnectionReuseStrategy reustrat, ConnectionKeepAliveStrategy kastrat, HttpRoutePlanner rouplan, HttpProcessor httpProcessor, HttpRequestRetryHandler retryHandler, RedirectHandler redirectHandler, AuthenticationHandler targetAuthHandler, AuthenticationHandler proxyAuthHandler, UserTokenHandler userTokenHandler, HttpParams params)

Added in API level 1

Public Methods

public HttpResponse execute (HttpHost target, HttpRequest request, HttpContext context)

Added in API level 1

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
IOException

Protected Methods

protected HttpRequest createConnectRequest (HttpRoute route, HttpContext context)

Added in API level 1

Creates the CONNECT request for tunnelling. Called by createTunnelToTarget.

Parameters

route	the route to establish
context	the context for request execution

Returns

the CONNECT request for tunnelling

protected boolean createTunnelToProxy (HttpRoute route, int hop, HttpContext context)

Added in API level 1

Creates a tunnel to an intermediate proxy. This method is not implemented in this class. It just throws an exception here.

Parameters

route	the route to establish
hop	the hop in the route to establish now. `route.getHopTarget(hop)` will return the proxy to tunnel to.
context	the context for request execution

Returns

true if the partially tunnelled connection is secure, false otherwise.

Throws

HttpException	in case of a problem
IOException	in case of an IO problem

protected boolean createTunnelToTarget (HttpRoute route, HttpContext context)

Added in API level 1

Creates a tunnel to the target server. The connection must be established to the (last) proxy. A CONNECT request for tunnelling through the proxy will be created and sent, the response received and checked. This method does not update the connection with information about the tunnel, that is left to the caller.

Parameters

route	the route to establish
context	the context for request execution

Returns

true if the tunnelled route is secure, false otherwise. The implementation here always returns false, but derived classes may override.

Throws

HttpException	in case of a problem
IOException	in case of an IO problem

protected HttpRoute determineRoute (HttpHost target, HttpRequest request, HttpContext context)

Added in API level 1

Determines the route for a request. Called by execute(HttpHost, HttpRequest, HttpContext) to determine the route for either the original or a followup request.

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 to use for the execution, never `null`

Returns

the route the request should take

Throws

HttpException	in case of a problem

protected void establishRoute (HttpRoute route, HttpContext context)

Added in API level 1

Establishes the target route.

Parameters

route	the route to establish
context	the context for the request execution

Throws

HttpException	in case of a problem
IOException	in case of an IO problem

protected RoutedRequest handleResponse (RoutedRequest roureq, HttpResponse response, HttpContext context)

Added in API level 1

Analyzes a response to check need for a followup.

Parameters

roureq	the request and route.
response	the response to analayze
context	the context used for the current request execution

Returns

the followup request and route if there is a followup, or null if the response should be returned as is

Throws

HttpException	in case of a problem
IOException	in case of an IO problem

protected void releaseConnection ()

Added in API level 1

Returns the connection back to the connection manager and prepares for retrieving a new connection during the next request.

protected void rewriteRequestURI (RequestWrapper request, HttpRoute route)

Added in API level 1

Throws

ProtocolException

Results

Classes

Exceptions

DefaultRequestDirector

Class Overview

Summary

Fields

protected final ClientConnectionManager connManager

protected final HttpProcessor httpProcessor

protected final ConnectionKeepAliveStrategy keepAliveStrategy

protected ManagedClientConnection managedConn

protected final HttpParams params

protected final RedirectHandler redirectHandler

protected final HttpRequestExecutor requestExec

protected final HttpRequestRetryHandler retryHandler

protected final ConnectionReuseStrategy reuseStrategy

protected final HttpRoutePlanner routePlanner

Public Constructors

Public Methods

public HttpResponse execute (HttpHost target, HttpRequest request, HttpContext context)

Parameters

Returns

Throws

Protected Methods

protected HttpRequest createConnectRequest (HttpRoute route, HttpContext context)

Parameters

Returns

protected boolean createTunnelToProxy (HttpRoute route, int hop, HttpContext context)

Parameters

Returns

Throws

protected boolean createTunnelToTarget (HttpRoute route, HttpContext context)

Parameters

Returns

Throws

protected HttpRoute determineRoute (HttpHost target, HttpRequest request, HttpContext context)

Parameters

Returns

Throws

protected void establishRoute (HttpRoute route, HttpContext context)

Parameters

Throws

protected RoutedRequest handleResponse (RoutedRequest roureq, HttpResponse response, HttpContext context)

Parameters

Returns

Throws

protected void releaseConnection ()

protected void rewriteRequestURI (RequestWrapper request, HttpRoute route)

Throws