此摘录摘自《从Tomcat到WildFly 》一书，您将在其中学习如何将现有的Tomcat体系结构移植到WildFly，包括服务器配置和在其顶部运行的应用程序。

WildFly是完全兼容的Java Enterprise Edition 7容器，与Tomcat相比，它具有更多的可用服务和选项集。

这本书还将使您了解迁移期间可能发生的最常见的陷阱和弊端。

1.简介

问题：我在Tomcat上有一个数据源配置，该配置用于从池中收集数据库连接。我需要在WildFly上移植我的配置。

在Apache Tomcat上，数据源配置可以包含在server.xml文件的global部分中。例如，这是流行的MySQL数据库的配置：

<Resource name="jdbc/mysqlds" auth="Container" type="javax.sql.DataSource"maxActive="100" maxIdle="30" maxWait="10000"username="tomcat" password="tomcat"driverClassName="com.mysql.jdbc.Driver"url="jdbc:mysql://localhost:3306/mydatabase"/>

另外，对于特定于应用程序的内容，应在WEB-INF / web.xml上放置以下几行。

<web-app xmlns="http://java.sun.com/xml/ns/j2ee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd" version="2.4"><description>Tomcat DB</description><resource-ref><description>Database Connection</description><res-ref-name>jdbc/mysqlds</res-ref-name><res-type>javax.sql.DataSource</res-type><res-auth>Container</res-auth></resource-ref>
</web-app>

为了能够加载MySQL JDBC驱动程序，您需要在CATALINA_HOME / lib文件夹中包含JAR库：

让我们看看如何在WildFly中配置数据源配置。这可以通过多种方式完成，但是所有可能的解决方案都涉及以下步骤：

将JDBC驱动程序安装为模块
在应用程序服务器上注册JDBC驱动程序
配置使用JDBC驱动程序的数据源

我们将看到推荐的方法，该方法需要使用命令行界面，尽管我们将提到一些可用的替代方法。

2.将JDBC驱动程序作为模块安装

WildFly基于每个库本身都是模块的假设。因此，我们首先将JDBC驱动程序变成一个模块。这可以通过在JBOSS_HOME / modules目录下创建文件路径结构来完成。例如，为了安装MySQL JDBC驱动程序，请创建如下的目录结构： JBOSS_HOME / modules / com / mysql / main 。

将JDBC驱动程序JAR复制到主子目录中。
在主子目录中，创建一个包含以下定义的module.xml文件（只需根据您的情况修改JDBC驱动程序名称）：

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

也可以使用命令行界面通过单个命令来完成上述过程，该命令将创建文件系统结构，将JDBC驱动程序复制到主文件夹中，并根据提供给CLI的选项来配置module.xml 。

假设MySQL JDBC驱动程序在/ home / wildfly文件夹中可用，请按以下步骤操作 ：

module add --name=com.mysql --resources=/home/wildfly/mysql-connector-java-5.1.24-bin.jar --dependencies=javax.api,javax.transaction.api

3.在应用程序服务器上注册JDBC驱动程序

现在您的MySQL可以作为应用服务器上的模块使用，我们将其注册为JDBC驱动程序。使用CLI时，这是一步操作：

/subsystem=datasources/jdbc-driver=mysql:add(driver-name=mysql,driver-module-name=com.mysql)

现在，您可以检查您的MySQL驱动程序是否已通过可用的JDBC驱动程序注册。这是您可以实现的方法：

[standalone@localhost:9990 /] /subsystem=datasources:installed-drivers-list
{. . . . . . . . . . ."driver-name" => "mysql","deployment-name" => undefined,"driver-module-name" => "com.mysql","module-slot" => "main","driver-datasource-class-name" => "","driver-xa-datasource-class-name" => "","driver-class-name" => "com.mysql.jdbc.Driver","driver-major-version" => 5,"driver-minor-version" => 1,"jdbc-compliant" => false        }]
}

4.配置使用JDBC驱动程序的数据源

最后一步实际上将创建一个供应用程序使用的数据源。为此，我们将使用CLI 数据源快捷方式命令，该命令要求输入池名称，JNDI绑定，JDBC连接参数以及最后的安全设置（用户名和密码）作为输入：

data-source add --jndi-name=java:/jdbc/mysqlds --name=MySQLPool --connection-url=jdbc:mysql://localhost:3306/mydatabase --driver-name=mysql --user-name=jboss --password=jboss

