JSP中tomcat的SQL Server2000資料庫連線池的配置

作者：Eve Cole 更新時間：2009-07-02 17:22:47

JSP中tomcat的SQL Server2000資料庫連線池的設定環境：
1. 資料庫：Microsoft SQL Server 2000
2. 資料庫驅動程式：net.sourceforge.jtds.jdbc.Driver
JNDI（Java Naming and Directory Interface）概論：
Tomcat4（5）提供了一個與Java Enterprise Edition應用服務相容的JNDI--InitialContext實作實例。它的初始資料設定在$CATALINA_HOME/conf/server.xml檔案裡，並可能在網頁應用程式環境描述（/WEB-INF/web.xml）裡被下列元素引用：
1) <env-entry>--環境入口，設定應用程式如何操作。
2) <resource-ref>--資源參數，一般是資料庫驅動程式、JavaMail Session、自訂類別工廠等。
3) <resource-env-ref>--在Servlet 2.4裡用來簡化設定不需要認證資訊的資源資源如環境參數、resource-ref變數。
InitialContext在網頁應用程式初始化時被設置，用來支援網頁應用程式元件。所有的入口和資源都放在JNDI命名空間裡的java:comp/env段裡。點擊下列網址以獲取更多資訊：
1) Java命名和目錄介面（Java Naming and Directory Interface）
2) J2EE平台說明（J2EE Platform Specification）
設定JNDI資源設定JNDI資源要在$CATALINA_HOME/conf/server.xml檔案裡使用下列標誌符：
1) <Environment>--設定域個可變的JNDI InitialContext入口的名字和值（同上面說的<env-entry>等價）。
2) <Resource>--設定應用程式可用的資源的名字和類型（同上面說的<resource-ref>等價）。
3) <ResourceParams>--設定Java資源類別工廠的名稱或將要使用的JavaBean屬性。
4) <ResourceLink>--為全域JNDI環境（JNDI Context）新增一個連結。
上述這些標誌符必須放在<Context>和</Context>之間（針對專門的網頁應用程式）或<DefaultContext>和</DefaultContext>之間。
此外，設在網頁應用程式環境描述（Web Application Descriptor）（/WEB-INF/web.xml）裡的名字和值也在初始環境（Initial Context）裡被設置，當被<Environemt>元素值允許時將被重設初始值。
全域變數能在<Server>子元素的<GlobalNamingResources>裡設定。
資料庫連線池概述：
資料庫連接是一種關鍵的有限的昂貴的資源，這在多用戶的網頁應用程式中體現得尤為突出。對資料庫連線的管理能顯著影響整個應用程式的伸縮性和健全性，影響到程式的效能指標。資料庫連線池正是針對這個問題提出來的。
資料庫連接池負責分配、管理和釋放資料庫連接，它允許應用程式重複使用一個現有的資料庫連接，而再不是重新建立一個；釋放空閒時間超過最大空閒時間的資料庫連接來避免因為沒有釋放資料庫連接而引起的資料庫連接遺漏。這項技術能明顯提高對資料庫操作的效能。
資料庫連線池在初始化時將建立一定數量的資料庫連線放到連線池中，這些資料庫連線的數量是由最小資料庫連線數來設定的。無論這些資料庫連線是否被使用，連線池都將一直保證至少擁有這麼多的連線數量。連接池的最大資料庫連線數量限定了這個連線池能佔有的最大連線數，當應用程式向連線池請求的連線數超過最大連線數量時，這些請求將會加入到等待佇列中。資料庫連線池的最小連線數和最大連線數的設定要考慮到下列幾個因素：
1) 最小連接數是連接池一直保持的資料庫連接，所以如果應用程式對資料庫連接的使用量不大，將會有大量的資料庫連接資源被浪費；
2) 最大連線數是連線池能申請的最大連線數，如果資料庫連線請求超過此數，後面的資料庫連線請求將會加入到等待佇列中，這會影響之後的資料庫操作。
3) 如果最小連線數與最大連線數相差太大，那麼最先的連線請求將會獲利，之後超過最小連線數量的連線請求等價於建立新的資料庫連線。不過，這些大於最小連線數的資料庫連線在使用完不會馬上被釋放，它將被放到連線池中等待重複使用或是空閒逾時後被釋放。
配置Tomcat資料庫連線池的前提：
1. 必須裝有Java運作環境；
2. 必須有SQL Server2000資料庫伺服器（可以不在本機）；
3. 必須有jtds.jar，並將它放在$CATALINA_HOME/common/lib目錄下（只能是這裡）。使用它是因為Microsoft公司的Java SQL Server驅動程式不支援二次查詢，可上網搜尋。目前使用的是jtds-0.6.jar。
在$CATALINA_HOME/conf/server.xml裡設定資料庫連線池：
下面是設定的程式碼，必須放在<Host>和</Host>之間。
<Context path="/quality" docBase="quality" debug="0" reloadable="true" crossContext="true">
<Logger className="org.apache.catalina.logger.FileLogger" prefix="localhost_quality_log." suffix=".txt" timestamp="true"/>
<Resource name="jdbc/connectDB" auth="Container" type="javax.sql.DataSource"/>
<ResourceParams name="jdbc/connectDB">
<parameter>
<name>maxActive</name>

