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.socket.ConnectionSocketFactory Do not use.
org.apache.hc.client5.http.socket.LayeredConnectionSocketFactory Use TlsSocketStrategy.
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.impl.auth.HttpAuthenticator Do not use.
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.impl.Operations.CompletedFuture Use CompletedFuture.
org.apache.hc.client5.http.socket.PlainConnectionSocketFactory Use DetachedSocketFactory. Please note this interface is considered internal.
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.SSLConnectionSocketFactory Use DefaultClientTlsStrategy.
org.apache.hc.client5.http.ssl.SSLConnectionSocketFactoryBuilder Use DefaultClientTlsStrategy
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.
org.apache.hc.client5.http.impl.TunnelRefusedException Do not use/

Deprecated Fields

Field and Description
org.apache.hc.client5.http.protocol.HttpClientContext.AUTH_CACHE Use getter methods
org.apache.hc.client5.http.protocol.HttpClientContext.AUTH_EXCHANGE_MAP Use getter methods
org.apache.hc.client5.http.protocol.HttpClientContext.AUTHSCHEME_REGISTRY Use getter methods
org.apache.hc.client5.http.protocol.HttpClientContext.COOKIE_ORIGIN Use getter methods
org.apache.hc.client5.http.protocol.HttpClientContext.COOKIE_SPEC Use getter methods
org.apache.hc.client5.http.protocol.HttpClientContext.COOKIE_STORE Use getter methods
org.apache.hc.client5.http.protocol.HttpClientContext.COOKIESPEC_REGISTRY Use getter methods
org.apache.hc.client5.http.protocol.HttpClientContext.CREDS_PROVIDER Use getter methods
org.apache.hc.client5.http.protocol.HttpClientContext.EXCHANGE_ID Use getter methods
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.protocol.HttpClientContext.HTTP_ROUTE Use getter methods
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.protocol.HttpClientContext.REDIRECT_LOCATIONS Use getter methods
org.apache.hc.client5.http.protocol.HttpClientContext.REQUEST_CONFIG Use getter methods
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.
org.apache.hc.client5.http.protocol.HttpClientContext.USER_TOKEN Use getter methods

Deprecated Methods

Method and Description
org.apache.hc.client5.http.protocol.HttpClientContext.adapt(HttpContext) Use HttpClientContext.castOrCreate(HttpContext).
org.apache.hc.client5.http.ssl.ClientTlsStrategyBuilder.build() Use ClientTlsStrategyBuilder.buildAsync() or ClientTlsStrategyBuilder.buildClassic().
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.io.ConnectionEndpoint.execute(String, ClassicHttpRequest, HttpRequestExecutor, HttpContext) Use ConnectionEndpoint.execute(String, ClassicHttpRequest, RequestExecutor, HttpContext)
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.ssl.DefaultClientTlsStrategy.getDefault() Use DefaultClientTlsStrategy.createDefault().
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.TunnelRefusedException.getResponseMessage() Use TunnelRefusedException.getResponse().
org.apache.hc.client5.http.ssl.DefaultClientTlsStrategy.getSystemDefault() Use DefaultClientTlsStrategy.createSystemDefault().
org.apache.hc.client5.http.protocol.HttpClientContext.getUserToken(Class<T>) Use HttpClientContext.getUserToken()
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.impl.async.CloseableHttpAsyncClient.register(String, String, Supplier<AsyncPushConsumer>) Use RequestRouter at the construction time
org.apache.hc.client5.http.impl.async.CloseableHttpAsyncClient.register(String, Supplier<AsyncPushConsumer>) Use RequestRouter at the construction time
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.ssl.ClientTlsStrategyBuilder.setHostnameVerificationPolicy(HostnameVerificationPolicy) Use #setHostVerificationPolicy
org.apache.hc.client5.http.config.RequestConfig.Builder.setProxy(HttpHost) Use DefaultProxyRoutePlanner or a custom HttpRoutePlanner.
org.apache.hc.client5.http.impl.io.PoolingHttpClientConnectionManagerBuilder.setSSLSocketFactory(LayeredConnectionSocketFactory) Use PoolingHttpClientConnectionManagerBuilder.setTlsSocketStrategy(TlsSocketStrategy)
org.apache.hc.client5.http.ssl.ClientTlsStrategyBuilder.setTlsDetailsFactory(Factory<SSLEngine, TlsDetails>) Do not use. This method has no effect.
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.io.BasicHttpClientConnectionManager(Lookup<ConnectionSocketFactory>) Use BasicHttpClientConnectionManager.create(Lookup)
org.apache.hc.client5.http.impl.io.BasicHttpClientConnectionManager(Lookup<ConnectionSocketFactory>, HttpConnectionFactory<ManagedHttpClientConnection>) Use BasicHttpClientConnectionManager.create(Lookup, HttpConnectionFactory)
org.apache.hc.client5.http.impl.io.BasicHttpClientConnectionManager(Lookup<ConnectionSocketFactory>, HttpConnectionFactory<ManagedHttpClientConnection>, SchemePortResolver, DnsResolver) Use BasicHttpClientConnectionManager.create(SchemePortResolver, DnsResolver, Lookup, HttpConnectionFactory)
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.io.DefaultHttpClientConnectionOperator(Lookup<ConnectionSocketFactory>, SchemePortResolver, DnsResolver) Do not use.
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.impl.io.PoolingHttpClientConnectionManager(Registry<ConnectionSocketFactory>) Use PoolingHttpClientConnectionManagerBuilder
org.apache.hc.client5.http.impl.io.PoolingHttpClientConnectionManager(Registry<ConnectionSocketFactory>, HttpConnectionFactory<ManagedHttpClientConnection>) Use PoolingHttpClientConnectionManagerBuilder
org.apache.hc.client5.http.impl.io.PoolingHttpClientConnectionManager(Registry<ConnectionSocketFactory>, PoolConcurrencyPolicy, PoolReusePolicy, TimeValue) Use PoolingHttpClientConnectionManagerBuilder
org.apache.hc.client5.http.impl.io.PoolingHttpClientConnectionManager(Registry<ConnectionSocketFactory>, PoolConcurrencyPolicy, PoolReusePolicy, TimeValue, HttpConnectionFactory<ManagedHttpClientConnection>) Use PoolingHttpClientConnectionManagerBuilder
org.apache.hc.client5.http.impl.io.PoolingHttpClientConnectionManager(Registry<ConnectionSocketFactory>, PoolConcurrencyPolicy, PoolReusePolicy, TimeValue, SchemePortResolver, DnsResolver, HttpConnectionFactory<ManagedHttpClientConnection>) Use PoolingHttpClientConnectionManagerBuilder
org.apache.hc.client5.http.impl.io.PoolingHttpClientConnectionManager(Registry<ConnectionSocketFactory>, PoolConcurrencyPolicy, TimeValue, HttpConnectionFactory<ManagedHttpClientConnection>) Use PoolingHttpClientConnectionManagerBuilder
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)
org.apache.hc.client5.http.impl.TunnelRefusedException(String, String) Do not use.