<think>好的，用户之前问了
WebClient和HttpClient哪个更常用，现在他继续问
WebClient的具体
使用方法，特别是
GET和POST请求。我需要详细讲解如何
使用WebClient，并且要覆盖
GET和POST的基本用法、示例代码以及一些高级配置。
首先，用户可能已经了解
WebClient是Spring推荐的响应式客户端，但需要具体的操作指南。他们可能刚接触
WebClient，或者之前用过HttpClient或RestTemplate，现在想迁移到
WebClient。因此，我应该从基本配置开始，逐步深入。
接下来，
GET请求部分需要说明如何创建
WebClient实例，发起
请求，处理响应。可能需要展示阻塞
和非阻塞两种方式，因为用户可能还在同步代码中过渡，但也要强调非阻塞的优势。示例代码要简洁，比如获取字符串或JSON对象。
然后是
POST请求，需要包括表单提交
和JSON数据传输。这里要提到设置Content-Type，
使用bodyValue或body
方法。同时，可能需要提到如何添加
请求头，比如设置认证信息，但用户的问题可能暂时不需要太复杂的头设置，不过给出示例更好。
高级配置部分，用户可能需要知道超时设置、拦截器、异常处理等。这些是实际开发中常见的需求，但用户可能没有直接提到，所以需要简要提及，让他们知道有这些功能存在。
另外，用户可能关心错误处理，比如如何处理4xx或5xx响应，需要给出示例，比如onStatus的
使用。SSL忽略虽然不推荐生产
使用，但在测试环境可能有需要，应该包含进去。
最后，总结
使用场景，强调
WebClient适合响应式项目，并推荐深入学习的方向，比如响应式编程
和Spring WebFlux。需要保持语言简洁，示例清晰，避免
使用复杂术语，让新手也能理解。
需要检查是否有遗漏的部分，比如URL参数的处理，是否需要详细说明uriBuilder的
使用？或者在
POST中如何处理multipart
请求？可能用户的问题集中在基本的
GET和POST，所以暂时不深入multipart，但如果有余力可以简要提及，或者作为扩展内容。
确保代码示例正确，比如
使用block()时要提醒在测试或非响应式环境
使用，而实际应用中应避免阻塞。同时，Mono
和Flux的处理需要正确，比如bodyToMono
和bodyToFlux的区别。
可能用户在实际
使用中会遇到常见问题，比如依赖缺失，需要提醒引入正确的starter，如spring-boot-starter-webflux。或者Content-Type未正确设置导致服务器无法解析
请求体，这些在示例中需要注意。
总之，结构要清晰，分步骤讲解，代码示例配合说明，关键点用强调或注释标出，帮助用户快速上手并避免常见错误。</think>以下是 **
WebClient** 的基础
使用详解，包括 **
GET/
POST 请求**的完整代码示例
和关键配置说明。基于 Spring Boot 3.x
和响应式编程模型。
---
### 1. **准备工作**
在 `pom.xml` 中引入依赖（Spring WebFlux）：
```xml
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-webflux</artifactId>
</dependency>
```
---
### 2. **创建
WebClient 实例**
两种常用方式：
```java
// 方式1：直接创建（默认配置）
WebClient client =
WebClient.create();
// 方式2：通过 Builder 自定义（推荐）
WebClient client =
WebClient.builder()
.baseUrl("https://api.example.com") // 统一设置根URL
.defaultHeader(HttpHeaders.CONTENT_TYPE, MediaType.APPLICATION_JSON_VALUE) // 默认
请求头
.build();
```
---
### 3. **
GET 请求示例**
#### **(1) 基础
GET 请求**
```java
// 同步阻塞方式（测试或非响应式场景
使用）
String response = client.
get()
.uri("/users/{id}", 1) // 路径参数
.retrieve() // 发起
请求
.bodyToMono(String.class) // 将响应体转为 Mono<String>
.block(); // 阻塞等待结果
// 异步非阻塞方式（响应式编程推荐）
Mono<String> monoResponse = client.
get()
.uri("/users?name={name}", "Alice") // 查询参数
.retrieve()
.bodyToMono(String.class);
monoResponse.subscribe(result -> System.out.println("异步结果: " + result));
```
#### **(2) 解析为 JSON 对象**
```java
// 定义 DTO 类
public record User(Long id, String name, String email) {}
//
请求并自动反序列化
Mono<User> userMono = client.
get()
.uri("/users/1")
.retrieve()
.bodyToMono(User.class);
userMono.subscribe(user -> System.out.println("用户信息: " + user));
```
---
### 4. **
POST 请求示例**
#### **(1) 提交表单数据**
```java
MultiValueMap<String, String> formData = new LinkedMultiValueMap<>();
formData.add("username", "john");
formData.add("password", "123456");
Mono<String> response = client.
post()
.uri("/login")
.contentType(MediaType.APPLICATION_FORM_URLENCODED)
.bodyValue(formData) // 直接传入表单对象
.retrieve()
.bodyToMono(String.class);
```
#### **(2) 提交 JSON 数据**
```java
User newUser = new User(null, "Bob", "bob@example.com");
Mono<User> createdUser = client.
post()
.uri("/users")
.contentType(MediaType.APPLICATION_JSON)
.bodyValue(newUser) // 自动序列化为 JSON
.retrieve()
.bodyToMono(User.class);
```
#### **(3)
使用 BodyInserter（复杂场景）**
```java
import static org.springframework.web.reactive.function.BodyInserters.*;
Mono<Void> result = client.
post()
.uri("/upload")
.body(fromMultipartData("file", new FileSystemResource("test.txt")))
.retrieve()
.bodyToMono(Void.class);
```
--
### 5. **高级配置**
#### **(1) 设置
请求头**
```java
client.
get()
.uri("/secure-data")
.header(HttpHeaders.AUTHORIZATION, "Bearer token123") // 自定义
请求头
.accept(MediaType.APPLICATION_JSON) // 设置 Accept 头
.retrieve()
// ...
```
#### **(2) 处理响应状态码**
```java
client.
get()
.uri("/data")
.retrieve()
.onStatus(
status -> status.is4xxClientError(), // 处理 4xx 错误
response -> Mono.error(new RuntimeException("客户端错误: " + response.statusCode()))
)
.bodyToMono(String.class);
```
#### **(3) 超时配置**
```java
client.
get()
.uri("/slow-api")
.retrieve()
.bodyToMono(String.class)
.timeout(Duration.ofSeconds(5)) // 设置超时时间
.onErrorResume(TimeoutException.class, e -> Mono.just("Fallback Data"));
```
#### **(4) 启用 SSL 忽略（仅测试环境）**
```java
WebClient client =
WebClient.builder()
.clientConnector(new ReactorClientHttpConnector(
HttpClient.create().secure(ssl -> ssl.sslContext(
SslContextBuilder.forClient().trustManager(InsecureTrustManagerFactory.INSTANCE)
))
))
.build();
```
---
### 6. **完整流程示例**
```java
@SpringBootTest
public class
WebClientDemo {
@Test
void test
GetUser() {
WebClient client =
WebClient.create("https://jsonplaceholder.typicode.com");
User user = client.
get()
.uri("/users/1")
.retrieve()
.bodyToMono(User.class)
.block();
System.out.println("获取用户: " + user);
}
@Test
void testCreate
Post() {
WebClient client =
WebClient.builder()
.baseUrl("https://jsonplaceholder.typicode.com")
.defaultHeader(HttpHeaders.CONTENT_TYPE, MediaType.APPLICATION_JSON_VALUE)
.build();
Post post = new
Post("New Title", "Content...", 1);
Post created
Post = client.
post()
.uri("/
posts")
.bodyValue(
post)
.retrieve()
.bodyToMono(
Post.class)
.block();
System.out.println("创建的
Post: " + created
Post);
}
}
```
---
### **关键总结**
- **
GET 请求**：
使用 `.
get().uri()`，支持路径参数
和查询参数。
- **
POST 请求**：通过 `.bodyValue()` 或 `.body()` 传递数据，需明确指定 Content-Type。
- **响应处理**：`.retrieve()` + `.bodyToMono()`/`.bodyToFlux()` 解析结果。
- **线程模型**：默认基于 Netty 的非阻塞 IO，需配合响应式编程（避免 `block()` 在生产代码中
使用）。
建议结合 Spring WebFlux 官方文档深入理解响应式编程模型：
https://docs.spring.io/spring-framework/reference/web/webflux-
webclient.html
本文介绍如何使用C#的WebClient类实现HTTP GET和POST请求。GET请求通过DownloadData方法获取网页内容，POST请求则通过UploadString方法发送表单数据。文中提供了具体的代码示例。
扫一扫
1310
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
