MySQL :: MySQL NDB Cluster API 開發人員指南 :: 4.2.1 取得、安裝和設定 MySQL NDB Cluster Connector for Java

MySQL NDB Cluster API 開發人員指南 / ... / 取得、安裝和設定 MySQL NDB Cluster Connector for Java

4.2.1 取得、安裝和設定 MySQL NDB Cluster Connector for Java

本節討論如何取得 ClusterJ 原始碼和二進位檔，以及如何編譯、安裝和開始使用 ClusterJ。

取得和安裝 MySQL NDB Cluster Connector for Java。您可以從 downloads.mysql.com 取得包含 ClusterJ 的最新 NDB Cluster 版本。NDB Cluster 安裝中提供的安裝指示也會安裝 ClusterJ。

從原始碼建置和安裝 MySQL NDB Cluster Connector for Java。您可以將 ClusterJ 作為建置和安裝 NDB Cluster 的一部分來建置和安裝，這始終需要您使用 CMake 選項 WITH_NDBCLUSTER_STORAGE_ENGINE（或其別名 WITH_NDBCLUSTER）來設定組建。

用於設定支援 ClusterJ 的 NDB Cluster 組建的典型 CMake 命令可能如下所示

cmake .. -DWITH_NDBCLUSTER=ON

預設會啟用 WITH_NDB_JAVA 選項，這表示 ClusterJ 會由上述命令與 NDB Cluster 一起建置。但是，如果 CMake 在您的系統上找不到 Java 的位置，設定程序將會失敗；如果需要，請使用 WITH_CLASSPATH 選項來提供 Java 類別路徑。如需有關可使用的其他 CMake 選項的資訊，請參閱 option_cmake_with_ndbcluster。

使用 CMake 設定組建後，請照常執行 make 和 make install 來編譯和安裝 NDB Cluster 軟體。

MySQL NDB Cluster Connector for Java jar 檔案。安裝後，這些 ClusterJ jar 檔案可以在 MySQL 安裝目錄下的 share/java 資料夾中找到（對於 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 Cluster 原始碼，並已編譯和安裝 NDB Cluster 和 ClusterJ，則需要執行以下步驟

將包含 NDB 用戶端程式庫 (libndbclient.so) 的資料夾的檔案路徑，以名為 ndbclient.lib 的屬性新增至您的本機 Maven settings.xml 檔案（可在本機 Maven 儲存庫中找到，對於 Linux 平台，通常為 /home/username/.m2）。用戶端程式庫位於 NDB Cluster 安裝資料夾下的 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 Cluster 時建立的組建目錄（在建置散發套件中的範例步驟中為 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）；選取旁邊有 Maven 圖示 () 的 clusterj 資料夾，然後按一下開啟專案。ClusterJ Aggregate 專案隨即匯入，並以 ClusterJ API、ClusterJ Core、ClusterJ Test Suite、ClusterJ Tie 和 ClusterJ Unit Test Framework 作為模組下的子專案匯入。
- 像使用 NetBeans 中任何其他 Maven 專案一樣處理 ClusterJ 專案。對原始碼所做的任何變更都會進入您從中編譯 NDB Cluster 以建立組建目錄的原始碼樹狀結構中。
在 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 專案。