c3p0的相關配置說明

Hibernate推薦使用c3p0作爲數據庫連接池，管理數據庫連接的資源。如果使用的應用服務器爲非商業版本（比如：tomcat等），建議使用c3p0作爲數據庫連接池。但是，如果使用的是商業應用服務器，建議使用應用服務器內置的數據庫連接池。因爲，商業產品一般都會提供連接池的運行情況監控信息，從而便於未來應用的調優等操作。
但是，對於c3p0的配置，由於之前一直沒有時間仔細研究，因此，也就暫且擱置。目前，又要使用hibernate，便又拿來，順便把自己所蒐羅到的所有的參數都記錄下來，以備查。
c3p0的配置方式分爲三種，分別是：

1. setters一個個地設置各個配置項
2. 類路徑下提供一個c3p0.properties文件
3. 類路徑下提供一個c3p0-config.xml文件

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"));

類路徑下提供一個c3p0.properties文件
文件的命名必須是c3p0.properties，c3p0會自動加載此資源文件的內容，並按照其中的配置進行數據源管理。文件內容格式類似於：

c3p0.driverClass=com.mysql.jdbc.Driver
c3p0.jdbcUrl=jdbc:mysql://localhost:3306/jdbc

記得是c3p0.後面加屬性名就是了，最後初始化數據源的方式就是這樣簡單：

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

類路徑下提供一個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");

hibernate默認使用的應該就是第3種方式。下面是參數的詳細說明：

<c3p0-config>
<default-config>
<!--當連接池中的連接耗盡的時候c3p0一次同時獲取的連接數。Default: 3 -->
<property name="acquireIncrement">3</property>

<!--定義在從數據庫獲取新連接失敗後重復嘗試的次數。Default: 30 -->
<property name="acquireRetryAttempts">30</property>

<!--兩次連接中間隔時間，單位毫秒。Default: 1000 -->
<property name="acquireRetryDelay">1000</property>

<!--連接關閉時默認將所有未提交的操作回滾。Default: false -->
<property name="autoCommitOnClose">false</property>

<!--c3p0將建一張名爲Test的空表，並使用其自帶的查詢語句進行測試。如果定義了這個參數，那麼屬性preferredTestQuery將被忽略。你不能在這張Test表上進行任何操作，它將只供c3p0測試使用。Default: null-->
<property name="automaticTestTable">Test</property>

<!--獲取連接失敗將會引起所有等待連接池來獲取連接的線程拋出異常。但是數據源仍有效保留，並在下次調用getConnection()的時候繼續嘗試獲取連接。如果設爲true，那麼在嘗試獲取連接失敗後該數據源將申明已斷開並永久關閉。Default: false-->
<property name="breakAfterAcquireFailure">false</property>

<!--當連接池用完時客戶端調用getConnection()後等待獲取新連接的時間，超時後將拋出SQLException,如設爲0則無限期等待。單位毫秒。Default: 0 -->
<property name="checkoutTimeout">100</property>

<!--通過實現ConnectionTester或QueryConnectionTester的類來測試連接。類名需制定全路徑。Default: com.mchange.v2.c3p0.impl.DefaultConnectionTester-->
<property name="connectionTesterClassName"></property>

<!--指定c3p0 libraries的路徑，如果（通常都是這樣）在本地即可獲得那麼無需設置，默認null即可Default: null-->
<property name="factoryClassLocation">null</property>

<!--Strongly disrecommended. Setting this to true may lead to subtle and bizarre bugs.（文檔原文）作者強烈建議不使用的一個屬性-->
<property name="forceIgnoreUnresolvedTransactions">false</property>

<!--每60秒檢查所有連接池中的空閒連接。Default: 0 -->
<property name="idleConnectionTestPeriod">60</property>

<!--初始化時獲取三個連接，取值應在minPoolSize與maxPoolSize之間。Default: 3 -->
<property name="initialPoolSize">3</property>

<!--最大空閒時間,60秒內未使用則連接被丟棄。若爲0則永不丟棄。Default: 0 -->
<property name="maxIdleTime">60</property>

<!--連接池中保留的最大連接數。Default: 15 -->
<property name="maxPoolSize">15</property>

<!--JDBC的標準參數，用以控制數據源內加載的PreparedStatements數量。但由於預緩存的statements屬於單個connection而不是整個連接池。所以設置這個參數需要考慮到多方面的因素。如果maxStatements與maxStatementsPerConnection均爲0，則緩存被關閉。Default: 0-->
<property name="maxStatements">100</property>

<!--maxStatementsPerConnection定義了連接池內單個連接所擁有的最大緩存statements數。Default: 0 -->
<property name="maxStatementsPerConnection"></property>

<!--c3p0是異步操作的，緩慢的JDBC操作通過幫助進程完成。擴展這些操作可以有效的提升性能通過多線程實現多個操作同時被執行。Default: 3-->
<property name="numHelperThreads">3</property>

<!--當用戶調用getConnection()時使root用戶成爲去獲取連接的用戶。主要用於連接池連接非c3p0的數據源時。Default: null-->
<property name="overrideDefaultUser">root</property>

<!--與overrideDefaultUser參數對應使用的一個參數。Default: null-->
<property name="overrideDefaultPassword">password</property>

<!--密碼。Default: null-->
<property name="password"></property>

<!--定義所有連接測試都執行的測試語句。在使用連接測試的情況下這個一顯著提高測試速度。注意：測試的表必須在初始數據源的時候就存在。Default: null-->
<property name="preferredTestQuery">select id from test where id=1</property>

<!--用戶修改系統配置參數執行前最多等待300秒。Default: 300 -->
<property name="propertyCycle">300</property>

<!--因性能消耗大請只在需要的時候使用它。如果設爲true那麼在每個connection提交的時候都將校驗其有效性。建議使用idleConnectionTestPeriod或automaticTestTable等方法來提升連接測試的性能。Default: false -->
<property name="testConnectionOnCheckout">false</property>

<!--如果設爲true那麼在取得連接的同時將校驗連接的有效性。Default: false -->
<property name="testConnectionOnCheckin">true</property>

<!--用戶名。Default: null-->
<property name="user">root</property>

<!--早期的c3p0版本對JDBC接口採用動態反射代理。在早期版本用途廣泛的情況下這個參數允許用戶恢復到動態反射代理以解決不穩定的故障。最新的非反射代理更快並且已經開始廣泛的被使用，所以這個參數未必有用。現在原先的動態反射與新的非反射代理同時受到支持，但今後可能的版本可能不支持動態反射代理。Default: false-->
<property name="usesTraditionalReflectiveProxies">false</property>

<property name="automaticTestTable">con_test</property>
    <property name="checkoutTimeout">30000</property>
    <property name="idleConnectionTestPeriod">30</property>
    <property name="initialPoolSize">10</property>
    <property name="maxIdleTime">30</property>
    <property name="maxPoolSize">25</property>
    <property name="minPoolSize">10</property>
    <property name="maxStatements">0</property>
    <user-overrides user="swaldman">
    </user-overrides>
</default-config>
<named-config name="dumbTestConfig">
    <property name="maxStatements">200</property>
    <user-overrides user="poop">
      <property name="maxStatements">300</property>
    </user-overrides>
   </named-config>
</c3p0-config>