org.apache.http.impl.client
Class DefaultHttpClient

java.lang.Object
  org.apache.http.impl.client.AbstractHttpClient
      org.apache.http.impl.client.DefaultHttpClient

All Implemented Interfaces:

HttpClient

@ThreadSafe
public class DefaultHttpClient
extends AbstractHttpClient

Default implementation of AbstractHttpClient.

This class creates an instance of SingleClientConnManager for connection management if not explicitly set.

This class creates the following chain of protocol interceptors per default:

• RequestDefaultHeaders
• RequestContent
• RequestTargetHost
• RequestClientConnControl
• RequestUserAgent
• RequestExpectContinue
• RequestAddCookies
• ResponseProcessCookies
• RequestTargetAuthentication
• RequestProxyAuthentication

This class sets up the following parameters if not explicitly set:

• Version: HttpVersion.HTTP_1_1
• ContentCharset: HTTP.DEFAULT_CONTENT_CHARSET
• UseExpectContinue: true
• NoTcpDelay: true
• SocketBufferSize: 8192
• UserAgent: Apache-HttpClient/release (java 1.5)

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.TCP_NODELAY
• CoreConnectionPNames.CONNECTION_TIMEOUT
• CoreConnectionPNames.STALE_CONNECTION_CHECK
• ConnRoutePNames.FORCED_ROUTE
• ConnRoutePNames.LOCAL_ADDRESS
• ConnRoutePNames.DEFAULT_PROXY
• ConnManagerPNames.TIMEOUT
• ConnManagerPNames.MAX_CONNECTIONS_PER_ROUTE
• ConnManagerPNames.MAX_TOTAL_CONNECTIONS
• CookieSpecPNames.DATE_PATTERNS
• 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.CONNECTION_MANAGER_FACTORY_CLASS_NAME

Since:

4.0

Constructor Summary

DefaultHttpClient()

DefaultHttpClient(ClientConnectionManager conman, HttpParams params)
Creates a new HTTP client from parameters and a connection manager.

DefaultHttpClient(HttpParams params)

Method Summary

protected AuthSchemeRegistry	createAuthSchemeRegistry()
protected ClientConnectionManager	createClientConnectionManager()
protected ConnectionKeepAliveStrategy	createConnectionKeepAliveStrategy()
protected ConnectionReuseStrategy	createConnectionReuseStrategy()
protected CookieSpecRegistry	createCookieSpecRegistry()
protected CookieStore	createCookieStore()
protected CredentialsProvider	createCredentialsProvider()
protected HttpContext	createHttpContext()
protected HttpParams	createHttpParams()
protected BasicHttpProcessor	createHttpProcessor()
protected HttpRequestRetryHandler	createHttpRequestRetryHandler()
protected HttpRoutePlanner	createHttpRoutePlanner()
protected AuthenticationHandler	createProxyAuthenticationHandler()
protected RedirectHandler	createRedirectHandler()
protected HttpRequestExecutor	createRequestExecutor()
protected AuthenticationHandler	createTargetAuthenticationHandler()
protected UserTokenHandler	createUserTokenHandler()

Methods inherited from class org.apache.http.impl.client.AbstractHttpClient

addRequestInterceptor, addRequestInterceptor, addResponseInterceptor, addResponseInterceptor, clearRequestInterceptors, clearResponseInterceptors, createClientRequestDirector, determineParams, execute, execute, execute, execute, execute, execute, execute, execute, getAuthSchemes, getConnectionKeepAliveStrategy, getConnectionManager, getConnectionReuseStrategy, getCookieSpecs, getCookieStore, getCredentialsProvider, getHttpProcessor, getHttpRequestRetryHandler, getParams, getProxyAuthenticationHandler, getRedirectHandler, getRequestExecutor, getRequestInterceptor, getRequestInterceptorCount, getResponseInterceptor, getResponseInterceptorCount, getRoutePlanner, getTargetAuthenticationHandler, getUserTokenHandler, removeRequestInterceptorByClass, removeResponseInterceptorByClass, setAuthSchemes, setCookieSpecs, setCookieStore, setCredentialsProvider, setHttpRequestRetryHandler, setKeepAliveStrategy, setParams, setProxyAuthenticationHandler, setRedirectHandler, setReuseStrategy, setRoutePlanner, setTargetAuthenticationHandler, setUserTokenHandler

Methods inherited from class java.lang.Object

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

Constructor Detail

DefaultHttpClient

public DefaultHttpClient(ClientConnectionManager conman,
                         HttpParams params)

Creates a new HTTP client from parameters and a connection manager.

Parameters:

params - the parameters

conman - the connection manager

DefaultHttpClient

public DefaultHttpClient(HttpParams params)

DefaultHttpClient

public DefaultHttpClient()

Method Detail

createHttpParams

protected HttpParams createHttpParams()

Specified by:

createHttpParams in class AbstractHttpClient

createRequestExecutor

protected HttpRequestExecutor createRequestExecutor()

Specified by:

createRequestExecutor in class AbstractHttpClient

createClientConnectionManager

protected ClientConnectionManager createClientConnectionManager()

Specified by:

createClientConnectionManager in class AbstractHttpClient

createHttpContext

protected HttpContext createHttpContext()

Specified by:

createHttpContext in class AbstractHttpClient

createConnectionReuseStrategy

protected ConnectionReuseStrategy createConnectionReuseStrategy()

Specified by:

createConnectionReuseStrategy in class AbstractHttpClient

createConnectionKeepAliveStrategy

protected ConnectionKeepAliveStrategy createConnectionKeepAliveStrategy()

Specified by:

createConnectionKeepAliveStrategy in class AbstractHttpClient

createAuthSchemeRegistry

protected AuthSchemeRegistry createAuthSchemeRegistry()

Specified by:

createAuthSchemeRegistry in class AbstractHttpClient

createCookieSpecRegistry

protected CookieSpecRegistry createCookieSpecRegistry()

Specified by:

createCookieSpecRegistry in class AbstractHttpClient

createHttpProcessor

protected BasicHttpProcessor createHttpProcessor()

Specified by:

createHttpProcessor in class AbstractHttpClient

createHttpRequestRetryHandler

protected HttpRequestRetryHandler createHttpRequestRetryHandler()

Specified by:

createHttpRequestRetryHandler in class AbstractHttpClient

createRedirectHandler

protected RedirectHandler createRedirectHandler()

Specified by:

createRedirectHandler in class AbstractHttpClient

createTargetAuthenticationHandler

protected AuthenticationHandler createTargetAuthenticationHandler()

Specified by:

createTargetAuthenticationHandler in class AbstractHttpClient

createProxyAuthenticationHandler

protected AuthenticationHandler createProxyAuthenticationHandler()

Specified by:

createProxyAuthenticationHandler in class AbstractHttpClient

createCookieStore

protected CookieStore createCookieStore()

Specified by:

createCookieStore in class AbstractHttpClient

createCredentialsProvider

protected CredentialsProvider createCredentialsProvider()

Specified by:

createCredentialsProvider in class AbstractHttpClient

createHttpRoutePlanner

protected HttpRoutePlanner createHttpRoutePlanner()

Specified by:

createHttpRoutePlanner in class AbstractHttpClient

createUserTokenHandler

protected UserTokenHandler createUserTokenHandler()

Specified by:

createUserTokenHandler in class AbstractHttpClient