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("創建連接池失敗!請檢查設置!!!");
}
有使用問題或建議可與我聯繫:[email protected]
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的連接對象。
還有其他的一些參數,可以參考源代碼。