本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# 安装 Amazon QLDB Java 示例应用程序
**重要**
终止支持通知：现有客户将能够使用 Amazon QLDB，直到 2025 年 7 月 31 日终止支持。有关更多详细信息，请参阅[将亚马逊 QLDB 账本迁移到亚马逊 Aurora PostgreSQL](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/)。
本节介绍如何为 Java 教程安装和运行所提供的 Amazon QLDB 示例应用程序。 step-by-step此示例应用程序的用例是机动车辆部门（DMV）数据库，用于追踪有关车辆登记的完整历史信息。
适用于 Java 的 DMV 示例应用程序在 GitHub 存储库 a [ws-samples/-amazon-qldb-dmv-sample](https://github.com/aws-samples/amazon-qldb-dmv-sample-java) java 中是开源的。
## 先决条件
在开始之前，请确保您已完成适用于 Java[先决条件](getting-started.java.md#getting-started.java.prereqs) 的 QLDB 驱动程序。这包括以下这些：
1. 注册 AWS.
1. 创建具有适当 QLDB 权限的用户。要完成本教程中的所有步骤，您需要通过 QLDB API 对分类账资源拥有完全管理权限。
1. 如果您使用的是以外的 IDE AWS Cloud9，请安装 Java 并授予开发所需的编程访问权限。
## 安装
以下步骤介绍如何在本地开发环境中下载与设置示例应用程序。或者，您可以使用 AWS Cloud9 作为 IDE 自动设置示例应用程序，并使用 CloudFormation 模板来配置开发资源。
### 本地开发环境
这些说明描述了如何利用自有资源和开发环境下载和安装 QLDB Java 示例应用程序。
**下载并运行示例应用程序**
1. 输入以下命令以从中克隆示例应用程序 GitHub。
------
#### [ 2.x ]
```
git clone https://github.com/aws-samples/amazon-qldb-dmv-sample-java.git
```
------
#### [ 1.x ]
```
git clone -b v1.2.0 https://github.com/aws-samples/amazon-qldb-dmv-sample-java.git
```
------
此软件包包含来自[Java 教程](getting-started.java.tutorial.md)的 Gradle 配置和完整代码。
1. 下载并运行提供的应用程序。
+ 如果您使用的是 Eclipse：
1. 启动 Eclipse，然后在**Eclipse**菜单选择**文件**、**导入**，然后选择 **现有 Gradle 项目**。
1. 在项目根目录中，浏览并选择包含 `build.gradle` 文件的应用程序目录。然后，选择 **完成** 以使用默认 Gradle 设置进行导入。
1. 你可以尝试运行 `ListLedgers` 程序作为示例。打开 `ListLedgers.java` 文件的上下文菜单（右键单击），选择 **作为 Java 应用程序运行**。
+ 如果您使用的是 IntelliJ：
1. 启动 IntelliJ，在 **IntelliJ** 菜单选择 **文件**，然后选择 **打开**。
1. 在项目根目录中，浏览并选择包含 `build.gradle`文件的应用程序目录。然后选择 **OK**（确定）。保留默认设置，然后再次选择 **确定**。
1. 你可以尝试运行 `ListLedgers` 程序作为示例。打开`ListLedgers.java`文件的上下文（右键单击）菜单，然后选择 **“运行ListLedgers”**。
1. 继续 [步骤 1：创建新分类账](getting-started.java.step-1.md) 开始教程并创建分类账。
### AWS Cloud9
这些说明描述了如何使用[AWS Cloud9](https://aws.amazon.com/cloud9)作为 IDE 自动设置适用于 Java 的 Amazon QLDB 车辆登记示例应用程序。在本指南中，您将使 用[CloudFormation](https://aws.amazon.com/cloudformation) 模板配置您的开发资源。
有关的更多信息 AWS Cloud9，请参阅《[AWS Cloud9 用户指南》](https://docs.aws.amazon.com/cloud9/latest/user-guide/)。要了解有关 CloudFormation的更多信息，请参阅 [AWS CloudFormation 用户指南](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/)。
**Topics**
+ [第 1 部分：配置资源](#sample-app.java.cfn-ac9.step-1)
+ [部分 2：设置 IDE](#sample-app.java.cfn-ac9.step-2)
+ [第 3 部分：运行 QLDB DMV 示例应用程序](#sample-app.java.cfn-ac9.step-3)
#### 第 1 部分：配置资源
在第一步中，您将使用 CloudFormation Amazon QLDB 示例应用程序预配置设置开发环境所需的资源。
**打开 CloudFormation 控制台并加载 QLDB 示例应用程序模板**
1. 登录 AWS 管理控制台 并在 [https://console.aws.amazon.com/cloudformat](https://console.aws.amazon.com/cloudformation/) ion 上打开 CloudFormation 控制台。
切换至支持 QLDB 的区域。有关完整列表，请参阅 *AWS 一般参考* 中的 [Amazon QLDB 端点和限额](https://docs.aws.amazon.com/general/latest/gr/qldb.html)。以下屏幕截图 AWS 管理控制台 显示美国东部（弗吉尼亚北部）为选定区域 AWS 区域。
![\[AWS 管理控制台 将美国东部（弗吉尼亚北部）显示为选中 AWS 区域。\]](http://docs.aws.amazon.com/zh_cn/qldb/latest/developerguide/images/cfn-ac9/aws-region-us-east-1.png)
1. 在 CloudFormation 控制台上，选择**创建堆栈**，然后选择**使用新资源（标准）**。
1. 在 **创建堆栈**页面上，选择 **指定模板**，选择 **Amazon S3 URL**。
1. 输入以下 URL，然后选择 **下一步**。
```
https://amazon-qldb-assets.s3.amazonaws.com/templates/QLDB-DMV-SampleApp.yml
```
1. 输入**堆栈名称**（例如**qldb-sample-app**），然后选择**下一步**。
1. 您可以根据需要添加任何标签，并保留默认选项。然后选择**下一步**。
1. 检查您的堆栈设置，然后选择**创建堆栈**。 CloudFormation 脚本可能需要几分钟才能完成。
此脚本为您的 AWS Cloud9 环境预置一个关联的亚马逊弹性计算云 (Amazon EC2) 实例，用于运行本教程中的 QLDB 示例应用程序。它还会将 [aws-samples/ amazon-qldb-dmv-sample-java](https://github.com/aws-samples/amazon-qldb-dmv-sample-java/) 存储库从您的开发环境中克隆到您的开发环境中。 GitHub AWS Cloud9
#### 部分 2：设置 IDE
在此步骤中，您已完成云开发环境设置。您可以下载并运行提供的 shell 脚本，使用示例应用程序的依赖项来设置 AWS Cloud9 IDE。
**设置您的 AWS Cloud9 环境**
1. 打开 AWS Cloud9 控制台，网址为[https://console.aws.amazon.com/cloud9/](https://console.aws.amazon.com/cloud9/)。
1. 在 **您的环境**，定位名为 **QLDB DMV Sample Application**的环境牌，然后选择 **打开 IDE**。底层 EC2 实例启动时，您的环境可能需要一分钟才能加载。
您的 AWS Cloud9 环境已预先配置了运行本教程所需的系统依赖项。在控制台的 **环境** 导航窗格中，确认您看到一个名为`QLDB DMV Sample Application`的文件夹。 AWS Cloud9 控制台的以下屏幕截图显示了 QLDB DMV 示例应用程序环境文件夹窗格。
![\[AWS Cloud9 控制台显示 QLDB DMV 示例应用程序环境文件夹窗格。\]](http://docs.aws.amazon.com/zh_cn/qldb/latest/developerguide/images/cfn-ac9/cloud9-folders.png)
如果您没有看到导航窗格，请切换主机左侧的 **环境** 选项卡。如果您在窗格中看不到任何文件夹，请使用设置图标（![\[Settings icon\]](http://docs.aws.amazon.com/zh_cn/qldb/latest/developerguide/images/settings.png)）启用**显示环境根目录**。
1. 在控制台底部窗格中，您应该会看到一个打开的`bash`终端窗口。如果您没有看到这个，请从主机顶部的 **窗口 菜单中**选择**新建终端**。
1. 接下来，下载并运行安装脚本以安装 OpenJDK 8，如果适用，请从 Git 存储库中查看相应的分支。在上一步中创建的 AWS Cloud9 终端中，按顺序运行以下两个命令：
------
#### [ 2.x ]
```
aws s3 cp s3://amazon-qldb-assets/setup-scripts/dmv-setup-v2.sh .
```
```
sh dmv-setup-v2.sh
```
------
#### [ 1.x ]
```
aws s3 cp s3://amazon-qldb-assets/setup-scripts/dmv-setup.sh .
```
```
sh dmv-setup.sh
```
------
完成后，您可看到终端中打印了以下消息：
```
** DMV Sample App setup completed , enjoy!! **
```
1. 花点时间浏览中的示例应用程序代码 AWS Cloud9，尤其是在以下目录路径中：`src/main/java/software/amazon/qldb/tutorial`。
#### 第 3 部分：运行 QLDB DMV 示例应用程序
在本步骤中，您将学习如何使用运行 Amazon QLDB DMV 示例应用程序任务。 AWS Cloud9要运行示例代码，请返回 AWS Cloud9 终端或按照*第 2 部分：设置 IDE* 中所做的那样创建一个新的终端窗口。
**运行示例应用程序**
1. 在终端中运行以下命令，以切换至项目根目录：
```
cd ~/environment/amazon-qldb-dmv-sample-java
```
确保您在以下目录路径运行示例。
```
/home/ec2-user/environment/amazon-qldb-dmv-sample-java/
```
1. 以下命令显示了运行每项任务的 Gradle 语法。
```
./gradlew run -Dtutorial=Task
```
例如，运行以下命令列出您 AWS 账户 和当前区域中的所有账本。
```
./gradlew run -Dtutorial=ListLedgers
```
1. 继续 [步骤 1：创建新分类账](getting-started.java.step-1.md) 开始教程并创建分类账。
1. （可选）完成教程后，如果您不再需要 CloudFormation 资源，就可以清理它们了。
1. 在 [https://console.aws.amazon.com/cloudformation](https://console.aws.amazon.com/cloudformation/) 上打开 CloudFormation 控制台，然后删除您在*第 1 部分：配置*资源中创建的堆栈。
1. 同时删除 CloudFormation 模板为您创建的 AWS Cloud9 堆栈。