文档主页
MySQL Connector/J 开发人员指南
相关文档 下载此手册
PDF (US Ltr) - 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 安装的根目录位置,以及使用属性 com.mysql.cj.extra.libs 指示其他库的位置(如果它们不在 mysql-connector-j/lib 中)。以下是一个包含这些属性设置的示例文件(将 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. 安装新创建的 .jar 文件(用于 JDBC 驱动程序),如同安装从 MySQL 下载的二进制 .jar 文件一样,按照 配置 CLASSPATH为应用程序服务器配置 Connector/J 中给出的说明进行操作。