SDK 中包含的代码示例 - AWS SDK for Java 1.x
如何获取示例使用命令行构建并运行示例使用 Eclipse IDE 构建并运行示例

自2024年7月31日起， AWS SDK for Java 1.x已进入维护模式，并将于2025年12月31日end-of-support上线。我们建议您迁移到AWS SDK for Java 2.x以继续接收新功能、可用性改进和安全更新。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

SDK 中包含的代码示例

AWS SDK for Java 附带代码示例，这些示例在可构建且可运行的程序中演示了该开发工具包的许多功能。您可以学习或修改这些程序，以使用AWS SDK for Java 实现您自己的 AWS 解决方案。

如何获取示例

AWS SDK for Java代码示例在开发工具包的 samples 目录中提供。如果您已使用设置AWS SDK for Java 中的信息下载并安装 SDK，则您的系统中已包含示例。

您也可以在AWS SDK for Java GitHub 存储库中查看最新示例（位于 src/samples 目录中）。

使用命令行构建并运行示例

示例包含 Ant 构建脚本，以便您从命令行轻松构建和运行这些脚本。每个示例还包含一个 HTML 格式的 README 文件，此文件包含每个示例特定的信息。

注意

如果您浏览 GitHub 上的代码示例，请在查看示例的 README.html 文件时单击源代码显示中的 Raw (原始) 按钮。在原始模式中，HTML 将在浏览器中按预期方式呈现。

先决条件

在运行任何AWS SDK for Java 示例之前，您需要在环境中或使用 AWS CLI 设置 AWS 凭证，如设置用于开发的 AWS 凭证和区域中所述。这些示例使用默认凭证提供程序链 (如果可能)。因此，您可以通过此方式设置凭证以消除将 AWS 凭证插入源代码目录中的文件（可能无意中签入并公开共享这些凭证）的有风险的实践。

运行示例

  1. 对包含示例代码的目录所做的更改。例如，如果您在 AWS SDK 下载的根目录中，并且希望运行 AwsConsoleApp 示例，则可键入：

    cd samples/AwsConsoleApp

  2. 使用 Ant 构建和运行示例。默认构建目标将执行这两项操作，您只需输入：

    ant

该示例将信息打印到标准输出，例如：

===========================================

Welcome to the {AWS} Java SDK!

===========================================
You have access to 4 Availability Zones.

You have 0 {EC2} instance(s) running.

You have 13 Amazon SimpleDB domain(s) containing a total of 62 items.

You have 23 {S3} bucket(s), containing 44 objects with a total size of 154767691 bytes.

使用 Eclipse IDE 构建并运行示例

如果您使用 AWS Toolkit for Eclipse，也可以基于AWS SDK for Java在 Eclipse 中启动新项目或将该开发工具包添加到现有 Java 项目。

先决条件

在安装 AWS Toolkit for Eclipse 后，建议您使用安全凭证配置此工具包。您可以随时通过以下方式执行此操作：从 Eclipse 中的窗口菜单选择首选项，然后选择 AWS Toolkit 部分。

运行示例

  1. 打开 Eclipse。

  2. 创建新的 AWS Java 项目。在 Eclipse 中的 File 菜单上，选择 New，然后单击 Project。New Project 向导随即打开。

  3. 展开 AWS 类别，然后选择 AWS Java 项目。

  4. 选择 Next（下一步）。项目设置页面随即显示。

  5. 在 Project Name 框中输入名称。AWS SDK for Java 示例组显示了 SDK 中可用的示例，如前所述。

  6. 通过选中每个复选框，选择要包含在项目中的示例。

  7. 输入 AWS 凭证。如果您已使用您的凭证配置 AWS Toolkit for Eclipse，则将自动填入该凭证。

  8. 选择 Finish (结束)。这将创建项目并将其添加到 Project Explorer。

  9. 选择要运行的示例 .java 文件。例如，对于 Amazon S3 示例，选择 S3Sample.java。

  10. 从 Run 菜单中选择 Run。

  11. 右键单击 Project Explorer 中的项目，指向 Build Path，然后选择 Add Libraries。

  12. 选择 AWS Java SDK，然后选择下一步，并按照其余的屏幕说明执行操作。