譯者語:
這篇文章介紹了在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:jboss4serverdefaultconf)是一個映射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:jboss4serverdefaultconf)是配置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了。