這篇文章介紹了在JBoss4上使用各種主流 數(shù)據(jù)庫(kù) 的配置方法,翻譯出來(lái)的目的是為了方便大家使用JBoss4時(shí)作為一個(gè)參考。希望對(duì)廣大愛(ài)好 Java 、愛(ài)好JBoss的朋友有所幫助。
· 前言
Jboss 4.0的開(kāi)發(fā)人員版本是一個(gè)開(kāi)源的 應(yīng)用服務(wù)器 ,他把HypersonicDB作為他的缺省數(shù)據(jù)庫(kù)。然而,開(kāi)發(fā)人員也許還要使用除了HypersonicDB以外其他種類的數(shù)據(jù)庫(kù),在這篇文章中我們將看到如何在Jboss上配置使用其他的數(shù)據(jù)庫(kù)。
· 簡(jiǎn)介
Jboss4.0使用了JDBC配置文件來(lái)配置數(shù)據(jù)庫(kù)連接,它為 EJB 和其它 J2EE 應(yīng)用提供了數(shù)據(jù)源(data source)進(jìn)行訪問(wèn)。如果你要使用HypersonicDB以外的數(shù)據(jù)庫(kù)你就要修改這個(gè)配置文件。這篇文章將著重講解下面的幾個(gè)部分:
1) Jboss的EJB部署描述符
2) Oralce數(shù)據(jù)庫(kù)的配置
3) MySQL 數(shù)據(jù)庫(kù)的配置
4) Sysbase數(shù)據(jù)庫(kù)的配置
5) DB2 數(shù)據(jù)庫(kù)的配置
6) Infomix數(shù)據(jù)庫(kù)的配置
· Jboss的EJB部署描述符
standardjaws. XML (位于X:\jboss4\server\default\conf)是一個(gè)映射CMP 實(shí)體EJB的標(biāo)準(zhǔn)部署描述文件。它用于配置CMP實(shí)體EJB,你也可以使用jaws.xml代替。你可以把這個(gè)文件copy到ejb .jar文件中的META-INF目錄下。這個(gè)文件用于描述下面的信息:
1) 描述一個(gè)數(shù)據(jù)源和映射類型。
2) 描述EJB映射的表
3) 描述EJB的finder方法
4) 描述類型映射
這里的數(shù)據(jù)源描述的是一個(gè)JNDI名稱,可以通過(guò)這個(gè)JNDI來(lái)獲得一個(gè)數(shù)據(jù)源連接池。Jboss4缺省的數(shù)據(jù)源使用的是HypersonicDB。如果使用其他的數(shù)據(jù)源你需要修改jaws.xml文件。
standardjbosscmp-jdbc.xml(位于X:\jboss4\server\default\conf)是配置Jboss CMP容器的標(biāo)準(zhǔn)部署描述文件,你也可以使用一個(gè)自定義的配置文件--jbosscmp-jdbc.xml來(lái)代替它。這個(gè)文件也放在EJB.jar文件的META-INF目錄中。缺省使用的還是HypersonicDB作為數(shù)據(jù)庫(kù),這里也需要修改。
· Oracle 數(shù)據(jù)庫(kù)的配置
Oracle以它的運(yùn)行穩(wěn)定和可靠成為了一個(gè)非常受歡迎的企業(yè)級(jí)數(shù)據(jù)庫(kù)。要在Jboss 上配置使用Oracle的話我們要做的第一件事就是把Oracle的JDBC 驅(qū)動(dòng) 程序復(fù)制到ClassPath下。我們把這個(gè)JDBC驅(qū)動(dòng)程序復(fù)制到server/default/lib目錄下。為了使用Oracle的事務(wù)處理數(shù)據(jù)源我們還要把/docs/examples/jca/oracle-xa-ds.xml復(fù)制到/server/default/deploy目錄下。如果使用的事非事務(wù)處理的數(shù)據(jù)源,就把/docs/examples/jca/oracle-ds.xml文件復(fù)制到/server/default/deploy目錄下。
下一步,我們需要修改oracle-de.xml配置文件。其中的<driver-class/>標(biāo)簽和<connection-url/>標(biāo)簽的設(shè)置如下:
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的計(jì)算機(jī)主機(jī)名,<port>是oracle數(shù)據(jù)庫(kù)的端口,<database>是數(shù)據(jù)庫(kù)名稱。下一步,我們將修改standardjaws.xml 或jaws.xml配置文件,并把<datasource> 和 <type-mapping>元素這只為下面這樣:
<jaws>
<datasource>java:/OracleDS</datasource>
<type-mapping>Oracle8</type-mapping>
</jaws>
下一步,再修改standardjbosscmp-jdbc.xml 或 jbosscmp-jdbc.xml配置文件,設(shè)置<datasource> 和 <datasource-mapping>元素使用Oracle。
<jbosscmp-jdbc>
<defaults>
<datasource>java:/OracleDS</datasource>
<datasource-mapping>Oracle8</datasource-mapping>
</defaults>
</jbosscmp-jdbc>
最后我們需要修改login-config.xml文件來(lái)使用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數(shù)據(jù)庫(kù)配置
MySQL是一個(gè)開(kāi)放源代碼的數(shù)據(jù)庫(kù),有很多開(kāi)源項(xiàng)目和小型的社團(tuán)都在使用它。要在Jboss4中使用MySQL的話首先要把MySQL的JDBC驅(qū)動(dòng)放到CLASSPATH中。同樣,把它復(fù)制到/server/default/lib目錄下,再把/docs/examples/jca/mysql-ds.xml復(fù)制到/server/default/deploy目錄下。修改mysql-ds.xml文件,設(shè)置<driver-class/>為 com.mysql.jdbc.Driver再把<connection-url/>設(shè)置為
jdbc:mysql://<mysqlhost>/<database>,其中<mysqlhost>是數(shù)據(jù)庫(kù)主機(jī)名<database>是數(shù)據(jù)庫(kù)名。
然后需要設(shè)置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>元素設(shè)置為下面這樣:
<jbosscmp-jdbc>
<defaults>
<datasource>java:/MySqlDS</datasource>
<datasource-mapping>mySql</datasource-mapping>
</defaults>
</jbosscmp-jdbc>
最后再修改login-config.xml文件來(lái)使用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了。
· SysBase數(shù)據(jù)庫(kù)配置
Sybase Adaptive Server EntERPrises(ASE)是Sysbase公司的數(shù)據(jù)庫(kù)服務(wù)器。ASE可以在Unix和Linux平臺(tái)上使用。同樣我們要把它的數(shù)據(jù)庫(kù)驅(qū)動(dòng)放到CLASSPATH中,把它復(fù)制到/server/default/lib目錄下,然后把/docs/examples/jca/sybase-ds.XML 復(fù)制到/server/default/deploy目錄下。修改sybase-ds.xml文件把<driver-class/>設(shè)置為 com.sybase.jdbc2.jdbc.SybDriver再把<connection-url/>設(shè)置為 jdbc:sybase:Tds:<host>:<port>/<database>,其中<host><port><database>分別為主機(jī)名、端口名和數(shù)據(jù)庫(kù)名。同樣需要修改standardjaws.xml 或 jaws.xml 文件的 <datasource> 和<type-mapping> 元素:
<jaws>
<datasource>Java:/SybaseDS</datasource>
<type-mapping>Sybase</type-mapping>
</jaws>
再修改standardjbosscmp-jdbc.xml 或 jbosscmp-jdbc.xml 文件的 <datasource> 和 <datasource-mapping>元素:
<jbosscmp-jdbc>
<defaults>
<datasource>java:/SybaseDS</datasource>
<datasource-mapping>Sybase</datasource-mapping>
</defaults>
</jbosscmp-jdbc>
最后修改login-config.xml 文件來(lái)使用Sysbase數(shù)據(jù)庫(kù).設(shè)置 <application-policy/> 元素:
<application-policy name = "SybaseDbRealm">
<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=SybaseDS
</module-option>
</login-module>
</authentication>
</application-policy>
修改了sybase-ds.xml, standardjaws.xml, standardjbosscmp-jdbc.xml, 和
login-config.xml文件后就可以在JBOSS中使用Sysbase了。
· DB2數(shù)據(jù)庫(kù)配置
IBM的DB2是一個(gè)完善、使用方便的數(shù)據(jù)庫(kù)服務(wù)器,它可以在Linux,UNIX和windows/" target="_blank">Windows平臺(tái)上使用。在JBOSS4上使用DB2只要把db2java.zip復(fù)制到/server/default/lib目錄下。然后復(fù)制/docs/examples/jca/db2-ds.xml到/server/default/deploy目錄下,然后修改<driver-class/> 元素位 COM.ibm.db2.jdbc.app.DB2Driver , <connection-url/> 元素為 jdbc:db2:其中的<database>元素代表數(shù)據(jù)庫(kù)服務(wù)名。
<jaws>
<datasource>java:/DB2DS</datasource>
<type-mapping>DB2</type-mapping>
</jaws>
下面是相應(yīng)的 standardjbosscmp-jdbc.xml (或 jbosscmp-jdbc.xml)文件:
<jbosscmp-jdbc>
<defaults>
<datasource>java:/DB2DS</datasource>
<datasource-mapping>DB2</datasource-mapping>
</defaults>
</jbosscmp-jdbc>
最后在login-config.xml文件中加上下面的內(nèi)容:
<application-policy name = "DB2DbRealm">
<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=DB2DS
</module-option>
</login-module>
</authentication>
</application-policy>
完成上面的配置就可以在Jboss上使用DB2了
· Informix 數(shù)據(jù)庫(kù)配置
IBM的Infoxmix數(shù)據(jù)庫(kù)服務(wù)器用于作為數(shù)據(jù)倉(cāng)庫(kù)、分析和報(bào)告。在Jboss4上使用Informix數(shù)據(jù)庫(kù),首先要把它相應(yīng)的數(shù)據(jù)庫(kù)JDBC驅(qū)動(dòng)復(fù)制到/server/default/lib目錄下,然后,把/docs/examples/jca/informix-ds.xml 復(fù)制到 /server/default/deploy目錄下,如果你使用的是事務(wù)的(XA)JDBC就復(fù)制那個(gè)/docs/examples/jca/informix-xa-ds.xml文件。
下一步要作的就是修改這個(gè)informix-ds.xml文件,把<driver-class/>元素設(shè)置為:com.informix.jdbc.IfxDriver把<connection-url/>元素設(shè)置為
jdbc:informix-sqli://<host>:<port>:informixserver=<ifx_server>,
其中,<host>,<port>,<ifx_server>分別代表數(shù)據(jù)庫(kù)主機(jī)名、數(shù)據(jù)庫(kù)端口和數(shù)據(jù)庫(kù)服務(wù)名。然后修改standardjaws.xml 或 jaws.xml文件的<datasource> 和 <type-mapping>元素:
<post>
<jaws>
<datasource>java:/InformixDS</datasource>
<type-mapping>InformixDB</type-mapping>
</jaws>
把standardjbosscmp-jdbc.xml 或 jbosscmp-jdbc.xml文件中的<datasource> 和 <datasource-mapping>元素設(shè)置為下面這樣:
<jbosscmp-jdbc>
<defaults>
<datasource>java:/InformixDS</datasource>
<datasource-mapping>InformixDB</datasource-mapping>
</defaults>
</jbosscmp-jdbc>
最后在login-config.xml文件中加入<application-policy/>元素:
<application-policy name = "InformixDbRealm">
<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=InformixDS
</module-option>
</login-module>
</authentication>
</application-policy>
這樣,你就可以在Jboss4中使用Informix數(shù)據(jù)庫(kù)了。
· 結(jié)論
Jboss4默認(rèn)情況下使用的是Hypersonic數(shù)據(jù)庫(kù),但如你所見(jiàn)我們只要簡(jiǎn)單的修改幾個(gè)配置文件就可以使用市面上流行的其他數(shù)據(jù)庫(kù)了