C3P0鏈接池的配置方式

c3p0的配置方式分爲三種，分別是 1.setters一個個地設置各個配置項 2.類路徑下提供一個c3p0.properties文件 3.類路徑下提供一個c3p0-config.xml文件 1.setters一個個地設置各個配置項 這種方式最繁瑣，形式通常是這樣：

Properties props = new Properties();
InputStream in = ConnectionManager.class.getResourceAsStream("/c3p0.properties");
props.load(in);
in.close();

ComboPooledDataSource cpds = new ComboPooledDataSource();
cpds.setDriverClass(props.getProperty("driverClass"));
cpds.setJdbcUrl(props.getProperty("jdbcUrl"));
cpds.setUser(props.getProperty("user"));
cpds.setPassword(props.getProperty("password"));

由於繁瑣，因此很不適合採用，因而文檔提供了另外另種方式。 2. 類路徑下提供一個c3p0.properties文件 文件的命名必須是c3p0.properties，裏面配置項的格式爲：

c3p0.driverClass=com.mysql.jdbc.Driver
c3p0.jdbcUrl=jdbc:mysql://localhost:3306/jdbc
c3p0.user=root
c3p0.password=java

上面只提供了最基本的配置項，其餘配置項參照 文檔配置，記得是c3p0.後面加屬性名就是了，最後初始化數據源的方式就是這樣簡單： p

rivate static ComboPooledDataSource ds = new ComboPooledDataSource();
public static Connection getConnection() {
try {
return ds.getConnection();
} catch (SQLException e) {
throw new RuntimeException(e);
}
}

3.類路徑下提供一個c3p0-config.xml文件 這種方式使用方式與第二種差很少，可是有更多的優勢 (1).更直觀明顯，很相似hibernate和spring的配置 (2).能夠爲多個數據源服務，提供default-config和named-config兩種配置方式 下面是一個配置模板：

<c3p0-config>
<default-config>
<property name="user">root</property>
<property name="password">java</property>
<property name="driverClass">com.mysql.jdbc.Driver</property>
<property name="jdbcUrl">jdbc:mysql://localhost:3306/jdbc</property>
<property name="initialPoolSize">10</property>
<property name="maxIdleTime">30</property>
<property name="maxPoolSize">100</property>
<property name="minPoolSize">10</property>
</default-config>

<named-config name="myApp">
<property name="user">root</property>
<property name="password">java</property>
<property name="driverClass">com.mysql.jdbc.Driver</property>
<property name="jdbcUrl">jdbc:mysql://localhost:3306/jdbc</property>

<property name="initialPoolSize">10</property>
<property name="maxIdleTime">30</property>
<property name="maxPoolSize">100</property>
<property name="minPoolSize">10</property>
</named-config>
</c3p0-config>

若是要使用default-config則初始化數據源的方式與第二種同樣，若是要使用named-config裏面配置初始化數據源，則只要使用一個帶參數的ComboPooledDataSource構造器就能夠了

private static ComboPooledDataSource ds = new ComboPooledDataSource("myApp");

下面整理一下從文檔和網上學習到的c3p0配置的理解 (user,password,driverClass,jdbcUrl沒有說的必要) 

