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配置文件。其中的<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">
修改了oracle-ds.xml, standardjaws.xml, standardjbosscmp-jdbc.xml,和
<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>
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了。
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文件把<driver-class/>設置為 com.sybase.jdbc2.jdbc.SybDriver再把<connection-url/>設置為 jdbc:sybase:Tds:<host>:<port>/<database>,其中<host><port><database>分別為主機名、端口名和數據庫名。同樣需要修改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 文件來使用Sysbase數據庫.設置 <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數據庫配置
IBM的DB2是一個完善、使用方便的數據庫服務器,它可以在Linux,UNIX和Windows平台上使用。在JBOSS4上使用DB2只要把db2java.zip復制到/server/default/lib目錄下。然後復制/docs/examples/jca/db2-ds.xml到/server/default/deploy目錄下,然後修改<driver-class/> 元素位 COM.ibm.db2.jdbc.app.DB2Driver , <connection-url/> 元素為 jdbc:db2:其中的<database>元素代表數據庫服務名。
<jaws>
<datasource>java:/DB2DS</datasource>
<type-mapping>DB2</type-mapping>
</jaws>
下面是相應的 standardjbosscmp-jdbc.xml (或 jbosscmp-jdbc.xml)文件:
<jbosscmp-jdbc>
<defaults>
<datasource>java:/DB2DS</datasource>
<datasource-mapping>DB2</datasource-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">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 數據庫配置
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文件,把<driver-class/>元素設置為:
com.informix.jdbc.IfxDriver把<connection-url/>元素設置為
jdbc:informix-sqli://<host>:<port>:informixserver=<ifx_server>,
其中,<host>,<port>,<ifx_server>分別代表數據庫主機名、數據庫端口和數據庫服務名。然後修改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>元素設置為下面這樣:
<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數據庫了。
結論
Jboss4默認情況下使用的是Hypersonic數據庫,但如你所見我們只要簡單的修改幾個配置文件就可以使用市面上流行的其他數據庫了。