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