开发工具包附带的代码示例 - 适用于 Java 的 AWS 开发工具包
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

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

开发工具包附带的代码示例

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

如何获取示例

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

您还可以在 AWS SDK for Java GitHub 存储库上的 src/samples 目录中查看最新示例。

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

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

注意

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

Prerequisites

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

运行示例

从命令行运行示例

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

    cd samples/AwsConsoleApp
  2. 使用 Ant 构建和运行示例。默认构建目标将执行这两项操作,您只需输入:

    ant

该示例将信息打印到标准输出 — 例如:

=========================================== Welcome to the AWS Java SDK! =========================================== You have access to 4 Availability Zones. You have 0 Amazon EC2 instance(s) running. You have 13 Amazon SimpleDB domain(s) containing a total of 62 items. You have 23 Amazon 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 项目。

Prerequisites

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

运行示例

使用 AWS Toolkit for Eclipse 运行示例

  1. 打开 Eclipse。

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

  3. 展开 AWS 类别,然后选择 AWS Java Project

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

  5. Project Name 框中输入名称。适用于 Java 的 AWS 开发工具包示例组显示该开发工具包中可用的示例,如前所述。

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

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

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

运行项目

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

  2. Run 菜单中选择 Run

将开发工具包添加到现有项目

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

  2. 选择 AWS Java SDK,然后选择 Next,并按照其余的屏幕说明执行操作。