javaIO和netty的基本原理

2026-04-24 10:34:11 +08:00 · 2022-11-27 14:45:19 +08:00
parent f90e4ed166
commit 19d3b3e3e2
169 changed files with 5444 additions and 3691 deletions
--- a/WebFlux04WebClient.md
+++ b/WebFlux04WebClient.md
@@ -0,0 +1,229 @@
+
+> 参考文件https://blog.csdn.net/hellozpc/article/details/122441522
+> https://blog.csdn.net/kerongao/article/details/109746190
+> https://www.cnblogs.com/chaosmoor/p/1670308e.html
+> https://www.jianshu.com/p/cc3a99614476
+
+
+## 1 概述
+
+### 简介
+
+它是Spring5中引入的响应式web客户端类库，最大特点是支持异步调用；我们还将学习WebTestClient，用于单元测试。
+
+简单地说，WebClient是一个接口，执行web请求的主要入口点。
+
+它是Spring Web Reactive模块的一部分，并且取代经典的RestTemplate而生。此外，新的客户端是一个响应式的、非阻塞的技术方案，可以在HTTP/1.1协议上工作。
+
+
+
+## 2 使用
+
+### 步骤
+
+使用WebClient我们需要按照如下几步来操作
+
+1. 创建WebClient实例
+2. 执行请求
+3. 处理返回数据
+
+### 创建WebClient实例
+
+构建WebClient有三种方法：
+
+第一种，使用默认配置构建WebClient
+```java
+WebClient client1 = WebClient.create();
+```
+第二种，使用base URI参数构建WebClient
+```java
+WebClient client2 = WebClient.create("http://localhost:8080");
+```
+第三种，使用DefaultWebClientBuilder构造WebClient。构造器流式编程接口创建。
+```java
+WebClient client3 = WebClient
+    .builder()
+    .baseUrl("http://localhost:8080")
+    .defaultCookie("cookieKey", "cookieValue")
+    .defaultHeader(HttpHeaders.CONTENT_TYPE, MediaType.APPLICATION_JSON_VALUE) 
+    .defaultUriVariables(Collections.singletonMap("url", "http://localhost:8080"))
+    .build();
+```
+
+
+### WebClient设置Timeouts
+通常，默认HTTP的超时为30秒，对于实际业务来说时间太长，所以让我们看看如何为我们的WebClient实例配置它们。
+
+可以通过TcpClient来设置超时时间，超时时间分为链接超时时间和读/写超时时间，为了保证达到预期效果这两个值都需要设置。
+
+我们可以通过ChannelOption.CONNECT_TIMEOUT_MILLIS设置连接超时，我们还可以使用ReadTimeoutHandler和WriteTimeoutHandler分别设置读和写超时
+```java
+TcpClient tcpClient = TcpClient
+  .create()
+  .option(ChannelOption.CONNECT_TIMEOUT_MILLIS, 5000)
+  .doOnConnected(connection -> {
+      connection.addHandlerLast(new ReadTimeoutHandler(5000, TimeUnit.MILLISECONDS));
+      connection.addHandlerLast(new WriteTimeoutHandler(5000, TimeUnit.MILLISECONDS));
+  });
+ 
+WebClient client = WebClient.builder()
+  .clientConnector(new ReactorClientHttpConnector(HttpClient.from(tcpClient)))
+  .build();
+```
+> 虽然我们也可以在WebClient客户端请求上调用超时，但这是一个信号超时，而不是HTTP连接或读/写超时;这是Mono/Flux发布者的超时
+
+### 准备请求数据
+
+**第一步**，我们需要通过method(HttpMethod method) 或调yonWebClient来指定请求的HTTP方法get, post,delete:
+```java
+WebClient.UriSpec<WebClient.RequestBodySpec> request1 = client3.method(HttpMethod.POST);
+WebClient.UriSpec<WebClient.RequestBodySpec> request2 = client3.post();
+```
+
+**第二步**，设置请求访问URL
+```java
+WebClient.RequestBodySpec uri1 = client3
+  .method(HttpMethod.POST)
+  .uri("/resource");
+ 
+WebClient.RequestBodySpec uri2 = client3
+  .post()
+  .uri(URI.create("/resource"));
+```
+路径参数：我们使用uriBuilder构建包含路径参数的uri，也可以直接使用占位符。 /events/{id} 访问点并构建相应的 URI：
+```java
+this.webClient.get()
+	.uri(uriBuilder -> uriBuilder
+		.path("/events/{id}")
+		.build(2))
+	.retrieve();
+verifyCalledUrl("/events/2");
+
+
+String url = "http://localhost:8080/user/{id}/{name}";
+String id = "123";
+String name = "Boss";
+Mono<String> mono = WebClient.create()
+        .method(HttpMethod.POST)
+        .uri(url, id, name)
+        .retrieve()
+        .bodyToMono(String.class);
+String result = mono.block();
+
+```
+查询参数：采用 /events?name=[name]&startDate=[startDate]访问点。要设置查询参数，我们需要调用 UriBuilder 接口的 queryParam()方法：
+```java
+this.webClient.get()
+	.uri(uriBuilder -> uriBuilder
+		.path("/events")
+		.queryParam("name", "InitFailed")
+		.queryParam("startDate", "13/02/2021")
+		.build())
+	.retrieve();
+verifyCalledUrl("/events?name=InitFailed&startDate=13/02/2021")
+```
+
+
+**第三步**，设置request body、content type、 length、cookies、headers 等请求参数
+
+例如，如果我们想要设置一个request body，有两种可用的方法:用一个BodyInserter，或者把这个工作委托给Publisher
+```java
+WebClient.RequestHeadersSpec requestSpec1 = WebClient
+  .create()
+  .method(HttpMethod.POST)
+  .uri("/resource")
+  .body(BodyInserters.fromPublisher(Mono.just("data")), String.class);
+ 
+WebClient.RequestHeadersSpec<?> requestSpec2 = WebClient
+  .create("http://localhost:8080")
+  .post()
+  .uri(URI.create("/resource"))
+  .body(BodyInserters.fromObject("data"));
+```
+BodyInserter 是一个接口，负责向request body中插入请求的body值
+
+我们还可以设置MultiValueMap数据作为request body值
+```java
+LinkedMultiValueMap map = new LinkedMultiValueMap();
+ 
+map.add("key1", "value1");
+map.add("key2", "value2");
+ 
+BodyInserter<MultiValueMap, ClientHttpRequest> inserter2
+ = BodyInserters.fromMultipartData(map);
+```
+或者插入一个对象
+```java
+BodyInserter<Object, ReactiveHttpOutputMessage> inserter3
+ = BodyInserters.fromObject(new Object());
+```
+在设置request body之后，我们可以设置content type、 length、cookies、headers
+
+此外，它还支持最常用的头文件，如“If-None-Match”、“If-Modified-Since”、“Accept”和“Accept- charset”。
+```java
+WebClient.ResponseSpec response1 = uri1
+  .body(inserter3)
+    .header(HttpHeaders.CONTENT_TYPE, MediaType.APPLICATION_JSON_VALUE)
+    .accept(MediaType.APPLICATION_JSON, MediaType.APPLICATION_XML)
+    .acceptCharset(Charset.forName("UTF-8"))
+    .ifNoneMatch("*")
+    .ifModifiedSince(ZonedDateTime.now())
+  .retrieve();
+```
+
+### 获取Response
+最后一个步骤是发送请求和接收响应,这可以通过exchange或retrieve方法来完成
+* exchange方法提供了ClientResponse以及它的status和header
+* 而retrieve方法是直接获取body的内容:
+```java
+String response2 = request1.exchange()
+  .block()
+  .bodyToMono(String.class)
+  .block();
+String response3 = request2
+  .retrieve()
+  .bodyToMono(String.class)
+  .block();
+```
+需要注意的是bodyToMono方法，如果状态代码是4xx(客户端错误)或5xx(服务器错误)，它将抛出一个WebClientException。
+
+* Monos.block()方法来订阅和检索与响应一起发送的实际数据
+* Monos.subscribe()非阻塞式获取响应结果
+```java
+@Test
+public void testSubscribe() {
+    Mono<String> mono = WebClient
+            .create()
+            .method(HttpMethod.GET)
+            .uri("http://localhost:8080/hello")
+            .retrieve()
+            .bodyToMono(String.class);
+    mono.subscribe(WebClientTest::handleMonoResp);
+}
+//响应回调
+private static void handleMonoResp(String monoResp) {
+    System.out.println("请求结果为：" + monoResp);
+}
+```
+
+注意！在使用新版的spring boot 2.4.0，可能会出现如下错误：
+```java
+org.springframework.core.io.buffer.DataBufferLimitException: Exceeded limit on max bytes to buffer : 262144
+```
+可以通过修改application.yaml配置文件,增加缓冲区大小(测试发现不起作用)
+```java
+spring.codec.max-in-memory-size: 5MB
+```
+通过代码配置缓冲区大小
+```java
+ WebClient client = WebClient.builder()
+                .exchangeStrategies(ExchangeStrategies.builder()
+                        .codecs(configurer -> {
+                                configurer.defaultCodecs()
+                                .maxInMemorySize(16 * 1024 * 1024) ; }
+                        )
+                        .build())
+                .build();
+
+```
+设置缓冲区大小为16MB