Deprecated API

Contents

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

Deprecated Interfaces

Interface and Description
org.apache.hc.client5.http.impl.MessageCopier Use message builders.
org.apache.hc.client5.http.impl.auth.NTLMEngine Do not use. the NTLM authentication scheme is no longer supported

Deprecated Classes

Class and Description
org.apache.hc.client5.http.async.methods.BasicHttpRequests Use BasicRequestBuilder.
org.apache.hc.client5.http.classic.methods.ClassicHttpRequests Use ClassicRequestBuilder
org.apache.hc.client5.http.impl.classic.ClassicRequestCopier Use ClassicRequestBuilder
org.apache.hc.client5.http.impl.auth.GGSSchemeBase Do not use. The GGS based experimental authentication schemes are no longer supported. Consider using Basic or Bearer authentication with TLS instead.
org.apache.hc.client5.http.async.methods.IgnoreCompleteExceptonFutureCallback Use IgnoreCompleteExceptionFutureCallback
org.apache.hc.client5.http.auth.KerberosConfig Do not use. The GGS based experimental authentication schemes are no longer supported. Consider using Basic or Bearer authentication with TLS instead.
org.apache.hc.client5.http.auth.KerberosCredentials Do not use. The GGS based experimental authentication schemes are no longer supported. Consider using Basic or Bearer authentication with TLS instead.
org.apache.hc.client5.http.impl.auth.KerberosScheme Do not use. The GGS based experimental authentication schemes are no longer supported. Consider using Basic or Bearer authentication with TLS instead.
org.apache.hc.client5.http.impl.auth.KerberosSchemeFactory Do not use. The GGS based experimental authentication schemes are no longer supported. Consider using Basic or Bearer authentication with TLS instead.
org.apache.hc.client5.http.auth.NTCredentials Do not use. the NTLM authentication scheme is no longer supported. Consider using Basic or Bearer authentication with TLS instead.
org.apache.hc.client5.http.impl.auth.NTLMScheme Do not use. the NTLM authentication scheme is no longer supported. Consider using Basic or Bearer authentication with TLS instead.
org.apache.hc.client5.http.impl.auth.NTLMSchemeFactory Do not use. the NTLM authentication scheme is no longer supported. Consider using Basic or Bearer authentication with TLS instead.
org.apache.hc.client5.http.protocol.RequestAuthCache Do not use.
org.apache.hc.client5.http.impl.RequestCopier Use BasicRequestBuilder
org.apache.hc.client5.http.async.methods.SimpleHttpRequests Use SimpleRequestBuilder.
org.apache.hc.client5.http.impl.auth.SPNegoScheme Do not use. The GGS based experimental authentication schemes are no longer supported. Consider using Basic or Bearer authentication with TLS instead.
org.apache.hc.client5.http.impl.auth.SPNegoSchemeFactory Do not use. The GGS based experimental authentication schemes are no longer supported. Consider using Basic or Bearer authentication with TLS instead.
org.apache.hc.client5.http.ssl.TrustSelfSignedStrategy For self-signed certificates prefer specifying a keystore containing the certificate when calling the SSLContextBuilder loadTrustMaterial methods.

Deprecated Exceptions

Exceptions and Description
org.apache.hc.client5.http.impl.auth.NTLMEngineException Do not use.

Deprecated Fields

Field and Description
org.apache.hc.client5.http.utils.DateUtils.GMT This attribute is no longer supported as a part of the public API.
org.apache.hc.client5.http.auth.StandardAuthScheme.KERBEROS Do not use. The GGS based experimental authentication schemes are no longer supported. Consider using Basic or Bearer authentication with TLS instead.
org.apache.hc.client5.http.auth.StandardAuthScheme.NTLM Do not use. the NTLM authentication scheme is no longer supported. Consider using Basic or Bearer authentication with TLS instead.
org.apache.hc.client5.http.utils.DateUtils.PATTERN_RFC1123 use DateUtils.INTERNET_MESSAGE_FORMAT
org.apache.hc.client5.http.auth.StandardAuthScheme.SPNEGO Do not use. The GGS based experimental authentication schemes are no longer supported. Consider using Basic or Bearer authentication with TLS instead.

Deprecated Methods

