commons DBCP 配置參數簡要說明

commons DBCP 配置參數簡要說明
　　前段時間因為項目原因，要在修改資料庫連接池到DBCP上，折騰了半天，有一點收穫，不敢藏私，特在這裡與朋友們共用。
　　在配置時，主要難以理解的主要有：removeAbandoned 、logAbandoned、removeAbandonedTimeout、maxWait這四個參數，設定了rmoveAbandoned=true那麼在getNumActive()快要到getMaxActive()的時候，系統會進行無效的Connection的回收，回收的Connection為removeAbandonedTimeout(預設300秒)中設定的秒數後沒有使用的Connection，啟用回收機制好像是getNumActive()=getMaxActive()-2。
有點忘了。
　　logAbandoned=true的話，將會在回收事件後，在log中列印出回收Connection的錯誤資訊，包括在哪個地方用了Connection卻忘記關閉了，在調試的時候很有用。
　　在這裡私人建議maxWait的時間不要設得太長，maxWait如果設定太長那麼用戶端會等待很久才激發回收事件。
　　以下是我的配置的properties檔案：
#串連設定
jdbc.driverClassName=oracle.jdbc.driver.OracleDriver
jdbc.url=jdbc:oracle:thin:@127.0.0.1:1521:DBSERVER
jdbc.username=user
jdbc.password=pass

#<!-- 初始化串連 -->
dataSource.initialSize=10

#<!-- 最大空閑串連 -->
dataSource.maxIdle=20

#<!-- 最小空閑串連 -->
dataSource.minIdle=5

#最大串連數量
dataSource.maxActive=50

#是否在自動回收逾時串連的時候列印串連的逾時錯誤
dataSource.logAbandoned=true

#是否自動回收逾時串連
dataSource.removeAbandoned=true

#逾時時間(以秒數為單位)
dataSource.removeAbandonedTimeout=180

#<!-- 逾時等待時間以毫秒為單位 6000毫秒/1000等於60秒 -->
dataSource.maxWait=1000

　　以下是我在串連控制中調用的方法：

        Properties  dbProps=null;
　　//下面的讀取設定檔可以根據實際的不同修改
        dbProps = ConfigProperties.getInstance().getProperties("jdbc.properties");
        try {
         String driveClassName = dbProps.getProperty("jdbc.driverClassName");
         String url = dbProps.getProperty("jdbc.url");
         String username = dbProps.getProperty("jdbc.username");
         String password = dbProps.getProperty("jdbc.password");
        
         String initialSize = dbProps.getProperty("dataSource.initialSize");
         String minIdle = dbProps.getProperty("dataSource.minIdle");
         String maxIdle = dbProps.getProperty("dataSource.maxIdle");
         String maxWait = dbProps.getProperty("dataSource.maxWait");
         String maxActive = dbProps.getProperty("dataSource.maxActive");
           //是否在自動回收逾時串連的時候列印串連的逾時錯誤
          boolean logAbandoned = (Boolean.valueOf(dbProps.getProperty("dataSource.logAbandoned","false"))).booleanValue();

          //是否自動回收逾時串連
          boolean removeAbandoned = (Boolean.valueOf(dbProps.getProperty("dataSource.removeAbandoned","false"))).booleanValue();

          //逾時時間(以秒數為單位)
          int removeAbandonedTimeout = Integer.parseInt(dbProps.getProperty("dataSource.removeAbandonedTimeout","300"));
       
         dataSource = new BasicDataSource();
         dataSource.setDriverClassName(driveClassName);
         dataSource.setUrl(url);
         dataSource.setUsername(username);
         dataSource.setPassword(password);

         //初始化串連數
         if(initialSize!=null)
          dataSource.setInitialSize(Integer.parseInt(initialSize));
        
         //最小空閑串連
         if(minIdle!=null)
          dataSource.setMinIdle(Integer.parseInt(minIdle));

         //最大空閑串連
         if(maxIdle!=null)
          dataSource.setMaxIdle(Integer.parseInt(maxIdle));
        
         //逾時回收時間(以毫秒為單位)
         if(maxWait!=null)
          dataSource.setMaxWait(Long.parseLong(maxWait));
        
         //最大串連數
         if(maxActive!=null){
          if(!maxActive.trim().equals("0"))
           dataSource.setMaxActive(Integer.parseInt(maxActive));
         }

         System.out.println("logAbandoned="+logAbandoned);
            dataSource.setLogAbandoned(logAbandoned);
         dataSource.setRemoveAbandoned(removeAbandoned);
         dataSource.setRemoveAbandonedTimeout(removeAbandonedTimeout);
        
         Connection conn = dataSource.getConnection();
         if(conn==null){
          log("建立串連池時,無法取得串連!檢查設定!!!");
         }else{
          conn.close();
         }
         System.out.println("串連池建立成功!!!");
        }
        catch (Exception e) {
         e.printStackTrace();
            System.out.println("建立串連池失敗!請檢查設定!!!");
        }

