Java 代码示例 - Amazon DynamoDB
Java：设置 AWS 凭证Java：设置 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 菜单中，依次选择文件、新建和其他。

  4. 在选择向导中，依次选择 AWS、AWS Java 项目和下一步。

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

    1. 在项目名称中输入项目名称。

    2. 在选择账户中，从列表中选择凭证配置文件。

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

  6. 选择完成创建项目。

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

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

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

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

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

有关更多信息，请参见 AWS SDK for Java。

注意

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

如果使用 AWS Toolkit for Eclipse，则可以为 SDK for Java 配置自动更新。要在 Eclipse 中进行此操作，转到首选项，选择 AWS Toolkit、AWS SDK for Java、自动下载新 SDK。

Java：设置 AWS 凭证

SDK for Java 要求在运行时为应用程序提供 AWS 凭证。本指南中的代码示例假设您使用 AWS 凭证文件，如《AWS SDK for Java开发人员指南》中的设置 AWS 凭证所述。

下面是一个名为 ~/.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 运行代码。有关完整列表，请参阅《Amazon Web Services 一般参考》中的 AWS 区域和终端节点。

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

AWS SDK V1

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

AWS SDK V2

DynamoDbClient client = DynamoDbClient.builder()
    .endpointOverride(URI.create("http://localhost:8000"))
    // The region is meaningless for local DynamoDb but required for client builder validation
    .region(Region.US_EAST_1)
    .credentialsProvider(StaticCredentialsProvider.create(
    AwsBasicCredentials.create("dummy-key", "dummy-secret")))
    .build();