org.apache.http.impl.client

Class DefaultRequestDirector

java.lang.Object

org.apache.http.impl.client.DefaultRequestDirector

All Implemented Interfaces:

org.apache.http.client.RequestDirector

Deprecated.

(4.3)

@Deprecated
public class DefaultRequestDirector
extends java.lang.Object
implements org.apache.http.client.RequestDirector

Default implementation of RequestDirector.

The following parameters can be used to customize the behavior of this class:

• CoreProtocolPNames.PROTOCOL_VERSION
• CoreProtocolPNames.STRICT_TRANSFER_ENCODING
• CoreProtocolPNames.HTTP_ELEMENT_CHARSET
• CoreProtocolPNames.USE_EXPECT_CONTINUE
• CoreProtocolPNames.WAIT_FOR_CONTINUE
• CoreProtocolPNames.USER_AGENT
• CoreConnectionPNames.SOCKET_BUFFER_SIZE
• CoreConnectionPNames.MAX_LINE_LENGTH
• CoreConnectionPNames.MAX_HEADER_COUNT
• CoreConnectionPNames.SO_TIMEOUT
• CoreConnectionPNames.SO_LINGER
• CoreConnectionPNames.SO_REUSEADDR
• CoreConnectionPNames.TCP_NODELAY
• CoreConnectionPNames.CONNECTION_TIMEOUT
• CoreConnectionPNames.STALE_CONNECTION_CHECK
• org.apache.http.conn.params.ConnRoutePNames#FORCED_ROUTE
• org.apache.http.conn.params.ConnRoutePNames#LOCAL_ADDRESS
• org.apache.http.conn.params.ConnRoutePNames#DEFAULT_PROXY
• org.apache.http.cookie.params.CookieSpecPNames#DATE_PATTERNS
• org.apache.http.cookie.params.CookieSpecPNames#SINGLE_COOKIE_HEADER
• AuthPNames.CREDENTIAL_CHARSET
• ClientPNames.COOKIE_POLICY
• ClientPNames.HANDLE_AUTHENTICATION
• ClientPNames.HANDLE_REDIRECTS
• ClientPNames.MAX_REDIRECTS
• ClientPNames.ALLOW_CIRCULAR_REDIRECTS
• ClientPNames.VIRTUAL_HOST
• ClientPNames.DEFAULT_HOST
• ClientPNames.DEFAULT_HEADERS
• ClientPNames.CONN_MANAGER_TIMEOUT

Since:

4.0

Field Summary

Fields

Modifier and Type	Field and Description
protected org.apache.http.conn.ClientConnectionManager	connManager Deprecated. The connection manager.
protected org.apache.http.protocol.HttpProcessor	httpProcessor Deprecated. The HTTP protocol processor.
protected org.apache.http.conn.ConnectionKeepAliveStrategy	keepAliveStrategy Deprecated. The keep-alive duration strategy.
protected org.apache.http.conn.ManagedClientConnection	managedConn Deprecated. The currently allocated connection.
protected org.apache.http.params.HttpParams	params Deprecated. The HTTP parameters.
protected org.apache.http.client.AuthenticationHandler	proxyAuthHandler Deprecated.
protected org.apache.http.auth.AuthState	proxyAuthState Deprecated.
protected org.apache.http.client.AuthenticationStrategy	proxyAuthStrategy Deprecated. The proxy authentication handler.
protected org.apache.http.client.RedirectHandler	redirectHandler Deprecated.
protected org.apache.http.client.RedirectStrategy	redirectStrategy Deprecated. The redirect strategy.
protected org.apache.http.protocol.HttpRequestExecutor	requestExec Deprecated. The request executor.
protected org.apache.http.client.HttpRequestRetryHandler	retryHandler Deprecated. The request retry handler.
protected ConnectionReuseStrategy	reuseStrategy Deprecated. The connection re-use strategy.
protected org.apache.http.conn.routing.HttpRoutePlanner	routePlanner Deprecated. The route planner.
protected org.apache.http.client.AuthenticationHandler	targetAuthHandler Deprecated.
protected org.apache.http.auth.AuthState	targetAuthState Deprecated.
protected org.apache.http.client.AuthenticationStrategy	targetAuthStrategy Deprecated. The target authentication handler.
protected org.apache.http.client.UserTokenHandler	userTokenHandler Deprecated. The user token handler.

