[ 云计算 | AWS 实践 ] 使用 Java 更新现有 Amazon S3 对象

╰半橙微兮° 2024-02-18 12:40 34阅读 0赞

![在这里插入图片描述][b5d16872018147ea9833aac5c189ede9.png]

本文收录于【[\#云计算入门与实践 - AWS][- AWS]】专栏中，收录 AWS 入门与实践相关博文。

本文同步于个人公众号：【**云计算洞察**】

更多关于云计算技术内容敬请关注：CSDN【[\#云计算入门与实践 - AWS][- AWS]】专栏。

本系列已更新博文：

*  [\[ 云计算 | AWS 实践 \] Java 应用中使用 Amazon S3 进行存储桶和对象操作完全指南][_ _ AWS _ _ Java _ Amazon S3]
 *  [\[ 云计算 | AWS 实践 \] Java 如何重命名 Amazon S3 中的文件和文件夹][_ _ AWS _ _ Java _ Amazon S3 1]
 *  [\[ 云计算 | AWS 实践 \] 使用 Java 列出存储桶中的所有 AWS S3 对象][_ _ AWS _ _ _ Java _ AWS S3]
 *  [\[ 云计算 | AWS 实践 \] 使用 Java 更新现有 Amazon S3 对象][_ _ AWS _ _ _ Java _ Amazon S3]

#### 文章目录 ####

*   *  一、前言
     *  二、前期准备
     *   *  2.1 导入Maven 依赖
         *  2.1 准备几个必要信息
     *  三、更新 S3 对象的步骤
     *   *  3.1.初始化 S3 客户端
         *  3.2 将新对象上传到 S3
         *  3.3 上传（覆盖）对象
         *  3.4 验证更新
     *  四、注意事项（重要）
     *  五、文末总结

### 一、前言 ###

Amazon Simple Storage Service（Amazon S3）是一种广泛使用的存储服务，提供了可扩展、安全和持久的对象存储功能。在某些情况下，我们需要更新已存在于 Amazon S3 中的对象。在 S3 中，对象是不可变的，这意味着我们不能直接修改对象的内容。但是，我们可以通过覆盖对象内容的方式来有效地“更新”它。

本篇文章将介绍如何使用 AWS Java SDK，将位于同一 AWS S3 路径下的现有文件内容替换为新内容。

### 二、前期准备 ###

#### 2.1 导入Maven 依赖 ####

首先，我们需要确保AWS SDK Maven依赖包已合并到项目中，让我们创建一个新的 Java 项目并将以下 Maven 依赖项添加到 pom.xml 文件中：

<dependency>
        <groupId>software.amazon.awssdk</groupId>
        <artifactId>s3</artifactId>
        <version>2.21.0</version>
    </dependency>

#### 2.1 准备几个必要信息 ####

要使用AWS SDK，我们需要以下几个要素：

**AWS 帐户**：首先，需要一个Amazon Web Services（AWS）帐户。如果尚未拥有，可直接在 AWS 控制台创建。

**AWS 安全凭证**：这些安全凭证是我们访问 AWS API 操作所需的访问密钥。可通过两种方式获取：使用 AWS 根帐户凭证中的“安全凭证”页面，或在 IAM 控制台中获取 IAM 用户凭证。

**选择AWS区域（Region）**：同时需要选择一个 AWS 区域来存储 Amazon S3 数据。需注意，S3 存储价格因区域不同而异。详细信息可参考官方文档（[点击这里][Link 1]）。

### 三、更新 S3 对象的步骤 ###

#### 3.1.初始化 S3 客户端 ####

首先，我们需要创建客户端连接来访问 Amazon S3 Web 服务。为此，我们将使用 AmazonS3 接口：

> 无论是你怎么写，都要先初始化 S3 客户端对象，之后在进行操作即可，记住这个步骤。

AWSCredentials credentials = new BasicAWSCredentials(
            "AWS AccessKey",
            "AWS secretKey"
    );

然后我们将配置客户端：

AmazonS3 s3client = AmazonS3ClientBuilder.standard()
            .withRegion(Regions.fromName("us-east-1"))
            .withCredentials(new AWSStaticCredentialsProvider(credentials))
            .build();

#### 3.2 将新对象上传到 S3 ####

现在我们可以使用 AWS Java SDK 在方法 putObject() 中将文件上传到 S3 存储桶：

PutObjectRequest request = PutObjectRequest.builder()
        .bucket(bucketName)
        .key(key)
        .build();
    
    return s3Client.putObject(request, Path.of(file.toURI()));

下面是调用上述代码的代码片段：

s3Service.putObject(
        AWS_BUCKET,
        "Document/helloWord.txt",
        new File("/Users/bluetata/Document/helloWord.txt")
    );

#### 3.3 上传（覆盖）对象 ####

由于 S3 中的对象是不可变的，因此“更新”对象涉及用新内容覆盖该对象。因此，为了更新，我们需要使用与添加文档相同的参数集来调用相同的`putObject()`方法：

public PutObjectResponse updateObject(String bucketName, String key, java.io.File file) {
        
        return this.putObject(bucketName, key, file);
    }

此代码将用提供的新内容**替换**现有对象。如果具有给定键的对象不存在，S3 将**创建一个新对象**。

#### 3.4 验证更新 ####

我们可能想要验证对象是否已成功更新。实现此目的的一种方法是检索对象的元数据并检查`lastModified`日期，或者计算对象的校验和并将其与预期值进行比较。

HeadObjectRequest req = HeadObjectRequest.builder()
        .bucket(bucketName)
        .key(key)
        .build();
    
    HeadObjectResponse response = s3Client.headObject(request);
    System.out.println("Last Modified: " + response.lastModified());

### 四、注意事项（重要） ###

需要牢记的是，在 S3 中，覆盖对象实际上是一次`PUT`操作，这可能会导致成本增加。在进行 S3 操作时，请时刻注意成本影响。

如果存储桶启用了版本控制，覆盖对象不会删除旧版本，而是会创建该对象的新版本。因此，我们会拥有对象的多个版本，每个版本都有独特的 ID。在需要时，我们可以检索任何以前的版本。

最后，如果元数据与该对象关联，请注意覆盖该对象将使用 PUT 操作期间提供的新元数据替换旧元数据。如果我们想保留旧的元数据，我们必须在请求中显式设置它。

### 五、文末总结 ###

虽然我们不能直接修改 S3 对象的内容，但是利用适用于 Java 的 AWS 开发工具包，可以轻松地用新内容覆盖对象。务必牢记的是：比如避免硬编码凭据以及了解操作可能带来的成本影响。通过这些步骤，我们能够自信地使用 Java 对 S3 对象进行管理和更新。

文末已经更新了 4 篇关于在 AWS 中各种操作 S3 的博文，希望对你有所帮助，更多博文敬请关注本博客。

[ 本文作者 ]   bluetata
    [ 原文链接 ]   https://bluetata.blog.csdn.net/article/details/134498219
    [ 最后更新 ]   11/20/2023 2:08
    [ 版权声明 ]   如果您在非 CSDN 网站内看到这一行，
    说明网络爬虫可能在本人还没有完整发布的时候就抓走了我的文章，
    可能导致内容不完整，请去上述的原文链接查看原文。

[b5d16872018147ea9833aac5c189ede9.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/18/e2d01a63ec624541b6b5050da72b82e6.png
[- AWS]: https://blog.csdn.net/dietime1943/category_12069924.html
[_ _ AWS _ _ Java _ Amazon S3]: https://bluetata.blog.csdn.net/article/details/132531011
[_ _ AWS _ _ Java _ Amazon S3 1]: https://bluetata.blog.csdn.net/article/details/133980910
[_ _ AWS _ _ _ Java _ AWS S3]: https://bluetata.blog.csdn.net/article/details/134174962
[_ _ AWS _ _ _ Java _ Amazon S3]: https://bluetata.blog.csdn.net/article/details/134498219
[Link 1]: https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/setup-credentials.html