Deprecated List (HttpClient Library (Version 3.1))
Date: 2018-05-07

# Deprecated API

## Contents

- Deprecated Interfaces
- Deprecated Classes
- Deprecated Exceptions
- Deprecated Fields
- Deprecated Methods
- Deprecated Constructors

- Deprecated Interfaces
  Interface and Description
  org.apache.commons.httpclient.MethodRetryHandler use `HttpMethodRetryHandler`

- Deprecated Classes
  Class and Description
  org.apache.commons.httpclient.auth.AuthSchemeBase No longer used
  org.apache.commons.httpclient.util.DateParser Use `DateUtil`
  org.apache.commons.httpclient.DefaultMethodRetryHandler use `DefaultHttpMethodRetryHandler`
  org.apache.commons.httpclient.auth.HttpAuthenticator no longer used
  org.apache.commons.httpclient.auth.HttpAuthRealm no longer used
  org.apache.commons.httpclient.HttpConstants use EncodingUtil class
  org.apache.commons.httpclient.methods.MultipartPostMethod Use `MultipartRequestEntity` in conjunction with `PostMethod` instead.
  org.apache.commons.httpclient.util.URIUtil.Coder use org.apache.commons.codec.net.URLCodec

- Deprecated Exceptions
  Exceptions and Description
  org.apache.commons.httpclient.HttpRecoverableException no longer used

- Deprecated Fields
  Field and Description
  org.apache.commons.httpclient.HttpsURL._default_port Use `HttpsURL.DEFAULT_PORT` instead. This one doesn't conform to the project naming conventions.
  org.apache.commons.httpclient.HttpURL._default_port Use `HttpURL.DEFAULT_PORT` instead. This one doesn't conform to the project naming conventions.
  org.apache.commons.httpclient.HttpsURL._default_scheme Use `HttpsURL.DEFAULT_SCHEME` instead. This one doesn't conform to the project naming conventions.
  org.apache.commons.httpclient.HttpURL._default_scheme Use `HttpURL.DEFAULT_SCHEME` instead. This one doesn't conform to the project naming conventions.
  org.apache.commons.httpclient.methods.multipart.Part.BOUNDARY use `HttpMethodParams.MULTIPART_BOUNDARY`
  org.apache.commons.httpclient.methods.multipart.Part.BOUNDARY_BYTES
  org.apache.commons.httpclient.cookie.CookiePolicy.COMPATIBILITY Use `CookiePolicy.BROWSER_COMPATIBILITY`
  org.apache.commons.httpclient.methods.EntityEnclosingMethod.CONTENT_LENGTH_AUTO Use `InputStreamRequestEntity.CONTENT_LENGTH_AUTO`.
  org.apache.commons.httpclient.methods.EntityEnclosingMethod.CONTENT_LENGTH_CHUNKED Use `EntityEnclosingMethod.setContentChunked(boolean)`.
  org.apache.commons.httpclient.cookie.CookiePolicy.NETSCAPE_DRAFT Use `CookiePolicy.NETSCAPE`
  org.apache.commons.httpclient.HttpState.PREEMPTIVE_DEFAULT This field and feature will be removed following HttpClient 3.0.
  org.apache.commons.httpclient.HttpState.PREEMPTIVE_PROPERTY This field and feature will be removed following HttpClient 3.0.
  org.apache.commons.httpclient.cookie.CookiePolicy.RFC2109 Use `CookiePolicy.RFC_2109`
  org.apache.commons.httpclient.cookie.CookiePolicy.RFC2965 Use `CookiePolicy.RFC_2965`

