ClientOptionsBuilder (filter-service-metrics 1.12 1.12 API)

java.lang.Object
- com.linecorp.armeria.client.ClientOptionsBuilder

```
public final class ClientOptionsBuilder
extends Object
```
Creates a new ClientOptions using the builder pattern.

See Also:

ClientBuilder

Constructor Summary

Constructors
Constructor and Description
`ClientOptionsBuilder()` Deprecated. Use `ClientOptions.builder()`.
`ClientOptionsBuilder(ClientOptions options)` Deprecated. Use `ClientOptions.toBuilder()`.

Method Summary

All Methods Instance Methods Concrete Methods Deprecated Methods
Modifier and Type	Method and Description
`B`	`addHttpHeader(CharSequence name, Object value)` Adds the specified HTTP header.
`B`	`addHttpHeaders(Iterable<? extends Map.Entry<? extends CharSequence,?>> httpHeaders)` Adds the specified HTTP headers.
`ClientOptions`	`build()` Returns a newly-created `ClientOptions` based on the `ClientOptionValue`s of this builder.
`B`	`contentPreview(int length)` Sets the `ContentPreviewerFactory` for creating a `ContentPreviewer` which produces the preview with the maximum `length` limit for a request and a response.
`B`	`contentPreview(int length, Charset defaultCharset)` Sets the `ContentPreviewerFactory` for creating a `ContentPreviewer` which produces the preview with the maximum `length` limit for a request and a response.
`B`	`contentPreviewerFactory(ContentPreviewerFactory factory)` Sets the `ContentPreviewerFactory` for a request and a response.
`B`	`decorator(DecoratingHttpClientFunction decorator)` Adds the specified HTTP-level `decorator`.
`B`	`decorator(Function<? super HttpClient,? extends HttpClient> decorator)` Adds the specified HTTP-level `decorator`.
`B`	`defaultMaxResponseLength(long maxResponseLength)` Deprecated. Use `maxResponseLength(long)`.
`B`	`defaultResponseTimeout(Duration responseTimeout)` Deprecated. Use `responseTimeout(Duration)`.
`B`	`defaultResponseTimeoutMillis(long responseTimeoutMillis)` Deprecated. Use `responseTimeoutMillis(long)`.
`B`	`defaultWriteTimeout(Duration writeTimeout)` Deprecated. Use `writeTimeout(Duration)`.
`B`	`defaultWriteTimeoutMillis(long writeTimeoutMillis)` Deprecated. Use `writeTimeoutMillis(long)`.
`B`	`maxResponseLength(long maxResponseLength)` Sets the maximum allowed length of a server response in bytes.
`<T> B`	`option(ClientOption<T> option, T value)` Adds the specified `ClientOption` and its `value`.
`<T> B`	`option(ClientOptionValue<T> optionValue)` Adds the specified `ClientOptionValue`.
`B`	`options(ClientOptions options)` Adds the specified `ClientOptions`.
`B`	`options(ClientOptionValue<?>... options)` Adds the specified `ClientOptionValue`s.
`B`	`options(Iterable<ClientOptionValue<?>> options)` Adds the specified `ClientOptionValue`s.
`B`	`requestContentPreviewerFactory(ContentPreviewerFactory factory)` Sets the `ContentPreviewerFactory` for a request.
`B`	`requestIdGenerator(Supplier<RequestId> requestIdGenerator)` Sets the `Supplier` that generates a `RequestId`.
`B`	`responseContentPreviewerFactory(ContentPreviewerFactory factory)` Sets the `ContentPreviewerFactory` for a response.
`B`	`responseTimeout(Duration responseTimeout)` Sets the timeout of a response.
`B`	`responseTimeoutMillis(long responseTimeoutMillis)` Sets the timeout of a response in milliseconds.
`B`	`rpcDecorator(DecoratingRpcClientFunction decorator)` Adds the specified RPC-level `decorator`.
`B`	`rpcDecorator(Function<? super RpcClient,? extends RpcClient> decorator)` Adds the specified RPC-level `decorator`.
`B`	`setHttpHeader(CharSequence name, Object value)` Sets the specified HTTP header.
`B`	`setHttpHeaders(Iterable<? extends Map.Entry<? extends CharSequence,?>> httpHeaders)` Sets the specified HTTP headers.
`B`	`writeTimeout(Duration writeTimeout)` Sets the timeout of a socket write attempt.
`B`	`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 Detail
  - ClientOptionsBuilder
```
@Deprecated
public ClientOptionsBuilder()
```
    Deprecated. Use ClientOptions.builder().
    
    Creates a new instance with the default options.
  - ClientOptionsBuilder
```
@Deprecated
public ClientOptionsBuilder(ClientOptions options)
```
    Deprecated. Use ClientOptions.toBuilder().
    
    Creates a new instance with the specified base options.
- Method Detail
  - build
```
public ClientOptions build()
```
    Returns a newly-created ClientOptions based on the ClientOptionValues of this builder.
  - options
```
public B options(ClientOptions options)
```
    Adds the specified ClientOptions.
  - options
```
public B options(ClientOptionValue<?>... options)
```
    Adds the specified ClientOptionValues.
  - options
```
public B options(Iterable<ClientOptionValue<?>> options)
```
    Adds the specified ClientOptionValues.
  - option
```
public <T> B option(ClientOption<T> option,
                    T value)
