Java 代码示例 - Amazon DynamoDB
Java: 设置 AWS 凭证Java: 设置 AWS 区域和终端节点
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅中国的 AWS 服务入门。

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

Java 代码示例

本开发人员指南中包含 Java 代码段以及可现成运行的程序。您可以在以下各章节中找到这些代码示例：

您可以通过结合使用 Eclipse 和 AWS Toolkit for Eclipse 来实现快速入门。除功能全面的 IDE 之外，您还获得带自动更新的AWS SDK for Java和预置模板来构建 AWS 应用程序。

运行 Java 代码示例（使用 Eclipse）

  1. 下载并安装 Eclipse IDE。

  2. 下载并安装AWS Toolkit for Eclipse。

  3. 启动 Eclipse，然后在 Eclipse 菜单中，依次选择 File (文件)、New (新建) 和 Other (其他)。

  4. 在 Select a wizard (选择向导) 中，依次选择 AWS、AWS Java Project (AWS Java 项目) 和 Next (下一步)。

  5. 在 Create an AWS Java (创建 AWS Java) 中，执行以下操作：

    1. 在 Project name (项目名称) 中，输入您的项目的名称。

    2. 在 Select Account (选择账户) 中，从列表中选择您的凭证配置文件。

      如果这是您首次使用 AWS Toolkit for Eclipse，请选择 Configure AWS Accounts (配置 AWS 账户) 以设置您的 AWS 凭证。

  6. 选择 Finish (完成) 以创建项目。

  7. 从 Eclipse 菜单中，依次选择 File (文件)、New (新建) 和 Class (类)。

  8. 在 Java Class (Java 类) 的 Name (名称) 中输入类名（使用与您要运行的代码示例相同的名称），然后选择 Finish (完成) 以创建该类。

  9. 将文档页中的代码示例复制到 Eclipse 编辑器中。

  10. 要运行代码，请在 Eclipse 菜单中选择 Run (运行)。

适用于 Java 的开发工具包提供线程安全的客户端来处理 DynamoDB。您的应用程序应创建一个客户端并在线程之间重复使用此客户端，您应将此作为一项最佳实践。

有关更多信息，请参阅适用于 Java 的 AWS 开发工具包。

注意

本指南中的代码示例旨在用于最新版本的AWS SDK for Java。

如果您使用的是 AWS Toolkit for Eclipse，则可以为适用于 Java 的开发工具包配置自动更新。要在 Eclipse 中执行此操作，请转到 Preferences （首选项），然后依次选择 AWS Toolkit、AWS SDK for Java （适用于 Java 的 AWS 开发工具包） 和 Download new SDKs automatically （自动下载新 AWS Toolkit）。

Java: 设置 AWS 凭证

适用于 Java 的开发工具包要求您在运行时向应用程序提供 AWS 凭证。本指南中的代码示例假定您使用 AWS 凭证文件，如 https://docs.amazonaws.cn/sdk-for-java/v1/developer-guide/set-up-creds.html 中的设置 AWS 凭证AWS SDK for Java Developer Guide中所述。

下面是一个名为 ~/.aws/credentials 的 AWS 凭证文件示例，其中波形符 (~) 代表您的主目录。 

[default]
aws_access_key_id = AWS access key ID goes here
aws_secret_access_key = Secret key goes here

Java: 设置 AWS 区域和终端节点

默认情况下，代码示例访问美国西部（俄勒冈）区域中的 DynamoDB。您可以通过修改 AmazonDynamoDB 属性来更改区域。

下面的代码示例用于实例化新的 AmazonDynamoDB。 

import com.amazonaws.services.dynamodbv2.AmazonDynamoDBClientBuilder;
import com.amazonaws.regions.Regions;
...
// This client will default to US West (Oregon)
AmazonDynamoDB client = AmazonDynamoDBClientBuilder.standard()
.withRegion(Regions.US_WEST_2)
.build();

您可以使用 withRegion 方法对任何区域中的 DynamoDB 运行您的代码。有关完整列表，请参阅 https://docs.amazonaws.cn/general/latest/gr/rande.html#ddb_region 中的 AWS 区域和终端节点Amazon Web Services 一般参考。

如果要使用计算机本地的 DynamoDB 运行代码示例，请按如下方式设置终端节点。


AmazonDynamoDB client = AmazonDynamoDBClientBuilder.standard().withEndpointConfiguration(
new AwsClientBuilder.EndpointConfiguration("http://localhost:8000", "us-west-2"))
.build();