JBoss EAP 6.1 中配置 MySQL 数据源教程

"该文档是关于在JBOSS环境中配置MySQL数据源的指南，主要针对JBOSS EAP 6.1版本。配置过程包括在指定目录下添加MySQL驱动模块，使用jboss-cli工具进行连接和配置数据源，以及设置数据源的相关属性如JNDI名称、服务器名和数据库名。" 在JBOSS企业应用平台（EAP）中配置数据源是系统集成的重要步骤，特别是对于依赖于关系型数据库的应用来说。在本例中，我们关注的是配置MySQL数据源，这是一个分布式（XA）数据源，适用于需要事务处理和高可用性的环境。以下是详细的配置步骤： 1. 添加MySQL驱动： 首先，需要将MySQL的JDBC驱动文件放置在指定的JBOSS模块目录下。通常，这会是`JBOSS_EAP_HOME\modules\system\layers\base\com\mysql`目录。在这里，你需要创建一个模块目录结构，例如`com.mysql.main`，并将MySQL的JDBC驱动jar文件放入其中。 2. 配置模块： 创建或编辑`module.xml`文件，位于上一步创建的模块目录下。文件内容应指明驱动名称、主类和其他相关属性，以指示JBOSS如何加载和使用MySQL驱动。 3. 启动jboss-cli工具： 打开命令行，导航到`JBOSS_EAP_HOME\bin`目录，并运行`jboss-cli.sh`（Linux/Mac）或`jboss-cli.bat`（Windows）来启动JBOSS命令行接口。 4. 连接JBOSS服务器： 使用`connect`命令连接到本地运行的JBOSS服务器，如`connect localhost`。确保服务器正在运行并且可以通过默认端口（如9999）访问。 5. 注册MySQL驱动： 通过jboss-cli执行命令来注册MySQL驱动，例如： ```bash /subsystem=datasources/jdbc-driver=mysql:add(driver-name=mysql, driver-module-name=com.mysql, driver-xa-datasource-class-name=com.mysql.jdbc.jdbc2.optional.MysqlXADataSource) ``` 这将告诉JBOSS驱动的名称、使用的模块和其对应的XADatasource类。 6. 创建数据源： 接下来，创建一个名为"Mysql"的分布式数据源： ```bash xa-data-source add --name=Mysql --jndi-name=java:jboss/datasources/NmsDmResourceDS --driver-name=mysql --xa-datasource-class=com.mysql.jdbc.jdbc2.optional.MysqlXADataSource ``` 这里指定了数据源的JNDI名称、驱动名称和数据源类。 7. 配置数据源属性： 设置数据源的具体属性，如服务器名和数据库名： ```bash /subsystem=datasources/xa-data-source=Mysql/xa-datasource-properties=ServerName:add(value=localhost) /subsystem=datasources/xa-data-source=Mysql/xa-data-source-properties=DatabaseName:add(value=nms_dm_resource_db) ``` 这将分别设置数据源连接的服务器地址和数据库名称。 8. 保存配置： 最后，所有更改都需要被保存到JBOSS的配置文件中，通常是`standalone.xml`或`domain.xml`，位于`JBOSS_EAP_HOME\standalone\configuration`目录下。如果使用jboss-cli，配置更改会被自动保存。 完成上述步骤后，JBOSS环境就配置好了使用MySQL的数据源，应用可以通过JNDI名称`java:jboss/datasources/NmsDmResourceDS`来查找并连接到数据库。这个过程确保了应用程序能正确地与MySQL数据库交互，执行查询、事务等操作。在实际部署环境中，还需要配置额外的参数，如用户名、密码、连接池大小等，以满足特定的应用需求和性能要求。