本文提供一個詳細而易懂的指導，讓你快速掌握使用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你的驅動程序�，F在建立一個你的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. 用于連接數據庫的參數拼寫錯誤或遺漏。請檢查是否正確的指定了該連接池的主機名，數據庫，用戶
名，用戶口令等。