diff --git a/spring/webflux/webclient.md b/spring/webflux/webclient.md new file mode 100644 index 0000000..6f9a1ca --- /dev/null +++ b/spring/webflux/webclient.md @@ -0,0 +1,40 @@ +# 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 +```