Constructor Summary

Constructors

Constructor and Description
DefaultRequestDirector(org.apache.http.protocol.HttpRequestExecutor requestExec, org.apache.http.conn.ClientConnectionManager conman, ConnectionReuseStrategy reustrat, org.apache.http.conn.ConnectionKeepAliveStrategy kastrat, org.apache.http.conn.routing.HttpRoutePlanner rouplan, org.apache.http.protocol.HttpProcessor httpProcessor, org.apache.http.client.HttpRequestRetryHandler retryHandler, org.apache.http.client.RedirectHandler redirectHandler, org.apache.http.client.AuthenticationHandler targetAuthHandler, org.apache.http.client.AuthenticationHandler proxyAuthHandler, org.apache.http.client.UserTokenHandler userTokenHandler, org.apache.http.params.HttpParams params) Deprecated.
DefaultRequestDirector(Log log, org.apache.http.protocol.HttpRequestExecutor requestExec, org.apache.http.conn.ClientConnectionManager conman, ConnectionReuseStrategy reustrat, org.apache.http.conn.ConnectionKeepAliveStrategy kastrat, org.apache.http.conn.routing.HttpRoutePlanner rouplan, org.apache.http.protocol.HttpProcessor httpProcessor, org.apache.http.client.HttpRequestRetryHandler retryHandler, org.apache.http.client.RedirectStrategy redirectStrategy, org.apache.http.client.AuthenticationHandler targetAuthHandler, org.apache.http.client.AuthenticationHandler proxyAuthHandler, org.apache.http.client.UserTokenHandler userTokenHandler, org.apache.http.params.HttpParams params) Deprecated.
DefaultRequestDirector(Log log, org.apache.http.protocol.HttpRequestExecutor requestExec, org.apache.http.conn.ClientConnectionManager conman, ConnectionReuseStrategy reustrat, org.apache.http.conn.ConnectionKeepAliveStrategy kastrat, org.apache.http.conn.routing.HttpRoutePlanner rouplan, org.apache.http.protocol.HttpProcessor httpProcessor, org.apache.http.client.HttpRequestRetryHandler retryHandler, org.apache.http.client.RedirectStrategy redirectStrategy, org.apache.http.client.AuthenticationStrategy targetAuthStrategy, org.apache.http.client.AuthenticationStrategy proxyAuthStrategy, org.apache.http.client.UserTokenHandler userTokenHandler, org.apache.http.params.HttpParams params) Deprecated.

Method Summary

Modifier and Type	Method and Description
protected HttpRequest	createConnectRequest(org.apache.http.conn.routing.HttpRoute route, org.apache.http.protocol.HttpContext context) Deprecated. Creates the CONNECT request for tunnelling.
protected boolean	createTunnelToProxy(org.apache.http.conn.routing.HttpRoute route, int hop, org.apache.http.protocol.HttpContext context) Deprecated. Creates a tunnel to an intermediate proxy.
protected boolean	createTunnelToTarget(org.apache.http.conn.routing.HttpRoute route, org.apache.http.protocol.HttpContext context) Deprecated. Creates a tunnel to the target server.
protected org.apache.http.conn.routing.HttpRoute	determineRoute(HttpHost targetHost, HttpRequest request, org.apache.http.protocol.HttpContext context) Deprecated. Determines the route for a request.
protected void	establishRoute(org.apache.http.conn.routing.HttpRoute route, org.apache.http.protocol.HttpContext context) Deprecated. Establishes the target route.
HttpResponse	execute(HttpHost targetHost, HttpRequest request, org.apache.http.protocol.HttpContext context) Deprecated.
protected RoutedRequest	handleResponse(RoutedRequest roureq, HttpResponse response, org.apache.http.protocol.HttpContext context) Deprecated. Analyzes a response to check need for a followup.
protected void	releaseConnection() Deprecated. Returns the connection back to the connection manager and prepares for retrieving a new connection during the next request.
protected void	rewriteRequestURI(RequestWrapper request, org.apache.http.conn.routing.HttpRoute route) Deprecated.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

