AWS SDK for Java V2 新增 S3 预签名 HEAD 请求支持

在 AWS SDK for Java V2 2.31.66 版本中，开发团队新增了对 S3 预签名 HEAD 请求的支持。这一功能完善了 SDK 对 S3 预签名 URL 的全面支持，使开发者能够生成用于 HEAD 操作的预签名 URL。

预签名 URL 的背景

预签名 URL 是 AWS S3 服务中一项重要功能，它允许开发者生成带有临时访问权限的 URL。这些 URL 可以在不暴露 AWS 凭证的情况下，让客户端直接访问 S3 资源。在之前的版本中，SDK 已经支持 GET、PUT、POST 和 DELETE 操作的预签名 URL，但 HEAD 操作的缺失给某些特定场景带来了不便。

HEAD 请求的典型应用场景

HEAD 请求在 S3 操作中有几个关键用途：

1. 文件元数据检查：客户端可以先通过 HEAD 请求获取文件的基本信息（如大小、类型等），再决定是否进行完整下载
2. 文件存在性验证：在不下载整个文件的情况下确认对象是否存在
3. 分块下载准备：在进行分块下载前获取文件总大小以规划下载策略
4. 预检检查：在正式 GET 请求前确认资源是否可用

新功能使用示例

以下是使用新功能的典型代码示例：

// 创建 S3 预签名器
S3Presigner presigner = S3Presigner.create();

// 生成预签名 HEAD 请求
PresignedHeadObjectRequest presigned = presigner.presignHeadObject(r -> r
    .signatureDuration(Duration.ofMinutes(30))
    .headObjectRequest(hor -> hor
        .bucket("my-bucket")
        .key("my-object-key")));

// 使用 HTTP 客户端执行请求
SdkHttpClient httpClient = ApacheHttpClient.builder().build();
HttpExecuteRequest request = HttpExecuteRequest.builder()
    .request(presigned.httpRequest())
    .build();

// 获取响应并提取内容长度
HttpExecuteResponse response = httpClient.prepareRequest(request).call();
String contentLength = response.httpResponse()
    .firstMatchingHeader("Content-Length")
    .orElse("0");

技术实现要点

1. 签名机制：预签名 URL 的生成过程与签名算法与其他方法类似，但专门针对 HEAD 方法进行了适配
2. 有效期控制：与其他预签名 URL 一样，可以设置有效期限
3. 请求参数：支持所有标准的 HeadObjectRequest 参数
4. 安全性：保持了与其他预签名 URL 相同的安全级别

迁移建议

对于从 V1 SDK 迁移的用户，现在可以完整地将 HEAD 预签名 URL 生成逻辑迁移到 V2 版本。新 API 的设计保持了与现有预签名 API 的一致性，使得迁移过程更加顺畅。

这一功能的加入标志着 AWS SDK for Java V2 在 S3 预签名 URL 功能上的完善，为开发者提供了更全面的工具集来处理各种 S3 访问场景。