文档主页
MySQL Connector/J 开发人员指南
相关文档 下载本手册
PDF (US Ltr) - 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 用于 .tar.gz 存档,WinZip 用于 .zip 存档),将 JAR 存档从 .tar.gz.zip 存档解压缩到合适的位置。

注意

由于发行版中可能存在很长的文件名,Connector/J 存档使用 GNU Tar 存档格式。使用 GNU Tar 或兼容的应用程序解压缩发行版的 .tar.gz 变体。

使用适用于 Linux 平台上的软件包管理系统的软件包: RPM 和 Debian 软件包可用于在 Oracle Linux、Debian、Ubuntu、SUSE 等许多 Linux 发行版上安装 Connector/J。使用系统的软件包管理系统安装这些软件包。

在 Windows 平台上: 您无法使用 适用于 Windows 的 MySQL 安装程序 在 Windows 平台上安装 Connector/J。请注意,也没有用于在 Windows 平台上安装 Connector/J 的独立 Windows 安装文件 (.msi)。对于 Windows 平台上的安装,请使用平台无关的存档。

配置 CLASSPATH

一旦 mysql-connector-j-version.jar 从二进制发行版软件包解压缩到正确的位置,通过将 JAR 存档放在您的 Java 类路径中来完成驱动程序的安装,可以通过将它的完整文件路径添加到您的 CLASSPATH 环境变量中,或者在启动 JVM 时使用命令行开关 -cp 直接指定文件路径。

例如,在 Linux 平台上,使用以下形式之一将 Connector/J 驱动程序添加到您的 CLASSPATH 中,具体取决于您的命令 shell

# 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 应用程序服务器支持或需要它们,您也可以使用 MysqlDataSourceMysqlConnectionPoolDataSource 类(位于 com.mysql.cj.jdbc 包中)。javax.sql.XADataSource 接口是使用 com.mysql.cj.jdbc.MysqlXADataSource 类实现的,它支持 XA 分布式事务。各种 MysqlDataSource 类支持以下参数(通过标准设置 mutator)

  • user

  • password

  • serverName

  • databaseName

  • port