@NotThreadSafe public class DefaultRequestDirector extends Object implements org.apache.http.client.RequestDirector
RequestDirector.
The following parameters can be used to customize the behavior of this class:
CoreProtocolPNames.PROTOCOL_VERSIONCoreProtocolPNames.STRICT_TRANSFER_ENCODINGCoreProtocolPNames.HTTP_ELEMENT_CHARSETCoreProtocolPNames.USE_EXPECT_CONTINUECoreProtocolPNames.WAIT_FOR_CONTINUECoreProtocolPNames.USER_AGENTCoreConnectionPNames.SOCKET_BUFFER_SIZECoreConnectionPNames.MAX_LINE_LENGTHCoreConnectionPNames.MAX_HEADER_COUNTCoreConnectionPNames.SO_TIMEOUTCoreConnectionPNames.SO_LINGERCoreConnectionPNames.TCP_NODELAYCoreConnectionPNames.CONNECTION_TIMEOUTCoreConnectionPNames.STALE_CONNECTION_CHECKConnRoutePNames.FORCED_ROUTEConnRoutePNames.LOCAL_ADDRESSConnRoutePNames.DEFAULT_PROXYConnManagerPNames.TIMEOUTConnManagerPNames.MAX_CONNECTIONS_PER_ROUTEConnManagerPNames.MAX_TOTAL_CONNECTIONSorg.apache.http.cookie.params.CookieSpecPNames#DATE_PATTERNSorg.apache.http.cookie.params.CookieSpecPNames#SINGLE_COOKIE_HEADERorg.apache.http.auth.params.AuthPNames#CREDENTIAL_CHARSETClientPNames.COOKIE_POLICYClientPNames.HANDLE_AUTHENTICATIONClientPNames.HANDLE_REDIRECTSClientPNames.MAX_REDIRECTSClientPNames.ALLOW_CIRCULAR_REDIRECTSClientPNames.VIRTUAL_HOSTClientPNames.DEFAULT_HOSTClientPNames.DEFAULT_HEADERS| Modifier and Type | Field and Description |
|---|---|
protected org.apache.http.conn.ClientConnectionManager |
connManager
The connection manager.
|
protected org.apache.http.protocol.HttpProcessor |
httpProcessor
The HTTP protocol processor.
|
protected org.apache.http.conn.ConnectionKeepAliveStrategy |
keepAliveStrategy
The keep-alive duration strategy.
|
protected org.apache.http.conn.ManagedClientConnection |
managedConn
The currently allocated connection.
|
protected org.apache.http.params.HttpParams |
params
The HTTP parameters.
|
protected org.apache.http.client.AuthenticationHandler |
proxyAuthHandler
The proxy authentication handler.
|
protected org.apache.http.auth.AuthState |
proxyAuthState |
protected org.apache.http.client.RedirectHandler |
redirectHandler
The redirect handler.
|
protected org.apache.http.protocol.HttpRequestExecutor |
requestExec
The request executor.
|
protected org.apache.http.client.HttpRequestRetryHandler |
retryHandler
The request retry handler.
|
protected org.apache.http.ConnectionReuseStrategy |
reuseStrategy
The connection re-use strategy.
|
protected org.apache.http.conn.routing.HttpRoutePlanner |
routePlanner
The route planner.
|
protected org.apache.http.client.AuthenticationHandler |
targetAuthHandler
The target authentication handler.
|
protected org.apache.http.auth.AuthState |
targetAuthState |
protected org.apache.http.client.UserTokenHandler |
userTokenHandler
The user token handler.
|
| Constructor and Description |
|---|
DefaultRequestDirector(org.apache.http.protocol.HttpRequestExecutor requestExec,
org.apache.http.conn.ClientConnectionManager conman,
org.apache.http.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) |
DefaultRequestDirector(org.apache.commons.logging.Log log,
org.apache.http.protocol.HttpRequestExecutor requestExec,
org.apache.http.conn.ClientConnectionManager conman,
org.apache.http.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) |
| Modifier and Type | Method and Description |
|---|---|
protected org.apache.http.HttpRequest |
createConnectRequest(org.apache.http.conn.routing.HttpRoute route,
org.apache.http.protocol.HttpContext context)
Creates the CONNECT request for tunnelling.
|
protected boolean |
createTunnelToProxy(org.apache.http.conn.routing.HttpRoute route,
int hop,
org.apache.http.protocol.HttpContext context)
Creates a tunnel to an intermediate proxy.
|
protected boolean |
createTunnelToTarget(org.apache.http.conn.routing.HttpRoute route,
org.apache.http.protocol.HttpContext context)
Creates a tunnel to the target server.
|
protected org.apache.http.conn.routing.HttpRoute |
determineRoute(org.apache.http.HttpHost target,
org.apache.http.HttpRequest request,
org.apache.http.protocol.HttpContext context)
Determines the route for a request.
|
protected void |
establishRoute(org.apache.http.conn.routing.HttpRoute route,
org.apache.http.protocol.HttpContext context)
Establishes the target route.
|
org.apache.http.HttpResponse |
execute(org.apache.http.HttpHost target,
org.apache.http.HttpRequest request,
org.apache.http.protocol.HttpContext context) |
protected org.apache.http.impl.client.RoutedRequest |
handleResponse(org.apache.http.impl.client.RoutedRequest roureq,
org.apache.http.HttpResponse response,
org.apache.http.protocol.HttpContext context)
Analyzes a response to check need for a followup.
|
protected void |
releaseConnection()
Returns the connection back to the connection manager
and prepares for retrieving a new connection during
the next request.
|
protected void |
rewriteRequestURI(org.apache.http.impl.client.RequestWrapper request,
org.apache.http.conn.routing.HttpRoute route) |
protected final org.apache.http.conn.ClientConnectionManager connManager
protected final org.apache.http.conn.routing.HttpRoutePlanner routePlanner
protected final org.apache.http.ConnectionReuseStrategy reuseStrategy
protected final org.apache.http.conn.ConnectionKeepAliveStrategy keepAliveStrategy
protected final org.apache.http.protocol.HttpRequestExecutor requestExec
protected final org.apache.http.protocol.HttpProcessor httpProcessor
protected final org.apache.http.client.HttpRequestRetryHandler retryHandler
protected final org.apache.http.client.RedirectHandler redirectHandler
protected final org.apache.http.client.AuthenticationHandler targetAuthHandler
protected final org.apache.http.client.AuthenticationHandler proxyAuthHandler
protected final org.apache.http.client.UserTokenHandler userTokenHandler
protected final org.apache.http.params.HttpParams params
protected org.apache.http.conn.ManagedClientConnection managedConn
protected final org.apache.http.auth.AuthState targetAuthState
protected final org.apache.http.auth.AuthState proxyAuthState
public DefaultRequestDirector(org.apache.commons.logging.Log log,
org.apache.http.protocol.HttpRequestExecutor requestExec,
org.apache.http.conn.ClientConnectionManager conman,
org.apache.http.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)
public DefaultRequestDirector(org.apache.http.protocol.HttpRequestExecutor requestExec,
org.apache.http.conn.ClientConnectionManager conman,
org.apache.http.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)
protected void rewriteRequestURI(org.apache.http.impl.client.RequestWrapper request,
org.apache.http.conn.routing.HttpRoute route)
throws org.apache.http.ProtocolException
org.apache.http.ProtocolExceptionpublic org.apache.http.HttpResponse execute(org.apache.http.HttpHost target,
org.apache.http.HttpRequest request,
org.apache.http.protocol.HttpContext context)
throws org.apache.http.HttpException,
IOException
execute in interface org.apache.http.client.RequestDirectororg.apache.http.HttpExceptionIOExceptionprotected void releaseConnection()
protected org.apache.http.conn.routing.HttpRoute determineRoute(org.apache.http.HttpHost target,
org.apache.http.HttpRequest request,
org.apache.http.protocol.HttpContext context)
throws org.apache.http.HttpException
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.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 executecontext - the context to use for the execution,
never nullorg.apache.http.HttpException - in case of a problemprotected void establishRoute(org.apache.http.conn.routing.HttpRoute route,
org.apache.http.protocol.HttpContext context)
throws org.apache.http.HttpException,
IOException
route - the route to establishcontext - the context for the request executionorg.apache.http.HttpException - in case of a problemIOException - in case of an IO problemprotected boolean createTunnelToTarget(org.apache.http.conn.routing.HttpRoute route,
org.apache.http.protocol.HttpContext context)
throws org.apache.http.HttpException,
IOException
route - the route to establishcontext - the context for request executiontrue if the tunnelled route is secure,
false otherwise.
The implementation here always returns false,
but derived classes may override.org.apache.http.HttpException - in case of a problemIOException - in case of an IO problemprotected boolean createTunnelToProxy(org.apache.http.conn.routing.HttpRoute route,
int hop,
org.apache.http.protocol.HttpContext context)
throws org.apache.http.HttpException,
IOException
route - the route to establishhop - the hop in the route to establish now.
route.getHopTarget(hop)
will return the proxy to tunnel to.context - the context for request executiontrue if the partially tunnelled connection
is secure, false otherwise.org.apache.http.HttpException - in case of a problemIOException - in case of an IO problemprotected org.apache.http.HttpRequest createConnectRequest(org.apache.http.conn.routing.HttpRoute route,
org.apache.http.protocol.HttpContext context)
createTunnelToTarget.route - the route to establishcontext - the context for request executionprotected org.apache.http.impl.client.RoutedRequest handleResponse(org.apache.http.impl.client.RoutedRequest roureq,
org.apache.http.HttpResponse response,
org.apache.http.protocol.HttpContext context)
throws org.apache.http.HttpException,
IOException
roureq - the request and route.response - the response to analayzecontext - the context used for the current request executionnull if the response should be returned as isorg.apache.http.HttpException - in case of a problemIOException - in case of an IO problemCopyright © 2015. All rights reserved.