- Deprecated Methods
  Method and Description
  org.apache.commons.httpclient.auth.HttpAuthenticator.authenticate(AuthScheme, HttpMethod, HttpConnection, HttpState) use AuthScheme
  org.apache.commons.httpclient.auth.NTLMScheme.authenticate(Credentials, String, String) Use `NTLMScheme.authenticate(Credentials, HttpMethod)`
  org.apache.commons.httpclient.auth.DigestScheme.authenticate(Credentials, String, String) Use `DigestScheme.authenticate(Credentials, HttpMethod)`
  org.apache.commons.httpclient.auth.BasicScheme.authenticate(Credentials, String, String) Use `BasicScheme.authenticate(Credentials, HttpMethod)`
  org.apache.commons.httpclient.auth.AuthScheme.authenticate(Credentials, String, String) Use `AuthScheme.authenticate(Credentials, HttpMethod)` Produces an authorization string for the given set of `Credentials`, method name and URI using the given authentication scheme in response to the actual authorization challenge.
  org.apache.commons.httpclient.auth.NTLMScheme.authenticate(NTCredentials, String) Use non-static `NTLMScheme.authenticate(Credentials, HttpMethod)`
  org.apache.commons.httpclient.auth.NTLMScheme.authenticate(NTCredentials, String, String) Use non-static `NTLMScheme.authenticate(Credentials, HttpMethod)`
  org.apache.commons.httpclient.auth.BasicScheme.authenticate(UsernamePasswordCredentials) Use `BasicScheme.authenticate(UsernamePasswordCredentials, String)` Returns a basic `Authorization` header value for the given `UsernamePasswordCredentials`.
  org.apache.commons.httpclient.auth.HttpAuthenticator.authenticateDefault(HttpMethod, HttpConnection, HttpState) use AuthScheme
  org.apache.commons.httpclient.auth.HttpAuthenticator.authenticateProxy(AuthScheme, HttpMethod, HttpConnection, HttpState) use AuthScheme
  org.apache.commons.httpclient.auth.HttpAuthenticator.authenticateProxyDefault(HttpMethod, HttpConnection, HttpState) use AuthScheme
  org.apache.commons.httpclient.util.URIUtil.Coder.decode(char[], String) use org.apache.commons.codec.net.URLCodec
  org.apache.commons.httpclient.util.URIUtil.Coder.encode(String, BitSet, String) use org.apache.commons.codec.net.URLCodec
  org.apache.commons.httpclient.HttpMethodBase.getAuthenticationRealm() use #getHostAuthState()
  org.apache.commons.httpclient.methods.HeadMethod.getBodyCheckTimeout() Use `HttpMethodParams`
  org.apache.commons.httpclient.methods.multipart.Part.getBoundary() uses a constant string. Rather use `Part.getPartBoundary()`
  org.apache.commons.httpclient.cookie.CookiePolicy.getCompatibilitySpec() Use `CookiePolicy.getCookieSpec(String)`
  org.apache.commons.httpclient.SimpleHttpConnectionManager.getConnection(HostConfiguration, long) Use #getConnectionWithTimeout(HostConfiguration, long)
  org.apache.commons.httpclient.MultiThreadedHttpConnectionManager.getConnection(HostConfiguration, long) Use #getConnectionWithTimeout(HostConfiguration, long)
  org.apache.commons.httpclient.HttpConnectionManager.getConnection(HostConfiguration, long) Use #getConnectionWithTimeout(HostConfiguration, long)
  org.apache.commons.httpclient.MultiThreadedHttpConnectionManager.getConnectionsInUse() Use `MultiThreadedHttpConnectionManager.getConnectionsInPool()`
  org.apache.commons.httpclient.MultiThreadedHttpConnectionManager.getConnectionsInUse(HostConfiguration) Use `MultiThreadedHttpConnectionManager.getConnectionsInPool(HostConfiguration)`
  org.apache.commons.httpclient.HttpState.getCookiePolicy() Use `HttpMethodParams.getCookiePolicy()`, `HttpMethod.getParams()`.
  org.apache.commons.httpclient.HttpState.getCookies(String, int, String, boolean) use CookieSpec#match(String, int, String, boolean, Cookie)
  org.apache.commons.httpclient.HttpState.getCredentials(String, String) use #getCredentials(AuthScope)
  org.apache.commons.httpclient.cookie.CookiePolicy.getDefaultPolicy() Use `CookiePolicy.getDefaultSpec()`
  org.apache.commons.httpclient.HttpClient.getHost() use #getHostConfiguration()
  org.apache.commons.httpclient.HttpMethodBase.getHostConfiguration() no longer applicable
  org.apache.commons.httpclient.HttpMethod.getHostConfiguration() no longer applicable
  org.apache.commons.httpclient.auth.NTLMScheme.getID() no longer used
  org.apache.commons.httpclient.auth.DigestScheme.getID() no longer used
  org.apache.commons.httpclient.auth.RFC2617Scheme.getID() no longer used
  org.apache.commons.httpclient.auth.AuthScheme.getID() no longer used
  org.apache.commons.httpclient.MultiThreadedHttpConnectionManager.getMaxConnectionsPerHost() Use `HttpConnectionManagerParams.getDefaultMaxConnectionsPerHost()`, `HttpConnectionManager.getParams()`.
  org.apache.commons.httpclient.MultiThreadedHttpConnectionManager.getMaxTotalConnections() Use `HttpConnectionManagerParams.getMaxTotalConnections()`, `HttpConnectionManager.getParams()`.
  org.apache.commons.httpclient.HttpMethodBase.getMethodRetryHandler() use `HttpMethodParams`
  org.apache.commons.httpclient.HttpClient.getPort() use #getHostConfiguration()
  org.apache.commons.httpclient.HttpMethodBase.getProxyAuthenticationRealm() use #getProxyAuthState()
  org.apache.commons.httpclient.HttpState.getProxyCredentials(String, String) use #getProxyCredentials(AuthScope)
  org.apache.commons.httpclient.HttpException.getReason() HttpClient no longer uses this for itself. It is only provided for compatibility with existing clients, and will be removed in a future release.
  org.apache.commons.httpclient.URIException.getReason() You should instead call `Throwable.getMessage()`.
  org.apache.commons.httpclient.HttpException.getReasonCode() HttpClient no longer uses this for itself. It is only provided for compatibility with existing clients, and will be removed in a future release.
  org.apache.commons.httpclient.HttpMethodBase.getRecoverableExceptionCount() no longer used Returns the number of "recoverable" exceptions thrown and handled, to allow for monitoring the quality of the connection.
  org.apache.commons.httpclient.HttpConnection.getSoTimeout() Use `HttpConnectionParams.getSoTimeout()`, `HttpConnection.getParams()`.
  org.apache.commons.httpclient.cookie.CookiePolicy.getSpecByPolicy(int) Use `CookiePolicy.getCookieSpec(String)`
  org.apache.commons.httpclient.cookie.CookiePolicy.getSpecByVersion(int) Use `CookiePolicy.getCookieSpec(String)`
  org.apache.commons.httpclient.methods.ExpectContinueMethod.getUseExpectHeader() Use `HttpMethodParams`
  org.apache.commons.httpclient.Header.getValues() Use #getElements
  org.apache.commons.httpclient.HttpConnection.getVirtualHost() no longer applicable
  org.apache.commons.httpclient.HostConfiguration.getVirtualHost() use HostParams
  org.apache.commons.httpclient.HttpState.isAuthenticationPreemptive() Use `HttpClientParams.isAuthenticationPreemptive()`, `HttpClient.getParams()`.
  org.apache.commons.httpclient.SimpleHttpConnectionManager.isConnectionStaleCheckingEnabled() Use `HttpConnectionParams.isStaleCheckingEnabled()`, `HttpConnectionManager.getParams()`.
  org.apache.commons.httpclient.MultiThreadedHttpConnectionManager.isConnectionStaleCheckingEnabled() Use `HttpConnectionParams.isStaleCheckingEnabled()`, `HttpConnectionManager.getParams()`.
  org.apache.commons.httpclient.HostConfiguration.isHostSet() no longer used
  org.apache.commons.httpclient.HttpMethodBase.isHttp11() Use `HttpMethodParams.getVersion()`
  org.apache.commons.httpclient.HostConfiguration.isProxySet() no longer used
  org.apache.commons.httpclient.HttpConnection.isStaleCheckingEnabled() Use `HttpConnectionParams.isStaleCheckingEnabled()`, `HttpConnection.getParams()`.
  org.apache.commons.httpclient.HttpClient.isStrictMode() Use `DefaultHttpParams.getParameter(String)` to exercise a more granular control over HTTP protocol strictness.
  org.apache.commons.httpclient.HttpMethodBase.isStrictMode() Use `HttpParams.setParameter(String, Object)` to exercise a more granular control over HTTP protocol strictness.
  org.apache.commons.httpclient.HttpMethod.isStrictMode() Use `HttpParams.setParameter(String, Object)` to exercise a more granular control over HTTP protocol strictness.
  org.apache.commons.httpclient.methods.OptionsMethod.needContentLength() only entity enclosing methods set content length header
  org.apache.commons.httpclient.HeaderElement.parse(String) Use #parseElements(String).
  org.apache.commons.httpclient.HttpParser.parseHeaders(InputStream) use #parseHeaders(InputStream, String)
  org.apache.commons.httpclient.HttpConnection.print(String) Use `HttpConnection.print(String, String)` Writes the specified String (as bytes) to the output stream.
  org.apache.commons.httpclient.HttpConnection.printLine(String) Use `HttpConnection.printLine(String, String)` Writes the specified String (as bytes), followed by `"\r\n".getBytes()` to the output stream.
  org.apache.commons.httpclient.HttpConnection.readLine() use #readLine(String)
  org.apache.commons.httpclient.HttpParser.readLine(InputStream) use #readLine(InputStream, String)
  org.apache.commons.httpclient.HttpMethodBase.recycle() no longer supported and will be removed in the future version of HttpClient
  org.apache.commons.httpclient.HttpMethod.recycle() no longer supported and will be removed in the future version of HttpClient
  org.apache.commons.httpclient.methods.TraceMethod.recycle() no longer supported and will be removed in the future version of HttpClient
  org.apache.commons.httpclient.methods.MultipartPostMethod.recycle() no longer supported and will be removed in the future version of HttpClient
  org.apache.commons.httpclient.methods.HeadMethod.recycle() no longer supported and will be removed in the future version of HttpClient
  org.apache.commons.httpclient.methods.GetMethod.recycle() no longer supported and will be removed in the future version of HttpClient
  org.apache.commons.httpclient.methods.EntityEnclosingMethod.recycle() no longer supported and will be removed in the future version of HttpClient
  org.apache.commons.httpclient.auth.HttpAuthenticator.selectAuthScheme(Header[]) Use `AuthChallengeParser.parseChallenges(Header[])` and `AuthPolicy.getAuthScheme(String)`
  org.apache.commons.httpclient.HttpState.setAuthenticationPreemptive(boolean) Use `HttpClientParams.setAuthenticationPreemptive(boolean)`, `HttpClient.getParams()`.
  org.apache.commons.httpclient.methods.HeadMethod.setBodyCheckTimeout(int) Use `HttpMethodParams`
  org.apache.commons.httpclient.SimpleHttpConnectionManager.setConnectionStaleCheckingEnabled(boolean) Use `HttpConnectionParams.setStaleCheckingEnabled(boolean)`, `HttpConnectionManager.getParams()`.
  org.apache.commons.httpclient.MultiThreadedHttpConnectionManager.setConnectionStaleCheckingEnabled(boolean) Use `HttpConnectionParams.setStaleCheckingEnabled(boolean)`, `HttpConnectionManager.getParams()`.
  org.apache.commons.httpclient.HttpClient.setConnectionTimeout(int) Use `HttpConnectionParams.setConnectionTimeout(int)`, `HttpConnectionManager.getParams()`.
  org.apache.commons.httpclient.HttpConnection.setConnectionTimeout(int) Use `HttpConnectionParams.setConnectionTimeout(int)`, `HttpConnection.getParams()`.
  org.apache.commons.httpclient.HttpState.setCookiePolicy(int) Use `HttpMethodParams.setCookiePolicy(String)`, `HttpMethod.getParams()`.
  org.apache.commons.httpclient.HttpState.setCredentials(String, String, Credentials) use #setCredentials(AuthScope, Credentials)
  org.apache.commons.httpclient.cookie.CookiePolicy.setDefaultPolicy(int) Use `CookiePolicy.registerCookieSpec(String, Class)`
  org.apache.commons.httpclient.NTCredentials.setDomain(String) Do not use. The NTCredentials objects should be immutable
  org.apache.commons.httpclient.NTCredentials.setHost(String) Do not use. The NTCredentials objects should be immutable
  org.apache.commons.httpclient.HostConfiguration.setHost(String, String, int, Protocol) #setHost(String, int, Protocol)
  org.apache.commons.httpclient.HttpMethodBase.setHostConfiguration(HostConfiguration) no longer applicable
  org.apache.commons.httpclient.HttpMethodBase.setHttp11(boolean) Use `HttpMethodParams.setVersion(HttpVersion)`
  org.apache.commons.httpclient.HttpClient.setHttpConnectionFactoryTimeout(long) Use `HttpClientParams.setConnectionManagerTimeout(long)`, `HttpClient.getParams()`
  org.apache.commons.httpclient.MultiThreadedHttpConnectionManager.setMaxConnectionsPerHost(int) Use `HttpConnectionManagerParams.setDefaultMaxConnectionsPerHost(int)`, `HttpConnectionManager.getParams()`.
  org.apache.commons.httpclient.MultiThreadedHttpConnectionManager.setMaxTotalConnections(int) Use `HttpConnectionManagerParams.setMaxTotalConnections(int)`, `HttpConnectionManager.getParams()`.
  org.apache.commons.httpclient.HttpMethodBase.setMethodRetryHandler(MethodRetryHandler) use `HttpMethodParams`
  org.apache.commons.httpclient.UsernamePasswordCredentials.setPassword(String) Do not use. The UsernamePasswordCredentials objects should be immutable
  org.apache.commons.httpclient.HttpState.setProxyCredentials(String, String, Credentials) use #setProxyCredentials(AuthScope, Credentials)
  org.apache.commons.httpclient.HttpException.setReason(String) HttpClient no longer uses this for itself. It is only provided for compatibility with existing clients, and will be removed in a future release.
  org.apache.commons.httpclient.URIException.setReason(String) Callers should instead set this via a parameter to the constructor.
  org.apache.commons.httpclient.HttpException.setReasonCode(int) HttpClient no longer uses this for itself. It is only provided for compatibility with existing clients, and will be removed in a future release.
  org.apache.commons.httpclient.URIException.setReasonCode(int) Callers should set the reason code as a parameter to the constructor.
  org.apache.commons.httpclient.methods.EntityEnclosingMethod.setRequestBody(InputStream) use `EntityEnclosingMethod.setRequestEntity(RequestEntity)`
  org.apache.commons.httpclient.methods.EntityEnclosingMethod.setRequestBody(String) use `EntityEnclosingMethod.setRequestEntity(RequestEntity)`
  org.apache.commons.httpclient.methods.EntityEnclosingMethod.setRequestContentLength(int) Use `EntityEnclosingMethod.setContentChunked(boolean)` or `EntityEnclosingMethod.setRequestEntity(RequestEntity)`
  org.apache.commons.httpclient.methods.EntityEnclosingMethod.setRequestContentLength(long) Use `EntityEnclosingMethod.setContentChunked(boolean)` or `EntityEnclosingMethod.setRequestEntity(RequestEntity)`
  org.apache.commons.httpclient.HttpConnection.setSendBufferSize(int) Use `HttpConnectionParams.setSendBufferSize(int)`, `HttpConnection.getParams()`.
  org.apache.commons.httpclient.HttpConnection.setSoTimeout(int) Use `HttpConnectionParams.setSoTimeout(int)`, `HttpConnection.getParams()`.
  org.apache.commons.httpclient.HttpConnection.setStaleCheckingEnabled(boolean) Use `HttpConnectionParams.setStaleCheckingEnabled(boolean)`, `HttpConnection.getParams()`.
  org.apache.commons.httpclient.HttpClient.setStrictMode(boolean) Use `DefaultHttpParams.setParameter(String, Object)` to exercise a more granular control over HTTP protocol strictness.
  org.apache.commons.httpclient.HttpMethodBase.setStrictMode(boolean) Use `HttpParams.setParameter(String, Object)` to exercise a more granular control over HTTP protocol strictness.
  org.apache.commons.httpclient.HttpMethod.setStrictMode(boolean) Use `HttpParams.setParameter(String, Object)` to exercise a more granular control over HTTP protocol strictness.
  org.apache.commons.httpclient.HttpClient.setTimeout(int) Use `HttpConnectionParams.setSoTimeout(int)`, `HttpConnectionManager.getParams()`.
  org.apache.commons.httpclient.methods.ExpectContinueMethod.setUseExpectHeader(boolean) Use `HttpMethodParams`
  org.apache.commons.httpclient.UsernamePasswordCredentials.setUserName(String) Do not use. The UsernamePasswordCredentials objects should be immutable
  org.apache.commons.httpclient.HttpConnection.setVirtualHost(String) no longer applicable
  org.apache.commons.httpclient.HttpConnection.shutdownOutput() unused

