H2AsyncClientBuilder

java.lang.Object
- org.apache.hc.client5.http.impl.async.H2AsyncClientBuilder

```
public class H2AsyncClientBuilder
extends Object
```
Builder for HTTP/2 only CloseableHttpAsyncClient instances.
Concurrent message exchanges with the same connection route executed with these CloseableHttpAsyncClient instances will get automatically multiplexed over a single physical HTTP/2 connection.

When a particular component is not explicitly set this class will use its default implementation.

Since:

5.0

Constructor Summary

Constructors
Modifier Constructor and Description

protected H2AsyncClientBuilder()

Constructors
Modifier	Constructor and Description
`protected`	`H2AsyncClientBuilder()`

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`protected void`	`addCloseable(Closeable closeable)` Adds to the list of `Closeable` resources to be managed by the client.
`H2AsyncClientBuilder`	`addExecInterceptorAfter(String existing, String name, AsyncExecChainHandler interceptor)` Adds this execution interceptor after interceptor with the given name.
`H2AsyncClientBuilder`	`addExecInterceptorBefore(String existing, String name, AsyncExecChainHandler interceptor)` Adds this execution interceptor before an existing interceptor.
`H2AsyncClientBuilder`	`addExecInterceptorFirst(String name, AsyncExecChainHandler interceptor)` Add an interceptor to the head of the processing list.
`H2AsyncClientBuilder`	`addExecInterceptorLast(String name, AsyncExecChainHandler interceptor)` Add an interceptor to the tail of the processing list.
`H2AsyncClientBuilder`	`addRequestInterceptorFirst(HttpRequestInterceptor interceptor)` Adds this protocol interceptor to the head of the protocol processing list.
`H2AsyncClientBuilder`	`addRequestInterceptorLast(HttpRequestInterceptor interceptor)` Adds this protocol interceptor to the tail of the protocol processing list.
`H2AsyncClientBuilder`	`addResponseInterceptorFirst(HttpResponseInterceptor interceptor)` Adds this protocol interceptor to the head of the protocol processing list.
`H2AsyncClientBuilder`	`addResponseInterceptorLast(HttpResponseInterceptor interceptor)` Adds this protocol interceptor to the tail of the protocol processing list.
`CloseableHttpAsyncClient`	`build()`
`static H2AsyncClientBuilder`	`create()`
`protected void`	`customizeExecChain(NamedElementChain<AsyncExecChainHandler> execChainDefinition)` Request exec chain customization and extension.
`H2AsyncClientBuilder`	`disableAuthCaching()` Disables authentication scheme caching.
`H2AsyncClientBuilder`	`disableAutomaticRetries()` Disables automatic request recovery and re-execution.
`H2AsyncClientBuilder`	`disableCookieManagement()` Disables state (cookie) management.
`H2AsyncClientBuilder`	`disableRedirectHandling()` Disables automatic redirect handling.
`H2AsyncClientBuilder`	`evictIdleConnections(TimeValue maxIdleTime)` Makes this instance of HttpClient proactively evict idle connections from the connection pool using a background thread.
`H2AsyncClientBuilder`	`replaceExecInterceptor(String existing, AsyncExecChainHandler interceptor)` Replace an existing interceptor with the given name with new interceptor.
`H2AsyncClientBuilder`	`setCharCodingConfig(CharCodingConfig charCodingConfig)` Sets `CharCodingConfig` configuration.
`H2AsyncClientBuilder`	`setDefaultAuthSchemeRegistry(Lookup<AuthSchemeFactory> authSchemeRegistry)` Assigns default `AuthScheme` registry which will be used for request execution if not explicitly set in the client execution context.
`H2AsyncClientBuilder`	`setDefaultCookieSpecRegistry(Lookup<CookieSpecFactory> cookieSpecRegistry)` Assigns default `CookieSpec` registry which will be used for request execution if not explicitly set in the client execution context.
`H2AsyncClientBuilder`	`setDefaultCookieStore(CookieStore cookieStore)` Assigns default `CookieStore` instance which will be used for request execution if not explicitly set in the client execution context.
`H2AsyncClientBuilder`	`setDefaultCredentialsProvider(CredentialsProvider credentialsProvider)` Assigns default `CredentialsProvider` instance which will be used for request execution if not explicitly set in the client execution context.
`H2AsyncClientBuilder`	`setDefaultHeaders(Collection<? extends Header> defaultHeaders)` Assigns default request header values.
`H2AsyncClientBuilder`	`setDefaultRequestConfig(RequestConfig config)` Assigns default `RequestConfig` instance which will be used for request execution if not explicitly set in the client execution context.
`H2AsyncClientBuilder`	`setDnsResolver(DnsResolver dnsResolver)` Assigns `DnsResolver` instance.
`H2AsyncClientBuilder`	`setH2Config(H2Config h2Config)` Sets `H2Config` configuration.
`H2AsyncClientBuilder`	`setIOReactorConfig(IOReactorConfig ioReactorConfig)` Sets `IOReactorConfig` configuration.
`H2AsyncClientBuilder`	`setProxyAuthenticationStrategy(AuthenticationStrategy proxyAuthStrategy)` Assigns `AuthenticationStrategy` instance for proxy authentication.
`H2AsyncClientBuilder`	`setRedirectStrategy(RedirectStrategy redirectStrategy)` Assigns `RedirectStrategy` instance.
`H2AsyncClientBuilder`	`setRetryStrategy(HttpRequestRetryStrategy retryStrategy)` Assigns `HttpRequestRetryStrategy` instance.
`H2AsyncClientBuilder`	`setRoutePlanner(HttpRoutePlanner routePlanner)` Assigns `HttpRoutePlanner` instance.
`H2AsyncClientBuilder`	`setSchemePortResolver(SchemePortResolver schemePortResolver)` Assigns `SchemePortResolver` instance.
`H2AsyncClientBuilder`	`setTargetAuthenticationStrategy(AuthenticationStrategy targetAuthStrategy)` Assigns `AuthenticationStrategy` instance for target host authentication.
`H2AsyncClientBuilder`	`setThreadFactory(ThreadFactory threadFactory)` Assigns `ThreadFactory` instance.
`H2AsyncClientBuilder`	`setTlsStrategy(TlsStrategy tlsStrategy)` Assigns `TlsStrategy` instance.
`H2AsyncClientBuilder`	`setUserAgent(String userAgent)` Assigns `User-Agent` value.
`H2AsyncClientBuilder`	`useSystemProperties()` Use system properties when creating and configuring default implementations.

