文件首頁
MySQL Connector/J 開發人員指南
相關文件 下載本手冊
PDF (美式信紙) - 1.2Mb
PDF (A4) - 1.2Mb


4.3 從原始碼安裝

注意

只有在您想要建置 Connector/J 的自訂版本,或您有興趣協助我們測試新程式碼時,才需要從原始碼安裝 Connector/J。若只是想在您的系統上啟動並執行 MySQL Connector/J,請使用標準二進位發行版本安裝 Connector/J;如需指示,請參閱第 4.1 節「從二進位發行版本安裝 Connector/J」

若要從原始碼安裝 MySQL Connector/J,請確保您的系統上具有下列軟體

提示

建議使用下列軟體的最新版本來編譯 Connector/J;否則,某些功能可能無法使用。

若要從原始碼建置 MySQL Connector/J,請遵循下列步驟

  1. 確保已安裝 JDK 1.8.x。

  2. 透過下列其中一種方式取得 Connector/J 的來源

    • Connector/J 下載頁面下載 Connector/J 的平台獨立發行版本封存檔 (以 .tar.gz.zip 格式)。將封存檔的內容解壓縮到名為 (例如) mysql-connector-j 的資料夾。

    • Connector/J 下載頁面下載 Connector/J 的原始碼 RPM 套件並安裝。

    • 從位於 GitHub 的 MySQL Connector/J 原始碼儲存庫檢查程式碼,網址為 https://github.com/mysql/mysql-connector-j。Connector/J 9.0 系列的最新版本位於 release/9.0 分支;使用下列命令檢查它

      $> git clone --branch release/9.0 https://github.com/mysql/mysql-connector-j.git

      在目前目錄下,此命令會建立 mysql-connector-j 子目錄,其中包含您需要的程式碼。

  3. 將所有必要的協力廠商程式庫放在來源樹狀結構根目錄的 lib 資料夾 (也就是,如果您已遵循上述步驟,則放在 mysql-connector-j/lib 中),或者將它們放在其他位置,稍後再將位置提供給 Ant (請參閱下方的步驟 5)。

  4. 將目前的工作目錄變更為上述步驟 2 中建立的 mysql-connector-j 目錄。

  5. 在目錄中,建立一個名為 build.properties 的檔案,以使用屬性 com.mysql.cj.build.jdk 向 Ant 指示您的 JDK 1.8.x 安裝根目錄的位置,以及額外函式庫的位置(如果它們不在 mysql-connector-j/lib 中),則使用屬性 com.mysql.cj.extra.libs。以下是一個設定這些屬性的範例檔案(將 path_to_* 部分替換為適當的檔案路徑)

    com.mysql.cj.build.jdk=path_to_jdk_1.8
    com.mysql.cj.extra.libs=path_to_folder_for_extra_libraries

    或者,您也可以透過 Ant 的 -D 選項設定這些屬性的值。

    注意

    從 Connector/J 5.1 升級到 8.0 及更高版本時,許多用於建置 Connector/J 的 Ant 屬性已重新命名或移除;有關詳細資訊,請參閱第 4.4.1.4 節「建置屬性的變更」

  6. 執行以下命令以編譯驅動程式,並為 Connector/J 建立 .jar 檔案

    $> ant build

    這會在目前目錄中建立一個 build 目錄,所有建置輸出都會放置於其中。在 build 目錄下會建立一個目錄,其名稱包含您正在建置的發行版本號碼。該目錄包含來源程式碼、已編譯的 .class 檔案,以及用於部署的 .jar 檔案。

    如需所有建置目標的資訊,包括建立完整封裝散發套件的目標,請執行以下命令

    $> ant -projecthelp
  7. 依照設定類別路徑為應用程式伺服器設定 Connector/J中提供的指示,安裝新建立的 JDBC 驅動程式 .jar 檔案,就像安裝從 MySQL 下載的二進位 .jar 檔案一樣。