适用于 Java 的亚马逊QLDB驱动程序 - 亚马逊 Quantum Ledger 数据库（亚马逊QLDB）
驱动程序资源先决条件 设置您的默认 AWS 凭证和区域安装

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

适用于 Java 的亚马逊QLDB驱动程序

重要

终止支持通知：现有客户可以在2025年7月31日终止支持QLDB之前使用亚马逊。有关更多详细信息，请参阅将亚马逊QLDB账本迁移到亚马逊 Aurora Postgr SQL e。

要处理账本中的数据，您可以使用 AWS 提供的驱动程序QLDB从 Java 应用程序连接到 Amazon。以下主题介绍如何开始使用 Java QLDB 驱动程序。

主题

驱动程序资源

有关 Java 驱动程序支持功能的更多信息，请参阅以下资源：

先决条件

在开始使用 Java QLDB 驱动程序之前，必须执行以下操作：

  1. 按照中的 AWS 设置说明进行操作访问亚马逊 QLDB。这包括以下这些：

    1. 注册 AWS.

    2. 创建具有相应QLDB权限的用户。

    3. 授权以编程方式访问开发。

  2. 通过下载并安装以下内容来设置一个 Java 开发环境：

    1. Java SE Development Kit 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 区域。有关可用区域的完整列表，请参阅中的 Amazon QLDB 终端节点和配额AWS 一般参考。QLDB

以下是名为的 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.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

Gradle

在您的 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

Gradle

在您的 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操作进行交互亚马逊QLDBAPI参考资料。

  2. jackson-dataformat-ion— F XML aster 的 Jackson 数据格式模块，适用于 Ion。示例应用程序需要版本 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>