适用于 Java 的 Amazon QLDB 驱动程序

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

主题

• 驱动程序资源
• 先决条件
• 设置您的默认 AWS 凭证和区域
• 安装
• 快速入门教程
• 说明书参考

驱动程序资源

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

• API 参考：2.x, 1.x

• 驱动程序源代码 (GitHub)

• 示例应用程序源代码 (GitHub)

• 分类账加载器框架 (GitHub)

• Amazon Ion 代码示例

先决条件

开始使用适用于 Java 的 QLDB 驱动程序之前，您必须执行以下操作:

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

   1. 注册AWS。

   2. 创建具有适当 QLDB 权限的用户。

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

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

   1. Java SE Development Kit 8，例如 Amazon Corretto 8。

   2. （可选）您选择的 Java 集成式开发环境 (IDE)，例如 Eclipse 或 IntelliJ。

3. 通过 设置您的默认 AWS 凭证和区域 为 AWS SDK for Java 配置您的开发环境。

接下来，您可下载完整的教程示例应用程序，也可以只在 Java 项目中安装驱动程序并运行短代码示例。

• 要在现有项目中安装 QLDB 驱动程序和 AWS SDK for Java，请继续执行安装。

• 要设置项目并运行演示分类账上基本数据事务的简短代码示例，请参阅 快速入门教程。

• 要在完整的教程示例应用程序中运行更深入的数据和管理 API 操作示例，请参阅 Java 教程。

设置您的默认 AWS 凭证和区域

QLDB 驱动程序和底层 AWS SDK for Java 要求在运行时向应用程序提供 AWS 凭证。本指南中的代码示例假设您使用 AWS 凭证文件，如 AWS SDK for Java 2.x《开发者指南》 中的 设置默认凭证和区域 所述。

作为这些步骤的一部分，您还应设置默认值 AWS 区域 以确定默认 QLDB 终端节点。在默认的 AWS 区域 中，代码示例连接到 QLDB。有关 QLDB 区域的完整列表，请参阅 AWS 一般参考中的 Amazon QLDB 端点和限额。

下面是一个名为 ~/.aws/credentials 的 AWS 凭证文件示例，其中波浪号字符 (~) 表示主目录。

[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	状态	最新发布日期
1.x	AWS SDK for Java 1.x	量产版	2023 年 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依赖于software.amazon.ion命名空间下的另一个 Ion 包，但这是一个与 QLDB 驱动程序不兼容的旧包。

有关如何在分类账上运行基本数据事务的简短代码示例，请参阅 说明书参考。

其他可选库

另外，您还可以在项目中添加以下有用的库。这些构件是 Java 教程 示例应用程序中必需的依赖项。

1. aws-java-sdk-qldb - AWS SDK for Java 的 QLDB 模块。QLDB 支持的最低版本为 1.11.785。

   在您的应用程序中使用此模块可以直接与 Amazon QLDB API 参考 中列出的管理 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>