在JBoss中配置多个数据库和数据源

2010-08-28 10:45:31来源:西部e网作者:

    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连接到更加牢固的数据库对于维护服务器的性能大有帮助。

关键词:JBossjava