Java

我们的客户端加密库已重命名为 AWS 数据库加密 SDK。本开发人员指南仍提供有关 DynamoDB 加密客户端的信息。

本主题说明如何安装并使用适用于 DynamoDB 的 Java 客户端加密库的版本 3.x。有关使用适用于 DynamoDB 的 AWS 数据库加密 SDK 进行编程的详细信息，请参阅上的-dynamodb 存储库中的 Java 示例。 aws-database-encryption-sdk GitHub

注意

以下主题重点侧重于适用于 DynamoDB 的 Java 客户端加密库的版本 3.x。

我们的客户端加密库已重命名为 AWS 数据库加密 SDK。 AWS 数据库加密 SDK 继续支持旧版 DynamoDB 加密客户端版本。

主题

• 先决条件
• 安装
• 使用 Java 客户端
• Java 示例
• 将版本 3.x 添加到现有表
• 迁移到版本 3.x

先决条件

在安装适用于 DynamoDB 的 Java 客户端加密库的版本 3.x 之前，请确保满足以下先决条件。

Java 开发环境

您需要使用 Java 8 或更高版本。在 Oracle 网站上，转到 Java SE 下载，然后下载并安装 Java SE Development Kit (JDK)。

如果使用 Oracle JDK，您还必须下载并安装 Java Cryptography Extension (JCE) Unlimited Strength Jurisdiction Policy Files。

AWS SDK for Java 2.x

适用于 DynamoDB 的 AWS 数据库加密 SDK 需要的 Dy namoDB 增强型客户端模块。 AWS SDK for Java 2.x可以安装整个开发工具包或仅安装此模块。

有关更新版本的信息 AWS SDK for Java，请参阅从 1.x 版迁移到 2.x 版。 AWS SDK for Java

可通过 Apache Maven 获得。 AWS SDK for Java 你可以声明整个模块的依赖关系 AWS SDK for Java，也可以只声明dynamodb-enhanced模块的依赖关系。

AWS SDK for Java 使用 Apache Maven 安装

• 要导入整个 AWS SDK for Java以作为依赖项，请在 pom.xml 文件中对其进行声明。

• 要仅为 AWS SDK for Java中的 Amazon DynamoDB 模块创建依赖项，请按照指定特定模块的说明进行操作。将 groupId 设置为 software.amazon.awssdk，并将 artifactID 设置为 dynamodb-enhanced。

  注意

  如果您使用 AWS KMS 密钥环或 AWS KMS 分层密钥环，则还需要为模块创建依赖关系。 AWS KMS 将 groupId 设置为 software.amazon.awssdk，并将 artifactID 设置为 kms。

安装

您可以按以下方式安装适用于 DynamoDB 的 Java 客户端加密库的版本 3.x。

使用 Apache Maven

适用于 Java 的 Amazon DynamoDB Encryption Client 通过 Apache Maven 提供，并具有以下依赖项定义。

<dependency>
  <groupId>software.amazon.cryptography</groupId>
  <artifactId>aws-database-encryption-sdk-dynamodb</artifactId>
  <version>version-number</version>
</dependency>

使用 Gradle Kotlin

通过将以下内容添加到 Gradle 项目的依赖项部分，您可以使用 Gradle 在适用于 Java 的 Amazon DynamoDB Encryption Client 上声明依赖项。

implementation("software.amazon.cryptography:aws-database-encryption-sdk-dynamodb:version-number")

手动方式

要安装适用于 DynamoDB 的 Java 客户端加密库，请克隆或下载-dynamodb 存储库。aws-database-encryption-sdk GitHub

安装 SDK 后，请先查看本指南中的示例代码和上的 aws-database-encryption-sdk-dynamodb 存储库中的 Java 示例。 GitHub