connManager

protected final org.apache.http.conn.ClientConnectionManager connManager

Deprecated.

The connection manager.

routePlanner

protected final org.apache.http.conn.routing.HttpRoutePlanner routePlanner

Deprecated.

The route planner.

reuseStrategy

protected final ConnectionReuseStrategy reuseStrategy

Deprecated.

The connection re-use strategy.

keepAliveStrategy

protected final org.apache.http.conn.ConnectionKeepAliveStrategy keepAliveStrategy

Deprecated.

The keep-alive duration strategy.

requestExec

protected final org.apache.http.protocol.HttpRequestExecutor requestExec

Deprecated.

The request executor.

httpProcessor

protected final org.apache.http.protocol.HttpProcessor httpProcessor

Deprecated.

The HTTP protocol processor.

retryHandler

protected final org.apache.http.client.HttpRequestRetryHandler retryHandler

Deprecated.

The request retry handler.

redirectHandler

@Deprecated
protected final org.apache.http.client.RedirectHandler redirectHandler

Deprecated.

The redirect handler.

redirectStrategy

protected final org.apache.http.client.RedirectStrategy redirectStrategy

Deprecated.

The redirect strategy.

targetAuthHandler

@Deprecated
protected final org.apache.http.client.AuthenticationHandler targetAuthHandler

Deprecated.

The target authentication handler.

targetAuthStrategy

protected final org.apache.http.client.AuthenticationStrategy targetAuthStrategy

Deprecated.

The target authentication handler.

proxyAuthHandler

@Deprecated
protected final org.apache.http.client.AuthenticationHandler proxyAuthHandler

Deprecated.

The proxy authentication handler.

proxyAuthStrategy

protected final org.apache.http.client.AuthenticationStrategy proxyAuthStrategy

Deprecated.

The proxy authentication handler.

userTokenHandler

protected final org.apache.http.client.UserTokenHandler userTokenHandler

Deprecated.

The user token handler.

params

protected final org.apache.http.params.HttpParams params

Deprecated.

The HTTP parameters.

managedConn

protected org.apache.http.conn.ManagedClientConnection managedConn

Deprecated.

The currently allocated connection.

targetAuthState

protected final org.apache.http.auth.AuthState targetAuthState

Deprecated.

proxyAuthState

protected final org.apache.http.auth.AuthState proxyAuthState

Deprecated.

Constructor Detail

DefaultRequestDirector

@Deprecated
public DefaultRequestDirector(org.apache.http.protocol.HttpRequestExecutor requestExec,
                                          org.apache.http.conn.ClientConnectionManager conman,
                                          ConnectionReuseStrategy reustrat,
                                          org.apache.http.conn.ConnectionKeepAliveStrategy kastrat,
                                          org.apache.http.conn.routing.HttpRoutePlanner rouplan,
                                          org.apache.http.protocol.HttpProcessor httpProcessor,
                                          org.apache.http.client.HttpRequestRetryHandler retryHandler,
                                          org.apache.http.client.RedirectHandler redirectHandler,
                                          org.apache.http.client.AuthenticationHandler targetAuthHandler,
                                          org.apache.http.client.AuthenticationHandler proxyAuthHandler,
                                          org.apache.http.client.UserTokenHandler userTokenHandler,
                                          org.apache.http.params.HttpParams params)

Deprecated.

DefaultRequestDirector

