41 lines
1.6 KiB
Markdown
41 lines
1.6 KiB
Markdown
# 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的示例如下：
|
||
```java
|
||
WebClient client = WebClient.builder()
|
||
.codecs(configurer -> ... )
|
||
.build();
|
||
```
|
||
一旦被创建后，WebClient是不可变的，`但是，可以对其进行克隆并对副本进行修改`，示例如下：
|
||
```java
|
||
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
|
||
```
|