WebClientBuilder (filter-service-metrics 1.12 1.12 API)

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

```
public final class WebClientBuilder
extends Object
```
Creates a new web client that connects to the specified URI using the builder pattern. Use the factory methods in WebClient if you do not have many options to override. Please refer to ClientBuilder for how decorators and HTTP headers are configured

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.
`WebClient`	`build()` Returns a newly-created web client based on the properties 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)`.
`WebClientBuilder`	`factory(ClientFactory factory)` Sets the `ClientFactory` of the client.
`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.
`WebClientBuilder`	`path(String path)` Sets the `path` of the client.
`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.
`WebClientBuilder`	`rpcDecorator(DecoratingRpcClientFunction decorator)` Adds the specified RPC-level `decorator`.
`WebClientBuilder`	`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

- Method Detail
  - factory
```
public WebClientBuilder factory(ClientFactory factory)
```
    Sets the ClientFactory of the client. The default is ClientFactory.ofDefault().
  - path
```
public WebClientBuilder path(String path)
```
    Sets the path of the client.
  - build
```
public WebClient build()
```
    Returns a newly-created web client based on the properties of this builder.
    
    Throws:
    
    IllegalArgumentException - if the scheme of the uri specified in WebClient.builder(String) or WebClient.builder(URI) is not an HTTP scheme
  - rpcDecorator
```
public WebClientBuilder 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 WebClientBuilder rpcDecorator(DecoratingRpcClientFunction decorator)
```
    Adds the specified RPC-level decorator.
    
    Parameters:
    
    decorator - the DecoratingRpcClientFunction that intercepts an invocation
  - 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
  - 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 WebClientBuilder

Method Summary

Methods inherited from class java.lang.Object

Method Detail

factory

path

build

rpcDecorator

rpcDecorator

options

options

options

option

option

defaultWriteTimeout

defaultWriteTimeoutMillis

writeTimeout

writeTimeoutMillis

defaultResponseTimeout

defaultResponseTimeoutMillis

responseTimeout

responseTimeoutMillis

defaultMaxResponseLength

maxResponseLength

requestContentPreviewerFactory

responseContentPreviewerFactory

contentPreviewerFactory

contentPreview

contentPreview

requestIdGenerator

decorator

decorator

addHttpHeader

addHttpHeaders

setHttpHeader

setHttpHeaders