　　有使用問題或建議可與我聯絡：yy-man@163.com
     
         2006-04-20   By: 小土

用apache的dbcp來建立獨立的資料庫連接池(db connection pool)
資料庫連接池的好處是不言而喻的，現在大部分的application server都提供自己的資料庫連接池方案，此時，只要按照application server的文檔說明，正確配置，即可在應用中享受到資料庫連接池的好處。
但是，有些時候，我們的應用是個獨立的java application，並不是普通的WEB/J2EE應用，而且是單獨啟動並執行，不要什麼application server的配合，這種情況下，我們就需要建立自己的資料庫連接池方案了。這裡，介紹如何利用apache的dbcp來建立為民自己的資料庫連接池。
1。首先，下載必須的jar包
dbcp包，目前版本是1.2.1：http://jakarta.apache.org/commons/dbcp/

pool包，目前版本是1.3：http://jakarta.apache.org/commons/pool/，

如果下載的pool包是1.2的版本，還要下載common-collections包：http://jakarta.apache.org/commons/collections/
在建立我們自己的資料庫連接池時，可以使用xml檔案來傳入需要的參數，這裡只使用hard code的方式來簡單介紹，所有需要我們自己寫的代碼很少，只要建立一個檔案如下：

import org.apache.commons.dbcp.BasicDataSource;
import org.apache.commons.dbcp.BasicDataSourceFactory;

import java.sql.SQLException;
import java.sql.Connection;
import java.util.Properties;

public class ConnectionSource {
    private static BasicDataSource dataSource = null;

    public ConnectionSource() {
    }

    public static void init() {

        if (dataSource != null) {
            try {
                dataSource.close();
            } catch (Exception e) {
                //
            }
            dataSource = null;
        }

        try {
            Properties p = new Properties();
            p.setProperty("driverClassName", "oracle.jdbc.driver.OracleDriver");
            p.setProperty("url", "jdbc:oracle:thin:@192.168.0.1:1521:testDB");
            p.setProperty("password", "scott");
            p.setProperty("username", "tiger");
            p.setProperty("maxActive", "30");
            p.setProperty("maxIdle", "10");
            p.setProperty("maxWait", "1000");
            p.setProperty("removeAbandoned", "false");
            p.setProperty("removeAbandonedTimeout", "120");
            p.setProperty("testOnBorrow", "true");
            p.setProperty("logAbandoned", "true");

            dataSource = (BasicDataSource) BasicDataSourceFactory.createDataSource(p);

        } catch (Exception e) {
            //
        }
    }

    public static synchronized Connection getConnection() throws  SQLException {
        if (dataSource == null) {
            init();
        }
        Connection conn = null;
        if (dataSource != null) {
            conn = dataSource.getConnection();
        }
        return conn;
    }
}

接下來，在我們的應用中，只要簡單地使用ConnectionSource.getConnection()就可以取得串連池中的資料庫連接，享受資料庫連接帶給我們的好處了。當我們使用完取得的資料庫連接後，只要簡單地使用connection.close()就可把此串連返回到串連池中，至於為什麼不是直接關閉此串連，而是返回給串連池，這是因為dbcp使用委派模型來實現Connection介面了。

在使用Properties來建立BasicDataSource時，有很多參數可以設定，比較重要的還有：

testOnBorrow、testOnReturn、testWhileIdle，他們的意思是當是取得串連、返回串連或串連空閑時是否進行有效性驗證（即是否還和資料庫連通的），預設都為false。所以當資料庫連接因為某種原因斷掉後，再從串連池中取得的串連，實際上可能是無效的串連了，所以，為了確保取得的串連是有效， 可以把把這些屬性設為true。當進行校正時，需要另一個參數：validationQuery，對oracle來說，可以是：SELECT COUNT(*) FROM DUAL，實際上就是個簡單的SQL語句，驗證時，就是把這個SQL語句在資料庫上跑一下而已，如果串連正常的，當然就有結果返回了。

還有2個參數：timeBetweenEvictionRunsMillis 和 minEvictableIdleTimeMillis， 他們兩個配合，可以持續更新串連池中的連線物件，當timeBetweenEvictionRunsMillis 大於0時，每過timeBetweenEvictionRunsMillis 時間，就會啟動一個線程，校正串連池中閑置時間超過minEvictableIdleTimeMillis的連線物件。

還有其他的一些參數，可以參考原始碼。

 

轉載請標明出處：http://blog.csdn.net/zllsdn/archive/2006/11/20/1398577.aspx