```
    Adds the specified ClientOption and its value.
  - option
```
public <T> B option(ClientOptionValue<T> optionValue)
```
    Adds the specified ClientOptionValue.
  - defaultWriteTimeout
```
@Deprecated
public B defaultWriteTimeout(Duration writeTimeout)
```
    Deprecated. Use writeTimeout(Duration).
    
    Sets the timeout of a socket write attempt.
    
    Parameters:
    
    writeTimeout - the timeout. 0 disables the timeout.
  - defaultWriteTimeoutMillis
```
@Deprecated
public B defaultWriteTimeoutMillis(long writeTimeoutMillis)
```
    Deprecated. Use writeTimeoutMillis(long).
    
    Sets the timeout of a socket write attempt in milliseconds.
    
    Parameters:
    
    writeTimeoutMillis - the timeout in milliseconds. 0 disables the timeout.
  - writeTimeout
```
public B writeTimeout(Duration writeTimeout)
```
    Sets the timeout of a socket write attempt.
    
    Parameters:
    
    writeTimeout - the timeout. 0 disables the timeout.
  - writeTimeoutMillis
```
public B writeTimeoutMillis(long writeTimeoutMillis)
```
    Sets the timeout of a socket write attempt in milliseconds.
    
    Parameters:
    
    writeTimeoutMillis - the timeout in milliseconds. 0 disables the timeout.
  - defaultResponseTimeout
```
@Deprecated
public B defaultResponseTimeout(Duration responseTimeout)
```
    Deprecated. Use responseTimeout(Duration).
    
    Sets the timeout of a response.
    
    Parameters:
    
    responseTimeout - the timeout. 0 disables the timeout.
  - defaultResponseTimeoutMillis
```
@Deprecated
public B defaultResponseTimeoutMillis(long responseTimeoutMillis)
```
    Deprecated. Use responseTimeoutMillis(long).
    
    Sets the timeout of a response in milliseconds.
    
    Parameters:
    
    responseTimeoutMillis - the timeout in milliseconds. 0 disables the timeout.
  - responseTimeout
```
public B responseTimeout(Duration responseTimeout)
```
    Sets the timeout of a response.
    
    Parameters:
    
    responseTimeout - the timeout. 0 disables the timeout.
  - responseTimeoutMillis
```
public B responseTimeoutMillis(long responseTimeoutMillis)
```
    Sets the timeout of a response in milliseconds.
    
    Parameters:
    
    responseTimeoutMillis - the timeout in milliseconds. 0 disables the timeout.
  - defaultMaxResponseLength
```
@Deprecated
public B defaultMaxResponseLength(long maxResponseLength)
```
    Deprecated. Use maxResponseLength(long).
    
    Sets the maximum allowed length of a server response in bytes.
    
    Parameters:
    
    maxResponseLength - the maximum length in bytes. 0 disables the limit.
  - maxResponseLength
```
public B 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.
  - requestContentPreviewerFactory
