如何为AmazonHttpClient添加Multipart请求能力？

我完全懂你的感受——用Apache HttpClient的CloseableHttpClient加MultipartEntityBuilder发Multipart请求驾轻就熟，但换到AWS的AmazonHttpClient就卡壳了，而且ChatGPT给的混合方案还不好使，确实头疼。

其实AmazonHttpClient本身没有封装现成的Multipart构建工具，但我们可以借助你熟悉的Apache工具来生成请求体，再适配到AWS的客户端里，步骤很清晰：

核心思路 #

AmazonHttpClient的RequestExecutionBuilder允许我们直接设置请求体字节和Content-Type头，所以我们可以用MultipartEntityBuilder先构建好Multipart内容，再把它转换成字节数组和正确的Content-Type（包含boundary），然后交给AWS客户端发送。

具体实现步骤 #

1. 用Apache工具构建Multipart请求体 #

既然你已经熟悉Apache的API，直接复用它来生成Multipart内容：

import org.apache.http.entity.mime.MultipartEntityBuilder;
import org.apache.http.entity.ContentType;
import org.apache.http.HttpEntity;
import java.io.ByteArrayOutputStream;
import java.io.File;
import java.io.IOException;

// 构建Multipart实体，添加文本字段和文件
MultipartEntityBuilder multipartBuilder = MultipartEntityBuilder.create();
multipartBuilder.addTextBody("description", "这是一个测试文件", ContentType.TEXT_PLAIN);
multipartBuilder.addBinaryBody(
    "attachment",
    new File("/path/to/your/file.jpg"),
    ContentType.IMAGE_JPEG,
    "test.jpg"
);

HttpEntity multipartEntity = multipartBuilder.build();

// 将实体转换成字节数组，并获取带boundary的Content-Type
ByteArrayOutputStream baos = new ByteArrayOutputStream();
try {
    multipartEntity.writeTo(baos);
} catch (IOException e) {
    // 处理IO异常
    throw new RuntimeException("构建Multipart内容失败", e);
}
byte[] multipartBody = baos.toByteArray();
String contentTypeHeader = multipartEntity.getContentType().getValue();

2. 用AmazonHttpClient发送请求 #

接下来把上面生成的内容适配到AWS客户端中，注意要设置正确的请求方法（Multipart一般用POST）、端点、Content-Type和请求体：

import software.amazon.awssdk.http.HttpMethodName;
import software.amazon.awssdk.http.SdkHttpFullRequest;
import software.amazon.awssdk.http.apache.ApacheHttpClient;
import java.nio.ByteBuffer;
import java.io.InputStream;
import java.io.IOException;

// 初始化AmazonHttpClient（根据你的需求配置凭据、代理等）
ApacheHttpClient awsHttpClient = ApacheHttpClient.create();

// 构建请求执行器
var requestBuilder = awsHttpClient.requestExecutionBuilder()
        // 设置请求方法和AWS服务端点
        .request(SdkHttpFullRequest.builder()
                .method(HttpMethodName.POST)
                .uri("https://your-aws-service-endpoint.com/api/upload")
                .build())
        // 设置Content-Type头（必须包含boundary，从Apache实体获取的就没问题）
        .contentType(contentTypeHeader)
        // 设置Multipart请求体字节
        .body(ByteBuffer.wrap(multipartBody));

// 执行请求并处理响应
try (var response = requestBuilder.execute()) {
    InputStream responseStream = response.responseBody();
    // 这里可以读取响应内容，比如转换成字符串或者解析成JSON
    // ... 你的响应处理逻辑
} catch (IOException e) {
    // 处理请求异常
    e.printStackTrace();
}

关键注意事项 #

• 不要混合客户端：AmazonHttpClient和Apache的CloseableHttpClient是两个独立的HTTP客户端实现，不能直接把Apache的请求对象传给AWS客户端，必须手动转换请求体和头。
• 签名一致性：AmazonHttpClient会自动处理AWS请求签名，只要你正确设置了请求方法、URI、头和体，签名就会正常工作，不用额外处理。
• 服务特定优化：如果是向AWS的特定服务（比如S3上传文件），其实AWS SDK有更专用的API（比如S3的PutObjectRequest），但如果是自定义的Multipart请求到AWS服务，上面的方法完全适用。

备注：内容来源于stack exchange，提问作者Gonzo