Java 代码示例 - Amazon DynamoDB
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

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

Java 代码示例

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

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

运行 Java 代码示例(使用 Eclipse)
  1. 下载并安装 Eclipse IDE。

  2. 下载并安装 Amazon Toolkit for Eclipse

  3. 启动 Eclipse,然后在 Eclipse 菜单中,依次选择文件新建其他

  4. 选择向导中,依次选择 AmazonAmazon Java 项目下一步

  5. 创建 Amazon Java 中,执行以下操作:

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

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

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

  6. 选择完成创建项目。

  7. Eclipse 菜单中,依次选择文件新建

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

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

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

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

有关更多信息,请参见 Amazon SDK for Java

注意

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

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

Java:设置 Amazon 凭证

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

下面是一个名为 ~/.aws/credentials 的 Amazon 凭证文件示例,其中波浪号字符 (~) 表示主目录。

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

Java:设置 Amazon 区域和端点

代码示例默认访问美国西部(俄勒冈)区域的 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 一般参考》中的 Amazon 区域和终端节点

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

Amazon SDK V1

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

Amazon 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();