使用Java客户端向Spring Boot服务器发送POST请求（客户端.请求.发送.服务器.Java...）

本文档旨在指导开发者如何使用Java客户端向Spring Boot服务器发送POST请求。文章将首先介绍问题背景，然后提供两种解决方案：一种是使用HttpURLConnection，另一种是使用Java 11引入的HttpClient。我们将详细讲解每种方法的实现步骤，并提供完整的代码示例，帮助开发者快速掌握POST请求的发送方法，并解决Spring Boot服务端无法接收POST请求的问题。

HttpURLConnection 是 Java 标准库中提供的用于进行 HTTP 通信的类。虽然它功能强大，但使用起来相对繁琐。以下是使用 HttpURLConnection 发送 POST 请求的步骤和代码示例：

1. 创建 URL 对象: 使用 Spring Boot 服务器的 URL 创建 URL 对象。

   String url = "http://127.0.0.1:8090/online";
   URL mUrl = new URL(url);

2. 打开连接: 使用 URL 对象的 openConnection() 方法打开一个 HttpURLConnection 连接。

   HttpURLConnection urlConn = (HttpURLConnection) mUrl.openConnection();

3. 设置请求方法: 设置请求方法为 POST。

   urlConn.setRequestMethod("POST");

4. 设置请求头: 设置 Content-Type 请求头，指定请求体的媒体类型。

   urlConn.setRequestProperty("Content-Type", "text/plain; charset=UTF-8");

   注意: Content-Type 非常重要，Spring Boot 才能正确解析请求体。常用的类型包括 application/json (JSON 数据), application/x-www-form-urlencoded (表单数据), 和 text/plain (纯文本数据)。 根据你的 Spring Boot 服务端期望接收的类型来设置。

5. 允许输出: 设置 DoOutput 为 true，允许向服务器发送数据。

   urlConn.setDoOutput(true);

6. 写入请求体: 获取输出流，并将请求体数据写入。

   String query = "Body";
   try (OutputStream os = urlConn.getOutputStream()) {
       byte[] input = query.getBytes(StandardCharsets.UTF_8);
       os.write(input, 0, input.length);
   }

7. 获取响应: 获取响应码，并读取响应内容。

   int responseCode = urlConn.getResponseCode();
   System.out.println("Response Code : " + responseCode);
   
   try (BufferedReader br = new BufferedReader(new InputStreamReader(urlConn.getInputStream(), StandardCharsets.UTF_8))) {
       StringBuilder response = new StringBuilder();
       String responseLine = null;
       while ((responseLine = br.readLine()) != null) {
           response.append(responseLine.trim());
       }
       System.out.println(response.toString());
   }

8. 断开连接: 关闭连接。

   urlConn.disconnect();

完整示例代码：

import java.io.BufferedReader;
import java.io.IOException;
import java.io.InputStreamReader;
import java.io.OutputStream;
import java.net.HttpURLConnection;
import java.net.URL;
import java.nio.charset.StandardCharsets;

public class HttpURLConnectionExample {

    public static void main(String[] args) throws IOException {
        String url = "http://127.0.0.1:8090/online";
        URL mUrl = new URL(url);
        HttpURLConnection urlConn = (HttpURLConnection) mUrl.openConnection();

        urlConn.setRequestMethod("POST");
        urlConn.setRequestProperty("Content-Type", "text/plain; charset=UTF-8");
        urlConn.setDoOutput(true);

        String query = "Body";
        try (OutputStream os = urlConn.getOutputStream()) {
            byte[] input = query.getBytes(StandardCharsets.UTF_8);
            os.write(input, 0, input.length);
        }

        int responseCode = urlConn.getResponseCode();
        System.out.println("Response Code : " + responseCode);

        try (BufferedReader br = new BufferedReader(new InputStreamReader(urlConn.getInputStream(), StandardCharsets.UTF_8))) {
            StringBuilder response = new StringBuilder();
            String responseLine = null;
            while ((responseLine = br.readLine()) != null) {
                response.append(responseLine.trim());
            }
            System.out.println(response.toString());
        }

        urlConn.disconnect();
    }
}

Java 11 引入了新的 HttpClient API，它提供了更简洁、更现代化的方式来发送 HTTP 请求。以下是使用 HttpClient 发送 POST 请求的步骤和代码示例：

