Java

我們的用戶端加密程式庫已重新命名為 AWS 資料庫加密 SDK。此開發人員指南仍提供有關 DynamoDB 加密用戶端的資訊。

本主題說明如何安裝和使用適用於 DynamoDB 的 Java 用戶端加密程式庫 3.x 版。如需使用適用於 DynamoDB 的 AWS 資料庫加密開發套件進行程式設計的詳細資訊，請參閱 GitHub 上 aws-database-encryption-sdk-dynamodb 儲存庫中的 Java 範例。

注意

下列主題著重於 DynamoDB 的 Java 用戶端加密程式庫 3.x 版。

我們的用戶端加密程式庫已重新命名為 AWS 資料庫加密 SDK。 AWS Database Encryption SDK 繼續支援舊版 DynamoDB Encryption Client 版本。

主題

• 先決條件

• 安裝

• 使用 Java 用戶端

• Java 範例

• 將 3.x 版新增至現有資料表

• 遷移至 3.x 版

先決條件

在為 DynamoDB 安裝 Java 用戶端加密程式庫的 3.x 版之前，請確定您有下列先決條件。

Java 開發環境

您會需要 Java 8 或更新版本。在 Oracle 網站上，移至 Java SE 下載，然後下載並安裝 Java SE 開發套件 (JDK)。

如果您使用 Oracle JDK，您還必須下載並安裝 Java Cryptography Extension (JCE) Unlimited Strength 管轄權政策檔案。

AWS SDK for Java 2.x

適用於 DynamoDB 的 AWS 資料庫加密 SDK 需要 的 DynamoDB 增強型用戶端模組 AWS SDK for Java 2.x。您可以安裝整個 SDK 或只安裝這個模組。

如需更新 版本的相關資訊 適用於 Java 的 AWS SDK，請參閱從 1.x 版遷移至 2.x 版 適用於 Java 的 AWS SDK。

可透過 Apache Maven 適用於 Java 的 AWS SDK 取得。您可以宣告整個 適用於 Java 的 AWS SDK或僅dynamodb-enhanced模組的相依性。

適用於 Java 的 AWS SDK 使用 Apache Maven 安裝

• 若要匯入整個 適用於 Java 的 AWS SDK 作為相依性，請在 pom.xml 檔案中宣告它。

• 若要僅針對 中的 Amazon DynamoDB 模組建立相依性 適用於 Java 的 AWS SDK，請遵循指定特定模組的指示。將 groupId 設定為 software.amazon.awssdk，將 artifactID設定為 dynamodb-enhanced。

  注意

  如果您使用 AWS KMS keyring AWS KMS 或階層 keyring，您也需要為 AWS KMS 模組建立相依性。將 groupId 設定為 software.amazon.awssdk，將 artifactID設定為 kms。

安裝

您可以使用下列方式安裝適用於 DynamoDB 的 Java 用戶端加密程式庫 3.x 版。

使用 Apache Maven

Amazon DynamoDB Encryption Client for Java 可透過 Apache Maven 使用下列相依性定義。

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

使用 Gradle Kotlin

您可以使用 Gradle 在適用於 Java 的 Amazon DynamoDB 加密用戶端上宣告相依性，方法是將以下內容新增至 Gradle 專案的相依性區段。

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

手動

若要安裝 DynamoDB 的 Java 用戶端加密程式庫，請複製或下載 aws-database-encryption-sdk-dynamodb GitHub 儲存庫。

安裝軟體開發套件後，請先查看本指南中的範例程式碼，以及 GitHub 上 aws-database-encryption-sdk-dynamodb 儲存庫中的 Java 範例。