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


MySQL Connector/J 開發人員指南  /  Connector/J 安裝  /  從二進制發行版安裝 Connector/J

4.1 從二進制發行版安裝 Connector/J

取得和使用二進制發行版套件

Connector/J 的不同類型二進制發行版套件可從Connector/J 下載頁面取得。以下說明如何使用每種類型的套件來安裝 Connector/J。

使用與平台無關的封存檔: .tar.gz.zip 封存檔可用於在任何平台上安裝 Connector/J。使用適當的圖形或命令列公用程式(例如,用於 .tar.gz 封存檔的 tar 和用於 .zip 封存檔的 WinZip),將 JAR 封存檔從 .tar.gz.zip 封存檔解壓縮到適當的位置。

注意

由於發行版中可能存在較長的文件名稱,Connector/J 封存檔使用 GNU Tar 封存格式。使用 GNU Tar 或相容的應用程式來解壓縮發行版的 .tar.gz 變體。

使用 Linux 平台上的軟體套件管理系統的套件: RPM 和 Debian 套件可用於在許多 Linux 發行版(如 Oracle Linux、Debian、Ubuntu、SUSE 等)上安裝 Connector/J。使用您系統的軟體套件管理系統安裝這些套件。

在 Windows 平台上:您無法使用Windows 版 MySQL 安裝程式在 Windows 平台上安裝 Connector/J。請注意,也沒有用於安裝 Connector/J 的獨立 Windows 安裝程式檔案 (.msi)。請改用與平台無關的封存檔在 Windows 平台上進行安裝。

設定 CLASSPATH

一旦將 mysql-connector-j-版本.jar 從二進制發行版套件解壓縮到正確的位置,請將 JAR 封存檔放置在您的 Java 類別路徑中,以完成驅動程式的安裝,方法是將其完整檔案路徑新增至您的 CLASSPATH 環境變數,或是在啟動 JVM 時使用命令列開關 -cp 直接指定檔案路徑。

例如,在 Linux 平台上,根據您的命令殼層,使用以下其中一種形式將 Connector/J 驅動程式新增至您的 CLASSPATH

# Bourne-compatible shell (sh, ksh, bash, zsh):
$> export CLASSPATH=/path/mysql-connector-j-ver.jar:$CLASSPATH

# C shell (csh, tcsh):
$> setenv CLASSPATH /path/mysql-connector-j-ver.jar:$CLASSPATH

您也可以在設定檔中設定 CLASSPATH 環境變數,方法是在使用者的 .profile.login 或其他登入檔案中在本機設定使用者,或編輯全域 /etc/profile 檔案來全域設定。

對於 Windows 平台,您透過系統控制台設定環境變數。

重要

請記得也將使用 Connector/J 所需的第三方程式庫的位置新增至 CLASSPATH。

設定應用程式伺服器的 Connector/J

若要將 MySQL Connector/J 與應用程式伺服器(如 GlassFish 或 Tomcat)搭配使用,請閱讀您的供應商文件,以了解如何設定第三方類別程式庫的資訊,因為大多數應用程式伺服器會忽略 CLASSPATH 環境變數。如需某些 J2EE 應用程式伺服器的組態範例,請參閱第 8 章《使用 Connector/J 的連線集區第 9.3 節「使用 Connector/J 設定負載平衡」第 9.5 節「進階負載平衡和容錯移轉組態」。但是,JDBC 連線集區組態資訊的權威來源是您自己的應用程式伺服器的文件。

如果您正在開發 Servlet 或 JSP,而且您的應用程式伺服器符合 J2EE 標準,您可以將驅動程式的 .jar 檔案放置在您的 Web 應用程式的 WEB-INF/lib 子目錄中,因為這是 J2EE Web 應用程式中第三方類別程式庫的標準位置。如果您的 J2EE 應用程式伺服器支援或需要,您也可以使用 com.mysql.cj.jdbc 套件中的 MysqlDataSourceMysqlConnectionPoolDataSource 類別。 javax.sql.XADataSource 介面是使用 com.mysql.cj.jdbc.MysqlXADataSource 類別實作,該類別支援 XA 分散式交易。各種 MysqlDataSource 類別支援下列參數(透過標準 set mutator)

  • user

  • password

  • serverName

  • databaseName

  • port