本文是作者在配置廖兄的blog時用到的,剛開始使用Tomcat5.0.27,后又使用Tomcat5.5.4,但是配置數(shù)據(jù)庫總有錯誤,后來發(fā)現(xiàn)時context標志被取消的緣故。吾本性情中人,搞不定就換,于是就使用Tomcat4.1.31。主要參考FanyHan等人的相關(guān)文章,介紹了Tomcat4.1.31這個版本下數(shù)據(jù)庫連接池的配置,及程序?qū)B接池的JNDI查找,并提供相應(yīng)測試代碼。最后指出配置及應(yīng)用過程中的常見問題及解決方法。
一、 Tomcat簡介
Tomcat是Apache Jakarta的子項目之一,是Sun公司推薦的JSP、Servlet容器。作為一款優(yōu)秀的應(yīng)用服務(wù)器,Tomcat提供了數(shù)據(jù)庫連接池、SSL、Proxy等許多通用組件功能,其中連接池是4.0以上版本的新增功能,應(yīng)用非常廣泛。
二、 該文配置環(huán)境
Tomcat4.1.31 + jdk1.4.2 + Sql Server 2000 + Win2000 AS
三、 對Tomcat4.1.31的DBCP配置
這里,將連接池置于tomcat的工程目錄中的blog子文件夾(新建)下,JNDI名設(shè)為jdbc/blog,數(shù)據(jù)庫服務(wù)器IP為localhost,SID為blog,配置步驟如下。
第一步:配置server.xml
在server.xml中找到
<!-- Tomcat Root Context -->
<!?
<Context path="" docBase="ROOT" debug="0"/>
-->
將其改為:
<Context path="/blog" docBase="blog" debug="0" reloadable="true">
<Resource name="jdbc/blog" auth="Container" type="javax.sql.DataSource"/>
<ResourceParams name="jdbc/blog">
<parameter>
<name>factory</name>
<value>org.apache.commons.dbcp.BasicDataSourceFactory</value>
</parameter>
<parameter>
<name>driverClassName</name>
<value>com.microsoft.jdbc.sqlserver.SQLServerDriver</value>
</parameter>
<parameter>
<name>url</name> <value>jdbc:microsoft:sqlserver://localhost:1433;databaseName=blog</value>
</parameter>
<parameter>
<name>username</name>
<value>sa</value>
</parameter>
<parameter>
<name>password</name>
<value>sa</value>
</parameter>
<parameter>
<name>maxActive</name>
<value>20</value>
</parameter>
<parameter>
<name>maxIdle</name>
<value>20</value>
</parameter>
<parameter>
<name>maxWait</name>
<value>-1</value>
</parameter>
</ResourceParams>
</Context>
參數(shù)說明:
Resource項:
<Resource name="jdbc/blog" auth="Container" type="javax.sql.DataSource"/>
Resource項(即連接池的DataSource對象),有3個屬性name、auth、type,name項是JNDI的名稱定義,程序通過JNDI才能找到此對象,這里取名jdbc/Sblog;auth項即連接池管理權(quán)屬性,這里取值Container,申明為容器管理;type項即對象的類型,這里取值javax.sql.DataSource,申明為數(shù)據(jù)庫連接池。
在接下來的<ResourceParams>域內(nèi)容里包含四個參數(shù)user、password、driverClassName、driverName,依次為數(shù)據(jù)庫的用戶名、密碼、JDBC驅(qū)動和數(shù)據(jù)庫地址。
factory參數(shù):
<parameter>
<name>factory</name>
<value>org.apache.commons.dbcp.BasicDataSourceFactory</value>
</parameter>
即基礎(chǔ)對象工廠,這里取值org.apache.commons.dbcp.BasicDataSourceFactory,即DBCP自帶的工廠,也可以用別的。
DriverClassName參數(shù):
<parameter>
<name>driverClassName</name>
<value>com.microsoft.jdbc.sqlserver.SQLServerDriver</value>
</parameter>
即數(shù)據(jù)庫的JDBC驅(qū)動名稱,具體值為:
Sql Server 2000: com.microsoft.jdbc.sqlserver.SQLServerDriver
首先要下載安裝sqlserver-jdbc-驅(qū)動,然后將其lib下的三個jar文件放到
tomcat/common/lib下。
MySql: org.gjt.mm.mysql.Driver
MySql的JDBC驅(qū)動包mm.mysql-2.0.14.jar。
Oracle8.1.7: oracle.jdbc.driver.OracleDriver
Oracle8.1.7的JDBC驅(qū)動包名叫classes.jar,一般位于Oracle安裝目錄下的ora81\jdbc\lib目錄下,初始擴展名為ZIP,需要手工把classes.zip改名為classes.jar,并放到tomcat/common/lib下。oracle.jdbc.driver.OracleDriver此類由classes.jar提供。
url參數(shù):
<parameter>
<name>url</name>
<value>jdbc:microsoft:sqlserver://localhost:1433;databaseName=blog</value>
</parameter>
即數(shù)據(jù)庫的地址。(不同的數(shù)據(jù)庫其地址都不相同)
username參數(shù):
<parameter>
<name>username</name>
<value>sa</value>
</parameter>
即連接數(shù)據(jù)庫的用戶名。
password參數(shù):
<parameter>
<name>password</name>
<value>**</value>
</parameter>
即連接數(shù)據(jù)庫的密碼。
maxActive、maxIdle和maxWait參數(shù):
<parameter>
<name>maxActive</name>
<value>20</value>
</parameter>
<parameter>
<name>maxIdle</name>
<value>20</value>
</parameter>
<parameter>
<name>maxWait</name>
<value>-1</value>
</parameter>
maxActive是最大激活連接數(shù),這里取值為20,表示同時最多有20個數(shù)據(jù)庫連 接。maxIdle是最大的空閑連接數(shù),這里取值為20,表示即使沒有數(shù)據(jù)庫連接時依然可以保持20空閑的連接,而不被清除,隨時處于待命狀態(tài)。MaxWait是最大等待秒鐘數(shù),這里取值-1,表示無限等待,直到超時為止,也可取值9000,表示9秒后超時。
第二步:配置web.xml
打開webapps/ROOT/WEB-INF下web.xml,加入如下內(nèi)容:
<resource-ref>
<description>SqlServer Datasource example</description>
<res-ref-name>jdbc/blog</res-ref-name>
<res-type>javax.sql.DataSource</res-type>
<res-auth>Container</res-auth>
</resource-ref>
第三部:配置tomcat(添加類)
將Microsoft SQL Server 2000 Driver for JDBC\lib目錄下的三個jar文件拷貝到Tomcat安裝目錄的common\lib下。
配置完成?。?
四、 測試代碼
數(shù)據(jù)庫如下:
新建一個名為blog的數(shù)據(jù)庫,在里面創(chuàng)建一個表格:Create table test(id varchar(12),name varchar(30));
寫一個jsp文件(testdb.jsp),將其置于webapps/ROOT目錄下,打開tomcat運行該頁面進行測試。
頁面testdb.jsp的內(nèi)容如下:
<%@ page contentType="text/html;charset=GBK"%>
<%@ page import= "java.sql.* "%>
<%@ page import= "javax.naming.* "%>
<%
try{
Context initCtx = new InitialContext();
Context ctx = (Context) initCtx.lookup("java:comp/env");
//獲取連接池對象
Object obj = (Object) ctx.lookup("jdbc/blog");
//類型轉(zhuǎn)換
javax.sql.DataSource ds = (javax.sql.DataSource)obj;
Connection conn = ds.getConnection();
Statement stmt = conn.createStatement();
String strSql = " insert into test(id,name) values(´00001´,´fany´)";
stmt.executeUpdate(strSql);
strSql = " select id,name from test ";
ResultSet rs = stmt.executeQuery(strSql);
if(rs.next()){
out.println(rs.getString(1));
out.println(rs.getString(2));
}
}catch(Exception ex){
ex.printStackTrace();
throw new SQLException("cannot get Connection pool.");
}
%>
運行tomcat,打開瀏覽器,輸入http://localhost:8080/blog/test.jsp,正常情況下會在頁面上看到"00001 fany"輸出。