请注意，数据源的JNDI名称必须使用前缀java：/才能被接受为有效。因此，tomcat中使用的绑定（“ jdbc / mysqlds”）已更改为“ java：/ jdbc / mysqlds”。

5.配置输出

如果已执行上述步骤，则应在“数据源”部分中使用以下数据源配置：

<datasources><datasource jndi-name="java:/jdbc/mysqlds" pool-name="MySQLPool" enabled="true"><connection-url>jdbc:mysql://localhost:3306/mydatabase</connection-url><driver>mysql</driver><security><user-name>jboss</user-name><password>jboss</password></security></datasource><drivers><driver name="mysql" module="com.mysql"/></drivers></datasources>

6.将数据源参数移植到WildFly

在应用程序服务器上配置数据源是在WildFly上移植应用程序的第一个里程碑。但是，可能您正在使用某些特定的连接池设置，这需要在应用程序服务器上进行移植。其中一些参数在WildFly上具有相同的匹配项，其他一些则基于不同的合并策略。因此，在将它们移植到应用程序服务器时，您需要调整配置。让我们看看如何将最常见的池选项移植到WildFly：

最小和最大池大小

选择正确的池大小是应用程序性能的必要条件。 Tomcat的最小池大小由minIdle参数确定，最大池大小通过maxActive配置。另一方面，池的初始大小是使用initialSize参数配置的。这是一个示例配置：

<Resource name="jdbc/mysqlds" auth="Container" type="javax.sql.DataSource"maxActive="100" minIdle="30" initialSize=”15” username="tomcat" password="tomcat"driverClassName="com.mysql.jdbc.Driver"url="jdbc:mysql://localhost:3306/mydatabase"/>

移植到WildFly时，参数分别命名为min-pool-size和max-pool-size，并且可以使用任何管理工具进行设置。更改默认数据源的方法如下：

/subsystem=datasources/data-source=ExampleDS/:write-attribute(name=min-pool-size,value=30)
/subsystem=datasources/data-source=ExampleDS/:write-attribute(name=max-pool-size,value=100)

另一方面，可以使用以下方法设置初始池大小 ：

/subsystem=datasources/data-source=ExampleDS/:write-attribute(name=initial-pool-size,value=5)

另外请注意，WildFly还有一个名为pool- prefill的属性，该属性确定是否尝试将连接池预填充到最小连接数：

/subsystem=datasources/data-source=ExampleDS/:write-attribute(name=pool-prefill,value=true)

处理空闲连接

已创建但应用程序未使用的连接被分类为空闲连接。 WildFly和Tomcat具有处理空闲连接的不同方法。更详细地，Tomcat使用minIdle和maxIdle参数分别确定应保留在池中的空闲连接的最小和最大。我们已经讨论过minIdle参数，可以将其变为WildFly min-pool-size 。另一方面，在WildFly上，maxIdle参数没有相应的匹配项。最接近的匹配是第i DLE-超时分钟 ，这之后，未使用的连接被关闭分钟（缺省15分钟）的数量。您实际上可以将这个参数更改为10分钟，如下所示：

/subsystem=datasources/data-source=ExampleDS/:write-attribute(name=idle-timeout-minutes,value=10)

在获取连接时设置超时

如果池中的所有连接都忙，则您的应用程序显然必须等待连接被释放。可以想象，这种情况存在超时，由Tomcat中的maxWait参数处理。在以下示例中，超时设置为30秒：

<Resource name="jdbc/mysqlds" auth="Container" type="javax.sql.DataSource"maxWait="30000" . . . . />

WildFly有一个对应的参数，名为blocking-timeout-wait-millis ；在以下CLI命令中，我们将其设置为1秒（1000毫秒）：

/subsystem=datasources/data-source=ExampleDS/:write-attribute(name=blocking-timeout-wait-millis,value=1000)

处理连接泄漏

连接泄漏在Tomcat中被称为“ 废弃的连接 ”，它是在创建Statement或PreparedStatement或CallableStatement时发生的，并且您错过了关闭连接或语句的时间（或更常见的是，您不包括Connection）最后关闭）。

您可以通过启用removeAbandoned参数来处理Tomcat中的废弃连接。如果设置为true，则如果连接的使用时间未超过removeAbandonedTimeout （默认为300秒），则该连接将被视为可以删除。

