Spring WebClient 实战示例

Spring WebClient 是 Spring 5 中引入的新特性，它是一种非阻塞式的 HTTP 客户端，可以用于调用 RESTful API 或其他 HTTP 服务。本文将详细讲解 Spring WebClient 的使用方法，并提供两个示例说明。

1. 创建 WebClient 对象

要使用 Spring WebClient，我们需要先创建 WebClient 对象。下面是一个简单的示例：

WebClient webClient = WebClient.create("http://localhost:8080");

在上面的代码中，我们使用 WebClient.create 方法创建了一个 WebClient 对象，并指定了要访问的 URL。

2. 发送 GET 请求

发送 GET 请求是 WebClient 最常见的用法之一。下面是一个简单的示例：

Mono<String> result = webClient.get()
  .uri("/hello")
  .retrieve()
  .bodyToMono(String.class);

System.out.println(result.block());

在上面的代码中，我们使用 webClient.get 方法创建了一个 GET 请求，并使用 uri 方法指定了要访问的 URI。然后，我们使用 retrieve 方法来执行请求，并使用 bodyToMono 方法将响应体转换为 Mono 类型。最后，我们使用 block 方法来阻塞当前线程，并输出响应结果。

3. 发送 POST 请求

发送 POST 请求也是 WebClient 常见的用法之一。下面是一个简单的示例：

Mono<String> result = webClient.post()
  .uri("/hello")
  .contentType(MediaType.APPLICATION_JSON)
  .body(BodyInserters.fromValue("{\"name\":\"John\",\"age\":30}"))
  .retrieve()
  .bodyToMono(String.class);

System.out.println(result.block());

在上面的代码中，我们使用 webClient.post 方法创建了一个 POST 请求，并使用 uri 方法指定了要访问的 URI。然后，我们使用 contentType 方法指定请求的 Content-Type，并使用 body 方法指定请求的 JSON 数据。最后，我们使用 retrieve 方法来执行请求，并使用 bodyToMono 方法将响应体转换为 Mono 类型。最后，我们使用 block 方法来阻塞当前线程，并输出响应结果。

4. 示例一：使用 WebClient 调用 RESTful API

假设我们有一个 RESTful API，可以根据用户 ID 获取用户信息。下面是一个简单的示例，演示了如何使用 WebClient 调用该 API：

WebClient webClient = WebClient.create("http://localhost:8080");

Mono<User> result = webClient.get()
  .uri("/user/{id}", 1)
  .retrieve()
  .bodyToMono(User.class);

System.out.println(result.block());

在上面的代码中，我们使用 WebClient.create 方法创建了一个 WebClient 对象，并指定了要访问的 URL。然后，我们使用 webClient.get 方法创建了一个 GET 请求，并使用 uri 方法指定了要访问的 URI。在 URI 中，我们使用占位符 {id} 来指定用户 ID。然后，我们使用 retrieve 方法来执行请求，并使用 bodyToMono 方法将响应体转换为 Mono 类型。最后，我们使用 block 方法来阻塞当前线程，并输出响应结果。

5. 示例二：使用 WebClient 调用 GitHub API

假设我们想要使用 WebClient 调用 GitHub API，获取某个用户的公共仓库列表。下面是一个简单的示例：

WebClient webClient = WebClient.create("https://api.github.com");

Mono<List<Repository>> result = webClient.get()
  .uri("/users/{username}/repos", "octocat")
  .header("User-Agent", "Spring 5 WebClient")
  .retrieve()
  .bodyToFlux(Repository.class)
  .collectList();

System.out.println(result.block());

在上面的代码中，我们使用 WebClient.create 方法创建了一个 WebClient 对象，并指定了要访问的 URL。然后，我们使用 webClient.get 方法创建了一个 GET 请求，并使用 uri 方法指定了要访问的 URI。在 URI 中，我们使用占位符 {username} 来指定用户名。然后，我们使用 header 方法来指定请求头中的 User-Agent。最后，我们使用 retrieve 方法来执行请求，并使用 bodyToFlux 方法将响应体转换为 Flux 类型。最后，我们使用 collectList 方法将 Flux 转换为 List，并使用 block 方法来阻塞当前线程，并输出响应结果。

总结

本文详细讲解了 Spring WebClient 的使用方法，并提供了两个示例说明。Spring WebClient 是一种非阻塞式的 HTTP 客户端，可以用于调用 RESTful API 或其他 HTTP 服务。通过本文的学习，相信读者已经掌握了如何使用 Spring WebClient 来发送 GET 请求和 POST 请求，并了解了如何使用 WebClient 调用 RESTful API 和其他 HTTP 服务。