程序包 cn.taketoday.web.reactive.function.client

接口 WebClient.Builder

所有已知实现类:

DefaultWebClientBuilder

封闭接口:

WebClient

public static interface WebClient.Builder

A mutable builder for creating a WebClient.

方法概要

修饰符和类型	方法	说明
WebClient.Builder	apply(Consumer<WebClient.Builder> builderConsumer)	Apply the given Consumer to this builder instance.
WebClient.Builder	baseUrl(String baseUrl)	Configure a base URL for requests.
WebClient	build()	Builder the WebClient instance.
WebClient.Builder	clientConnector(ClientHttpConnector connector)	Configure the ClientHttpConnector to use.
WebClient.Builder	clone()	Clone this WebClient.Builder.
WebClient.Builder	codecs(Consumer<ClientCodecConfigurer> configurer)	Configure the codecs for the WebClient in the underlying ExchangeStrategies.
WebClient.Builder	defaultCookie(String cookie, String... values)	Global option to specify a cookie to be added to every request, if the request does not already contain such a cookie.
WebClient.Builder	defaultCookies(Consumer<cn.taketoday.util.MultiValueMap<String,String>> cookiesConsumer)	Provides access to every defaultCookie(String, String...) declared so far with the possibility to add, replace, or remove.
WebClient.Builder	defaultHeader(String header, String... values)	Global option to specify a header to be added to every request, if the request does not already contain such a header.
WebClient.Builder	defaultHeaders(Consumer<HttpHeaders> headersConsumer)	Provides access to every defaultHeader(String, String...) declared so far with the possibility to add, replace, or remove.
WebClient.Builder	defaultRequest(Consumer<WebClient.RequestHeadersSpec<?>> defaultRequest)	Provide a consumer to customize every request being built.
WebClient.Builder	defaultStatusHandler(Predicate<HttpStatusCode> statusPredicate, Function<ClientResponse,reactor.core.publisher.Mono<? extends Throwable>> exceptionFunction)	Register a default status handler to apply to every response.
WebClient.Builder	defaultUriVariables(Map<String,?> defaultUriVariables)	Configure default URL variable values to use when expanding URI templates with a Map.
WebClient.Builder	exchangeFunction(ExchangeFunction exchangeFunction)	Provide an ExchangeFunction pre-configured with ClientHttpConnector and ExchangeStrategies.
WebClient.Builder	exchangeStrategies(ExchangeStrategies strategies)	Configure the ExchangeStrategies to use.
WebClient.Builder	exchangeStrategies(Consumer<ExchangeStrategies.Builder> configurer)	Customize the strategies configured via exchangeStrategies(ExchangeStrategies).
WebClient.Builder	filter(ExchangeFilterFunction filter)	Add the given filter to the end of the filter chain.
WebClient.Builder	filters(Consumer<List<ExchangeFilterFunction>> filtersConsumer)	Manipulate the filters with the given consumer.
WebClient.Builder	uriBuilderFactory(UriBuilderFactory uriBuilderFactory)	Provide a pre-configured UriBuilderFactory instance.

方法详细资料

baseUrl

WebClient.Builder baseUrl(String baseUrl)

Configure a base URL for requests. Effectively a shortcut for:

 String baseUrl = "https://abc.go.com/v1";
 DefaultUriBuilderFactory factory = new DefaultUriBuilderFactory(baseUrl);
 WebClient client = WebClient.builder().uriBuilderFactory(factory).build();
 

The DefaultUriBuilderFactory is used to prepare the URL for every request with the given base URL, unless the URL request for a given URL is absolute in which case the base URL is ignored.

Note: this method is mutually exclusive with uriBuilderFactory(UriBuilderFactory). If both are used, the baseUrl value provided here will be ignored.

另请参阅:

• DefaultUriBuilderFactory(String)
• uriBuilderFactory(UriBuilderFactory)

defaultUriVariables

WebClient.Builder defaultUriVariables(Map<String,?> defaultUriVariables)

Configure default URL variable values to use when expanding URI templates with a Map. Effectively a shortcut for:

 Map<String, ?> defaultVars = ...;
 DefaultUriBuilderFactory factory = new DefaultUriBuilderFactory();
 factory.setDefaultVariables(defaultVars);
 WebClient client = WebClient.builder().uriBuilderFactory(factory).build();
 

Note: this method is mutually exclusive with uriBuilderFactory(UriBuilderFactory). If both are used, the defaultUriVariables value provided here will be ignored.

另请参阅:

• DefaultUriBuilderFactory.setDefaultUriVariables(Map)
• uriBuilderFactory(UriBuilderFactory)