@Deprecated
public DefaultRequestDirector(Log log,
                                          org.apache.http.protocol.HttpRequestExecutor requestExec,
                                          org.apache.http.conn.ClientConnectionManager conman,
                                          ConnectionReuseStrategy reustrat,
                                          org.apache.http.conn.ConnectionKeepAliveStrategy kastrat,
                                          org.apache.http.conn.routing.HttpRoutePlanner rouplan,
                                          org.apache.http.protocol.HttpProcessor httpProcessor,
                                          org.apache.http.client.HttpRequestRetryHandler retryHandler,
                                          org.apache.http.client.RedirectStrategy redirectStrategy,
                                          org.apache.http.client.AuthenticationHandler targetAuthHandler,
                                          org.apache.http.client.AuthenticationHandler proxyAuthHandler,
                                          org.apache.http.client.UserTokenHandler userTokenHandler,
                                          org.apache.http.params.HttpParams params)

Deprecated.

DefaultRequestDirector

public DefaultRequestDirector(Log log,
                              org.apache.http.protocol.HttpRequestExecutor requestExec,
                              org.apache.http.conn.ClientConnectionManager conman,
                              ConnectionReuseStrategy reustrat,
                              org.apache.http.conn.ConnectionKeepAliveStrategy kastrat,
                              org.apache.http.conn.routing.HttpRoutePlanner rouplan,
                              org.apache.http.protocol.HttpProcessor httpProcessor,
                              org.apache.http.client.HttpRequestRetryHandler retryHandler,
                              org.apache.http.client.RedirectStrategy redirectStrategy,
                              org.apache.http.client.AuthenticationStrategy targetAuthStrategy,
                              org.apache.http.client.AuthenticationStrategy proxyAuthStrategy,
                              org.apache.http.client.UserTokenHandler userTokenHandler,
                              org.apache.http.params.HttpParams params)

Deprecated.

Since:

4.2

Method Detail

rewriteRequestURI

protected void rewriteRequestURI(RequestWrapper request,
                                 org.apache.http.conn.routing.HttpRoute route)
                          throws ProtocolException

Deprecated.

Throws:

ProtocolException

execute

public HttpResponse execute(HttpHost targetHost,
                            HttpRequest request,
                            org.apache.http.protocol.HttpContext context)
                     throws HttpException,
                            java.io.IOException

Deprecated.

Specified by:

execute in interface org.apache.http.client.RequestDirector

Throws:

HttpException

java.io.IOException

releaseConnection

protected void releaseConnection()

Deprecated.

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

determineRoute

protected org.apache.http.conn.routing.HttpRoute determineRoute(HttpHost targetHost,
                                                                HttpRequest request,
                                                                org.apache.http.protocol.HttpContext context)
                                                         throws HttpException

Deprecated.

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

Parameters:

targetHost - 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

establishRoute

protected void establishRoute(org.apache.http.conn.routing.HttpRoute route,
                              org.apache.http.protocol.HttpContext context)
                       throws HttpException,
                              java.io.IOException

Deprecated.

Establishes the target route.

Parameters:

route - the route to establish

context - the context for the request execution

Throws:

HttpException - in case of a problem

java.io.IOException - in case of an IO problem

createTunnelToTarget

protected boolean createTunnelToTarget(org.apache.http.conn.routing.HttpRoute route,
                                       org.apache.http.protocol.HttpContext context)
                                throws HttpException,
                                       java.io.IOException

Deprecated.

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

java.io.IOException - in case of an IO problem

createTunnelToProxy

protected boolean createTunnelToProxy(org.apache.http.conn.routing.HttpRoute route,
                                      int hop,
                                      org.apache.http.protocol.HttpContext context)
                               throws HttpException,
                                      java.io.IOException

Deprecated.

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

java.io.IOException - in case of an IO problem

createConnectRequest

protected HttpRequest createConnectRequest(org.apache.http.conn.routing.HttpRoute route,
                                           org.apache.http.protocol.HttpContext context)

Deprecated.

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

handleResponse

protected RoutedRequest handleResponse(RoutedRequest roureq,
                                       HttpResponse response,
                                       org.apache.http.protocol.HttpContext context)
                                throws HttpException,
                                       java.io.IOException

Deprecated.

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

java.io.IOException - in case of an IO problem