<value>100</value>
</parameter>
<parameter>
<name>maxIdle</name>

<value>30</value>
</parameter>
<parameter>
<name>maxWait</name>

<value>10000</value>
</parameter>
<parameter>
<name>removeAbandoned</name>

<value>true</value>
</parameter>
<parameter>
<name>removeAbandonedTimeout</name>

<value>60</value>
</parameter>
<parameter>
<name>logAbandoned</name>

<value>false</value>
</parameter>
<parameter>
<name>factory</name>
<!-DBCP Basic Datasource Factory -->
<value>org.apache.commons.dbcp.BasicDataSourceFactory</value>
</parameter>
<parameter>
<name>username</name>

<value>Iorishinier</value>
</parameter>
<parameter>
<name>password</name>

<value>mypasswd</value>
</parameter>
<parameter>
<name>driverClassName</name>

<value>net.sourceforge.jtds.jdbc.Driver</value>
</parameter>
<parameter>
<name>url</name>

<value>jdbc:jtds:sqlserver://127.127.127.127:1433/Northwind</value>
</parameter>
</ResourceParams>
</Context>
下面是一些參數的說明：
<Context path="/quality" docBase="quality" debug="0" reloadable="true" crossContext="true">
其中：
1) path 指定路徑，這裡設定的是$CATALINA_HOME/webapps下的quality目錄；
2) docBase 檔案根目錄。
3) reloader 當網頁被更新時是否重新編譯。
4) maxActive 連線池的最大資料庫連線數。設為0表示無限制。
5) maxIdle 資料庫連線的最大空閒時間。超過此空閒時間，資料庫連線將被標記為不可用，然後被釋放。設為0表示無限制。
6) maxWait 最大建立連線等待時間。若超過此時間將會接獲異常。設為－1表示無限制。
7) removeAbandoned 回收被遺棄的（一般是忘了釋放的）資料庫連接到連接池。
8) removeAbandonedTimeout 資料庫連接過多長時間不用將被視為被遺棄而收回連接池。
9) logAbandoned 將被遺棄的資料庫連接的回收記入日誌。
10) driverClassName JDBC驅動程式。
11) url 資料庫連接字串在$CATALINA_HOME/webapps/quality/WEB-INF/web.xml裡設定被引用的資源：
下面是設定碼，必須放在<web-app>和</web-app>裡。

<resource-ref>
<description>connectDB test</description>
<res-ref-name>jdbc/connectDB</res-ref-name>
<res-type>javax.sql.DataSource</res-type>
<res-auth>Container</res-auth>
</resource-ref>

下面是一下參數的必要說明：
1) description 對被引用的資源的描述。
2) res-ref-name 資源名稱。請參閱上面的<ResourceParams name="jdbc/connectDB">
3) res-type 資源類型。請參閱上面的<Resource name="jdbc/connectDB" auth="Container" type="javax.sql.DataSource"/>
在JSP中使用資源：
這是在$CATALINA_HOME/webapps/quality下的某級子目錄裡的jsp網頁檔案部分程式碼：
<%@ page contentType="text/html;charset=GBK"%>
<%@ page errorPage="error.jsp"%>
<%@ page import="javax.naming.*"%>
<%@ page import="javax.sql.*"%>
<%@ page import="java.sql.*"%>
<html>
<head>
</head>
<body>
<%

………………
………………

// 資料庫操作
Context ctx=null;
Connection cnn=null;
Statement stmt=null;
ResultSet rs=null;
try
{
ctx=new InitialContext();
if(ctx==null)
throw new Exception("沒有匹配的環境");
DataSource ds=(DataSource)ctx.lookup("java:comp/env/jdbc/connectDB");
if(ds==null)
throw new Exception("沒有匹配資料庫");

cnn=ds.getConnection();
stmt=cnn.createStatement(ResultSet.TYPE_SCROLL_SENSITIVE,ResultSet.CONCUR_READ_ONLY);
rs=stmt.executeQuery("select * from table1");

………………
………………

}
finally
{
if(rs!=null)
rs.close();
if(stmt!=null)
stmt.close();
if(cnn!=null)
cnn.close();
if(ctx!=null)
ctx.close();
}
%>
</body>
</html>
代碼說明：
DataSource ds=(DataSource)ctx.lookup("java:comp/env/jdbc/connectDB");
上面這句應用了剛才設的資源。
資源使用完要釋放，尤其是Context資源，請參閱try-catch-finally部分的finally程式碼段，這是一種好的習慣。資源釋放時如果釋放了上級資源，則下級資源將先被釋放。如：釋放了ctx，那麼資源釋放順序將是rs，stmt，cnn，ctx。換句話說，如果釋放了ctx，那麼rs，stmt和cnn都將不可用了。
這裡的釋放資源只是將資料庫連線回連結池中，並不是把資源真正釋放掉，請參閱資料庫連線池概述。