Method and Description
org.apache.hc.client5.http.cookie.CookieStore.clearExpired(Date) Use CookieStore.clearExpired(Instant)
org.apache.hc.client5.http.utils.DateUtils.clearThreadLocal() Noop method. Do not use.
org.apache.hc.client5.http.async.methods.SimpleHttpRequest.copy(HttpRequest) Use SimpleRequestBuilder
org.apache.hc.client5.http.impl.io.DefaultHttpResponseParserFactory.create(Http1Config) Use DefaultHttpResponseParserFactory.create()
org.apache.hc.client5.http.utils.URIUtils.create(HttpHost, String) Use URIBuilder.
org.apache.hc.client5.http.utils.URIUtils.create(String, URIAuthority, String) Use URIBuilder.
org.apache.hc.client5.http.impl.async.HttpAsyncClients.createMinimal(HttpVersionPolicy, H2Config, Http1Config, IOReactorConfig) Use HttpAsyncClients.createMinimal(H2Config, Http1Config, IOReactorConfig)
org.apache.hc.client5.http.impl.async.HttpAsyncClients.createMinimal(HttpVersionPolicy, H2Config, Http1Config, IOReactorConfig, AsyncClientConnectionManager) Use HttpAsyncClients.createMinimal(H2Config, Http1Config, IOReactorConfig, AsyncClientConnectionManager)
org.apache.hc.client5.http.classic.HttpClient.execute(ClassicHttpRequest) It is strongly recommended to use execute methods with HttpClientResponseHandler such as HttpClient.execute(ClassicHttpRequest, HttpClientResponseHandler) in order to ensure automatic resource deallocation by the client. For special cases one can still use HttpClient.executeOpen(HttpHost, ClassicHttpRequest, HttpContext) to keep the response object open after the request execution.
org.apache.hc.client5.http.impl.classic.CloseableHttpClient.execute(ClassicHttpRequest) It is strongly recommended to use execute methods with HttpClientResponseHandler such as CloseableHttpClient.execute(ClassicHttpRequest, HttpClientResponseHandler) in order to ensure automatic resource deallocation by the client. For special cases one can still use HttpClient.executeOpen(HttpHost, ClassicHttpRequest, HttpContext) to keep the response object open after the request execution.
org.apache.hc.client5.http.classic.HttpClient.execute(ClassicHttpRequest, HttpContext) It is strongly recommended to use execute methods with HttpClientResponseHandler such as HttpClient.execute(ClassicHttpRequest, HttpContext, HttpClientResponseHandler) in order to ensure automatic resource deallocation by the client. For special cases one can still use HttpClient.executeOpen(HttpHost, ClassicHttpRequest, HttpContext) to keep the response object open after the request execution.
org.apache.hc.client5.http.impl.classic.CloseableHttpClient.execute(ClassicHttpRequest, HttpContext) It is strongly recommended to use execute methods with HttpClientResponseHandler such as CloseableHttpClient.execute(ClassicHttpRequest, HttpContext, HttpClientResponseHandler) in order to ensure automatic resource deallocation by the client. For special cases one can still use HttpClient.executeOpen(HttpHost, ClassicHttpRequest, HttpContext) to keep the response object open after the request execution.
org.apache.hc.client5.http.classic.HttpClient.execute(HttpHost, ClassicHttpRequest) It is strongly recommended to use execute methods with HttpClientResponseHandler such as HttpClient.execute(HttpHost, ClassicHttpRequest, HttpClientResponseHandler) in order to ensure automatic resource deallocation by the client. For special cases one can still use HttpClient.executeOpen(HttpHost, ClassicHttpRequest, HttpContext) to keep the response object open after the request execution.
org.apache.hc.client5.http.impl.classic.CloseableHttpClient.execute(HttpHost, ClassicHttpRequest) It is strongly recommended to use execute methods with HttpClientResponseHandler such as CloseableHttpClient.execute(HttpHost, ClassicHttpRequest, HttpClientResponseHandler) in order to ensure automatic resource deallocation by the client. For special cases one can still use HttpClient.executeOpen(HttpHost, ClassicHttpRequest, HttpContext) to keep the response object open after the request execution.
org.apache.hc.client5.http.classic.HttpClient.execute(HttpHost, ClassicHttpRequest, HttpContext) It is strongly recommended to use execute methods with HttpClientResponseHandler such as HttpClient.execute(HttpHost, ClassicHttpRequest, HttpContext, HttpClientResponseHandler) in order to ensure automatic resource deallocation by the client. For special cases one can still use HttpClient.executeOpen(HttpHost, ClassicHttpRequest, HttpContext) to keep the response object open after the request execution.
org.apache.hc.client5.http.impl.classic.CloseableHttpClient.execute(HttpHost, ClassicHttpRequest, HttpContext) It is strongly recommended to use execute methods with HttpClientResponseHandler such as CloseableHttpClient.execute(HttpHost, ClassicHttpRequest, HttpContext, HttpClientResponseHandler) in order to ensure automatic resource deallocation by the client. For special cases one can still use HttpClient.executeOpen(HttpHost, ClassicHttpRequest, HttpContext) to keep the response object open after the request execution.
org.apache.hc.client5.http.utils.DateUtils.formatDate(Date) Use DateUtils.formatStandardDate(Instant)
org.apache.hc.client5.http.utils.DateUtils.formatDate(Date, String) Use DateUtils.formatDate(Instant, DateTimeFormatter)
org.apache.hc.client5.http.config.RequestConfig.getConnectTimeout() Use ConnectionConfig.getConnectTimeout().
org.apache.hc.client5.http.impl.cookie.BasicClientCookie.getCreationDate() Use BasicClientCookie.getCreationInstant().
org.apache.hc.client5.http.cookie.Cookie.getCreationDate() Use Cookie.getCreationInstant()
org.apache.hc.client5.http.impl.io.PoolingHttpClientConnectionManager.getDefaultSocketConfig() Use custom PoolingHttpClientConnectionManager.setConnectionConfigResolver(Resolver)
org.apache.hc.client5.http.impl.cookie.BasicClientCookie.getExpiryDate() Use BasicClientCookie.getExpiryInstant()
org.apache.hc.client5.http.cookie.Cookie.getExpiryDate() Use {Cookie.getExpiryInstant()}
org.apache.hc.client5.http.auth.BearerToken.getPassword() Do not use.
org.apache.hc.client5.http.auth.UsernamePasswordCredentials.getPassword() Use UsernamePasswordCredentials.getUserPassword().
org.apache.hc.client5.http.auth.Credentials.getPassword() Use specific credentials class that represent a username / password set of a security token.
org.apache.hc.client5.http.config.RequestConfig.getProxy() Use DefaultProxyRoutePlanner or a custom HttpRoutePlanner.
org.apache.hc.client5.http.impl.nio.PoolingAsyncClientConnectionManager.getValidateAfterInactivity() Use custom PoolingAsyncClientConnectionManager.setConnectionConfigResolver(Resolver)
org.apache.hc.client5.http.impl.io.BasicHttpClientConnectionManager.getValidateAfterInactivity() Use BasicHttpClientConnectionManager.getConnectionConfig()
org.apache.hc.client5.http.impl.io.PoolingHttpClientConnectionManager.getValidateAfterInactivity() Use PoolingHttpClientConnectionManager.setConnectionConfigResolver(Resolver).
org.apache.hc.client5.http.utils.DateUtils.isAfter(MessageHeaders, MessageHeaders, String) This method is no longer supported as a part of the public API.
org.apache.hc.client5.http.utils.DateUtils.isBefore(MessageHeaders, MessageHeaders, String) This method is no longer supported as a part of the public API.
org.apache.hc.client5.http.impl.cookie.BasicClientCookie.isExpired(Date) Use BasicClientCookie.isExpired(Instant)
org.apache.hc.client5.http.cookie.Cookie.isExpired(Date) Use {Cookie.isExpired(Instant)}
org.apache.hc.client5.http.utils.DateUtils.parseDate(MessageHeaders, String) Use DateUtils.parseStandardDate(MessageHeaders, String)
org.apache.hc.client5.http.utils.DateUtils.parseDate(String) Use DateUtils.parseStandardDate(String)
org.apache.hc.client5.http.utils.DateUtils.parseDate(String, String[]) Use DateUtils.parseDate(String, DateTimeFormatter...)
org.apache.hc.client5.http.utils.DateUtils.parseDate(String, String[], Date) Use DateUtils.parseDate(String, DateTimeFormatter...)
org.apache.hc.client5.http.ssl.SSLConnectionSocketFactory.prepareSocket(SSLSocket) Use SSLConnectionSocketFactory.prepareSocket(SSLSocket, HttpContext)
org.apache.hc.client5.http.utils.URIUtils.rewriteURI(URI) Use URIBuilder.
org.apache.hc.client5.http.utils.URIUtils.rewriteURI(URI, HttpHost) Use URIBuilder.
org.apache.hc.client5.http.utils.URIUtils.rewriteURI(URI, HttpHost, boolean) Use URIBuilder.
org.apache.hc.client5.http.impl.nio.PoolingAsyncClientConnectionManagerBuilder.setConnectionTimeToLive(TimeValue) Use PoolingAsyncClientConnectionManagerBuilder.setDefaultConnectionConfig(ConnectionConfig)
org.apache.hc.client5.http.impl.io.PoolingHttpClientConnectionManagerBuilder.setConnectionTimeToLive(TimeValue) Use PoolingHttpClientConnectionManagerBuilder.setDefaultConnectionConfig(ConnectionConfig).
org.apache.hc.client5.http.config.RequestConfig.Builder.setConnectTimeout(long, TimeUnit) Use ConnectionConfig.Builder.setConnectTimeout(long, TimeUnit).
org.apache.hc.client5.http.config.RequestConfig.Builder.setConnectTimeout(Timeout) Use ConnectionConfig.Builder.setConnectTimeout(Timeout).
org.apache.hc.client5.http.impl.cookie.BasicClientCookie.setCreationDate(Date) Use BasicClientCookie.setCreationDate(Instant)
org.apache.hc.client5.http.impl.cookie.BasicClientCookie.setExpiryDate(Date) Use {BasicClientCookie.setExpiryDate(Instant)}
org.apache.hc.client5.http.cookie.SetCookie.setExpiryDate(Date) Use {SetCookie.setExpiryDate(Instant)}
org.apache.hc.client5.http.config.RequestConfig.Builder.setProxy(HttpHost) Use DefaultProxyRoutePlanner or a custom HttpRoutePlanner.
org.apache.hc.client5.http.ssl.ClientTlsStrategyBuilder.setTlsDetailsFactory(Factory<SSLEngine, TlsDetails>) Do not use.
org.apache.hc.client5.http.impl.nio.PoolingAsyncClientConnectionManagerBuilder.setValidateAfterInactivity(TimeValue) Use PoolingAsyncClientConnectionManagerBuilder.setConnectionConfigResolver(Resolver).
org.apache.hc.client5.http.impl.nio.PoolingAsyncClientConnectionManager.setValidateAfterInactivity(TimeValue) Use PoolingAsyncClientConnectionManager.setConnectionConfigResolver(Resolver).
org.apache.hc.client5.http.impl.io.BasicHttpClientConnectionManager.setValidateAfterInactivity(TimeValue) Use BasicHttpClientConnectionManager.setConnectionConfig(ConnectionConfig)
org.apache.hc.client5.http.impl.io.PoolingHttpClientConnectionManager.setValidateAfterInactivity(TimeValue) Use PoolingHttpClientConnectionManager.setConnectionConfigResolver(Resolver).
org.apache.hc.client5.http.impl.io.PoolingHttpClientConnectionManagerBuilder.setValidateAfterInactivity(TimeValue) Use PoolingHttpClientConnectionManagerBuilder.setDefaultConnectionConfig(ConnectionConfig).
org.apache.hc.client5.http.impl.async.HttpAsyncClientBuilder.setVersionPolicy(HttpVersionPolicy) Use TlsConfig and connection manager methods

