doc: 阅读webclient文档
This commit is contained in:
@@ -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 pool,HttpClient会使用这些共享的资源。对于基于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();
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|||||||
Reference in New Issue
Block a user