uriBuilderFactory

WebClient.Builder uriBuilderFactory(UriBuilderFactory uriBuilderFactory)

Provide a pre-configured UriBuilderFactory instance. This is an alternative to, and effectively overrides the following shortcut properties:

• baseUrl(String)
• defaultUriVariables(Map).

参数:

uriBuilderFactory - the URI builder factory to use

另请参阅:

• baseUrl(String)
• defaultUriVariables(Map)

defaultHeader

WebClient.Builder defaultHeader(String header,
 String... values)

Global option to specify a header to be added to every request, if the request does not already contain such a header.

参数:

header - the header name

values - the header values

defaultHeaders

WebClient.Builder defaultHeaders(Consumer<HttpHeaders> headersConsumer)

Provides access to every defaultHeader(String, String...) declared so far with the possibility to add, replace, or remove.

参数:

headersConsumer - the consumer

defaultCookie

WebClient.Builder defaultCookie(String cookie,
 String... values)

Global option to specify a cookie to be added to every request, if the request does not already contain such a cookie.

参数:

cookie - the cookie name

values - the cookie values

defaultCookies

WebClient.Builder defaultCookies(Consumer<cn.taketoday.util.MultiValueMap<String,String>> cookiesConsumer)

Provides access to every defaultCookie(String, String...) declared so far with the possibility to add, replace, or remove.

参数:

cookiesConsumer - a function that consumes the cookies map

defaultRequest

WebClient.Builder defaultRequest(Consumer<WebClient.RequestHeadersSpec<?>> defaultRequest)

Provide a consumer to customize every request being built.

参数:

defaultRequest - the consumer to use for modifying requests

defaultStatusHandler

WebClient.Builder defaultStatusHandler(Predicate<HttpStatusCode> statusPredicate,
 Function<ClientResponse,reactor.core.publisher.Mono<? extends Throwable>> exceptionFunction)

Register a default status handler to apply to every response. Such default handlers are applied in the order in which they are registered, and after any others that are registered for a specific response.

参数:

statusPredicate - to match responses with

exceptionFunction - to map the response to an error signal

返回:

this builder

filter

WebClient.Builder filter(ExchangeFilterFunction filter)

Add the given filter to the end of the filter chain.

参数:

filter - the filter to be added to the chain

filters

WebClient.Builder filters(Consumer<List<ExchangeFilterFunction>> filtersConsumer)

Manipulate the filters with the given consumer. The list provided to the consumer is "live", so that the consumer can be used to remove filters, change ordering, etc.

参数:

filtersConsumer - a function that consumes the filter list

返回:

this builder

clientConnector

WebClient.Builder clientConnector(ClientHttpConnector connector)

Configure the ClientHttpConnector to use. This is useful for plugging in and/or customizing options of the underlying HTTP client library (e.g. SSL).

By default this is set to ReactorClientHttpConnector.

参数:

connector - the connector to use

codecs

WebClient.Builder codecs(Consumer<ClientCodecConfigurer> configurer)

Configure the codecs for the WebClient in the underlying ExchangeStrategies.

参数:

configurer - the configurer to apply

exchangeStrategies

WebClient.Builder exchangeStrategies(ExchangeStrategies strategies)

Configure the ExchangeStrategies to use.

For most cases, prefer using codecs(Consumer) which allows customizing the codecs in the ExchangeStrategies rather than replace them. That ensures multiple parties can contribute to codecs configuration.

By default this is set to ExchangeStrategies.withDefaults().

参数:

strategies - the strategies to use

exchangeStrategies

WebClient.Builder exchangeStrategies(Consumer<ExchangeStrategies.Builder> configurer)

Customize the strategies configured via exchangeStrategies(ExchangeStrategies). This method is designed for use in scenarios where multiple parties wish to update the ExchangeStrategies.

exchangeFunction

WebClient.Builder exchangeFunction(ExchangeFunction exchangeFunction)

Provide an ExchangeFunction pre-configured with ClientHttpConnector and ExchangeStrategies.

This is an alternative to, and effectively overrides clientConnector(cn.taketoday.http.client.reactive.ClientHttpConnector), and exchangeStrategies(ExchangeStrategies).

参数:

exchangeFunction - the exchange function to use

apply

WebClient.Builder apply(Consumer<WebClient.Builder> builderConsumer)

Apply the given Consumer to this builder instance.

This can be useful for applying pre-packaged customizations.

参数:

builderConsumer - the consumer to apply

clone

WebClient.Builder clone()

Clone this WebClient.Builder.

build

WebClient build()

Builder the WebClient instance.