<Resource name="jdbc/mysqlds" auth="Container" type="javax.sql.DataSource"removeAbandoned ="true"  removeAbandonedTimeout=”300”. . . . />

在WildFly方面，没有任何针对突然关闭合格（已废弃）的连接的调整。另一方面，有一些有用的参数可用于检测或跟踪问题。

如果您担心语句（和PreparedStatements），则可以使用track-statements参数，该参数在连接返回到池时检查未关闭的语句，并在关闭语句/返回到准备好的语句高速缓存时关闭结果集。有效值为：

false：不跟踪语句和结果
true：跟踪语句和结果集，并在未关闭时发出警告
nowarn：跟踪语句，但不警告其未关闭

这是设置此参数以使用NOWARN的方法：

/subsystem=datasources/data-source=ExampleDS/:write-attribute(name=track-statements,value=NOWARN)

此外，您可以启用缓存层的调试，这由WildFly由连接器子系统（JCA）的一部分“ 缓存的连接管理”来处理。

/subsystem=jca/cached-connection-manager=cached-connection-manager/:write-attribute(name=debug,value=true)

您还应该启用error参数，该参数将使您检测与缓存的连接管理器连接的任何错误：

/subsystem=jca/cached-connection-manager=cached-connection-manager/:write-attribute(name=error,value=true)

启用日志记录后，对于从池中获取的每个连接，您将看到以下信息：

DEBUG [org.jboss.jca.core.connectionmanager.pool.strategy.OnePool] (MSC service thread 1-4) {JNDI_NAME}: getConnection(null, null) [1/100]

另一方面，当连接返回到池时，您将阅读以下消息：

DEBUG [org.jboss.jca.core.connectionmanager.pool.strategy.OnePool] (MSC service thread 1-4) {JNDI_NAME}: returnConnection(607e334, false) [1/99]

如果要调试应用程序发出的语句，则可以轻松找出连接泄漏的位置。

最后，如果您想了解有关JDBC级别的详细信息，可以通过将名为spy的属性设置为true来记录JDBC语句：

/subsystem=datasources/data-source=MySQLPool/:write-attribute(name=spy,value=true)

为了调试服务器日志中的JDBC语句，您需要创建一个logger元素，该元素可跟踪jboss.jdbc.spy包。您可以按照以下步骤进行操作：

/subsystem=logging/logger=jboss.jdbc.spy/:add(level=TRACE)

重新加载服务器配置并检查服务器日志，这些日志默认包含在JBOSS_HOME / standalone / log / server.log （独立模式）或JBOSS_HOME / domain / [服务器名称] /log/server.log （域模式）中。

配置语句缓存

“ Prepared Statement”是数据库上的预编译对象，其访问计划将被重用以比正常查询更快地执行更多查询。当需要在不同请求中发出相同的语句时，应用程序服务器本身也可以缓存准备好的语句。 Tomcat的jdbc-pool功能可以使用JDBC拦截器来管理Prepared Statement缓存，该拦截器在创建池时被设置为JDBC属性。例如：

<Resource name="jdbc/mysqlds" auth="Container" type="javax.sql.DataSource"jdbcInterceptors="StatementCache(prepared=true,callable=false,max=50)"
</Resource>

在WildFly上运行时，您可以通过编写prepare -statements-cache-size属性来设置PreparedStatement缓存大小，如以下示例所示，该属性将其大小设置为25条语句：

/subsystem=datasources/data-source=ExampleDS/:write-attribute(name=prepared-statements-cache-size,value=25)

此摘录摘自《从Tomcat到WildFly 》一书，您将在其中学习如何将现有的Tomcat体系结构移植到WildFly，包括服务器配置和在其顶部运行的应用程序。 您还将了解迁移过程中可能发生的最常见的陷阱和弊端。

自1999年以来，Apache Tomcat是Apache软件基金会作为开源项目开发的流行Web服务器和Servlet容器。今天，它是在简单站点和大型网络中运行Web应用程序的最广泛使用的平台之一。

尽管如此，Apache Tomcat上可用的库数量通常仅够用于仅需HTTP协议和有限数量服务的非常简单的体系结构。 这自然导致了通过新扩展或模块（例如Spring，Hibernate，JDO或Struts）增加其功能的趋势。 尽管本书的目的不是要对这些体系结构产生负面影响，但我们确实相信，对其他解决方案的比较知识可以帮助您为项目选择最佳方案。