Package org.projectnessie.client.http

Class HttpClientBuilder

java.lang.Object

org.projectnessie.client.http.HttpClientBuilder

All Implemented Interfaces:

NessieClientBuilder<HttpClientBuilder>

public class HttpClientBuilder
extends java.lang.Object
implements NessieClientBuilder<HttpClientBuilder>

A builder class that creates a NessieHttpClient via builder().

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	HttpClientBuilder()

Method Summary

Modifier and Type	Method	Description
<API extends NessieApi> API	build(java.lang.Class<API> apiVersion)	Builds a new NessieApi.
static HttpClientBuilder	builder()
HttpClientBuilder	fromConfig(java.util.function.Function<java.lang.String,java.lang.String> configuration)	Configure this HttpClientBuilder instance using a configuration object and standard Nessie configuration keys defined by the constants defined in NessieConfigConstants.
HttpClientBuilder	fromSystemProperties()	Same semantics as fromConfig(Function), uses the system properties.
HttpClientBuilder	withAuthentication(NessieAuthentication authentication)	Sets the NessieAuthentication instance to be used.
HttpClientBuilder	withAuthenticationFromConfig(java.util.function.Function<java.lang.String,java.lang.String> configuration)	Configure only authentication in this HttpClientBuilder instance using a configuration object and standard Nessie configuration keys defined by the constants defined in NessieConfigConstants.
HttpClientBuilder	withConnectionTimeout(int connectionTimeoutMillis)	Set the connection timeout in milliseconds for this client.
HttpClientBuilder	withDisableCompression(boolean disableCompression)	Set whether the compression shall be disabled or not.
HttpClientBuilder	withFollowRedirects(java.lang.String redirects)
HttpClientBuilder	withForceUrlConnectionClient(boolean forceUrlConnectionClient)
HttpClientBuilder	withHttp2Upgrade(boolean http2Upgrade)
HttpClientBuilder	withReadTimeout(int readTimeoutMillis)	Set the read timeout in milliseconds for this client.
HttpClientBuilder	withResponseFactory(HttpResponseFactory responseFactory)
HttpClientBuilder	withSSLContext(javax.net.ssl.SSLContext sslContext)	Set the SSL context for this client.
HttpClientBuilder	withSSLParameters(javax.net.ssl.SSLParameters sslParameters)
HttpClientBuilder	withTracing(boolean tracing)	Whether to enable adding the HTTP headers of an active OpenTracing span to all Nessie requests.
HttpClientBuilder	withUri(java.net.URI uri)	Set the Nessie server URI.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.projectnessie.client.NessieClientBuilder

withUri

Constructor Detail

HttpClientBuilder

protected HttpClientBuilder()

Method Detail

builder

public static HttpClientBuilder builder()

fromSystemProperties

public HttpClientBuilder fromSystemProperties()

Same semantics as fromConfig(Function), uses the system properties.

Specified by:

fromSystemProperties in interface NessieClientBuilder<HttpClientBuilder>

Returns:

this

See Also:

fromConfig(Function)

fromConfig

public HttpClientBuilder fromConfig(java.util.function.Function<java.lang.String,java.lang.String> configuration)

Configure this HttpClientBuilder instance using a configuration object and standard Nessie configuration keys defined by the constants defined in NessieConfigConstants. Non-null values returned by the configuration-function will override previously configured values.

Specified by:

fromConfig in interface NessieClientBuilder<HttpClientBuilder>

Parameters:

configuration - The function that returns a configuration value for a configuration key.

Returns:

this

See Also:

fromSystemProperties()

withAuthenticationFromConfig

public HttpClientBuilder withAuthenticationFromConfig(java.util.function.Function<java.lang.String,java.lang.String> configuration)

Configure only authentication in this HttpClientBuilder instance using a configuration object and standard Nessie configuration keys defined by the constants defined in NessieConfigConstants.

Specified by:

withAuthenticationFromConfig in interface NessieClientBuilder<HttpClientBuilder>

Parameters:

configuration - The function that returns a configuration value for a configuration key.

Returns:

this

See Also:

fromConfig(Function)

withUri

public HttpClientBuilder withUri(java.net.URI uri)

Set the Nessie server URI. A server URI must be configured.

Specified by:

withUri in interface NessieClientBuilder<HttpClientBuilder>

Parameters:

uri - server URI

Returns:

this

withAuthentication

public HttpClientBuilder withAuthentication(NessieAuthentication authentication)

Description copied from interface: NessieClientBuilder

Sets the NessieAuthentication instance to be used.

Specified by:

withAuthentication in interface NessieClientBuilder<HttpClientBuilder>

Parameters:

authentication - authentication for this client

Returns:

this

withTracing

public HttpClientBuilder withTracing(boolean tracing)

Whether to enable adding the HTTP headers of an active OpenTracing span to all Nessie requests. If enabled, the OpenTracing dependencies must be present at runtime.

Parameters:

tracing - true to enable passing HTTP headers for active tracing spans.

Returns:

this

withReadTimeout

public HttpClientBuilder withReadTimeout(int readTimeoutMillis)

Set the read timeout in milliseconds for this client. Timeout will throw HttpClientReadTimeoutException.

Parameters:

readTimeoutMillis - number of seconds to wait for a response from server.

Returns:

this

withConnectionTimeout

public HttpClientBuilder withConnectionTimeout(int connectionTimeoutMillis)

Set the connection timeout in milliseconds for this client. Timeout will throw HttpClientException.

Parameters:

connectionTimeoutMillis - number of seconds to wait to connect to the server.

Returns:

this

withDisableCompression

public HttpClientBuilder withDisableCompression(boolean disableCompression)

Set whether the compression shall be disabled or not.

Parameters:

disableCompression - whether the compression shall be disabled or not.

Returns:

this

withSSLContext

public HttpClientBuilder withSSLContext(javax.net.ssl.SSLContext sslContext)

Set the SSL context for this client.

Parameters:

sslContext - the SSL context to use

Returns:

this

withSSLParameters

public HttpClientBuilder withSSLParameters(javax.net.ssl.SSLParameters sslParameters)

withHttp2Upgrade

public HttpClientBuilder withHttp2Upgrade(boolean http2Upgrade)

withFollowRedirects

public HttpClientBuilder withFollowRedirects(java.lang.String redirects)

withForceUrlConnectionClient

public HttpClientBuilder withForceUrlConnectionClient(boolean forceUrlConnectionClient)

withResponseFactory

public HttpClientBuilder withResponseFactory(HttpResponseFactory responseFactory)

build

public <API extends NessieApi> API build(java.lang.Class<API> apiVersion)

Description copied from interface: NessieClientBuilder

Builds a new NessieApi.

Specified by:

build in interface NessieClientBuilder<HttpClientBuilder>

Returns:

A new NessieApi.