Создание модуля соединения WildFly с СУБД MySQL

Для работы приложений развернутых на сервера WildFly с базой данных MySQL необходимо создать новый модуль, содержащий JDBC драйвер СУБД MySQL. Архив с драйвером можно загрузить с официального сайта сервера баз данных MySQL.

На момент публикации материала, актуальной версией JDBC драйвера — 5.1.42. Скачиваем zip-архив с драйвером mysql-connector-java-5.1.42.zip и распаковываем его. Для установки на сервере приложений понадобится файл библиотеки драйвера mysql-connector-java-5.1.42-bin.jar. Рассмотрим по шагам создание нового модуля на сервере приложений для коннектора MySQL:

 

Шаг—1. Переходим в каталог развернутого сервера приложений WildFly — [каталог WildFly]\modules\system\layers\base\com\, где последовательно создаем дополнительные каталоги mysql → driver → main. Результатом нашей работы будет последовательность вложенных каталогов - ..\com\mysql\driver\main\. 

Шаг—2. Во вновь созданный каталог необходимо поместить jar файл из архива mysql-connector-java-5.1.42.zip: mysql-connector-java-5.1.42-bin.jar. Именно в данном файле и находится библиотека реализующая jdbc-драйвер для работы Java с СУБД MySQL.

Шаг—3. Имена созданных каталогов определяют имя нашего нового модуля [com.mysql.driver]. Для корректного развертывания модуля на сервере необходимо создать файл module.xml следующего содержания:

<?xml version="1.0" encoding="UTF-8"?>
<module xmlns="urn:jboss:module:1.3" name="com.mysql.driver">
	<resources>
		<resource-root path="mysql-connector-java-5.1.42-bin.jar"/>
	</resources>
	<dependencies>
		<module name="javax.api"/>
		<module name="javax.transaction.api"/>
	</dependencies>
</module>

Шаг—4. На данном этапе установим в настройках сервера сам класс драйвера, ответственного за создание соединения с базой данных MySQL. Переходим в каталог на сервере приложений: [каталог WildFly]\standalone\configuration и открыть на редактирование файл – standalone.xml. В данной файле переходим к разделу - drivers (между открывающимся и закрывающимся тегами <drivers>), добавляем новый раздел <driver>, с указанием класса, ответственных за создание соединения (сессии) с базой данных MySQL. После добавления нового раздела, содержимое файла дополнится следующей информацией:

<drivers>
	...
	<driver name="mysql" module="com.mysql.driver">
		<driver-class>com.mysql.jdbc.Driver</driver-class>
	</driver>
	...
</drivers>