将 MySQL JDBC 驱动程序添加到 Wildfly

太过爱你忘了你带给我的痛 2023-09-30 11:21 22阅读 0赞

开箱即用，Wildfly 仅附带 H2 JDBC 驱动程序。很可能，您有不同的数据库，例如 Oracle、MS SQL 或 MySQL。只要您可以访问 Wildfly，安装适当的 JDBC 驱动程序就相当简单。将其安装到 Wildfly 本身的优势在于，您可以为所有已部署的应用程序强制执行特定的 JDBC 驱动程序版本。但是，如果您要将应用程序部署到集群的 Wildfly，最好将 JDBC 驱动程序与您的应用程序一起部署。

Wildfly 的所有“扩展”都位于 WILDFLY\_HOME/modules/system/layers/base 中。如果您导航到此文件夹，您应该会看到包文件夹。这些包文件夹对应于扩展的包。让我们安装 MySQL JDBC 驱动程序，所以继续创建一个 com/mysql 文件夹树。在那里，您需要创建另一个文件夹，称为“main”。在此文件夹中，您需要复制[JDBC JAR 文件][JDBC JAR]（一定要获取最新的驱动程序！）并创建一个包含以下内容的 module.xml 文件：

<table style="width:673.344px;"> 
 <tbody> 
  <tr> 
   <td style="text-align:left;vertical-align:baseline;"> 
    <div style="margin-left:0;text-align:right;"> 
     <span style="color:#666666;"><span style="background-color:#ffffff;"><span style="background-color:#FFFFFF;"><span style="color:#afafaf;">1</span></span></span></span> 
    </div> 
    <div style="margin-left:0;text-align:right;"> 
     <span style="color:#666666;"><span style="background-color:#ffffff;"><span style="background-color:#FFFFFF;"><span style="color:#afafaf;">2</span></span></span></span> 
    </div> 
    <div style="margin-left:0;text-align:right;"> 
     <span style="color:#666666;"><span style="background-color:#ffffff;"><span style="background-color:#FFFFFF;"><span style="color:#afafaf;">3</span></span></span></span> 
    </div> 
    <div style="margin-left:0;text-align:right;"> 
     <span style="color:#666666;"><span style="background-color:#ffffff;"><span style="background-color:#FFFFFF;"><span style="color:#afafaf;">4</span></span></span></span> 
    </div> 
    <div style="margin-left:0;text-align:right;"> 
     <span style="color:#666666;"><span style="background-color:#ffffff;"><span style="background-color:#FFFFFF;"><span style="color:#afafaf;">5</span></span></span></span> 
    </div> 
    <div style="margin-left:0;text-align:right;"> 
     <span style="color:#666666;"><span style="background-color:#ffffff;"><span style="background-color:#FFFFFF;"><span style="color:#afafaf;">6</span></span></span></span> 
    </div> 
    <div style="margin-left:0;text-align:right;"> 
     <span style="color:#666666;"><span style="background-color:#ffffff;"><span style="background-color:#FFFFFF;"><span style="color:#afafaf;">7</span></span></span></span> 
    </div> 
    <div style="margin-left:0;text-align:right;"> 
     <span style="color:#666666;"><span style="background-color:#ffffff;"><span style="background-color:#FFFFFF;"><span style="color:#afafaf;">8</span></span></span></span> 
    </div> 
    <div style="margin-left:0;text-align:right;"> 
     <span style="color:#666666;"><span style="background-color:#ffffff;"><span style="background-color:#FFFFFF;"><span style="color:#afafaf;">9</span></span></span></span> 
    </div> </td> 
   <td style="text-align:left;vertical-align:baseline;width:633.438px;"> 
    <div style="margin-left:0;text-align:left;"> 
     <div style="margin-left:0;text-align:left;"> 
      <span style="color:#666666;"><span style="background-color:#ffffff;"><span style="background-color:#FFFFFF;"><code>&lt;</code><code>module</code> <code>xmlns</code><code>=</code><code>"urn:jboss:module:1.5"</code> <code>name</code><code>=</code><code>"com.mysql"</code><code>&gt;</code></span></span></span> 
     </div> 
     <div style="margin-left:0;text-align:left;"> 
      <span style="color:#666666;"><span style="background-color:#ffffff;"><span style="background-color:#FFFFFF;"><code>&nbsp;&nbsp;&nbsp;&nbsp;</code><code>&lt;</code><code>resources</code><code>&gt;</code></span></span></span> 
     </div> 
     <div style="margin-left:0;text-align:left;"> 
      <span style="color:#666666;"><span style="background-color:#ffffff;"><span style="background-color:#FFFFFF;"><code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>&lt;</code><code>resource-root</code> <code>path</code><code>=</code><code>"mysql-connector-java-8.0.12.jar"</code> <code>/&gt;</code></span></span></span> 
     </div> 
     <div style="margin-left:0;text-align:left;"> 
      <span style="color:#666666;"><span style="background-color:#ffffff;"><span style="background-color:#FFFFFF;"><code>&nbsp;&nbsp;&nbsp;&nbsp;</code><code>&lt;/</code><code>resources</code><code>&gt;</code></span></span></span> 
     </div> 
     <div style="margin-left:0;text-align:left;"> 
      <span style="color:#666666;"><span style="background-color:#ffffff;"><span style="background-color:#FFFFFF;"><code>&nbsp;&nbsp;&nbsp;&nbsp;</code><code>&lt;</code><code>dependencies</code><code>&gt;</code></span></span></span> 
     </div> 
     <div style="margin-left:0;text-align:left;"> 
      <span style="color:#666666;"><span style="background-color:#ffffff;"><span style="background-color:#FFFFFF;"><code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>&lt;</code><code>module</code> <code>name</code><code>=</code><code>"javax.api"</code><code>/&gt;</code></span></span></span> 
     </div> 
     <div style="margin-left:0;text-align:left;"> 
      <span style="color:#666666;"><span style="background-color:#ffffff;"><span style="background-color:#FFFFFF;"><code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>&lt;</code><code>module</code> <code>name</code><code>=</code><code>"javax.transaction.api"</code><code>/&gt;</code></span></span></span> 
     </div> 
     <div style="margin-left:0;text-align:left;"> 
      <span style="color:#666666;"><span style="background-color:#ffffff;"><span style="background-color:#FFFFFF;"><code>&nbsp;&nbsp;&nbsp;&nbsp;</code><code>&lt;/</code><code>dependencies</code><code>&gt;</code></span></span></span> 
     </div> 
     <div style="margin-left:0;text-align:left;"> 
      <span style="color:#666666;"><span style="background-color:#ffffff;"><span style="background-color:#FFFFFF;"><code>&lt;/</code><code>module</code><code>&gt;</code></span></span></span> 
     </div> 
    </div> </td> 
  </tr> 
 </tbody> 