1.基本配置項 acquireIncrement default : 3 鏈接池在無空閒鏈接可用時一次性建立的新數據庫鏈接數 initialPoolSize default : 3 鏈接池初始化時建立的鏈接數 maxPoolSize default : 15 鏈接池中擁有的最大鏈接數，若是得到新鏈接時會使鏈接總數超過這個值則不會再獲取新鏈接，而是等待 其餘鏈接釋放，因此這個值有可能會設計地很大 maxIdleTime default : 0 單位 s 鏈接的最大空閒時間，若是超過這個時間，某個數據庫鏈接尚未被使用，則會斷開掉這個鏈接 若是爲0，則永遠不會斷開鏈接 minPoolSize default : 3 鏈接池保持的最小鏈接數，後面的maxIdleTimeExcessConnections跟這個配合使用來減輕鏈接池的負載 2.管理鏈接池的大小和鏈接的生存時間 maxConnectionAge default : 0 單位 s 配置鏈接的生存時間，超過這個時間的鏈接將由鏈接池自動斷開丟棄掉。固然正在使用的鏈接不會立刻斷開，而是等待 它close再斷開。配置爲0的時候則不會對鏈接的生存時間進行限制。 maxIdleTimeExcessConnections default : 0 單位 s 這個配置主要是爲了減輕鏈接池的負載，好比鏈接池中鏈接數由於某次數據訪問高峯致使建立了不少數據鏈接 可是後面的時間段須要的數據庫鏈接數不多，則此時鏈接池徹底沒有必要維護那麼多的鏈接，因此有必要將 斷開丟棄掉一些鏈接來減輕負載，必須小於maxIdleTime。配置不爲0，則會將鏈接池中的鏈接數量保持到minPoolSize。 爲0則不處理。 maxIdleTime也能夠歸屬到這一類，前面已經寫出來了。 3.配置鏈接測試：由於鏈接池中的數據庫鏈接頗有多是維持數小時的鏈接，頗有可能由於數據庫服務器的問題，網絡問題等致使實際鏈接已經無效，可是鏈接池裏面的鏈接仍是有效的，若是此時得到鏈接確定會發生異常，因此有必要經過測試鏈接來確認鏈接的有效性。 下面的前三項用來配置如何對鏈接進行測試，後三項配置對鏈接進行測試的時機。 automaticTestTable default : null 用來配置測試鏈接的一種方式。配置一個表名，鏈接池根據這個表名建立一個空表， 而且用本身的測試sql語句在這個空表上測試數據庫鏈接 這個表只能由c3p0來使用，用戶不能操做，同時用戶配置的preferredTestQuery 將會被忽略。 preferredTestQuery default : null 用來配置測試鏈接的另外一種方式。與上面的automaticTestTable兩者只能選一。 若是要用它測試鏈接，千萬不要設爲null，不然測試過程會很耗時，同時要保證sql語句中的表在數據庫中必定存在。 connectionTesterClassName default :  com.mchange.v2.c3p0.impl.DefaultConnectionTester 鏈接池用來支持automaticTestTable和preferredTestQuery測試的類，必須是全類名，就像默認的那樣， 能夠經過實現UnifiedConnectionTester接口或者繼承AbstractConnectionTester來定製本身的測試方法 idleConnectionTestPeriod default : 0 用來配置測試空閒鏈接的間隔時間。測試方式仍是上面的兩種之一，能夠用來解決MySQL8小時斷開鏈接的問題。由於它 保證鏈接池會每隔必定時間對空閒鏈接進行一次測試，從而保證有效的空閒鏈接能每隔必定時間訪問一次數據庫，將於MySQL 8小時無會話的狀態打破。爲0則不測試。 testConnectionOnCheckin default : false 若是爲true，則在close的時候測試鏈接的有效性。爲了提升測試性能，能夠與idleConnectionTestPeriod搭配使用， 配置preferredTestQuery或automaticTestTable也能夠加快測試速度。 testConnectionOnCheckout default : false 性能消耗大。若是爲true，在每次getConnection的時候都會測試，爲了提升性能， 能夠與idleConnectionTestPeriod搭配使用， 配置preferredTestQuery或automaticTestTable也能夠加快測試速度。 4.配置PreparedStatement緩存 maxStatements default : 0 鏈接池爲數據源緩存的PreparedStatement的總數。因爲PreparedStatement屬於單個Connection,因此 這個數量應該根據應用中平均鏈接數乘以每一個鏈接的平均PreparedStatement來計算。爲0的時候不緩存， 同時maxStatementsPerConnection的配置無效。 maxStatementsPerConnection default : 0 鏈接池爲數據源單個Connection緩存的PreparedStatement數，這個配置比maxStatements更有意義，由於 它緩存的服務對象是單個數據鏈接，若是設置的好，確定是能夠提升性能的。爲0的時候不緩存。 5.重連相關配置 acquireRetryAttempts default : 30 鏈接池在得到新鏈接失敗時重試的次數，若是小於等於0則無限重試直至鏈接得到成功 acquireRetryDelay default : 1000 單位ms 鏈接池在得到新鏈接時的間隔時間 breakAfterAcquireFailure default : false 若是爲true，則當鏈接獲取失敗時自動關閉數據源，除非從新啓動應用程序。因此通常不用。 我的以爲上述三個沒有更改的必要，但能夠將acquireRetryDelay配置地更短一些 6.定製管理Connection的生命週期 connectionCustomizerClassName default : null 用來定製Connection的管理，好比在Connection acquire 的時候設定Connection的隔離級別，或者在 Connection丟棄的時候進行資源關閉，就能夠經過繼承一個AbstractConnectionCustomizer來實現相關 方法，配置的時候使用全類名。有點相似監聽器的做用。 例如：

import java.sql.Connection;
import com.mchange.v2.c3p0.AbstractConnectionCustomizer;
public class ConnectionCustomizer extends AbstractConnectionCustomizer{
@Override
public void onAcquire(Connection c, String parentDataSourceIdentityToken)
throws Exception {
System.out.println("acquire : " + c);
}
@Override
public void onCheckIn(Connection c, String parentDataSourceIdentityToken)
throws Exception {
System.out.println("checkin : " + c);
}
@Override
public void onCheckOut(Connection c, String parentDataSourceIdentityToken)
throws Exception {
System.out.println("checkout : " + c);
}
@Override
public void onDestroy(Connection c, String parentDataSourceIdentityToken)
throws Exception {
System.out.println("destroy : " + c);
}
}
<property name="connectionCustomizerClassName">liuyun.zhuge.db.ConnectionCustomizer</property>

7.配置未提交的事務處理 autoCommitOnClose default : false 鏈接池在回收數據庫鏈接時是否自動提交事務 若是爲false，則會回滾未提交的事務 若是爲true，則會自動提交事務 forceIgnoreUnresolvedTransactions default : false 這個配置強烈不建議爲true。 通常來講事務固然由本身關閉了，爲何要讓鏈接池來處理這種不細心問題呢？ 8.配置debug和回收Connection unreturnedConnectionTimeout default : 0 單位 s 爲0的時候要求全部的Connection在應用程序中必須關閉。若是不爲0，則強制在設定的時間到達後回收 Connection，因此必須當心設置，保證在回收以前全部數據庫操做都可以完成。這種限制減小Connection未關閉 狀況的不是很適用。爲0不對connection進行回收，即便它並無關閉。 debugUnreturnedConnectionStackTraces default : false 若是爲true而且unreturnedConnectionTimeout設爲大於0的值，當全部被getConnection出去的鏈接 unreturnedConnectionTimeout時間到的時候，就會打印出堆棧信息。只能在debug模式下適用，由於 打印堆棧信息會減慢getConnection的速度 同第七項同樣的，鏈接用完固然得close了，不要經過unreturnedConnectionTimeout讓鏈接池來回收未關閉的鏈接。 9.其餘配置項：由於有些配置項幾乎沒有本身配置的必要，使用默認值就好，因此沒有再寫出來 checkoutTimeout default : 0 配置當鏈接池全部鏈接用完時應用程序getConnection的等待時間。爲0則無限等待直至有其餘鏈接釋放 或者建立新的鏈接，不爲0則當時間到的時候若是仍沒有得到鏈接，則會拋出SQLException