Package com.linecorp.armeria.client

Class AbstractClientOptionsBuilder

java.lang.Object

com.linecorp.armeria.client.AbstractClientOptionsBuilder

Direct Known Subclasses:

AbstractWebClientBuilder, ArmeriaRetrofitBuilder, ClientBuilder, ClientOptionsBuilder

public class AbstractClientOptionsBuilder
extends Object

A skeletal builder implementation for ClientOptions.

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	AbstractClientOptionsBuilder()	Creates a new instance.
protected	AbstractClientOptionsBuilder(ClientOptions options)	Creates a new instance with the specified base options.

Method Summary

Modifier and Type	Method	Description
AbstractClientOptionsBuilder	addHeader(CharSequence name, Object value)	Adds the specified HTTP header.
AbstractClientOptionsBuilder	addHeaders(Iterable<? extends Map.Entry<? extends CharSequence,?>> headers)	Adds the specified HTTP headers.
AbstractClientOptionsBuilder	auth(BasicToken token)	Sets the HTTP basic access authentication header using HttpHeaderNames.AUTHORIZATION.
AbstractClientOptionsBuilder	auth(OAuth1aToken token)	Sets the OAuth Core 1.0 Revision A header using HttpHeaderNames.AUTHORIZATION.
AbstractClientOptionsBuilder	auth(OAuth2Token token)	Sets the OAuth 2.0 header using HttpHeaderNames.AUTHORIZATION.
protected ClientOptions	buildOptions()	Builds ClientOptions with the given options and the default options.
protected ClientOptions	buildOptions(ClientOptions baseOptions)	Builds ClientOptions with the specified baseOptions and the options which were set to this builder.
AbstractClientOptionsBuilder	clearDecorators()	Clears all HTTP-level and RPC-level decorators set so far.
AbstractClientOptionsBuilder	decorator(DecoratingHttpClientFunction decorator)	Adds the specified HTTP-level decorator.
AbstractClientOptionsBuilder	decorator(Function<? super HttpClient,? extends HttpClient> decorator)	Adds the specified HTTP-level decorator.
AbstractClientOptionsBuilder	endpointRemapper(Function<? super Endpoint,? extends EndpointGroup> endpointRemapper)	Sets a Function that remaps an Endpoint into an EndpointGroup.
AbstractClientOptionsBuilder	factory(ClientFactory factory)	Sets the ClientFactory used for creating a client.
AbstractClientOptionsBuilder	maxResponseLength(long maxResponseLength)	Sets the maximum allowed length of a server response in bytes.
<T> AbstractClientOptionsBuilder	option(ClientOption<T> option, T value)	Adds the specified ClientOption and its value.
<T> AbstractClientOptionsBuilder	option(ClientOptionValue<T> optionValue)	Adds the specified ClientOptionValue.
AbstractClientOptionsBuilder	options(ClientOptions options)	Adds the specified ClientOptions.
AbstractClientOptionsBuilder	options(ClientOptionValue<?>... options)	Adds the specified ClientOptionValues.
AbstractClientOptionsBuilder	options(Iterable<ClientOptionValue<?>> options)	Adds the specified ClientOptionValues.
AbstractClientOptionsBuilder	requestIdGenerator(Supplier<RequestId> requestIdGenerator)	Sets the Supplier that generates a RequestId.
AbstractClientOptionsBuilder	responseTimeout(Duration responseTimeout)	Sets the timeout of a response.
AbstractClientOptionsBuilder	responseTimeoutMillis(long responseTimeoutMillis)	Sets the timeout of a response in milliseconds.
AbstractClientOptionsBuilder	rpcDecorator(DecoratingRpcClientFunction decorator)	Adds the specified RPC-level decorator.
AbstractClientOptionsBuilder	rpcDecorator(Function<? super RpcClient,? extends RpcClient> decorator)	Adds the specified RPC-level decorator.
AbstractClientOptionsBuilder	setHeader(CharSequence name, Object value)	Sets the specified HTTP header.
AbstractClientOptionsBuilder	setHeaders(Iterable<? extends Map.Entry<? extends CharSequence,?>> headers)	Sets the specified HTTP headers.
AbstractClientOptionsBuilder	writeTimeout(Duration writeTimeout)	Sets the timeout of a socket write attempt.
AbstractClientOptionsBuilder	writeTimeoutMillis(long writeTimeoutMillis)	Sets the timeout of a socket write attempt in milliseconds.

Methods inherited from class java.lang.Object

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

Constructor Details

AbstractClientOptionsBuilder

protected AbstractClientOptionsBuilder()

Creates a new instance.

AbstractClientOptionsBuilder

protected AbstractClientOptionsBuilder(ClientOptions options)

Creates a new instance with the specified base options.

Method Details

options

public AbstractClientOptionsBuilder options(ClientOptions options)

Adds the specified ClientOptions.

options

public AbstractClientOptionsBuilder options(ClientOptionValue<?>... options)

Adds the specified ClientOptionValues.

options

public AbstractClientOptionsBuilder options(Iterable<ClientOptionValue<?>> options)

Adds the specified ClientOptionValues.

option

public <T> AbstractClientOptionsBuilder option(ClientOption<T> option,
T value)

Adds the specified ClientOption and its value.

option

public <T> AbstractClientOptionsBuilder option(ClientOptionValue<T> optionValue)