```
public B requestContentPreviewerFactory(ContentPreviewerFactory factory)
```
    Sets the ContentPreviewerFactory for a request.
  - responseContentPreviewerFactory
```
public B responseContentPreviewerFactory(ContentPreviewerFactory factory)
```
    Sets the ContentPreviewerFactory for a response.
  - contentPreviewerFactory
```
public B contentPreviewerFactory(ContentPreviewerFactory factory)
```
    Sets the ContentPreviewerFactory for a request and a response.
  - contentPreview
```
public B contentPreview(int length,
                        Charset defaultCharset)
```
    Sets the ContentPreviewerFactory for creating a ContentPreviewer which produces the preview with the maximum length limit for a request and a response. The previewer is enabled only if the content type of a request/response meets any of the following conditions:
    - when it matches text/* or application/x-www-form-urlencoded
    - when its charset has been specified
    - when its subtype is "xml" or "json"
    - when its subtype ends with "+xml" or "+json"
    Parameters:
    
    length - the maximum length of the preview
    
    defaultCharset - the default charset used when a charset is not specified in the "content-type" header
  - contentPreview
```
public B contentPreview(int length)
```
    Sets the ContentPreviewerFactory for creating a ContentPreviewer which produces the preview with the maximum length limit for a request and a response. The previewer is enabled only if the content type of a request/response meets any of the following conditions:
    - when it matches text/* or application/x-www-form-urlencoded
    - when its charset has been specified
    - when its subtype is "xml" or "json"
    - when its subtype ends with "+xml" or "+json"
    Parameters:
    
    length - the maximum length of the preview.
  - requestIdGenerator
```
public B requestIdGenerator(Supplier<RequestId> requestIdGenerator)
```
    Sets the Supplier that generates a RequestId.
  - decorator
```
public B 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 B decorator(DecoratingHttpClientFunction decorator)
```
    Adds the specified HTTP-level decorator.
    
    Parameters:
    
    decorator - the DecoratingHttpClientFunction that intercepts an invocation
  - rpcDecorator
```
public B 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 B rpcDecorator(DecoratingRpcClientFunction decorator)
```
    Adds the specified RPC-level decorator.
    
    Parameters:
    
    decorator - the DecoratingRpcClientFunction that intercepts an invocation
  - addHttpHeader
```
public B addHttpHeader(CharSequence name,
                       Object value)
```
    Adds the specified HTTP header.
  - addHttpHeaders
```
public B addHttpHeaders(Iterable<? extends Map.Entry<? extends CharSequence,?>> httpHeaders)
```
    Adds the specified HTTP headers.
  - setHttpHeader
```
public B setHttpHeader(CharSequence name,
                       Object value)
```
    Sets the specified HTTP header.
  - setHttpHeaders
```
public B setHttpHeaders(Iterable<? extends Map.Entry<? extends CharSequence,?>> httpHeaders)
```
    Sets the specified HTTP headers.

Class ClientOptionsBuilder

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

ClientOptionsBuilder

ClientOptionsBuilder

Method Detail

build

options

options

options

option

option

defaultWriteTimeout

defaultWriteTimeoutMillis

writeTimeout

writeTimeoutMillis

defaultResponseTimeout

defaultResponseTimeoutMillis

responseTimeout

responseTimeoutMillis

defaultMaxResponseLength

maxResponseLength

requestContentPreviewerFactory

responseContentPreviewerFactory

contentPreviewerFactory

contentPreview

contentPreview

requestIdGenerator

decorator

decorator

rpcDecorator

rpcDecorator

addHttpHeader

addHttpHeaders

setHttpHeader

setHttpHeaders