用於 Java 的亞馬遜 QLDB 驅動程序

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

主題

• 駕駛資源
• 先決條件
• 設定您的預設AWS憑證和區域
• 安裝
• 快速入門教學
• 食譜參考

駕駛資源

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

• 應用程式介面參考：2.x、1.x

• 驅動程式原始程式碼 (GitHub)

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

• 分類帳載入程式架構 (GitHub)

• Amazon Ion 程式碼範例

先決條件

開始使用適用於 Java 的 QLDB 驅動程式：

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

   1. 註冊 AWS。

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

   3. 授予程式設計存取權以進行開發。

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

   1. Java SE 開發工具包 8, 如亞馬遜郵輪 8.

   2. （可選）您選擇的 Java 集成開發環境（IDE），例如日蝕或 IntelliJ。

3. 為AWS SDK for Java by 配置您的開發環境設定您的預設AWS憑證和區域。

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

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

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

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

設定您的預設AWS憑證和區域

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

在這些步驟中，您也應該設定預設值AWS 區域以決定預設 QLDB 端點。程式碼範例會以預設值連線至 QLDBAWS 區域。如需提供 QLDB 的完整區域清單，請參閱中的 Amazon QLDB 端點和配額AWS 一般參考。

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

[default] 
aws_access_key_id = your_access_key_id
aws_secret_access_key = your_secret_access_key

將您自己的AWS認證值替換為您的存取碼和您的密鑰的值。

安裝

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

驅動程式版本	AWS SDK	狀態	最新發佈日期
1.	AWS SDK for Java1.	生產發行	2020 年 3 月 20 日
2.x	AWS SDK for Java 2.x	生產發行	2021 年 6 月 4 日

要安裝 QLDB 驅動程序，我們建議使用依賴管理系統，如搖籃或 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— 更快的 XML 的傑克遜數據格式模塊離子. 範例應用程式需要版本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>