Adds the specified ClientOptionValue.

factory

public AbstractClientOptionsBuilder factory(ClientFactory factory)

Sets the ClientFactory used for creating a client. The default is ClientFactory.ofDefault().

writeTimeout

public AbstractClientOptionsBuilder writeTimeout(Duration writeTimeout)

Sets the timeout of a socket write attempt.

Parameters:

writeTimeout - the timeout. 0 disables the timeout.

writeTimeoutMillis

public AbstractClientOptionsBuilder writeTimeoutMillis(long writeTimeoutMillis)

Sets the timeout of a socket write attempt in milliseconds.

Parameters:

writeTimeoutMillis - the timeout in milliseconds. 0 disables the timeout.

responseTimeout

public AbstractClientOptionsBuilder responseTimeout(Duration responseTimeout)

Sets the timeout of a response.

Parameters:

responseTimeout - the timeout. 0 disables the timeout.

responseTimeoutMillis

public AbstractClientOptionsBuilder responseTimeoutMillis(long responseTimeoutMillis)

Sets the timeout of a response in milliseconds.

Parameters:

responseTimeoutMillis - the timeout in milliseconds. 0 disables the timeout.

maxResponseLength

public AbstractClientOptionsBuilder maxResponseLength(long maxResponseLength)

Sets the maximum allowed length of a server response in bytes.

Parameters:

maxResponseLength - the maximum length in bytes. 0 disables the limit.

requestIdGenerator

public AbstractClientOptionsBuilder requestIdGenerator(Supplier<RequestId> requestIdGenerator)

Sets the Supplier that generates a RequestId.

endpointRemapper

public AbstractClientOptionsBuilder endpointRemapper(Function<? super Endpoint,? extends EndpointGroup> endpointRemapper)

Sets a Function that remaps an Endpoint into an EndpointGroup. This ClientOption is useful when you need to override a single target host into a group of hosts to enable client-side load-balancing, e.g.

 MyService.Iface client =
     Clients.newClient("tbinary+http://example.com/api",
                       MyService.Iface.class);

 EndpointGroup myGroup = EndpointGroup.of(Endpoint.of("node-1.example.com")),
                                          Endpoint.of("node-2.example.com")));

 MyService.Iface derivedClient =
     Clients.newDerivedClient(client, options -> {
         return options.toBuilder()
                       .endpointRemapper(endpoint -> {
                           if (endpoint.host().equals("example.com")) {
                               return myGroup;
                           } else {
                               return endpoint;
                           }
                       })
                       .build();
     });

 // This request goes to 'node-1.example.com' or 'node-2.example.com'.
 derivedClient.call();
 

Note that the remapping does not occur recursively but only once.

See Also:

ClientOptions.ENDPOINT_REMAPPER, ClientOptions.endpointRemapper()

decorator

public AbstractClientOptionsBuilder decorator(Function<? super HttpClient,? extends HttpClient> decorator)

Adds the specified HTTP-level decorator.

Parameters:

decorator - the Function that transforms an HttpClient to another

decorator

public AbstractClientOptionsBuilder decorator(DecoratingHttpClientFunction decorator)

Adds the specified HTTP-level decorator.

Parameters:

decorator - the DecoratingHttpClientFunction that intercepts an invocation

clearDecorators

public AbstractClientOptionsBuilder clearDecorators()

Clears all HTTP-level and RPC-level decorators set so far.

rpcDecorator

public AbstractClientOptionsBuilder rpcDecorator(Function<? super RpcClient,? extends RpcClient> decorator)

Adds the specified RPC-level decorator.

Parameters:

decorator - the Function that transforms an RpcClient to another

rpcDecorator

public AbstractClientOptionsBuilder rpcDecorator(DecoratingRpcClientFunction decorator)

Adds the specified RPC-level decorator.

Parameters:

decorator - the DecoratingRpcClientFunction that intercepts an invocation

addHeader

public AbstractClientOptionsBuilder addHeader(CharSequence name,
Object value)

Adds the specified HTTP header.

addHeaders

public AbstractClientOptionsBuilder addHeaders(Iterable<? extends Map.Entry<? extends CharSequence,?>> headers)

Adds the specified HTTP headers.

setHeader

public AbstractClientOptionsBuilder setHeader(CharSequence name,
Object value)

Sets the specified HTTP header.

setHeaders

public AbstractClientOptionsBuilder setHeaders(Iterable<? extends Map.Entry<? extends CharSequence,?>> headers)

Sets the specified HTTP headers.

auth

public AbstractClientOptionsBuilder auth(BasicToken token)

Sets the HTTP basic access authentication header using HttpHeaderNames.AUTHORIZATION.

auth

public AbstractClientOptionsBuilder auth(OAuth1aToken token)

Sets the OAuth Core 1.0 Revision A header using HttpHeaderNames.AUTHORIZATION.

auth

public AbstractClientOptionsBuilder auth(OAuth2Token token)

Sets the OAuth 2.0 header using HttpHeaderNames.AUTHORIZATION.

buildOptions

protected final ClientOptions buildOptions()

Builds ClientOptions with the given options and the default options.

buildOptions

protected final ClientOptions buildOptions(@Nullable
ClientOptions baseOptions)

Builds ClientOptions with the specified baseOptions and the options which were set to this builder.