- Deprecated Constructors
  Constructor and Description
  org.apache.commons.httpclient.auth.AuthSchemeBase(String) Use parameterless constructor and `AuthScheme.processChallenge(String)` method
  org.apache.commons.httpclient.auth.BasicScheme(String) Use parameterless constructor and `AuthScheme.processChallenge(String)` method
  org.apache.commons.httpclient.ConnectMethod() use #ConnectMethod(HttpHost); Create a connect method.
  org.apache.commons.httpclient.ConnectMethod(HttpMethod) the wrapped method is no longer used Create a connect method wrapping the existing method
  org.apache.commons.httpclient.ContentLengthInputStream(InputStream, int) use `ContentLengthInputStream.ContentLengthInputStream(InputStream, long)` Creates a new length limited stream
  org.apache.commons.httpclient.auth.DigestScheme(String) Use parameterless constructor and `AuthScheme.processChallenge(String)` method
  org.apache.commons.httpclient.HttpConnection(String, int, String, String, int, Protocol) use #HttpConnection(String, int, String, int, Protocol)
  org.apache.commons.httpclient.NTCredentials() Do not use. Null user name, domain & host no longer allowed
  org.apache.commons.httpclient.protocol.Protocol(String, SecureProtocolSocketFactory, int) Use the constructor that uses ProtocolSocketFactory, this version of the constructor is only kept for backwards API compatibility.
  org.apache.commons.httpclient.auth.RFC2617Scheme(String) Use parameterless constructor and `AuthScheme.processChallenge(String)` method
  org.apache.commons.httpclient.methods.StringRequestEntity(String) use `StringRequestEntity.StringRequestEntity(String, String, String)` instead
  org.apache.commons.httpclient.URI(char[]) Use #URI(String, boolean)
  org.apache.commons.httpclient.URI(char[], String) Use #URI(String, boolean, String)
  org.apache.commons.httpclient.URI(String) Use #URI(String, boolean)
  org.apache.commons.httpclient.URI(String, String) Use #URI(String, boolean, String)
  org.apache.commons.httpclient.URI(URI, String) Use #URI(URI, String, boolean)
  org.apache.commons.httpclient.UsernamePasswordCredentials() Do not use. Null user name no longer allowed

Copyright (c) 1999-2005 - Apache Software Foundation