IDC资讯中心
本文提供一个详细而易懂的指导，让你快速掌握使用microsoft sql server
关系数据库管理系统(rdbms)和jboss j2ee 应用
服务器套件来开发，发布和运行企业java应用程序的基本知识。
jboss是一个业界领先的开放源码的符合标准的j2ee应用服务器套件的名\r
称。该套件包括jbossserver ejb v1.1 container 和server, jbossmq jms
1.0 implemetation, jbossns jndi implemetation,jbosscmp advanced o/r mapper和
jdbc data object storage implemetation以及
jaas-based jbosssx security frameeork。 所有的jboss应用程序都是
100%纯java应用程序。
microsoft sql server是一个健壮的高性能的和高安全的关系数据库平
台。 它是一个运行在windows 95,98,me,nt和2000平台上的windows应用
程序。它也有windows ce平台下的版本，但我想你不会将该版本和jboss一起使用吧?
将高性能的开放源码100%java j2ee应用服务器的jboss套件和高超新能
的microsoft sql server rdbms组合起来，可以给你提供一个windows平台
下的j2ee开发和发布环境，相比其它windows平台下的j2ee应用套间和
rdbms方案，该组合性能优异，高回报(roi),极大减少产品上市时间(rttm)。
首先，你需要从jboss网站获取一份jboss软件。所有jboss的产品信息以及
如何获取jboss软件的指导可以在jboss faq或在jboss 站点找到。本文的余下
部分包含下列内容:
1. 安装ms sql server的jdbc驱动程序
2. 配置jboss使用jdbc驱动程序
3. 为cmp指定ms sql server数据类型
4. 问题解答
需要注意的是jboss应用服务器套件和ms sql server都在蓬勃发展。它们
的版本都在发行，修订，增添新的特性。这意味着 本文的某些信息对于你的
jboss或ms sql server过时了。如果你使用最新的jboss cvs版本或开发版或\r
ms sql server beta版时 更容易出现这种情况。
安装jdbc驱动程序
在你能够与jboss(或所有其它java应用程序)一起使用microsoft sql
server之前，你必须取得并安装jdbc驱动程序。现将一些现有的microsoft
sql server jdbc驱动程序列在下面。
—————————————————————————————————————
驱动程序 提供者 jdbc 类型 availability 版本
—————————————————————————————————————
freetds http://www.freetds.org/ type 4 免费/开放源码
—————————————————————————————————————
merant
datadirect http://www.merant.com/ type 4 商业
connect jdbc
—————————————————————————————————————
i-net opta
jdbc http://www.inetsoftware.de/ type 4 商业 4.10修订版
—————————————————————————————————————
weblogic
jdriver for weblogic type 4 商业
ms sql server
—————————————————————————————————————
atinav
aveconnect http://www.atinav.com/ type 4 商业
jdbc
—————————————————————————————————————
sun jdbc-
odbc bridge http://java.sun.com type 4 免费
—————————————————————————————————————
注
* sun jdbc-odbc桥驱动程序和freetds jdbc驱动程序(至少目前2001年4月的版本)不推荐\r
使用于正式的j2ee开发和发布
安装sun jdbc-odbc桥驱动程序
sun jdbc-odbc桥驱动程序在java 2 sdk安装过程中自动安装。安装包\r
为sun.jdbc.odbc。对于所有使用jdbc-odbc桥的应用程序该包都必须在
classpath中。在本教程中假设sun jdbc-odbc桥已经正确的安装在你的系
统中。
为了使用sun jdbc-odbc桥你需要创建一个odbc数据源来引用ms sql
server数据库。本教程中假设已经创建了名为 jboss_odbc
指向某个ms sqlserver数据库的数据源。
安装freetds驱动程序
从http://www.freetds.org下载freetds, 你应该得到了名为freetds_jdbc.snapshot.jar的
文件，然后复制到%jboss_home%/lib/ext
目录下。
安装merant datadirect connect jdbc驱动程序
有两种方法， 你可以选择下列方法之一：
1. 运行merant安装程序，然后将base.jar, util.jar和sqlserver.jar文件添加到
classpath中。这些文件位于%merant_home/lib
目录下。
2. 将base.jar, uitl.jar和sqlserver.jar文件从%merant_home%/lib目录复制到
%jboss_home%/lib/ext目录，推荐采用这种方法。
安装i-net opta 2000jdbcdriver
你可以采用下列方法之一：
1. 运行jboss时将opta2000.jar文件加入classpath。
2. 将文件opta2000.jar复制到%/jboss_home%/lib/ext目录。这是推荐的方法。
配置jboss使用jdbc驱动程序
关于配置jboss使用你的jdbc驱动程序的指导取决于你使用的jboss版本，请选择适合你\r
的版本的方法。
配置jboss 2.4
遵照配置jboss2.1和2.2的指导，
但是将org.opentools.minerva.jdbc.xa.wrapper.xadatasourceimpl
替换为org.jboss.pool.jdbc.xa.wrapper.xadatasourceimpl。
配置jboss2.1和2.2
告诉jboss新的jdbc驱动程序
在安装好ms sql server jdbc驱动程序后，你需要告诉jboss你要使用该驱动
程序。将该驱动程序添加
到jboss启动时加载的jdbc清单中。该清单存放在jboss.jcml文件中。该文件可
在
%jboss_home%/conf/<config-name>中找到。对于标准的jboss发行版\r
本，<config-name>是default而
jboss-jetty版本则是jetty。该入口应该是一行用逗号分隔开的jdbc驱动程序名列表。
打开文件，找到以下面的mbean标记开始的入口:
<mbean code="org.jboss.jdbc.jdbcprovider" name="defaultdomain:service=jdbcprovider">
驱动程序列表放在名为drivers的<attribute>子标记中。按如下所示将你的
jdbc驱动程序添加到列表
中。
$ 添加sun jdbc-odbc桥驱动程序
<mbean code="org.jboss.jdbc.jdbcprovider" name="defaultdomain:service=jdbcprovider">
<attribute name="drivers">
org.hsql.jdbcdriver,org.enhydra.instantdb.jdbc.idbdriver,sun.jdbc.od
bc.jdbcodbcdriver
</attribute>
</mbean>
$ 添加freetds驱动程序
<mbean code="org.jboss.jdbc.jdbcprovider" name="defaultdomain:service=jdbcprovider">
<attribute name="drivers">
org.hsql.jdbcdriver,org.enhydra.instantdb.jdbc.idbdriver,com.interne
tcds.jdbc.tds.driver
</attribute>
</mbean>
$ 添加merant datadirect connect jdbc驱动程序
<mbean code="org.jboss.jdbc.jdbcprovider" name="defaultdomain:service=jdbcprovider">
<attribute name="drivers">
org.hsql.jdbcdriver,org.enhydra.instantdb.jdbc.idbdriver,com.merant
.datadirect.jdbc.sqlserver.sqlserverdriver
</attribute>
</mbean>
$ 添加i-net opta 2000 jdbc驱动程序
<mbean code="org.jboss.jdbc.jdbcprovider" name="defaultdomain:service=jdbcprovider">
<attribute name="drivers">
org.hsql.jdbcdriver,org.enhydra.instantdb.jdbc.idbdriver,com.inet.td
s.tdsdriver
</attribute>
</mbean>
$ 添加weblogic jdriver for microsoft sql server
<mbean code="org.jboss.jdbc.jdbcprovider" name="defaultdomain:service=jdbcprovider">
<attribute name="drivers">
org.hsql.jdbcdriver,org.enhydra.instantdb.jdbc.idbdriver,weblogic.jd
bc.mssqlserver4.driver
</attribute>
</mbean>
创建db连接池
到目前为止，你已经告诉jboss你的驱动程序。现在建立一个你的ejbbean能够
连接的连接池。在本教程中，你将创建
一个名为sqlserverpool的连接池。要创建连接池，先在jboss.jcml文件中定位
已下列行开始的mbean入口：
<mbean code="org.jboss.jdbc.xadatasourceloader" name="defaultdomain:service=xadatasource,name=defaultds">
在你刚在定位的mbean项下面加入如下所给的mbean项。注意这些必须加在结束标记</mbean>后面！！！
$ sun jdbc-odbc桥驱动程序连接池声明
<mbean code="org.jboss.jdbc.xadatasourceloader" name="defaultdomain:service=xadatasource,name=sqlserverpool
">
<attribute name="datasourceclass">org.opentools.minerva.jdbc.xa.wrapper.x
adatasourceimpl</attribute>
<attribute name="poolname">sqlserverpool</attribute>
<attribute name="url">jdbc:odbc:jboss_odbc</attribute>
<attribute name="jdbcuser">dbusername</attribute>
<attribute name="password">dbpassword</attribute>
etc…
</mbean>
$ merant datadirect connect jdbc驱动程序连接池声明
<mbean code="org.jboss.jdbc.xadatasourceloader" name="defaultdomain:service=xadatasource,name=sqlserverpool
">
<attribute name="datasourceclass">org.opentools.minerva.jdbc.xa.wrapper.x
adatasourceimpl</attribute>
<attribute name="poolname">sqlserverpool</attribute>
<attribute name="url">jdbc:sqlserver://servername:1433</attribute>
<attribute name="properties">databasename=databasename</attribute>
<attribute name="jdbcuser">dbusername</attribute>
<attribute name="password">dbpassword</attribute>
etc…
</mbean>
$ i-net opta 2000 jdbc驱动程序连接池声明(采用inet数据源)
<mbean code="org.jboss.jdbc.xadatasourceloader" name="defaultdomain:service=xadatasource,name=sqlserverpool
">
<attribute name="datasourceclass">com.inet.tds.xdatasource</attribute>
<attribute name="poolname">sqlserverpool</attribute>
<attribute name="properties">host=servername; database=databasename</attribute>
<attribute name="jdbcuser">dbusername</attribute>
<attribute name="password">dbpassword</attribute>
etc…
</mbean>
$ i-net opta 2000 jdbc驱动程序连接池声明(采用jboss数据源)
<mbean code="org.jboss.jdbc.xadatasourceloader" name="defaultdomain:service=xadatasource,name=sqlserverpool
">
<attribute name="datasourceclass">org.opentools.minerva.jdbc.xa.wrapper.x
adatasourceimpl</attribute>
<attribute name="poolname">sqlserverpool</attribute>
<attribute name="url">jdbc:inetdae7:hostname</attribute>
<attribute name="jdbcuser">dbusername</attribute>
<attribute name="password">dbpassword</attribute>
etc…
</mbean>
$ weblogic jdriver for microsoft sql server连接池声明
<mbean code="org.jboss.jdbc.xadatasourceloader" name="defaultdomain:service=xadatasource,name=sqlserverpool">
<attribute name="datasourceclass">org.opentools.minerva.jdbc.xa.wrapper.xadatasourceimpl</attribute>
<attribute name="poolname">sqlserverpool</attribute>
<attribute name="url">jdbc:weblogic:mssqlserver4:databasename@servername:1433</attribute>
<attribute name="properties">user=dbusername; password=dbpassword</attribute>
etc…
</mbean>
检验db连接池
启动jboss确保jdbc驱动程序找到并且创建了连接池，如果成功加载jdbc驱动程序将有如下所示的输出
[transaction manager] initializing
[transaction manager] loaded jdbc-driver:org.hsql.jdbcdriver
[transaction manager] loaded jdbc-driver:org.enhydra.instantdb.jdbc.idbdriver
[transaction manager] loaded jdbc-driver:sun.jdbc.odbc.jdbcodbcdriver
[transaction manager] loaded jdbc-driver:com.merant.datadirect.jdbc.sqlserver.sqlserverdriver
[transaction manager] loaded jdbc-driver:com.inet.tds.tdsdriver
[transaction manager] loaded jdbc-driver:weblogic.jdbc.mssqlserver4.driver
[transaction manager] initialized
稍等片刻…连接池的输出
[sqlserverpool] starting
[sqlserverpool] xa connection pool sqlserverpool bound to java:/sqlserverpool
[sqlserverpool] started
配置cmp数据类型映射
配置jboss使用ms sql server连接池作为缺省的数据源，你可以选择下列方法之一:
$ 在你的应用程序的meta-inf目录下创建jaws.xml文件重载standardjaws.xml中如下所示的缺省设置
示例 jaws.xml(ms sql server cmp数据类型映射)
<?xml version="1.0" encoding="utf-8"?>
<jaws>
<datasource>java:/sqlserverpool</datasource>
<type-mapping>ms sqlserver</type-mapping>
<default-entity>
<remove-table>false</remove-table>
</default-entity>
<type-mappings>
<type-mapping>
<name>ms sqlserver</name>
<!– 请将standardjaws中的"ms sqlserver"映射复制到此处 –>
</type-mapping>
</type-mappings>
</jaws>
$ 改变%jboss_home%/conf目录下的standardjaws.xml文件中的缺省设置
要改变缺省的数据源和数据类型映射，请对standardjaws.xml文件作如下修改
<?xml version="1.0" encoding="utf-8"?>
<jaws>
<datasource>java:/sqlserverpool</datasource>
<type-mapping>ms sqlserver</type-mapping>
*注: 除了ms sqlserver 2000，其它版本都使用ms sqlserver。如果你使用的是sql server2000, 将
上面的ms sqlserver改为ms sqlserver2000。
疑难解答
jdbc未装载错误
在启动时显示如下错误:
[jdbc] could not load driver:sun.jdbc.odbc.jdbcodbcdrivers
这种错误可能在下列情况出现:
1. jboss.jcml配置文件中的jdbc驱动名称拼写错误。在如上的例子中应该是
sun.jdbc.odbc.jdbcodbcdriver
2. jdbc驱动程序没有正确的安装 – 它的类文件或.jar文件不在classpath中。
在启动连接池时jboss悬停
当jboss启动时，一系列的信息显示在控制台上。关于连接池的最后信息应该如下所示：
[hypersonic] press [ctrl]+[c] to abort
[instantdb] started
[defaultds] starting
[defaultds] xa connection pool defaultds bound to java:/defaultds
[defaultds] started
[sqlserverpool] starting
[sqlserverpool] xa connection pool sqlserverpool bound to java:/sqlserverpool
首先检查jdbc驱动程序是否正确加载。如果没有正确加载请察看前面的"jdbc未装载错误\\\"部分。如果驱动
正确加载，该错误意味着jboss不能和你的数据库服务器通讯。该错误可能在以下情形出现:
1. 用于连接数据库的参数拼写错误或遗漏。请检查是否正确的指定了该连接池的主机名，数据库，用户
名，用户口令等。