</table>

完成后，您应该有一个如下所示的文件夹：

现在，我们需要告诉服务器新的 JDBC 驱动程序。打开您正在使用的配置文件（例如 WILDFLY\_HOME/standalone/configuration/standalone.xml），然后导航到“<drivers>”部分。您应该在此处看到对 H2 JDBC 驱动程序的引用。在 H2 的“<driver>”条目之后添加以下块：

<table> 
 <tbody> 
  <tr> 
   <td style="text-align:left;vertical-align:baseline;"> 
    <div style="margin-left:0;text-align:right;"> 
     <span style="color:#666666;"><span style="background-color:#ffffff;"><span style="background-color:#FFFFFF;"><span style="color:#afafaf;">1</span></span></span></span> 
    </div> 
    <div style="margin-left:0;text-align:right;"> 
     <span style="color:#666666;"><span style="background-color:#ffffff;"><span style="background-color:#FFFFFF;"><span style="color:#afafaf;">2</span></span></span></span> 
    </div> 
    <div style="margin-left:0;text-align:right;"> 
     <span style="color:#666666;"><span style="background-color:#ffffff;"><span style="background-color:#FFFFFF;"><span style="color:#afafaf;">3</span></span></span></span> 
    </div> 
    <div style="margin-left:0;text-align:right;"> 
     <span style="color:#666666;"><span style="background-color:#ffffff;"><span style="background-color:#FFFFFF;"><span style="color:#afafaf;">4</span></span></span></span> 
    </div> </td> 
   <td style="text-align:left;vertical-align:baseline;"> 
    <div style="margin-left:0;text-align:left;"> 
     <div style="margin-left:0;text-align:left;"> 
      <span style="color:#666666;"><span style="background-color:#ffffff;"><span style="background-color:#FFFFFF;"><code>&lt;</code><code>driver</code> <code>name</code><code>=</code><code>"mysql"</code> <code>module</code><code>=</code><code>"com.mysql"</code><code>&gt;</code></span></span></span> 
     </div> 
     <div style="margin-left:0;text-align:left;"> 
      <span style="color:#666666;"><span style="background-color:#ffffff;"><span style="background-color:#FFFFFF;"><code>&nbsp;</code><code>&lt;</code><code>driver-class</code><code>&gt;com.mysql.cj.jdbc.Driver&lt;/</code><code>driver-class</code><code>&gt;</code></span></span></span> 
     </div> 
     <div style="margin-left:0;text-align:left;"> 
      <span style="color:#666666;"><span style="background-color:#ffffff;"><span style="background-color:#FFFFFF;"><code>&nbsp;</code><code>&lt;</code><code>xa-datasource-class</code><code>&gt;com.mysql.cj.jdbc.MysqlXADataSource&lt;/</code><code>xa-datasource-class</code><code>&gt;</code></span></span></span> 
     </div> 
     <div style="margin-left:0;text-align:left;"> 
      <span style="color:#666666;"><span style="background-color:#ffffff;"><span style="background-color:#FFFFFF;"><code>&lt;/</code><code>driver</code><code>&gt;</code></span></span></span> 
     </div> 
    </div> </td> 
  </tr> 
 </tbody> 
</table>

添加后，退回您的服务器，您应该会在日志文件中看到以下消息，让您知道驱动程序已加载：

不要担心“不合规”消息。它仍然可以工作。

而已！您现在应该能够创建 MySQL 数据源。

如果您想知道如何为其他数据库安装 JDBC 驱动程序，步骤非常相似。您将遇到的问题是弄清楚驱动程序类、xa-数据源类、驱动程序名称和模块应该是什么。最简单的方法是查看[DataSourceTemplates.java][][官方 Wildfly 管理控制台源代码][Wildfly]中的文件. 它包含的驱动程序列表并不详尽，但确实包括所有主要驱动程序。

**编辑（2018 年 9 月）：**我更新了 module.xml 文件以使用新的 Driver 和 XA DataSource 类。据我了解，这些与 MySQL 5.x+ 兼容。

[JDBC JAR]: https://dev.mysql.com/downloads/connector/j/5.1.html
[DataSourceTemplates.java]: https://github.com/hal/core/blob/master/gui/src/main/java/org/jboss/as/console/client/shared/subsys/jca/model/DataSourceTemplates.java
[Wildfly]: https://github.com/hal/core