jboss是一款非常强大的j2ee应用程序服务器，但是这种强大的功能也带来了复杂性。本文作者marcus zarra分析了如何在jboss中配置多个数据库以及数据源。
　　
　　配置数据源
　　jboss的默认安装过程总共有三种配置选项：所有的（all）、默认的（default）和最小的（minimal）。如果你第一次启动jboss服务器的时候没有附带任何参数，它自然就运行了默认配置。如果需要运行其它的配置，就必须使用-c参数运行启动脚本，如下所示：
　　
　　${jboss.root}/bin/run.sh -c minimal
　　
　　用这种方式启动jboss就指示它使用最小的服务器配置代替默认的配置。但是试图改变jboss自身的配置的时候，这种技术是非常有用的。你可以在不同的配置中进行修改操作，如果有必要就回滚到默认配置。可是，你在弄混数据源之前，应该把默认配置复制一份，这样就可以安全地操作该副本了（在本文中，我把自己的副本叫作example，因此在服务器目录中有四种配置信息：所有的、默认的、最小的和example）。
　　
　　在jboss中改变默认数据源的第一步是配置一个新数据源。jboss中所有的数据库配置都在你所工作的服务器目录下的deploy目录中定义的（在例子中是server/example/deploy）。jboss使用的默认数据库是纯java数据库hypersonic。这个数据库的配置信息位于hsqldb-ds.xml文件中。这个xml配置文件描述了如何连接到hypersonic数据库。删除这个文件中的所有注释之后，我们得到如下所示的配置信息：
　　
　　＜?xml version="1.0" encoding="utf-8"?＞
　　＜datasources＞
　　＜local-tx-datasource＞
　　＜jndi-name＞defaultds＜/jndi-name＞
　　＜connection-url＞
　　jdbc:hsqldb:${jboss.server.data.dir}${/}hypersonic${/}localdb
　　＜/connection-url＞
　　＜driver-class＞org.hsqldb.jdbcdriver＜/driver-class＞
　　＜user-name＞sa＜/user-name＞
　　＜password＞＜/password＞
　　＜min-pool-size＞5＜/min-pool-size＞
　　＜max-pool-size＞20＜/max-pool-size＞
　　＜idle-timeout-minutes＞0＜/idle-timeout-minutes＞
　　＜track-statements/＞
　　＜security-domain＞hsqldbrealm＜/security-domain＞
　　＜depends＞jboss:service=hypersonic,database=localdb＜/depends＞
　　＜/local-tx-datasource＞
　　＜mbean code="org.jboss.jdbc.hypersonicdatabase" name="jboss:service=hypersonic,database=localdb"＞
　　＜attribute name="database"＞localdb＜/attribute＞
　　＜attribute name="inprocessmode"＞true＜/attribute＞
　　＜/mbean＞
　　＜/datasources＞
　　
　　这些参数中的大多数与jdbc的参数相似。根（root）下的第一个部分是＜local-tx-datasource＞。这是你定义数据库以及如何连接该数据库的位置：驱动程序、url、用户名和密码。你还定义了连接池中应该有多少个连接。
　　
　　第二步分包含了两个有趣的参数：
　　
　　? ＜security-domain＞允许你在login-config.xml文件中而不是在数据源配置信息中配置数据库的用户名和密码。
　　
　　? ＜depends＞指定该服务只有在它所依赖的服务启动后才启动。该参数允许你编写数据库应该正确运行的服务。＜depends＞标签还指示jboss根据需要关闭某些数据项。示例中的这个标记表明mbean必须在数据库启动之前启动，在数据库关闭之后关闭。
　　
　　在定义好数据源之后，服务器的其它部分就可以使用它了。希望使用这个数据源的任何其它服务或配置都必须使用jndi名称来引用它。在示例中，jndi名称是defaultds。
　　
　　添加另一个数据源
　　为了给jboss添加另一个数据源，你需要建立一个新的配置文件。我希望建立一个数据源，它连接到我本机的mysql数据库，并专门使用example数据库。为了达到这个目标，我建立了一个与前面一个类似的配置文件：
　　
　　＜?xml version="1.0" encoding="utf-8"?＞
　　＜datasources＞
　　＜local-tx-datasource＞
　　＜jndi-name＞exampleds＜/jndi-name＞
　　＜connection-url＞jdbc:mysql://localhost/example＜/connection-url＞
　　＜driver-class＞org.gjt.mm.mysql.driver＜/driver-class＞
　　＜user-name＞exampleuser＜/user-name＞
　　＜password＞examplepassword＜/password＞
　　＜min-pool-size＞5＜/min-pool-size＞
　　＜max-pool-size＞20＜/max-pool-size＞
　　＜idle-timeout-minutes＞0＜/idle-timeout-minutes＞
　　＜track-statements/＞
　　＜/local-tx-datasource＞
　　＜/datasources＞
　　
　　我建立了名为exampleds的数据源，它通过jdbc，使用用户名exampleuser和密码examplepassword连接到一个mysql数据库。我还特别指定连接池最少有5个连接，最多不超过20个连接，并且这些连接不能空闲。接着我把这个文件存储为deploy目录中的example-ds.xml（这个文件的名称并不重要，但是名称一致是有好处的）。
　　
　　由于我的新数据源不需要、也不依赖于任何其它的模块，配置信息中就没有＜depends＞标签。同时，由于我在这个文件中指定了使用数据库的用户名和密码，我也不需要参照安全域（security domain）。
　　
　　使用新的数据源
　　现在我希望把jboss中的一些服务移动到我的新数据源上。其原因很简单：尽管hypersonic是一个良好的数据库，但是它不应该用于产品环境和/或高容量（high-traffic）系统；mysql和其它几个数据库可以更好地扮演这个角色。
　　
　　java消息服务
　　jboss服务器中使用数据库的一个最常见的部分是消息服务。服务器的这部分的容量很大，并且应该使用我的新数据源。deploy/jms目录中的下面两个文件定义了消息服务如何使用数据源：
　　
　　? hsqldb-jdbc-state-service.xml
　　? hsqldb-jdbc2-service.xml
　　
　　首先，我修改了其中一个文件的名称以突出数据库的类型：把hsqldb-jdbc-state-service.xml 更名为mysql-jdbc-state-service.xml。我对mysql-jdbc-state-service.xml文件只作了一点点修改：＜depends＞标签应该引用新的exampleds数据源而不是默认的defaultds。这可以确保该数据源在消息服务启动前启动了。我还改变了注释信息，表明我用mysql数据库代替了默认的hypersonic数据库。
　　下一步，应该删除并替换hsqldb-jdbc2-service.xml文件。由于这个文件定义了消息服务如何使用数据库，我们必须在该文件中提供特定数据库的信息。幸运的是，对于大多数通用的数据库来说，jboss替我们完成了这项工作。我从${jboss.root}/doc/examples/jms检索到mysql特定的文件（mysql-jdbc2-service.xml），并把它放到deploy/jms目录中。我只对该文件作了一个很小的修改，把数据源的名称改变为exampleds，与我在数据源配置文件中指定的jndi名称相匹配。
　　
　　最后，为了使消息服务完全转变，我把conf/login-config.xml文件中的defaultds改为exampleds。这个设置告诉jboss，与消息服务相关的登录信息也使用example数据库。
　　
　　调度管理器
　　如果你要使用jboss的调度管理器和它的数据库调度程序（scheduler），你也必须指向新的数据源。该配置文件位于deploy/schedule-manager-service.xml。搜索这个文件中的defaultds，找到需要重新配置的mbean，我把该mbean的datasourceproperty（数据源属性）指向exampleds，替代了指向defaultds。
　　
　　请注意，一定要检查一个sql语句，以确保使用你的数据库工作正常。
　　
　　默认的容器控制（container-managed）持续性
　　
　　为了改变默认的维持bean（bean-persistence）的数据库，你必须更新conf/standardjbosscmp-jdbc.xml文件，把defaultds修改为exampleds。此外，你还必须更新＜type-mapping＞标签以匹配新数据库；这个标签的值位于该文件中更深入的地方。对于本文的例子，我把这个值改变为mysql。
　　
　　你还应该采用相同的方法更新conf/standardjaws.xml文件：把defaultds改变为exampleds，并更新＜type-mapping＞标签，以反映使用的数据库的类型。
　　
　　包装
　　为了确保所有部分都转换到了新数据源上，请删除deploy/hsqldb-ds.xml文件并启动jboss。如果产生了任何错误，就说明你遗漏了某些配置文件。
　　
　　总之，我发现使用内建的hypersonic数据库进行开发比管理外部的数据库带来的痛苦要少一些。但是在产品环境中，hypersonic是不适合任务需要的。把jboss连接到更加牢固的数据库对于维护服务器的性能大有帮助。