使用 DBCP

JSP/Servlet: 使用 DBCP

如果是自行取得資料庫連線，每次都要載入Connection、使用者驗證、建立連結等動作，Connection開開關關的會相當沒有效率，在單機使用者上也許感覺不太出來，但是對於Web應用程式，需要服務的人數多的情況下，效能的問題就會被突顯出來。

您可以預設建立好一定數量的Connection並儲存在一個池（Pool）中，在需要的時候從池中取得Connection，不需要的時候將 Connection放回池中，如此就可以重複利用Connection，而不用浪費時間在Connection的重新載入與開關。

目前已經有許多設計好的連接池元件可以直接取得使用，而不用您重新設計一個連接池，在Tomcat中帶有DBCP連接池，您可以直接利用它來使用連接池，取得資源的方法是透過JNDI（Java Naming and Directory Interface），不過您只要了解設定方式即可，這只是一些Key in的動作且並不困難。

首先您必須將JDBC驅動程式放置在Tomcat的common/lib下，然後編輯conf/server.xml，在<Host>與</Host>之間加入以下的內容：

server.xml

...
<!-- 應用程式目錄是JSP --> 
<Context path="/JSP" docBase="JSP"> 
    <!-- 使用資料庫名稱是 GUESTBOOK --> 
    <Resource name="jdbc/GUESTBOOK" scope="Shareable" 
              type="javax.sql.DataSource"/> 
    <ResourceParams name="jdbc/GUESTBOOK"> 
        <parameter> 
            <name>factory</name> 
            <value>
               org.apache.commons.dbcp.BasicDataSourceFactory
            </value> 
        </parameter>
 
        <!-- DBCP database connection settings --> 
        <!-- JDBC URL --> 
        <parameter> 
           <name>url</name> 
           <value>jdbc:mysql://localhost/GUESTBOOK</value> 
        </parameter> 
        <!-- JDBC驅動程式 --> 
        <parameter> 
            <name>driverClassName</name> 
            <value>com.mysql.jdbc.Driver</value> 
        </parameter> 
        <!-- 資料庫使用者與密碼 --> 
        <parameter> 
            <name>username</name> 
            <value>caterpillar</value> 
        </parameter> 
        <parameter> 
            <name>password</name> 
            <value>123456</value> 
        </parameter>
 
        <!-- DBCP connection pooling options --> 
        <!-- 等待Connection的時間，單位ms，-1表不限制 --> 
        <parameter> 
            <name>maxWait</name> 
            <value>3000</value> 
        </parameter> 
        <!-- 連接池中最多可idle的Connection數，
            也就是最少的Connection數，0表不限制 --> 
        <parameter> 
            <name>maxIdle</name> 
            <value>10</value> 
        </parameter> 
        <!-- 連接池至多的Connection數，0表示不限制 --> 
        <parameter> 
            <name>maxActive</name> 
            <value>100</value> 
        </parameter> 
    </ResourceParams> 
</Context> 
...

設定好後，接下來設定Web應用程式的web.xml，加入以下的內容：

web.xml

... 
    <resource-ref> 
        <description>JNDI JDBC DataSource</description> 
        <res-ref-name>jdbc/GUESTBOOK</res-ref-name> 
        <res-type>javax.sql.DataSource</res-type> 
        <res-auth>Container</res-auth> 
    </resource-ref> 
...

這樣就可以使用DBCP連接池的功能了，可以這麼取Connection：

Context initContext = new InitialContext();
Context envContext =
(Context)initContext.lookup("java:/comp/env");
DataSource ds =
(DataSource)envContext.lookup("jdbc/GUESTBOOK");
Connection conn = ds.getConnection();

下面這個JSP程式是個簡單測試透過連接池取得連線的範例：

test.jsp

<%@page import="java.sql.*"%> 
<%@ page import="javax.sql.*" %> 
<%@ page import="javax.naming.*" %> 
<%@page contentType="text/html;charset=big5"%> 
<% 
    try { 
        Context initContext = new InitialContext(); 
        Context envContext  = 
            (Context)initContext.lookup("java:/comp/env"); 
        DataSource ds = 
            (DataSource)envContext.lookup("jdbc/GUESTBOOK"); 
        Connection conn = ds.getConnection(); 
 
        if(!conn.isClosed()) 
            out.println("資料庫連線測試成功！"); 
        conn.close(); 
    } 
    catch(SQLException e) { 
        out.println(e.toString()); 
    }
%>

From Gossip@caterpillar

JSP/Servlet: 使用 DBCP