C3P0的詳細配置說明(com.mchange.v2.c3p0.ComboPooledDataSource)

C3P0是一個開放源代碼的JDBC連接池,它在lib目錄中與Hibernate一起發佈,包括了實現jdbc3和 jdbc2擴展規範說明的Connection 和Statement 池的DataSources 對象。 
  <!--當連 接池中的連接耗盡的時候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> 
  在Hibernate(spring管理)中的配置: 
  <bean id="dataSource" class="com.mchange.v2.c3p0.ComboPooledDataSource" destroy-method="close">
   <property name="driverClass"><value>oracle.jdbc.driver.OracleDriver</value></property> 
  <property name="jdbcUrl"><value>jdbc:oracle:thin:@localhost:1521:Test</value></property> 
  <property name="user"><value>Kay</value></property> 
  <property name="password"><value>root</value></property> 
  <!--連接池中保留的最小連接數。--> 
  <property name="minPoolSize" value="10" /> 
  <!--連接池中保留的最大連接數。Default: 15 --> 
  <property name="maxPoolSize" value="100" /> 
  <!--最大空閒時間,1800秒內未使用則連 接被丟棄。若爲0則永不丟棄。Default: 0 --> 
   <property name="maxIdleTime" value="1800" /> 
  <!--當連接池中的連接耗盡的時候c3p0一次同時獲取的連接數。Default: 3 --> 
  <property name="acquireIncrement" value="3" /> 
  <property name="maxStatements" value="1000" /> 
  <property name="initialPoolSize" value="10" /> 
  <!--每60秒檢查所有連接池中的空閒連接。Default: 0 --> 
  <property name="idleConnectionTestPeriod" value="60" /> 
  <!--定義在從數據庫獲取新連接失敗後重復嘗試的次數。Default: 30 --> 
  <property name="acquireRetryAttempts" value="30" /> 
  <property name="breakAfterAcquireFailure" value="true" /> 
  <property name="testConnectionOnCheckout" value="false" /> 
  </bean> 
  ########################### 
  ### C3P0 Connection Pool### 
  ########################### 
  #hibernate.c3p0.max_size 2 
  #hibernate.c3p0.min_size 2 
  #hibernate.c3p0.timeout 5000 
  #hibernate.c3p0.max_statements 100 
  #hibernate.c3p0.idle_test_period 3000 
  #hibernate.c3p0.acquire_increment 2 
  #hibernate.c3p0.validate false 
  在hibernate.cfg.xml文件裏面加入如下的配置: 
  <!-- 最大連接數 --> 
   <property name="hibernate.c3p0.max_size">20</property> 
  <!-- 最小連接數 --> 
  <property name="hibernate.c3p0.min_size">5</property> 
  <!-- 獲得連接的超時時間,如果超過這個時間,會拋出異常,單位毫秒 --> 
  <property name="hibernate.c3p0.timeout">120</property> 
  <!-- 最大的PreparedStatement的數量 --> 
  <property name="hibernate.c3p0.max_statements">100</property> 
  <!-- 每隔120秒檢查連接池裏的空閒連接 ,單位是秒--> 
  <property name="hibernate.c3p0.idle_test_period">120</property> 
  <!-- 當連接池裏面的連接用完的時候,C3P0一下獲取的新的連接數 --> 
  <property name="hibernate.c3p0.acquire_increment">2</property> 
  <!-- 每次都驗證連接是否可用 --> 
  <property name="hibernate.c3p0.validate">true</property> 
發佈了16 篇原創文章 · 獲贊 3 · 訪問量 3萬+
發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章