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">
<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了。
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数据库,但如你所见我们只要简单的修改几个配置文件就可以使用市面上流行的其他数据库了
我本地的项目的
所在路径:D:\jboss-4.0.2\server\default\conf\login-config.xml在后面增加上下面:
<application-policy name = "lams">
<authentication>
<login-module code = "org.lamsfoundation.lams.security.UniversalLoginModule" flag = "required">
<module-option name="dsJndiName">java:/jdbc/lams-ds</module-option>
<module-option name="principalsQuery">select password from lams_user where login=?</module-option>
<module-option name="rolesQuery">
SELECT DISTINCT r.name,'Roles' FROM
lams_user u LEFT OUTER JOIN lams_user_organisation uo USING(user_id)
LEFT OUTER JOIN lams_user_organisation_role urr USING(user_organisation_id)
LEFT OUTER JOIN lams_role r USING (role_id)
WHERE u.login=?
</module-option>
</login-module>
</authentication>
</application-policy>
而我在deploy目录下:配置个数据源mysql-ds.xml,:
<?xml version="1.0" encoding="UTF-8"?> <!-- $Id: mysql-ds.xml,v 1.2 2005/03/10 02:26:34 cperfect Exp $ --> <!-- Datasource config for MySQL using 3.0.9 available from: http://www.mysql.com/downloads/api-jdbc-stable.html --> <datasources> <!-- lams-ds datasource for use by LAMS Core and Services --> <local-tx-datasource> <jndi-name>jdbc/lams-ds</jndi-name> <connection-url>jdbc:mysql://192.168.1.202:3306/lams</connection-url> <driver-class>com.mysql.jdbc.Driver</driver-class> <!-- Tell MySQL Connector to use UTF-8 character encoding, --> <!-- and convert MySQL zero times to null --> <connection-property name="characterEncoding">utf8</connection-property> <connection-property name="zeroDateTimeBehavior">convertToNull</connection-property> <!-- Set transaction isolation level to match db --> <transaction-isolation>TRANSACTION_READ_COMMITTED</transaction-isolation> <user-name>lams</user-name> <password>lams</password> <!-- Set minimum adn maximum size of pool --> <max-pool-size>64</max-pool-size> <min-pool-size>0</min-pool-size> <!-- Connections not used after 5 minutes will be closed and removed --> <idle-timeout-minutes>5</idle-timeout-minutes> </local-tx-datasource> </datasources>
在java中使用时:
/** * 取当前用户的密码 * @param username * @return * @throws FailedLoginException * @throws NamingException * @throws SQLException */ public static String getManagerPassword(String username) throws FailedLoginException, NamingException, SQLException { InitialContext ctx = new InitialContext(); DataSource ds = (DataSource) ctx.lookup(JNDI_DATASOURCE); Connection conn = null; String password = null; ResultSet rs = null; try { conn = ds.getConnection(); PreparedStatement ps = conn.prepareStatement(PASSWORD_QUERY); ps.setString(1, username); rs = ps.executeQuery(); // check if there is any result if (rs.next()) { password = rs.getString(1); }else { String[] g= getManagerUser(username); ///从数据库中心拿出用户名 if(g!=null) { String sql="insert into lams_user(login,password,first_name,email,create_date,locale_id,authentication_method_id,timezone,flash_theme_id,html_theme_id) value(?,?,?,?,?,5,1,25,1,2)"; ps = conn.prepareStatement(sql); ps.setString(1,username); String pw=""; try{ if(g[0]!=null&&g[0].length()>0) pw=HashUtil.sha1(g[0]); }catch(Exception e) { } ps.setString(2, pw); String realname =""; if(g[1]!=null&&g[1].length()>0) { realname = g[1]; }else{ realname = g[2]; } ps.setString(3, realname); ps.setString(4, g[3]); ps.setString(5, new Date().toLocaleString()); int k = ps.executeUpdate(); if(k>0){ password=pw; } } } } finally { if(rs!=null)rs.close(); if (conn != null && !conn.isClosed()) conn.close(); } return password; }