aws sdk java

适用于 Java 的 AWS 开发工具包

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

请参阅适用于 Java 2.x 的 AWS 开发工具包了解如何开始。

自 2024 年 7 月 31 日起处于维护模式

AWS SDK for Java 1.x 处于维护模式。 AWS SDK for Java 1.x 于 2024 年 7 月 31 日进入维护模式，并将于 2025 年 12 月 31 日终止支持。在维护模式期间，AWS 将限制开发工具包的发布，以仅解决关键错误修复和安全问题。 SDK 将不会接收新服务或现有服务的 API 更新，也不会进行更新以支持新区域。

我们建议您迁移到适用于 Java 的 AWS 开发工具包 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 上。

发行说明

CHANGELOG.md 中跟踪从版本 1.12.1（2021 年 6 月）开始对 SDK 的更改。

从版本 1.11.82 开始，已停用的SDK 1.11.x 系列中的更改列在 CHANGELOG-1.11.x.md 文件中。

AWS 入门

使用适用于 Java 2.x 的 AWS 开发工具包开始使用。

使用适用于 Java 1.x 的 AWS 开发工具包

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

最低要求

要运行适用于 Java 1.x 的 AWS 开发工具包，您将需要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.779</ 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 开发工具包的更多信息，请参阅开发人员指南的设置 AWS SDK for Java 1.x 部分。

从源头构建

从 GitHub 查看代码后，您可以使用 Maven 构建它。要在构建中禁用 GPG 签名，请使用：

mvn clean install -Dgpg.skip=true

寻求帮助

GitHub issues 是与我们团队互动的首选渠道。另请查看这些社区资源以获取帮助：

• 在 StackOverflow 上提问并使用aws-java-sdk进行标记
• 在我们的问题页面上阐明您的功能请求或对现有功能请求进行投票
• 查看博客，了解大量有用的演练和提示
• 通过 AWS 控制台中的 AWS 支持中心打开案例
• 如果您发现了错误，请提出问题

SDK主要版本维护与支持

有关开发工具包主要版本及其底层依赖项的维护和支持的信息，请参阅 AWS 开发工具包和工具参考指南中的以下内容：

• AWS 开发工具包和工具维护政策
• AWS 开发工具包和工具版本支持列表

支持的次要版本

• 1.12.x - 处于维护模式。我们建议迁移到适用于 Java 2.x 的 AWS 开发工具包。

• 1.11.x - 不再受支持，但迁移到 1.12.x 不需要更改代码。

适用于 Java 2.x 的 AWS 开发工具包

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