Jboss 4.0的开发人员版本是一个开源的应用服务器,他把HypersonicDB作为他的缺省数据库。然而,开发人员也许还要使用除了HypersonicDB以外其他种类的数据库,在这篇文章中我们将看到如何在Jboss上配置使用其他的数据库。
简介
Jboss4.0使用了JDBC配置文件来配置数据库连接,它为EJB和其它J2EE应用提供了数据源(data source)进行访问。如果你要使用HypersonicDB以外的数据库你就要修改这个配置文件。这篇文章将着重讲解下面的几个部分:
Jboss的EJB部署描述符
Oralce数据库的配置
MySQL数据库的配置
Sysbase数据库的配置
DB2数据库的配置
Infomix数据库的配置
Jboss的EJB部署描述符
standardjaws.xml (位于X:\jboss4\server\default\conf)是一个映射CMP 实体EJB的标准部署描述文件。它用于配置CMP实体EJB,你也可以使用jaws.xml代替。你可以把这个文件copy到ejb .jar文件中的META-INF目录下。这个文件用于描述下面的信息:
描述一个数据源和映射类型
描述EJB映射的表
描述EJB的finder方法
描述类型映射
这里的数据源描述的是一个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配置文件。其中的标签和标签的设置如下:
Oracle OCI Type 2 DriverClass: 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中是安装Oracle的计算机主机名,是oracle数据库的端口,是数据库名称。下一步,我们将修改standardjaws.xml 或jaws.xml配置文件,并把 和 元素这只为下面这样:
</database></database></port> </host></database></port> </host></database>
- <jaws>
- <datasource>java:/OracleDSdatasource>
- <type-mapping>Oracle8type-mapping>
- jaws>
下一步,再修改standardjbosscmp-jdbc.xml 或 jbosscmp-jdbc.xml配置文件,设置 和 元素使用Oracle。
- <jbosscmp-jdbc>
- <defaults>
- <datasource>java:/OracleDSdatasource>
- <datasource-mapping>Oracle8datasource-mapping>
- defaults>
- jbosscmp-jdbc>
最后我们需要修改login-config.xml文件来使用Oracle,下面是login-config.xml文件的元素:
- <application-policy name = "OracleDbRealm">
- <authentication>
- <login-module code = "org.jboss.resource.security.ConfiguredIdentityLoginModule" flag = "required">
- <module-option name = "principal">samodule-option>
- <module-option name = "userName">samodule-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文件,设置为 com.mysql.jdbc.Driver再把设置为
jdbc:mysql:///,其中是数据库主机名是数据库名。
然后需要设置standardjaws.xml 或 jaws.xml文件的和元素:- <jaws>
- <datasource>java:/MySqlDSdatasource>
- <type-mapping>mySqltype-mapping>
- jaws>
同样也需要把standardjbosscmp-jdbc.xml 或 jbosscmp-jdbc.xml文件的 和 元素设置为下面这样:
- <jbosscmp-jdbc>
- <defaults>
- <datasource>java:/MySqlDSdatasource>
- <datasource-mapping>mySqldatasource-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">samodule-option>
- <module-option name ="userName">samodule-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了。
SysBase数据库配置
Sybase Adaptive Server Enterprises(ASE)是Sysbase公司的数据库服务器。ASE可以在Unix和linux平台上使用。同样我们要把它的数据库驱动放到 CLASSPATH中,把它复制到/server/default/lib目录下,然后把/docs/examples/jca/sybase- ds.xml 复制到/server/default/deploy目录下。修改sybase-ds.xml文件把设置为 com.sybase.jdbc2.jdbc.SybDriver再把设置为 jdbc:sybase:Tds::/,其中分别为主机名、端口名和数据库名。同样需要修改standardjaws.xml 或 jaws.xml 文件的 和 元素:
- <jaws>
- <datasource>java:/SybaseDSdatasource>
- <type-mapping>Sybasetype-mapping>
- jaws>
再修改standardjbosscmp-jdbc.xml 或 jbosscmp-jdbc.xml 文件的 和 元素:
- <jbosscmp-jdbc>
- <defaults>
- <datasource>java:/SybaseDSdatasource>
- <datasource-mapping>Sybasedatasource-mapping>
- defaults>
- jbosscmp-jdbc>
最后修改login-config.xml 文件来使用Sysbase数据库.设置 元素:
- <application-policy name = "SybaseDbRealm">
- <authentication>
- <login-module code = "org.jboss.resource.security.ConfiguredIdentityLoginModule" flag = "required">
- <module-option name ="principal">samodule-option>
- <module-option name = "userName">samodule-option>
- <module-option name = "password">module-option>
- <module-option name = "managedConnectionFactoryName">
- jboss.jca:service=LocalTxCM,name=SybaseDS
- module-option>
- login-module>
- authentication>
- application-policy>
修改了sybase-ds.xml, standardjaws.xml, standardjbosscmp-jdbc.xml, 和login-config.xml文件后就可以在JBOSS中使用Sysbase了。
DB2数据库配置
IBM的DB2是一个完善、使用方便的数据库服务器,它可以在Linux,UNIX和Windows平台上使用。在JBOSS4上使用DB2只要把 db2java.zip复制到/server/default/lib目录下。然后复制/docs/examples/jca/db2-ds.xml到 /server/default/deploy目录下,然后修改 元素位 COM.ibm.db2.jdbc.app.DB2Driver , 元素为 jdbc:db2:其中的元素代表数据库服务名。- <jaws>
- <datasource>java:/DB2DSdatasource>
- <type-mapping>DB2type-mapping>
- jaws>
下面是相应的 standardjbosscmp-jdbc.xml (或 jbosscmp-jdbc.xml)文件:
- <jbosscmp-jdbc>
- <defaults>
- <datasource>java:/DB2DSdatasource>
- <datasource-mapping>DB2datasource-mapping>
- defaults>
- jbosscmp-jdbc>
最后在login-config.xml文件中加上下面的内容:
- <application-policy name = "DB2DbRealm">
- <authentication>
- <login-module code = "org.jboss.resource.security.ConfiguredIdentityLoginModule" flag = "required">
- <module-option name = "principal">samodule-option>
- <module-option name = "userName">samodule-option>
- <module-option name = "password">module-option>
- <module-option name = "managedConnectionFactoryName">
- jboss.jca:service=LocalTxCM,name=DB2DS
- module-option>
- login-module>
- authentication>
- application-policy>
完成上面的配置就可以在Jboss上使用DB2了
Informix 数据库配置
IBM的Infoxmix数据库服务器用于作为数据仓库、分析和报告。在Jboss4上使用Informix数据库,首先要把它相应的数据库 JDBC驱动复制到/server/default/lib目录下,然后,把/docs/examples/jca/informix-ds.xml 复制到 /server/default/deploy目录下,如果你使用的是事务的(XA)JDBC就复制那个 /docs/examples/jca/informix-xa-ds.xml文件。
下一步要作的就是修改这个informix-ds.xml文件,把元素设置为:com.informix.jdbc.IfxDriver把元素设置为
jdbc:informix-sqli://::informixserver=,
其中,,,分别代表数据库主机名、数据库端口和数据库服务名。然后修改standardjaws.xml 或 jaws.xml文件的 和 元素:- <jaws>
- <datasource>java:/InformixDSdatasource>
- <type-mapping>InformixDBtype-mapping>
- jaws>
把standardjbosscmp-jdbc.xml 或 jbosscmp-jdbc.xml文件中的 和 元素设置为下面这样:
- <jbosscmp-jdbc>
- <defaults>
- <datasource>java:/InformixDSdatasource>
- <datasource-mapping>InformixDBdatasource-mapping>
- defaults>
- jbosscmp-jdbc>
最后在login-config.xml文件中加入元素:
- <application-policy name = "InformixDbRealm">
- <authentication>
- <login-module code = "org.jboss.resource.security.ConfiguredIdentityLoginModule" flag = "required">
- <module-option name = "principal">samodule-option>
- <module-option name = "userName">samodule-option>
- <module-option name = "password">module-option>
- <module-option name ="managedConnectionFactoryName">
- jboss.jca:service=LocalTxCM,name=InformixDS
- module-option>
- login-module>
- authentication>
- application-policy>
这样,你就可以在Jboss4中使用Informix数据库了。
结论
Jboss4默认情况下使用的是Hypersonic数据库,但如你所见我们只要简单的修改几个配置文件就可以使用市面上流行的其他数据库了。