Deprecated API

Contents

• Deprecated Interfaces
• Deprecated Classes
• Deprecated Exceptions
• Deprecated Fields
• Deprecated Methods
• Deprecated Constructors

Deprecated Interfaces

Interface	Description
org.apache.commons.httpclient.MethodRetryHandler	use HttpMethodRetryHandler

Deprecated Classes

Class	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	Description
org.apache.commons.httpclient.HttpRecoverableException	no longer used

Deprecated Fields

Field	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	Description
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.BasicScheme.authenticate(Credentials, String, String)	Use BasicScheme.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.DigestScheme.authenticate(Credentials, String, String)	Use DigestScheme.authenticate(Credentials, HttpMethod)
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.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.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.HttpConnectionManager.getConnection(HostConfiguration, long)	Use #getConnectionWithTimeout(HostConfiguration, long)
org.apache.commons.httpclient.MultiThreadedHttpConnectionManager.getConnection(HostConfiguration, long)	Use #getConnectionWithTimeout(HostConfiguration, long)
org.apache.commons.httpclient.SimpleHttpConnectionManager.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.HttpMethod.getHostConfiguration()	no longer applicable
org.apache.commons.httpclient.HttpMethodBase.getHostConfiguration()	no longer applicable
org.apache.commons.httpclient.auth.AuthScheme.getID()	no longer used
org.apache.commons.httpclient.auth.DigestScheme.getID()	no longer used
org.apache.commons.httpclient.auth.NTLMScheme.getID()	no longer used
org.apache.commons.httpclient.auth.RFC2617Scheme.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.HostConfiguration.getVirtualHost()	use HostParams
org.apache.commons.httpclient.HttpConnection.getVirtualHost()	no longer applicable
org.apache.commons.httpclient.HttpState.isAuthenticationPreemptive()	Use HttpClientParams.isAuthenticationPreemptive(), HttpClient.getParams().
org.apache.commons.httpclient.MultiThreadedHttpConnectionManager.isConnectionStaleCheckingEnabled()	Use HttpConnectionParams.isStaleCheckingEnabled(), HttpConnectionManager.getParams().
org.apache.commons.httpclient.SimpleHttpConnectionManager.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.HttpMethod.isStrictMode()	Use HttpParams.setParameter(String, Object) 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.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.HttpMethod.recycle()	no longer supported and will be removed in the future version of HttpClient
org.apache.commons.httpclient.HttpMethodBase.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.methods.GetMethod.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.MultipartPostMethod.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.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.MultiThreadedHttpConnectionManager.setConnectionStaleCheckingEnabled(boolean)	Use HttpConnectionParams.setStaleCheckingEnabled(boolean), HttpConnectionManager.getParams().
org.apache.commons.httpclient.SimpleHttpConnectionManager.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.HostConfiguration.setHost(String, String, int, Protocol)	#setHost(String, int, Protocol)
org.apache.commons.httpclient.NTCredentials.setHost(String)	Do not use. The NTCredentials objects should be immutable
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.HttpMethod.setStrictMode(boolean)	Use HttpParams.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.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	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(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(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