MySQL :: MySQL NDB 集群 API 开发者指南 :: 4.2.1 获取、安装和设置适用于 Java 的 MySQL NDB 集群连接器

MySQL NDB 集群 API 开发者指南 / ... / 获取、安装和设置适用于 Java 的 MySQL NDB 集群连接器

4.2.1 获取、安装和设置适用于 Java 的 MySQL NDB 集群连接器

本节讨论如何获取 ClusterJ 源代码和二进制文件，以及如何编译、安装和开始使用 ClusterJ。

获取并安装适用于 Java 的 MySQL NDB 集群连接器。 您可以从 downloads.mysql.com 获取最新的 NDB 集群版本，其中包括 ClusterJ。NDB 集群安装中给出的安装说明也会安装 ClusterJ。

从源代码构建和安装适用于 Java 的 MySQL NDB 集群连接器。 您可以将 ClusterJ 作为构建和安装 NDB 集群的一部分进行构建和安装，这始终需要您使用 CMake 选项 WITH_NDBCLUSTER_STORAGE_ENGINE（或其别名 WITH_NDBCLUSTER）配置构建。

用于配置支持 ClusterJ 的 NDB 集群构建的典型 CMake 命令可能如下所示

cmake .. -DWITH_NDBCLUSTER=ON

默认情况下启用 WITH_NDB_JAVA 选项，这意味着 ClusterJ 将通过上述命令与 NDB 集群一起构建。但是，如果 CMake 无法在您的系统上找到 Java 的位置，则配置过程将会失败；如果需要，请使用 WITH_CLASSPATH 选项提供 Java 类路径。有关可以使用其他 CMake 选项的信息，请参阅 option_cmake_with_ndbcluster。

使用 CMake 配置构建后，像往常一样运行 make 和 make install 来编译和安装 NDB 集群软件。

适用于 Java 的 MySQL NDB 集群连接器 jar 文件。 安装后，可以在 MySQL 安装目录下的 share/java 文件夹中找到这些 ClusterJ jar 文件（对于 Linux 平台，默认情况下为 /usr/local/mysql）

clusterj-api-version.jar：这是编译时 jar 文件，是编译 ClusterJ 应用程序代码所需的。
clusterj-version.jar：这是执行 ClusterJ 应用程序所需的运行时库。
clusterj-test-version.jar：这是 ClusterJ 测试套件，是测试 ClusterJ 安装所需的。

使用 Maven 构建 ClusterJ

ClusterJ 的源文件配置为 Maven 项目，允许使用 Maven 轻松进行编译和安装。假设您已获得 NDB 集群源代码，并已按照上述说明编译并安装了 NDB 集群和 ClusterJ，则需要执行以下步骤

将包含 NDB 客户端库 (libndbclient.so) 的文件夹的文件路径作为名为 ndbclient.lib 的属性添加到本地 Maven settings.xml 文件中（位于本地 Maven 存储库中，对于 Linux 平台，通常为 /home/username/.m2）。客户端库位于 NDB 集群安装文件夹下的 lib 文件夹中。如果本地 Maven 存储库中不存在 settings.xml，请创建一个。这是一个包含 ndbclient.lib 属性的简单 settings.xml 文件的样子

<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0
                      http://maven.apache.org/xsd/settings-1.0.0.xsd">
  <profiles>
    <profile>
      <id>jni-library</id>
      <activation>
        <activeByDefault>true</activeByDefault>
      </activation> 
      <properties>
        <ndbclient.lib>/NDB_Cluster_installation_directory/lib/</ndbclient.lib>
      </properties>
    </profile>
  </profiles>

</settings>

转到编译 NDB 集群时创建的构建目录（在构建发行版的示例步骤中为 bld），然后转到其下的 storage/ndb/clusterj 文件夹。运行文件夹中的 mvn_install_ndbjtie.sh 脚本
```
./mvn_install_ndbjtie.sh
```
它安装 ndbjtie.jar，它为 ClusterJ 提供 JNI 层，是构建 CluterJ 所需的。
通过在 storage/ndb/clusterj 目录中运行 mvn install 来使用 Maven 安装 ClusterJ
```
mvn install
```
这将导致构建 ClusterJ，并将生成的 .jar 文件安装到本地 Maven 存储库中。
注意

您可以通过向命令添加选项 skipTests 来跳过安装过程结束时进行的测试
```
mvn install -DskipTests
```
这可以防止由于尚未设置测试环境而导致安装失败。

在 IDE 中使用 Maven 构建 ClusterJ

由于 ClusterJ 的源文件配置为 Maven 项目，因此您可以轻松地将它们导入到您喜欢的支持 Maven 的 IDE 中，根据需要自定义和重建它们，请按照以下步骤操作

确保已启用 IDE 对 Maven 的支持。您可能需要为此安装 Maven 插件。
按照使用 Maven 构建 ClusterJ 中的步骤 1 和 2 操作，这将使 ClusterJ 源代码可以使用 Maven。
将 ClusterJ 导入为 Maven 项目。以下是在一些流行的 IDE 中执行此操作的方法

在 NetBeans 中
- 在主菜单中，选择文件 > 打开项目。此时将出现打开项目对话框
- 在打开项目对话框中，浏览到构建目录下的 storage/ndb 文件夹（请参阅使用 Maven 构建 ClusterJ 中的步骤 2）；选择 clusterj 文件夹，该文件夹旁边带有 Maven 图标 ()，然后单击打开项目。此时将导入 ClusterJ Aggregate 项目，并将 ClusterJ API、ClusterJ Core、ClusterJ Test Suite、ClusterJ Tie 和 ClusterJ Unit Test Framework 作为子项目导入到模块下。
- 像处理 NetBeans 中的任何其他 Maven 项目一样处理 ClusterJ 项目。对源代码的任何更改都会进入您从中编译 NDB 集群以创建构建目录的源代码树中。
在 Eclipse 中
- 在主菜单中，选择文件 > 导入。此时将出现导入对话框
- 在导入对话框中，选择 Maven > 现有 Maven 项目作为导入向导，然后单击下一步。此时将出现导入 Maven 项目对话框。
- 在导入 Maven 项目对话框中，浏览到构建目录下的 storage/ndb 文件夹（请参阅使用 Maven 构建 ClusterJ 中的步骤 2）；选择 clusterj 文件夹，然后单击选择文件夹。 clusterj-aggregate 项目及其子项目 clusterj-api、clusterj-core、clusterj-test、clusterj-tie 和 clusterj-unit 将出现在 Maven 项目对话框中。单击全选，然后单击完成。此时将导入所有 ClusterJ 项目。
- 像处理 Eclipse 中的任何其他 Maven 项目一样处理 ClusterJ 项目。