Methods inherited from class java.lang.Object
clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail
- H2AsyncClientBuilder
```
protected H2AsyncClientBuilder()
```

Method Detail

addCloseable
```
@Internal
protected void addCloseable(Closeable closeable)
```
Adds to the list of Closeable resources to be managed by the client.
For internal use.

addExecInterceptorAfter

public final H2AsyncClientBuilder addExecInterceptorAfter(String existing,
                                                          String name,
                                                          AsyncExecChainHandler interceptor)

Adds this execution interceptor after interceptor with the given name.

addExecInterceptorBefore

public final H2AsyncClientBuilder addExecInterceptorBefore(String existing,
                                                           String name,
                                                           AsyncExecChainHandler interceptor)

Adds this execution interceptor before an existing interceptor.

addExecInterceptorFirst

public final H2AsyncClientBuilder addExecInterceptorFirst(String name,
                                                          AsyncExecChainHandler interceptor)

Add an interceptor to the head of the processing list.

addExecInterceptorLast

public final H2AsyncClientBuilder addExecInterceptorLast(String name,
                                                         AsyncExecChainHandler interceptor)

Add an interceptor to the tail of the processing list.

addRequestInterceptorFirst

public final H2AsyncClientBuilder addRequestInterceptorFirst(HttpRequestInterceptor interceptor)

Adds this protocol interceptor to the head of the protocol processing list.

addRequestInterceptorLast

public final H2AsyncClientBuilder addRequestInterceptorLast(HttpRequestInterceptor interceptor)

Adds this protocol interceptor to the tail of the protocol processing list.

addResponseInterceptorFirst

public final H2AsyncClientBuilder addResponseInterceptorFirst(HttpResponseInterceptor interceptor)

Adds this protocol interceptor to the head of the protocol processing list.

addResponseInterceptorLast

public final H2AsyncClientBuilder addResponseInterceptorLast(HttpResponseInterceptor interceptor)

Adds this protocol interceptor to the tail of the protocol processing list.

build

public CloseableHttpAsyncClient build()

create

public static H2AsyncClientBuilder create()

customizeExecChain

@Internal
protected void customizeExecChain(NamedElementChain<AsyncExecChainHandler> execChainDefinition)

Request exec chain customization and extension.

For internal use.

disableAuthCaching

public final H2AsyncClientBuilder disableAuthCaching()

Disables authentication scheme caching.

disableAutomaticRetries
```
public final H2AsyncClientBuilder disableAutomaticRetries()
```
Disables automatic request recovery and re-execution.

disableCookieManagement

public final H2AsyncClientBuilder disableCookieManagement()

Disables state (cookie) management.

disableRedirectHandling

public final H2AsyncClientBuilder disableRedirectHandling()

Disables automatic redirect handling.

