doc: 阅读webclient文档

This commit is contained in:
asahi
2025-04-22 12:52:03 +08:00
parent 7e2c4317c3
commit 6a6dfd5bed

View File

@@ -38,3 +38,59 @@ WebClient client2 = client1.mutate()
// client2 has filterA, filterB, filterC, filterD // client2 has filterA, filterB, filterC, filterD
``` ```
### MaxInMemorySize
Codecs对于缓存在内存中的数据大小存在限制避免导致应用的内存问题。默认情况下该值被设置为`256KB`,如果该大小不够,那么将会见到如下报错:
```
org.springframework.core.io.buffer.DataBufferLimitException: Exceeded limit on max bytes to buffer
```
如果想要修改该默认的codecs限制可以使用如下配置
```java
WebClient webClient = WebClient.builder()
.codecs(configurer -> configurer.defaultCodecs().maxInMemorySize(2 * 1024 * 1024))
.build();
```
### reactor netty
为了自定义reactor netty配置可以提供一个预先定义的`HttpClient`
```java
HttpClient httpClient = HttpClient.create().secure(sslSpec -> ...);
WebClient webClient = WebClient.builder()
.clientConnector(new ReactorClientHttpConnector(httpClient))
.build();
```
#### Resources
默认情况下,`HttpClient`将会参与使用`reactor.netty.http.HttpResources`中保存的全局reactor netty resources。
`HttpResources`中包含event loop threads和connection poolHttpClient会使用这些共享的资源。对于基于event loop的并发更倾向使用固定、共享的资源直到进程退出时这些全局资源才会被释放。
如果server的生命周期和进程相同那么对全局资源无需手动释放。但若server在进程的生命周期中可能会启动和停止那么可以声明一个`ReactorResourceFactory`类型的bean并设置`globalResources=true`默认从而确保reactor netty的global resource在`ApplicationContext`关闭时被释放,示例如下所示:
```java
@Bean
public ReactorResourceFactory reactorResourceFactory() {
return new ReactorResourceFactory();
}
```
也可以不使用global reactor netty resources但是在该模式下你需要确保所有reactor netty client and server使用共享的资源示例如下所示
```java
@Bean
public ReactorResourceFactory resourceFactory() {
ReactorResourceFactory factory = new ReactorResourceFactory();
factory.setUseGlobalResources(false);
return factory;
}
@Bean
public WebClient webClient() {
Function<HttpClient, HttpClient> mapper = client -> {
// Further customizations...
};
ClientHttpConnector connector =
new ReactorClientHttpConnector(resourceFactory(), mapper);
return WebClient.builder().clientConnector(connector).build();
}
```