AWS SDK for Java 2.x 操作 Amazon S3 完全指南

解然嫚Keegan

于 2025-06-04 09:09:53 发布

阅读量373

点赞数 3

CC 4.0 BY-SA版权

本文链接：https://blog.youkuaiyun.com/gitblog_00071/article/details/148416993

AWS SDK for Java 2.x 操作 Amazon S3 完全指南

aws-doc-sdk-examples Welcome to the AWS Code Examples Repository. This repo contains code examples used in the AWS documentation, AWS SDK Developer Guides, and more. For more information, see the Readme.md file below. 项目地址: https://gitcode.com/gh_mirrors/aw/aws-doc-sdk-examples

概述

Amazon Simple Storage Service (Amazon S3) 是 AWS 提供的对象存储服务，可用于存储和检索任意数量的数据。本文将详细介绍如何使用 AWS SDK for Java 2.x 来操作 Amazon S3 服务。

重要提示

在使用这些代码示例前，请注意以下几点：

费用问题：运行这些代码可能会产生 AWS 服务费用，建议在测试时使用 AWS 免费套餐。
权限控制：遵循最小权限原则，只授予代码执行任务所需的最小权限。
区域限制：某些 AWS 服务并非在所有区域都可用，请确认您使用的区域支持相关服务。

环境准备

在开始之前，请确保：

已安装 Java 开发环境（JDK 8 或更高版本）
已配置 AWS 凭证和默认区域
已在项目中添加 AWS SDK for Java 2.x 依赖

基础操作示例

1. 创建 S3 客户端

S3Client s3 = S3Client.builder()
    .region(Region.US_EAST_1)
    .build();

2. 列出所有存储桶

ListBucketsResponse response = s3.listBuckets();
response.buckets().forEach(bucket -> {
    System.out.println(bucket.name());
});

3. 创建存储桶

CreateBucketRequest request = CreateBucketRequest.builder()
    .bucket("my-unique-bucket-name")
    .build();
s3.createBucket(request);

进阶操作指南

文件上传与下载

上传文件

PutObjectRequest putOb = PutObjectRequest.builder()
    .bucket(bucketName)
    .key(objectKey)
    .build();
s3.putObject(putOb, RequestBody.fromFile(new File(filePath)));

下载文件

GetObjectRequest getOb = GetObjectRequest.builder()
    .bucket(bucketName)
    .key(objectKey)
    .build();
ResponseBytes<GetObjectResponse> objectBytes = s3.getObjectAsBytes(getOb);
byte[] data = objectBytes.asByteArray();

大文件分块上传

对于大文件，建议使用分段上传：

UploadFileRequest uploadFileRequest = UploadFileRequest.builder()
    .source(Paths.get(filePath))
    .bucket(bucketName)
    .key(objectKey)
    .build();
s3TransferManager.uploadFile(uploadFileRequest);

实用场景实现

1. 检查存储桶是否存在

boolean exists = s3.listBuckets().buckets().stream()
    .anyMatch(b -> b.name().equals(bucketName));

2. 删除不完整的分段上传

ListMultipartUploadsRequest listRequest = ListMultipartUploadsRequest.builder()
    .bucket(bucketName)
    .build();
ListMultipartUploadsResponse listResponse = s3.listMultipartUploads(listRequest);

listResponse.uploads().forEach(upload -> {
    AbortMultipartUploadRequest abortRequest = AbortMultipartUploadRequest.builder()
        .bucket(bucketName)
        .key(upload.key())
        .uploadId(upload.uploadId())
        .build();
    s3.abortMultipartUpload(abortRequest);
});

3. 生成预签名 URL

GetUrlPresignRequest presignRequest = GetUrlPresignRequest.builder()
    .signatureDuration(Duration.ofMinutes(10))
    .getObjectRequest(getOb)
    .build();
URL url = presigner.presignGetObject(presignRequest).url();