rikako-note/spring/webflux/webclient.md

WebClient

WebClient基于Reactor提供了functional, fluent API。

WebClient是非阻塞的，其依赖的codecs和server端使用的codecs相同。

Configuration

创建WebClient最简单的方式是通过静态工厂方法：

• WebClient.create()
• WebClient.create(String baseUrl)

除此之外，也可以通过WebClient.builder()来指定更多选项：

• uriBuilderFactory： 自定义uriBuilderFactory，用于创建UriBuilder，UriBuilder包含共享的配置，例如base URI等
• defaultUriVariables: 在拓展uri templates时，使用到的默认值
• defaultHeader：对每个请求都包含的headers
• defaultCookie：每个请求都包含的Cookie
• defaultRequest： 对每个请求进行自定义的Consumer
• filter：对于每个请求的client filter
• exchangeStrategies：自定义http message的reader/writer
• clientConnector：http client library设置
• observationRegistry： the registry to use for enabling Observability support
• observationConvention: an optional, custom convention to extract metadata for recorded observations.

创建WebClient的示例如下：

WebClient client = WebClient.builder()
		.codecs(configurer -> ... )
		.build();

一旦被创建后，WebClient是不可变的，但是，可以对其进行克隆并对副本进行修改，示例如下：

WebClient client1 = WebClient.builder()
		.filter(filterA).filter(filterB).build();

WebClient client2 = client1.mutate()
		.filter(filterC).filter(filterD).build();

// client1 has filterA, filterB

// client2 has filterA, filterB, filterC, filterD