4.3 Installing from Source — MySQL Connectors 1.0

4.3 Установка из исходного кода

Внимание

Вам необходимо установить Connector/J из исходного кода только в том случае, если вы хотите создать настроенную версию Connector/J или если вы заинтересованы в тестировании нашего нового кода. Чтобы просто запустить MySQL Connector/J на вашей системе, установите Connector/J с помощью стандартного двоичного выпуска; см. Раздел 4.1, «Установка Connector/J из двоичного дистрибутива» для получения инструкций.

Для установки MySQL Connector/J из исходного кода убедитесь, что на вашей системе установлено следующее программное обеспечение:

Подсказка

Рекомендуется использовать последние версии доступного программного обеспечения для компиляции Connector/J; в противном случае некоторые функции могут быть недоступны.

Клиент Git, если вы хотите получить исходные коды из нашего репозитория GitHub (доступен по адресу http://git-scm.com/downloads).
Apache Ant версии 1.10.6 или новее (доступен по адресу http://ant.apache.org/).
JDK 1.8.x (доступен по адресу https://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html).
Следующие библиотеки сторонних разработчиков:
- JUnit 5.11.3 (см. информацию об установке и загрузке в Руководстве пользователя JUnit 5). Требуются следующие JAR-файлы:
  - junit-jupiter-api-5.11.3.jar (доступен, например, по адресу https://central.sonatype.com/artifact/org.junit.jupiter/junit-jupiter-api/5.11.3/jar).
  - junit-jupiter-engine-5.11.3.jar (доступен, например, по адресу https://central.sonatype.com/artifact/org.junit.jupiter/junit-jupiter-engine/5.11.3/jar).
  - junit-platform-commons-1.11.3.jar (доступен, например, по адресу https://central.sonatype.com/artifact/org.junit.platform/junit-platform-commons/1.11.3/jar).
  - junit-platform-engine-1.11.3.jar (доступен, например, по адресу https://central.sonatype.com/artifact/org.junit.platform/junit-platform-engine/1.11.3/jar).
  - junit-platform-launcher-1.11.3.jar (доступен, например, по адресу https://central.sonatype.com/artifact/org.junit.platform/junit-platform-launcher/1.11.3/jar).
  - Дополнительные JAR-файлы, от которых зависит JUnit 5:
    
    apiguardian-api-1.1.2.jar (доступен, например, по адресу https://central.sonatype.com/artifact/org.apiguardian/apiguardian-api/1.1.2/jar).
    
    opentest4j-1.3.0.jar (доступен, например, по адресу https://central.sonatype.com/artifact/org.opentest4j/opentest4j/1.3.0/jar).
- Javassist 3.30.2 (javassist-3.30.2-GA.jar, доступен, например, по адресу https://central.sonatype.com/artifact/org.javassist/javassist/3.30.2-GA/bundle).
- Protocol Buffers Java API 4.29.0 (protobuf-java-4.29.0.jar, доступен, например, по адресу https://central.sonatype.com/artifact/com.google.protobuf/protobuf-java/4.29.0/bundle).
- C3P0 0.10.1 или новее (c3p0-0.10.1.jar, доступен, например, по адресу https://central.sonatype.com/artifact/com.mchange/c3p0/0.10.1/jar).
- Simple Logging Facade API 2.0.16 или новее (slf4j-api-2.0.16.jar, доступен, например, по адресу https://central.sonatype.com/artifact/org.slf4j/slf4j-api/2.0.16/jar).
- Java Hamcrest 2.2 или новее (hamcrest-2.2.jar, доступен, например, по адресу https://central.sonatype.com/artifact/org.hamcrest/hamcrest/2.2/jar).
- Oracle Cloud Infrastructure SDK for Java (oci-java-sdk-common-3.54.0.jar, доступен, например, по адресу https://central.sonatype.com/artifact/com.oracle.oci.sdk/oci-java-sdk-common/3.54.0/jar).
- OpenTelemetry API (opentelemetry-api-1.44.1.jar, доступен, например, по адресу https://central.sonatype.com/artifact/io.opentelemetry/opentelemetry-api/1.44.1).
- OpenTelemetry Context (opentelemetry-context-1.44.1.jar, доступен, например, по адресу https://central.sonatype.com/artifact/io.opentelemetry/opentelemetry-context/1.44.1).
- Open Test Alliance for the JVM (opentest4j-1.3.0.jar, доступен, например, по адресу https://central.sonatype.com/artifact/org.opentest4j/opentest4j/1.3.0).

Для сборки MySQL Connector/J из исходного кода выполните следующие шаги:

Убедитесь, что у вас установлен JDK 1.8.x.
Получите исходные коды Connector/J одним из следующих способов:
- Загрузите архив распространения Connector/J, независимый от платформы (в формате .tar.gz или .zip), содержащий исходные коды, со страницы Загрузки Connector/J. Извлеките содержимое архива в папку, например, mysql-connector-j.
- Загрузите пакет RPM с исходными кодами Connector/J со страницы Загрузки Connector/J и установите его.
- Скачайте код из репозитория исходного кода MySQL Connector/J на GitHub по адресу https://github.com/mysql/mysql-connector-j. Последняя версия серии Connector/J 9.2 находится на ветке release/9.2; используйте следующую команду для ее скачивания:
```
$> git clone --branch release/9.2 https://github.com/mysql/mysql-connector-j.git
```
  В текущей директории будет создана поддиректория mysql-connector-j, содержащая необходимый код.
Поместите все необходимые сторонние библиотеки в папку lib в корне дерева исходных кодов (то есть в mysql-connector-j/lib, если вы следовали указаниям выше), или поместите их в другое место и укажите расположение в Ant позже (см. шаг 5 ниже).
Измените текущую рабочую директорию на mysql-connector-j, созданную на шаге 2.
В этой директории создайте файл build.properties, чтобы указать Ant расположение корневой директории установки JDK 1.8.x с помощью свойства com.mysql.cj.build.jdk, а также расположение дополнительных библиотек, если они не находятся в 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 и более поздним версиям, ряд свойств Ant для сборки Connector/J были переименованы или удалены; подробности см. в разделе 4.4.1.4, «Изменения свойств сборки».
Выполните следующую команду для компиляции драйвера и создания файла .jar для Connector/J:
```
$> ant build
```
Это создает директорию build в текущей директории, где хранятся результаты сборки. Под директорией build создается директория, имя которой включает номер версии выпуска, которую вы собираете. Эта директория содержит исходные коды, скомпилированные файлы .class и файл .jar для развертывания.

Для получения информации обо всех целевых задачах сборки, включая те, которые создают полностью упакованный дистрибутив, выполните следующую команду:
```
$> ant -projecthelp
```
Установите недавно созданный файл .jar для JDBC-драйвера, как вы устанавливаете двоичный файл .jar, который вы загружаете с MySQL, следуя инструкциям, приведенным в настройке CLASSPATH или настройке Connector/J для прикладных серверов.