本文主要介紹Tomcat4.0.6和Tomcat4.1.18兩個版本下數據庫連接池的配置,及程序對連接池的JNDI查找,並提供相應測試代碼。最後指出配置及應用過程中的常見問題及解決方法。
一、Tomcat簡介 Tomcat是Apache Jakarta的子項目之一,是Sun公司推薦的jsp、Servlet容器。作為一款優秀的應用服務器,Tomcat提供了數據庫連接池、SSL、Proxy等許多通用組件功能,其中連接池是4.0以上版本的新增功能,應用非常廣泛。
二、Tomcat4的連接池 Tomcat4的開發可分為兩個階段,4.0.6是第一階段最推薦的release版本,內置的數據庫連接池為Tyrex 0.9.7.0,Tyrex由exolab.org開發,相關信息可以參見www. exolab.org。之後,Tomcat的開發者在4.0.x的基礎上對Tomcat進行了重構,重構後的release版本推薦4.1.18,這時內置的連接池改為DBCP,DBCP也是由Jakarta Commons的一個子項目。 接下來,將分別以4.0.6和4.1.18為例介紹這兩種連接池對Oracle8.1.7的配置。
三、對Tomcat4.0.6的Tyrex配置 為方便起見,將連接池置於ROOT下,JNDI名設為jdbc/OracleDB,數據庫服務器IP為192.168.0.50,SID為oradb,操作系統Win2000,jdk1.3.1,配置步驟如下。
第一步:配置server.XML 在server.xml文件中找到 <!-- Tomcat Root Context --> <!-- <Context path="" docBase="ROOT" debug="0"/> --> 將其改為 <!-- Tomcat Root Context --> <Context path="" docBase="ROOT" debug="0"> <Resource name="jdbc/OracleDB" auth="Container" type="Javax.sql.DataSource"/> <ResourceParams name="jdbc/OracleDB"> <parameter> <name>user</name> <value>holen</value> </parameter> <parameter> <name>passWord</name> <value>holen</value> </parameter> <parameter> <name>driverClassName</name> <value>oracle.jdbc.driver.OracleDriver</value> </parameter> <parameter> <name>driverName</name> <value>jdbc:oracle:thin:@192.168.0.50:1521:oradb</value> </parameter> </ResourceParams> </Context> 說明:將ROOT的Context從注釋中移出來,並定義Resource項,如下: <Resource name="jdbc/OracleDB" auth="Container" type="javax.sql.DataSource"/> Resource項(即連接池的DataSource對象),有3個屬性name、auth、type,name項是JNDI的名稱定義,程序通過JNDI才能找到此對象,這裡取名jdbc/OracleDB;auth項即連接池管理權屬性,這裡取值Container,申明為容器管理;type項即對象的類型,這裡取值javax.sql.DataSource,申明為數據庫連接池,Tyrex不但可以用作數據庫連接池,還有許多別的功能,有興趣的朋友可以打開Tyrex的jar包看看或訪問www.exolab.org,在這裡就不多說了。 在接下來的<ResourceParams>域內容裡包含四個參數user、password、driverClassName、driverName,依次為數據庫的用戶名、密碼、JDBC驅動和數據庫地址。 用戶名、密碼是為訪問數據庫准備的,這裡均取值holen。 driverClassName即數據庫的JDBC驅動名稱,如Oracle8.1.7的JDBC驅動包名叫classes.jar,一般位於Oracle安裝目錄下的ora81\jdbc\lib目錄下,初始擴展名為ZIP,需要手工把classes.zip改名為classes.jar,並放到common/lib下。這裡取值oracle.jdbc.driver.OracleDriver,此類由classes.jar提供。 <parameter> <name>driverClassName</name> <value>oracle.jdbc.driver.OracleDriver</value> </parameter> 對於其他數據庫,如mysql,其driverClassName一般為org.gjt.mm.mysql.Driver。 最後一個參數即driverName,即數據庫的地址(准確點說應該叫url,4.1.18就改叫url了) <parameter> <name>driverName</name> <value>jdbc:oracle:thin:@192.168.0.50:1521:oradb</value> </parameter> 在這裡填寫裡的是Oracle的訪問地址,若是MySql、DB2、SqlServer或其他數據庫,請填寫相應的地址。
第二步:將Oracle的JDBC驅動classes12.jar拷貝到Tomcat安裝目錄的common/lib下,其他數據庫也一樣,請把其相應的JDBC驅動包置於common/lib,如MySql的JDBC驅動包mm.mysql-2.0.14.jar。 至此,配置完成,測試代碼將在後面給出。 對Tomcat4.1.18的DBCP配置
四、對Tomcat4.1.18的DBCP配置 配置方法與4.0.6稍有不同,以下是配置步驟
第一步:配置server.xml 在server.xml文件中找到 <!-- Tomcat Root Context --> <!-- <Context path="" docBase="ROOT" debug="0"/> --> 將其改為 <!-- Tomcat Root Context --> <Context path="" docBase="ROOT" debug="0"> <Resource name="jdbc/OracleDB" auth="Container" type="javax.sql.DataSource"/> <ResourceParams name="jdbc/OracleDB"> <parameter> <name>factory</name> <value>org.apache.commons.dbcp.BasicDataSourceFactory</value> </parameter> <parameter> <name>driverClassName</name> <value>oracle.jdbc.driver.OracleDriver</value> </parameter> <parameter> <name>url</name> <value>jdbc:oracle:thin:@192.168.0.50:1521:oradb</value> </parameter> <parameter> <name>username</name> <value>holen</value> </parameter> <parameter> <name>password</name> <value>holen</value> </parameter> <parameter> <name>maxActive</name> <value>20</value> </parameter> <parameter> <name>maxIdle</name> <value>10</value> </parameter> <parameter> <name>maxWait</name> <value>-1</value> </parameter> </ResourceParams> </Context> 說明:從配置文件可以看出,DBCP的配置與Tyrex類似,但功能更加豐富。相同就不多說,重點講述不同的地方。 factory參數: <parameter> <name>factory</name> <value>org.apache.commons.dbcp.BasicDataSourceFactory</value> </parameter> 即基礎對象工廠,這裡取值org.apache.commons.dbcp.BasicDataSourceFactory,即DBCP自帶的工廠,也可以用別的。 需說明一點是,雖然4.1.18裡主推DBCP作連接池,但仍然可以使用Tyrex作為連接池,而且此時的Tyrex已從0.9.7.0升級到了1.0,支持JTA/JCA對象等,對象的獲取仍然是通過JNDI,具體的配置方法可以參見Tomcat文檔。 url參數: <parameter> <name>url</name> <value>jdbc:oracle:thin:@192.168.0.50:1521:oradb</value> url是數據庫訪問地址,在前提已提到。 接下來有三個參數,均為連接數相關,如下: <parameter> <name>maxActive</name> <value>20</value> </parameter> <parameter> <name>maxIdle</name> <value>10</value> </parameter> <parameter> <name>maxWait</name> <value>-1</value> </parameter> maxActive是最大激活連接數,這裡取值20個,表示同時最多有20個與數據庫的連接。 maxIdle是最大空閒連接數,這裡取值10個,表示即使沒有連接請求時,依然可以保持10空閒的連接,而不被清除,隨時處於待命狀態。關於對象的狀態,有興趣的朋友可以看看EJB方面的資料。 maxWait是最大等待秒鐘數,這裡取值-1,表示無限等待,直到超時為止,也可以取值9000,即表示9秒後超時。 關於maxActive與maxIdle的一點建議,對於企業級應用,其兩者的值一般比較接近,或者相同,關鍵是要分析應用的大