1. 创建 HttpClient 对象: 使用 HttpClient.newHttpClient() 创建一个 HttpClient 实例。

   HttpClient client = HttpClient.newHttpClient();

2. 创建 HttpRequest 对象: 使用 HttpRequest.newBuilder() 构建一个 HttpRequest 对象。你需要指定 URL, 请求方法 (POST), 和请求体。

   String url = "http://127.0.0.1:8090/online";
   String query = "Body";
   HttpRequest request = HttpRequest.newBuilder()
           .uri(URI.create(url))
           .header("Content-Type", "text/plain; charset=UTF-8") // 设置 Content-Type
           .POST(HttpRequest.BodyPublishers.ofString(query, StandardCharsets.UTF_8))
           .build();

   注意: 同样，Content-Type 的设置非常重要，需要与 Spring Boot 服务端期望的类型一致。 HttpRequest.BodyPublishers.ofString() 方法用于创建请求体。

3. 发送请求: 使用 HttpClient 的 send() 方法发送请求，并获取响应。

   HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());

   HttpResponse.BodyHandlers.ofString() 指定响应体的内容类型为 String。

4. 处理响应: 获取响应状态码和响应体。

   System.out.println("Response Status Code: " + response.statusCode());
   System.out.println("Response Body: " + response.body());

完整示例代码：

import java.io.IOException;
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.nio.charset.StandardCharsets;

public class HttpClientExample {

    public static void main(String[] args) throws IOException, InterruptedException {
        HttpClient client = HttpClient.newHttpClient();
        String url = "http://127.0.0.1:8090/online";
        String query = "Body";

        HttpRequest request = HttpRequest.newBuilder()
                .uri(URI.create(url))
                .header("Content-Type", "text/plain; charset=UTF-8")
                .POST(HttpRequest.BodyPublishers.ofString(query, StandardCharsets.UTF_8))
                .build();

        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());

        System.out.println("Response Status Code: " + response.statusCode());
        System.out.println("Response Body: " + response.body());
    }
}

确保你的 Spring Boot 服务端能够正确接收 POST 请求。以下是一个简单的示例：

import org.springframework.http.HttpStatus;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class MessageService {

    @PostMapping(path = "/online", consumes = "text/plain") // 指定 consumes
    public ResponseEntity<?> getResponse(@RequestBody String requestBody){
        System.out.println("Post Recieved: " + requestBody);
        return new ResponseEntity<>("Received: " + requestBody, HttpStatus.OK);
    }
}

关键点:

• @PostMapping 注解: 使用 @PostMapping 注解来处理 POST 请求。
• path 属性: 设置 path 属性来指定请求路径。
• consumes 属性: 设置 consumes 属性来指定服务端能够处理的 Content-Type。 确保它与客户端发送的 Content-Type 一致。 在这个例子中，我们指定 consumes = "text/plain"，表示服务端期望接收纯文本数据。
• @RequestBody 注解: 使用 @RequestBody 注解来接收请求体数据。

• Content-Type 匹配: 确保客户端发送的 Content-Type 与 Spring Boot 服务端 consumes 属性指定的类型匹配。这是最常见的问题原因。
• 字符编码: 在发送和接收数据时，始终指定字符编码 (例如 UTF-8)，以避免乱码问题。
• 依赖: 如果使用 HttpClient，请确保你的项目使用了 Java 11 或更高版本。
• 异常处理: 在实际应用中，需要添加适当的异常处理代码，以处理网络连接、IO 错误等问题。
• 调试: 使用网络抓包工具 (例如 Wireshark) 可以帮助你分析 HTTP 请求和响应，从而更好地调试问题。

通过本文档的学习，你应该能够使用 Java 客户端成功向 Spring Boot 服务器发送 POST 请求。 选择 HttpURLConnection 或 HttpClient 取决于你的项目需求和 Java 版本。 HttpClient 提供了更简洁的 API，推荐在 Java 11+ 环境中使用。 记住，确保 Content-Type 匹配是解决问题的关键。

以上就是使用Java客户端向Spring Boot服务器发送POST请求的详细内容，更多请关注知识资源分享宝库其它相关文章！