Deprecated Constructors

Constructor and Description
org.apache.hc.client5.http.impl.cookie.BasicExpiresHandler(String[]) Use BasicExpiresHandler(DateTimeFormatter...)
org.apache.hc.client5.http.impl.auth.BasicScheme(Charset) This constructor is deprecated to enforce the use of StandardCharsets.UTF_8 encoding in compliance with RFC 7617 for HTTP Basic Authentication. Use the default constructor BasicScheme() instead.
org.apache.hc.client5.http.impl.auth.BasicSchemeFactory(Charset) This constructor is deprecated to enforce the use of StandardCharsets.UTF_8 encoding in compliance with RFC 7617 for HTTP Basic Authentication. Use the default constructor BasicSchemeFactory() instead.
org.apache.hc.client5.http.ssl.DefaultClientTlsStrategy(SSLContext, String[], String[], SSLBufferMode, HostnameVerifier, Factory<SSLEngine, TlsDetails>) Use DefaultClientTlsStrategy(SSLContext, String[], String[], SSLBufferMode, HostnameVerifier)
org.apache.hc.client5.http.impl.auth.DigestScheme(Charset) This constructor is deprecated to enforce the use of StandardCharsets.UTF_8 encoding in compliance with RFC 7616 for HTTP Digest Access Authentication. Use the default constructor DigestScheme() instead.
org.apache.hc.client5.http.impl.auth.DigestSchemeFactory(Charset) This constructor is deprecated to enforce the use of StandardCharsets.UTF_8 encoding in compliance with RFC 7616 for HTTP Digest Access Authentication. Use the default constructor DigestSchemeFactory() instead.
org.apache.hc.client5.http.async.AsyncExecChain.Scope(String, HttpRoute, HttpRequest, CancellableDependency, HttpClientContext, AsyncExecRuntime) Use Scope#Scope(String, HttpRoute, HttpRequest, CancellableDependency, HttpClientContext, AsyncExecRuntime, Scheduler, AtomicInteger)