如何在 Java 9 中利用 HttpClient 发送 multipart/form-data 请求？

2024-03-07 12:37:37

利用 Java 9 HttpClient 发送 multipart/form-data 请求

导言

当涉及到文件上传和同时提交文件和文本数据时，multipart/form-data 请求发挥着至关重要的作用。在这篇文章中，我们将深入探究如何在 Java 9 中使用 HttpClient 发送 multipart/form-data 请求，以满足你的开发需求。

了解 HttpClient

Java 9 引入了 HttpClient，它是一个强大的 API，取代了过时的 HttpURLConnection API。HttpClient 提供了更现代、更友好的界面，用于处理 HTTP 请求和响应。

构造 multipart/form-data 请求

发送 multipart/form-data 请求涉及以下步骤：

1. 创建 HttpClient 实例：

HttpClient client = HttpClient.newHttpClient();

2. 构建 HttpRequest：

HttpRequest request = HttpRequest.newBuilder(new URI("http://example.com/upload"))
    .POST(HttpRequest.BodyProcessor.fromString("foo"))
    .POST(HttpRequest.BodyProcessor.fromFile(Paths.get("/path/to/file")))
    .build();

在上面的代码中，我们创建了一个 POST 请求，并通过 BodyProcessor.fromString 和 BodyProcessor.fromFile 添加了两个部分。第一个部分是一个文本字段，而第二个部分是一个文件上传。

3. 发送请求并获取响应：

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

设置参数名称

在 HttpClient 中，multipart/form-data 参数的名称通过 Content-Disposition 头部指定。对于文本字段，名称设置为 name 属性，而对于文件上传，名称设置为 filename 属性。

在上面的示例中，文本字段的名称为 "foo"，文件上传的名称由文件名 "file" 给定。

示例代码

以下代码演示了如何发送一个 multipart/form-data 请求来上传文件：

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.file.Path;
import java.nio.file.Paths;

public class HttpClientMultipartForm {

    public static void main(String[] args) throws IOException, InterruptedException {
        // 创建 HttpClient 实例
        HttpClient client = HttpClient.newHttpClient();

        // 创建 multipart/form-data 请求
        HttpRequest request = HttpRequest.newBuilder(new URI("http://example.com/upload"))
                .POST(HttpRequest.BodyProcessor.fromString("foo"))
                .POST(HttpRequest.BodyProcessor.fromFile(Paths.get("/path/to/file")))
                .build();

        // 发送请求并获取响应
        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());

        // 打印响应
        System.out.println(response.body());
    }
}