Java 的 Amazon QLDB 驅動程序 - Amazon Quantum Ledger 資料庫 （Amazon QLDB）
司機資源必要條件設定您的預設 AWS 憑證和區域安裝

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

Java 的 Amazon QLDB 驅動程序

重要

支援結束通知：現有客戶將能夠使用 Amazon，QLDB直到 2025 年 7 月 31 日終止支援為止。有關更多詳細信息，請參閱將 Amazon QLDB 分類帳遷移到 Amazon Aurora 郵政. SQL

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

主題

司機資源

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

必要條件

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

  1. 按照中的 AWS 設定指示進行操作訪問 Amazon QLDB。這包含下列項目：

    1. 註冊 AWS.

    2. 建立具有適當QLDB權限的使用者。

    3. 授予程序化訪問以進行開發。

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

    1. Java SE 開發工具包 8, 如 Amazon 郵輪 8.

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

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

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

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

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

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

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

QLDB驅動程式和基礎AWS SDK for Java需要您在執行階段向應用程式提供 AWS 認證。本指南中的程式碼範例假設您正在使用 AWS 憑證檔案，如AWS SDK for Java 2.x 開發人員指南中的 [設定預設認證] 和 [區域] 中所述。

在這些步驟中，您還應該設置默認值 AWS 區域 以確定默認QLDB端點。程式碼範例會連線到您QLDB的預設值 AWS 區域。如需可用區域QLDB的完整清 AmazonQLDB，請參閱 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 SDK Status 最新發布日期
1. AWS SDK for Java 1. 生產發行 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驅動程序不兼容的舊版軟件包。

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

其他可選程式庫

或者，您也可以在專案中加入下列有用的資源庫。這些成品是爪哇教程範例應用程式中必要的相依性。

  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>