適用於 Java 的 Amazon QLDB 驅動程式

重要

支援終止通知：現有客戶將可以使用 Amazon QLDB，直到 07/31/2025 的支援結束為止。如需詳細資訊，請參閱將 Amazon QLDB Ledger 遷移至 Amazon Aurora PostgreSQL。

若要使用 分類帳中的資料，您可以使用 AWS 提供的驅動程式，從 Java 應用程式連線至 Amazon QLDB。下列主題說明如何開始使用適用於 Java 的 QLDB 驅動程式。

主題

• 驅動程式資源

• 先決條件

• 設定您的預設 AWS 登入資料和區域

• 安裝

• 快速入門教學課程

• 技術指南參考

驅動程式資源

如需 Java 驅動程式支援功能的詳細資訊，請參閱下列資源：

• API 參考：2.x、1.x

• 驅動程式原始碼 (GitHub)

• 應用程式原始碼範例 (GitHub)

• Ledger 載入器架構 (GitHub)

• Amazon Ion 程式碼範例

先決條件

開始使用適用於 Java 的 QLDB 驅動程式之前，您必須執行下列動作：

1. 請遵循 中的 AWS 設定指示存取 Amazon QLDB。這包含下列項目：

   1. 註冊 AWS。

   2. 建立具有適當 QLDB 許可的使用者。

   3. 授予開發的程式設計存取權。

2. 透過下載並安裝下列項目來設定 Java 開發環境：

   1. Java SE 開發套件 8，例如 Amazon Corretto 8。

   2. （選用） 您選擇的 Java 整合開發環境 (IDE)，例如 Eclipse 或 IntelliJ。

3. 透過 AWS SDK for Java 設定 的開發環境設定您的預設 AWS 登入資料和區域。

接下來，您可以下載完整的教學課程範例應用程式，或者您只能在 Java 專案中安裝驅動程式並執行短程式碼範例。

• 若要在現有專案 AWS SDK for Java 中安裝 QLDB 驅動程式和 ，請繼續安裝。

• 若要設定專案並執行示範分類帳上基本資料交易的簡短程式碼範例，請參閱 快速入門教學課程。

• 若要在完整的教學課程範例應用程式中執行更深入的資料和管理 API 操作範例，請參閱 Java 教學課程。

設定您的預設 AWS 登入資料和區域

QLDB 驅動程式和基礎 AWS SDK for Java需要您在執行時間提供 AWS 登入資料給應用程式。本指南中的程式碼範例假設您使用的是 AWS 登入資料檔案，如 AWS SDK for Java 2.x 開發人員指南中的設定預設登入資料和區域中所述。

在這些步驟中，您也應該設定預設值 AWS 區域 來判斷預設的 QLDB 端點。程式碼範例會連接到預設 中的 QLDB AWS 區域。如需可使用 QLDB 的區域完整清單，請參閱 中的 Amazon QLDB 端點和配額AWS 一般參考。

以下是名為 的 AWS 登入資料檔案範例~/.aws/credentials，其中的波浪字元 (~) 代表您的主目錄。

[default] 
aws_access_key_id = your_access_key_id
aws_secret_access_key = your_secret_access_key

將您自己的 AWS 登入資料值替換為 your_access_key_id 和 your_secret_access_key 的值。

安裝

QLDB 支援下列 Java 驅動程式版本及其 AWS SDK 相依性。

驅動程式版本	AWS 開發套件	Status	最新發行日期
1.x	AWS SDK for Java 1.x	生產版本	2020 年 3 月 20 日
2.x	AWS SDK for Java 2.x	生產版本	2021 年 6 月 4 日

若要安裝 QLDB 驅動程式，我們建議您使用相依性管理系統，例如 Gradle 或 Maven。例如，在 Java 專案中新增下列成品做為相依性。

2.x

漸層

在build.gradle組態檔案中新增此相依性。

dependencies {
    compile group: 'software.amazon.qldb', name: 'amazon-qldb-driver-java', version: '2.3.1'
}

Maven

在pom.xml組態檔案中新增此相依性。

<dependencies>
  <dependency>
    <groupId>software.amazon.qldb</groupId>
    <artifactId>amazon-qldb-driver-java</artifactId>
    <version>2.3.1</version>
  </dependency>
</dependencies>

此成品會自動包含 AWS SDK for Java 2.x 核心模組、Amazon Ion 程式庫和其他必要的相依性。

1.x

漸層

在build.gradle組態檔案中新增此相依性。

dependencies {
    compile group: 'software.amazon.qldb', name: 'amazon-qldb-driver-java', version: '1.1.0'
}

Maven

在pom.xml組態檔案中新增此相依性。

<dependencies>
  <dependency>
    <groupId>software.amazon.qldb</groupId>
    <artifactId>amazon-qldb-driver-java</artifactId>
    <version>1.1.0</version>
  </dependency>
</dependencies>

此成品會自動包含 AWS SDK for Java 核心模組、Amazon Ion 程式庫和其他必要的相依性。

重要

Amazon Ion 命名空間 – 在應用程式中匯入 Amazon Ion 類別時，您必須使用位於命名空間 下的套件com.amazon.ion。 AWS SDK for Java 取決於命名空間 下的另一個 Ion 套件software.amazon.ion，但這是與 QLDB 驅動程式不相容的舊版套件。

如需如何在分類帳上執行基本資料交易的簡短程式碼範例，請參閱 技術指南參考。

其他選用程式庫

您也可以選擇性地在專案中新增下列有用的程式庫。這些成品是Java 教學課程範例應用程式中的必要相依性。

1. aws-java-sdk-qldb – 的 QLDB 模組 AWS SDK for Java。QLDB 支援的最小版本為 1.11.785。

   在應用程式中使用此模組，直接與 中列出的管理 API 操作互動Amazon QLDB API 參考。

2. jackson-dataformat-ion – 適用於 Ion 的 FasterXML 的 Jackson 資料格式模組。範例應用程式需要 版本 2.10.0 或更新版本。

Gradle

在build.gradle組態檔案中新增這些相依性。

dependencies {
    compile group: 'com.amazonaws', name: 'aws-java-sdk-qldb', version: '1.11.785'
    compile group: 'com.fasterxml.jackson.dataformat', name: 'jackson-dataformat-ion', version: '2.10.0'
}

Maven

在pom.xml組態檔案中新增這些相依性。

<dependencies>
  <dependency>
    <groupId>com.amazonaws</groupId>
    <artifactId>aws-java-sdk-qldb</artifactId>
    <version>1.11.785</version>
  </dependency>
  <dependency>
    <groupId>com.fasterxml.jackson.dataformat</groupId>
    <artifactId>jackson-dataformat-ion</artifactId>
    <version>2.10.0</version>
  </dependency>
</dependencies>