适用于 Java 的 Amazon SDK 1.x于2025年12月31日达到支撑终止状态。我们建议您迁移到 [Amazon SDK for Java 2.x](https://docs.amazonaws.cn/sdk-for-java/latest/developer-guide/home.html) 以继续获得新功能、可用性改进和安全更新。

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

# SDK 中包含的代码示例
<a name="java-dg-samples"></a>

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

## 如何获取示例
<a name="how-to-get-the-samples"></a>

适用于 Java 的 Amazon SDK代码示例在开发工具包的 *samples* 目录中提供。如果您已使用[设置适用于 Java 的 Amazon SDK](setup-install.md) 中的信息下载并安装 SDK，则您的系统中已包含示例。

您也可以在适用于 Java 的 Amazon SDK GitHub 存储库中查看最新示例（位于 [src/samples](https://github.com/aws/aws-sdk-java/tree/master/src/samples) 目录中）。

## 使用命令行构建并运行示例
<a name="samples-cmdline"></a>

示例包含 [Ant](http://ant.apache.org/) 构建脚本，以便您从命令行轻松构建和运行这些脚本。每个示例还包含一个 HTML 格式的 README 文件，此文件包含每个示例特定的信息。

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

### 先决条件
<a name="prerequisitessamples"></a>

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

### 运行示例
<a name="running-the-samples"></a>

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

   ```
   cd samples/AwsConsoleApp
   ```

1. 使用 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 构建并运行示例
<a name="building-and-running-the-samples-using-the-eclipse-ide"></a>

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

### 先决条件
<a name="id1samples"></a>

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

### 运行示例
<a name="id2"></a>

1. 打开 Eclipse。

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

1. 展开 **Amazon** 类别，然后选择 **Amazon Java 项目**。

1. 选择**下一步**。项目设置页面随即显示。

1. 在 **Project Name** 框中输入名称。适用于 Java 的 Amazon SDK 示例组显示了 SDK 中可用的示例，如前所述。

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

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

1. 选择**完成**。这将创建项目并将其添加到 **Project Explorer**。

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

1. 从 **Run** 菜单中选择 **Run**。

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

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