evictIdleConnections
```
public final H2AsyncClientBuilder evictIdleConnections(TimeValue maxIdleTime)
```
Makes this instance of HttpClient proactively evict idle connections from the connection pool using a background thread.
One MUST explicitly close HttpClient with Closeable.close() in order to stop and release the background thread.
Please note this method has no effect if the instance of HttpClient is configuted to use a shared connection manager.

Parameters:

maxIdleTime - maximum time persistent connections can stay idle while kept alive in the connection pool. Connections whose inactivity period exceeds this value will get closed and evicted from the pool.

replaceExecInterceptor

public final H2AsyncClientBuilder replaceExecInterceptor(String existing,
                                                         AsyncExecChainHandler interceptor)

Replace an existing interceptor with the given name with new interceptor.

setCharCodingConfig

public final H2AsyncClientBuilder setCharCodingConfig(CharCodingConfig charCodingConfig)

Sets CharCodingConfig configuration.

setDefaultAuthSchemeRegistry
```
public final H2AsyncClientBuilder setDefaultAuthSchemeRegistry(Lookup<AuthSchemeFactory> authSchemeRegistry)
```
Assigns default AuthScheme registry which will be used for request execution if not explicitly set in the client execution context.

setDefaultCookieSpecRegistry
```
public final H2AsyncClientBuilder setDefaultCookieSpecRegistry(Lookup<CookieSpecFactory> cookieSpecRegistry)
```
Assigns default CookieSpec registry which will be used for request execution if not explicitly set in the client execution context.

setDefaultCookieStore
```
public final H2AsyncClientBuilder setDefaultCookieStore(CookieStore cookieStore)
```
Assigns default CookieStore instance which will be used for request execution if not explicitly set in the client execution context.

setDefaultCredentialsProvider
```
public final H2AsyncClientBuilder setDefaultCredentialsProvider(CredentialsProvider credentialsProvider)
```
Assigns default CredentialsProvider instance which will be used for request execution if not explicitly set in the client execution context.

setDefaultHeaders

public final H2AsyncClientBuilder setDefaultHeaders(Collection<? extends Header> defaultHeaders)

Assigns default request header values.

setDefaultRequestConfig
```
public final H2AsyncClientBuilder setDefaultRequestConfig(RequestConfig config)
```
Assigns default RequestConfig instance which will be used for request execution if not explicitly set in the client execution context.

setDnsResolver

public final H2AsyncClientBuilder setDnsResolver(DnsResolver dnsResolver)

Assigns DnsResolver instance.

setH2Config

public final H2AsyncClientBuilder setH2Config(H2Config h2Config)

Sets H2Config configuration.

setIOReactorConfig

public final H2AsyncClientBuilder setIOReactorConfig(IOReactorConfig ioReactorConfig)

Sets IOReactorConfig configuration.

setProxyAuthenticationStrategy

public final H2AsyncClientBuilder setProxyAuthenticationStrategy(AuthenticationStrategy proxyAuthStrategy)

Assigns AuthenticationStrategy instance for proxy authentication.

setRedirectStrategy
```
public H2AsyncClientBuilder setRedirectStrategy(RedirectStrategy redirectStrategy)
```
Assigns RedirectStrategy instance.
Please note this value can be overridden by the disableRedirectHandling() method.

setRetryStrategy
```
public final H2AsyncClientBuilder setRetryStrategy(HttpRequestRetryStrategy retryStrategy)
```
Assigns HttpRequestRetryStrategy instance.
Please note this value can be overridden by the disableAutomaticRetries() method.

setRoutePlanner

public final H2AsyncClientBuilder setRoutePlanner(HttpRoutePlanner routePlanner)

Assigns HttpRoutePlanner instance.

setSchemePortResolver

public final H2AsyncClientBuilder setSchemePortResolver(SchemePortResolver schemePortResolver)

Assigns SchemePortResolver instance.

setTargetAuthenticationStrategy

public final H2AsyncClientBuilder setTargetAuthenticationStrategy(AuthenticationStrategy targetAuthStrategy)

Assigns AuthenticationStrategy instance for target host authentication.

setThreadFactory

public final H2AsyncClientBuilder setThreadFactory(ThreadFactory threadFactory)

Assigns ThreadFactory instance.

setTlsStrategy

public final H2AsyncClientBuilder setTlsStrategy(TlsStrategy tlsStrategy)

Assigns TlsStrategy instance.

setUserAgent

public final H2AsyncClientBuilder setUserAgent(String userAgent)

Assigns User-Agent value.

useSystemProperties
```
public final H2AsyncClientBuilder useSystemProperties()
```
Use system properties when creating and configuring default implementations.

Class H2AsyncClientBuilder

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail