译者语:
这篇文章介绍了在JBoss4上使用各种主流数据库的配置方法,翻译出来的目的是为了方便大家使用JBoss4时作为一个参考。希望对广大爱好Java、爱好JBoss的朋友有所帮助。
前言
Jboss 4.0的开发人员版本是一个开源的应用服务器,他把HypersonicDB作为他的缺省数据库。然而,开发人员也许还要使用除了HypersonicDB以外其他种类的数据库,在这篇文章中我们将看到如何在Jboss上配置使用其他的数据库。
简介
Jboss4.0使用了JDBC配置文件来配置数据库连接,它为EJB和其它J2EE应用提供了数据源(data source)进行访问。如果你要使用HypersonicDB以外的数据库你就要修改这个配置文件。这篇文章将着重讲解下面的几个部分:
l Jboss的EJB部署描述符
l Oralce数据库的配置
l MySQL数据库的配置
l Sysbase数据库的配置
l DB2数据库的配置
l Infomix数据库的配置
Jboss的EJB部署描述符
standardjaws.xml (位于X:\jboss4\server\default\conf)是一个映射CMP 实体EJB的标准部署描述文件。它用于配置CMP实体EJB,你也可以使用jaws.xml代替。你可以把这个文件copy到ejb .jar文件中的META-INF目录下。这个文件用于描述下面的信息:
l 描述一个数据源和映射类型。
l 描述EJB映射的表
l 描述EJB的finder方法
l 描述类型映射
这里的数据源描述的是一个JNDI名称,可以通过这个JNDI来获得一个数据源连接池。Jboss4缺省的数据源使用的是HypersonicDB。如果使用其他的数据源你需要修改jaws.xml文件。
standardjbosscmp-jdbc.xml(位于X:\jboss4\server\default\conf)是配置Jboss CMP容器的标准部署描述文件,你也可以使用一个自定义的配置文件--jbosscmp-jdbc.xml来代替它。这个文件也放在EJB.jar文件的META-INF目录中。缺省使用的还是HypersonicDB作为数据库,这里也需要修改。
Oracle数据库的配置
Oracle以它的运行稳定和可靠成为了一个非常受欢迎的企业级数据库。要在Jboss 上配置使用Oracle的话我们要做的第一件事就是把Oracle的JDBC驱动程序复制到ClassPath下。我们把这个JDBC驱动程序复制到server/default/lib目录下。为了使用Oracle的事务处理数据源我们还要把/docs/examples/jca/oracle-xa-ds.xml复制到/server/default/deploy目录下。如果使用的事非事务处理的数据源,就把/docs/examples/jca/oracle-ds.xml文件复制到/server/default/deploy目录下。
下一步,我们需要修改oracle-de.xml配置文件。其中的<driver-class/>标签和<connection-url/>标签的设置如下:
Oracle OCI Type 2 Driver
Class: oracle.jdbc.driver.OracleDriver
URL: jdbc:oracle:oci8:@<database>
Oracle OCI Thin Type 4 Driver
Class: oracle.jdbc.driver.OracleDriver
URL: jdbc:oracle:thin:@<host>:<port>:<database>
Oracle OCI XA Type 2 Driver
Class: oracle.jdbc.xa.client.OracleXADataSource
URL: jdbc:oracle:thin:@<host>:<port>:<database>
Oracle OCI Type 2 Driver
Class: oracle.jdbc.driver.OracleDriver
URL: jdbc:oracle:oci8:@<database>
在Connection URL中<host>是安装Oracle的计算机主机名,<port>是oracle数据库的端口,<database>是数据库名称。下一步,我们将修改standardjaws.xml 或jaws.xml配置文件,并把<datasource> 和 <type-mapping>元素这只为下面这样:
<jaws>
<datasource>java:/OracleDS</datasource>
<type-mapping>Oracle8</type-mapping>
</jaws>
下一步,再修改standardjbosscmp-jdbc.xml 或 jbosscmp-jdbc.xml配置文件,设置<datasource> 和 <datasource-mapping>元素使用Oracle。
<jbosscmp-jdbc>
<defaults>
<datasource>java:/OracleDS</datasource>
<datasource-mapping>Oracle8</datasource-mapping>
</defaults>
</jbosscmp-jdbc>
最后我们需要修改login-config.xml文件来使用Oracle,下面是login-config.xml文件的<application-policy>元素:
<application-policy name = "OracleDbRealm">
<authentication>
<login-module code =
"org.jboss.resource.security.ConfiguredIdentityLoginModule"
flag = "required">
<module-option name = "principal">sa</module-option>
<module-option name = "userName">sa</module-option>
<module-option name = "password"></module-option>
<module-option name ="managedConnectionFactoryName">
jboss.jca:service=LocalTxCM,name=OracleDS
</module-option>
</login-module>
</authentication>
</application-policy>
修改了oracle-ds.xml, standardjaws.xml, standardjbosscmp-jdbc.xml,和
login-config.xml 文件之后就可以再Jboss4中使用Oracle了。
MySQL数据库配置
MySQL是一个开放源代码的数据库,有很多开源项目和小型的社团都在使用它。要在Jboss4中使用MySQL的话首先要把MySQL的JDBC驱动放到CLASSPATH中。同样,把它复制到/server/default/lib目录下,再把/docs/examples/jca/mysql-ds.xml复制到/server/default/deploy目录下。修改mysql-ds.xml文件,设置<driver-class/>为 com.mysql.jdbc.Driver再把<connection-url/>设置为
jdbc:mysql://<mysqlhost>/<database>,其中<mysqlhost>是数据库主机名<database>是数据库名。
然后需要设置standardjaws.xml 或 jaws.xml文件的<datasource>和<type-mapping>元素:
<jaws>
<datasource>java:/MySqlDS</datasource>
<type-mapping>mySql</type-mapping>
</jaws>
同样也需要把standardjbosscmp-jdbc.xml 或 jbosscmp-jdbc.xml文件的<datasource> 和 <datasource-mapping>元素设置为下面这样:
<jbosscmp-jdbc>
<defaults>
<datasource>java:/MySqlDS</datasource>
<datasource-mapping>mySql</datasource-mapping>
</defaults>
</jbosscmp-jdbc>
最后再修改login-config.xml文件来使用MySQL:
<application-policy name = "MySqlDbRealm">
<authentication>
<login-module code =
"org.jboss.resource.security.ConfiguredIdentityLoginModule"
flag = "required">
<module-option name ="principal">sa</module-option>
<module-option name ="userName">sa</module-option>
<module-option name ="password"></module-option>
<module-option name ="managedConnectionFactoryName">
jboss.jca:service=LocalTxCM,name=MySqlDS
</module-option>
</login-module>
</authentication>
</application-policy>
修改了mysql-ds.xml, standardjaws.xml, standardjbosscmp-jdbc.xml,和login-config.xml 文件就可以在Jboss上使用MySQL了。