Tomcat4的數據庫連接池配置




Tomcat4的數據庫連接池配置
本文主要介紹Tomcat4.1.19這兩個版本下數據庫連接池的配置，及程序對連接池的JNDI查找，并提供相應

測試代碼。最后指出配置及應用過程中的常見問題及解決方法。
一、 Tomcat簡介
Tomcat是Apache Jakarta的子項目之一，是Sun公司推薦的JSP、Servlet容器。作為一款優秀的應用服務

器，Tomcat提供了數據庫連接池、SSL、Proxy等許多通用組件功能，其中連接池是4.0以上版本的新增功

能，應用非常廣泛。
二、 該文配置環境
Tomcat4.1.19 + jdk1.3 + Sql Server 2000 + Jbuilder 8.0 + Win2000
三、 對Tomcat4.1.19的DBCP配置
為方便起見，將連接池置于ROOT下，JNDI名設為jdbc/SqlServerDB，數據庫服務器IP為

192.168.0.47，SID為hrntest，配置步驟如下。
第一步：配置server.xml
在server.xml中找到
<!-- Tomcat Root Context -->
<!—
 <Context path="" docBase="ROOT" debug="0"/>
-->

將其改為
<!-- Tomcat Root Context -->

<Context path="" docBase="ROOT" debug="0" reloadable="true">
<Resource name="jdbc/SqlServerDB" auth="Container" type="javax.sql.DataSource"/>
<ResourceParams name="jdbc/SqlServerDB">
 <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://192.168.0.47:1433;databa

seName=hrntest</value>
</parameter>
<parameter>
 <name>username</name>
 <value>Fany</value>
</parameter>
<parameter>
 <name>password</name>
 <value>fanyhan</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>


參數說明：
Resource項：
<Resource　name="jdbc/SqlServerDB" auth="Container" type="javax.sql.DataSource"/>

Resource項（即連接池的DataSource對象），有3個屬性name、auth、type，name項是JNDI的名稱定義，

程序通過JNDI才能找到此對象，這里取名jdbc/SqlServerDB；auth項即連接池管理權屬性，這里取值

Container，申明為容器管理；type項即對象的類型，這里取值javax.sql.DataSource，申明為數據庫連

接池。
在接下來的<ResourceParams>域內容里包含四個參數user、password、driverClassName、driverName，

依次為數據庫的用戶名、密碼、JDBC驅動和數據庫地址。
 factory參數：
<parameter>
<name>factory</name>
<value>org.apache.commons.dbcp.BasicDataSourceFactory</value>
</parameter>

即基礎對象工廠，這里取值org.apache.commons.dbcp.BasicDataSourceFactory，即DBCP自帶的工廠，也

可以用別的。
DriverClassName參數：
<parameter>
<name>driverClassName</name>
<value>com.microsoft.jdbc.sqlserver.SQLServerDriver</value>
</parameter>


即數據庫的JDBC驅動名稱，具體值為：
　　　　 Sql Server 2000: com.microsoft.jdbc.sqlserver.SQLServerDriver
首先要下載安裝sqlserver-jdbc-驅動，然后將其lib下的三個jar文件放到

tomcat/common/lib下。
 MySql：　　　　　org.gjt.mm.mysql.Driver
MySql的JDBC驅動包mm.mysql-2.0.14.jar。
　　　　 Oracle8.1.7：oracle.jdbc.driver.OracleDriver
Oracle8.1.7的JDBC驅動包名叫classes.jar，一般位于Oracle安裝目錄下的

ora81\jdbc\lib目錄下，初始擴展名為ZIP，需要手工把classes.zip改名為classes.jar，并放到

tomcat/common/lib下。oracle.jdbc.driver.OracleDriver此類由classes.jar提供。
　　url參數：
<parameter>
<name>url</name>

<value>jdbc:microsoft:sqlserver://192.168.0.47:1433; 
databaseName=hrntest</value>
</parameter>



即數據庫的地址。（不同的數據庫其地址都不相同）
Sql Server 2000:
jdbc:microsoft:sqlserver://192.168.0.47:1433;databaseName=hrntest
Oracle8.1.7：jdbc:oracle:thin:@192.168.0.47:1521: hrntest
Username參數：

<parameter>
<name>username</name>
<value>Fany</value>
</parameter>



即連接數據庫的用戶名。
<parameter>
<name>password</name>
<value>fanyhan</value>
</parameter>

password參數：

即連接數據庫的密碼。
maxActive、maxIdle和maxWait參數：
<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是最大激活連接數，這里取值為20，表示同時最多有20個數據庫連　
　接。maxIdle是最大的空閑連接數，這里取值為20，表示即使沒有數據庫連接時依然可以保持20空閑的

連接，而不被清除，隨時處于待命狀態。MaxWait是最大等待秒鐘數，這里取值-1，表示無限等待，直到

超時為止，也可取值9000，表示9秒后超時。
第二步：配置web.xml
打開webapps/ROOT/WEB-INF下web.xml，加入如下內容： 
<resource-ref>
<description>SqlServer Datasource example</description>
<res-ref-name>jdbc/SqlServerDB</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下。
　配置完成

四、 測試代碼
數據庫如下：
　　　　Create table test(id varchar(12),name varchar(30))
方法１：寫一個jsp文件（testdb.jsp），將其置于webapps/ROOT目錄下，打開tomcat運行該頁面進行測

試。

頁面testdb.jsp的內容如下：

<%@ 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/SqlServerDB");
 //類型轉換
 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.");
 }
%>


　方法2：寫一個數據庫連接的類
類內容如下：

static String jndiName="jdbc/SqlServerDB";

/**
 * 從連接池中取得一個空閑的數據庫連接
 * @returnConnection
 * @exceptionException
 */
public static Connection getConnection() throws Exception{
 Connection conn = null;
 try {
Context initCtx = new InitialContext();
Context ctx = (Context) initCtx.lookup("java:comp/env");
//獲取連接池對象
Object obj = (Object) ctx.lookup(jndiName);
//類型轉換
javax.sql.DataSource ds = (javax.sql.DataSource)obj;
//獲得數據庫連接
conn= ds.getConnection();
} catch (java.lang.SecurityException se) {
throw se;
} catch(Exception e) {
 e.printStackTrace();
 throw e;
}
return conn;

}

[我在測的時候，沒有這么繁，我只把三個JAR文件放在了相應的位置，測試連接也成功以呀！為什么呀！]