AWS SDK for Java

AWS SDK for Java 使 Java 开发者能够轻松使用 Amazon Web Services 并构建可扩展的解决方案，涵盖 Amazon S3、Amazon DynamoDB、Amazon Glacier 等。

请参阅 AWS SDK for Java 2.x 了解如何开始。

自 2024 年 7 月 31 日起进入维护模式

AWS SDK for Java 1.x 已进入维护模式。AWS SDK for Java 1.x 于 2024 年 7 月 31 日进入维护模式，并将于 2025 年 12 月 31 日停止支持。在维护期间，AWS 将仅发布针对关键错误修复和安全问题的 SDK 更新。该 SDK 将不会接收新服务或现有服务的 API 更新，也不会更新以支持新的区域。

我们建议您迁移到 AWS SDK for Java 2.x。AWS SDK for Java 2.x 提供了改进的功能、增强的性能以及来自 AWS 的持续支持。通过采用最新版本的 SDK，开发者可以确保其在 AWS 上解决方案的安全性、兼容性和稳定性。更新还使您能够利用 AWS 的最新服务和创新。

2025 年 12 月 31 日停止支持

AWS SDK for Java 1.x 将于 2025 年 12 月 31 日停止支持。停止支持后，AWS 将不再接收更新或发布新版本。先前发布的版本将继续通过公共包管理器提供，代码将继续保留在 GitHub 上。

发布说明

从版本 1.12.1（2021 年 6 月）开始的 SDK 变更记录在 CHANGELOG.md 中。

已退役的 1.11.x 系列 SDK 中从版本 1.11.82 开始的变更列在 CHANGELOG-1.11.x.md 文件中。

开始使用 AWS

使用 AWS SDK for Java 2.x 开始使用。

使用 AWS SDK for Java 1.x

AWS SDK for Java 1.x 已进入维护模式，因此我们建议您使用 AWS SDK for Java 2.x。

最低要求

要运行 AWS SDK for Java 1.x，您需要 Java 1.8+。有关 SDK 的要求和最佳设置的更多信息，请参阅开发者指南中的安装 Java 开发环境部分。

安装 1.x SDK

您可以通过 Maven 在项目中使用 AWS SDK for Java 1.x。导入 aws-java-sdk-bom 并在依赖项中指定项目所需的 SDK Maven 模块。

导入 1.x BOM

<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>com.amazonaws</groupId>
      <artifactId>aws-java-sdk-bom</artifactId>
      <version>1.12.788</version>
      <type>pom</type>
      <scope>import</scope>
    </dependency>
  </dependencies>
</dependencyManagement>

使用 1.x SDK Maven 模块

<dependencies>
  <dependency>
    <groupId>com.amazonaws</groupId>
    <artifactId>aws-java-sdk-ec2</artifactId>
  </dependency>
  <dependency>
    <groupId>com.amazonaws</groupId>
    <artifactId>aws-java-sdk-s3</artifactId>
  </dependency>
  <dependency>
    <groupId>com.amazonaws</groupId>
    <artifactId>aws-java-sdk-dynamodb</artifactId>
  </dependency>
</dependencies>

有关通过其他方式安装 1.x SDK 的更多信息，请参阅开发者指南中的设置 AWS SDK for Java 1.x 部分。

从源码构建

从 GitHub 检出代码后，您可以使用 Maven 进行构建。要禁用构建中的 GPG 签名，请使用：

mvn clean install -Dgpg.skip=true

获取帮助

GitHub issues 是与我们团队互动的最佳渠道。此外，还可以查看以下社区资源以获取帮助：

在 StackOverflow 上提问，并添加标签 aws-java-sdk
在我们的 Issues 页面上提出功能请求或为现有请求投票
查看 blog 获取大量有用的教程和技巧
通过 AWS 控制台中的 AWS Support Center 打开工单
如果发现可能是一个 bug，请提交一个 issue

SDK 主版本的维护和支持

有关 SDK 主版本及其底层依赖项的维护和支持信息，请参阅 AWS SDKs and Tools 参考指南中的以下内容：

支持的次要版本

1.12.x - 处于维护模式。我们建议迁移到 AWS SDK for Java 2.x。
1.11.x - 不再受支持，但迁移到 1.12.x 应该不需要更改代码。

AWS SDK for Java 2.x

SDK 的 2.x 版本已正式发布。它是对 1.x 代码库的重大重写，基于 Java 8+ 构建，并添加了几个经常请求的功能。这些包括支持非阻塞 I/O、改进的启动性能、自动迭代分页响应以及在运行时插入不同 HTTP 实现的能力。

更多信息请参阅 AWS SDK for Java 2.x 开发者指南，或查看项目仓库 https://github.com/aws/aws-sdk-java-v2。

Java 版本的维护和支持

AWS SDK for Java 1.x 支持 Java 8 到 17 版本，但可能不会更新以支持未来的 Java 版本。为了确保与最新 JDK 版本的长期兼容性，我们建议您迁移到 AWS SDK for Java 2.x。

aws__aws-sdk-java_CVE-2022-31159_1-12-2600

最受欢迎