Spring DataSource>DBCP & C3P0

FrankYou發表於2018-03-15
Spring

Spring在第三方依賴包中包含了兩個資料來源的實現類包，其一是Apache的DBCP，其二是 C3P0。可以在Spring配置檔案中利用這兩者中任何一個配置資料來源。

DBCP資料來源

DBCP類包位於 <spring_home></spring_home>/lib/jakarta-commons/commons-dbcp.jar，DBCP是一個依賴 Jakarta commons-pool物件池機制的資料庫連線池，所以在類路徑下還必須包括<spring_home></spring_home>/lib/jakarta- commons/commons-pool.jar。

下面是使用DBCP配置MySql資料來源的配置片斷：

xml 程式碼

<bean id="dataSource" class="org.apache.commons.dbcp.BasicDataSource" destroy-method="close"> 
<property name="driverClassName" value="com.mysql.jdbc.Driver" /> 
<property name="url" value="jdbc:mysql://localhost:3309/sampledb" /> 
<property name="username" value="root" /> 
<property name="password" value="1234" /> 
</bean>

BasicDataSource提供了close()方法關閉資料來源，所以必須設定destroy-method=”close”屬性，

以便Spring容器關閉時，資料來源能夠正常關閉。除以上必須的資料來源屬性外，還有一些常用的屬性：
defaultAutoCommit：設定從資料來源中返回的連線是否採用自動提交機制，預設值為 true；
defaultReadOnly：設定資料來源是否僅能執行只讀操作， 預設值為 false；
maxActive：最大連線資料庫連線數，設定為0時，表示沒有限制；
maxIdle：最大等待連線中的數量，設定為0時，表示沒有限制；
maxWait：最大等待秒數，單位為毫秒， 超過時間會報出錯誤資訊；
validationQuery：用於驗證連線是否成功的查詢SQL語句，SQL語句必須至少要返回一行資料，

如你可以簡單地設定為：“select count(*) from user”；
removeAbandoned：是否自我中斷，預設是 false ；
removeAbandonedTimeout：幾秒後資料連線會自動斷開，在removeAbandoned為true，提供該值；
logAbandoned：是否記錄中斷事件， 預設為 false；

C3P0資料來源

C3P0是一個開放原始碼的JDBC資料來源實現專案，它在lib目錄中與Hibernate一起釋出，實現了JDBC3和JDBC2擴充套件規範說明的 Connection 和Statement 池。
C3P0類包位於<spring_home></spring_home>/lib/c3p0/c3p0-0.9.0.4.jar。下面是使用C3P0配置一個 Oracle資料來源：

xml 程式碼

<bean id="dataSource" class="com.mchange.v2.c3p0.ComboPooledDataSource" 
destroy-method="close"> 
<property name="driverClass" value=" oracle.jdbc.driver.OracleDriver "/> 
<property name="jdbcUrl" value=" jdbc:oracle:thin:@localhost:1521:ora9i "/> 
<property name="user" value="admin"/> 
<property name="password" value="1234"/> 
</bean>

ComboPooledDataSource和BasicDataSource一樣提供了一個用於關閉資料來源的close()方法，

這樣我們就可以保證Spring容器關閉時資料來源能夠成功釋放。
C3P0擁有比DBCP更豐富的配置屬性，通過這些屬性，可以對資料來源進行各種有效的控制：
acquireIncrement：當連線池中的連線用完時，C3P0一次性建立新連線的數目；
acquireRetryAttempts：定義在從資料庫獲取新連線失敗後重復嘗試獲取的次數，預設為30；
acquireRetryDelay：兩次連線中間隔時間，單位毫秒，預設為1000；
autoCommitOnClose：連線關閉時預設將所有未提交的操作回滾。預設為false；
automaticTestTable： C3P0將建一張名為Test的空表，並使用其自帶的查詢語句進行測試。

如果定義了這個引數，那麼屬性preferredTestQuery將被忽略。

你 不能在這張Test表上進行任何操作，它將中為C3P0測試所用，預設為null；
breakAfterAcquireFailure：獲取連線失敗將會引起所有等待獲取連線的執行緒丟擲異常。但是資料來源仍有效保留，

並在下次調 用getConnection()的時候繼續嘗試獲取連線。如果設為true，那麼在嘗試獲取連線失敗後該資料來源將申明已斷開並永久關閉。預設為 false；
checkoutTimeout：當連線池用完時客戶端呼叫getConnection()後等待獲取新連線的時間，超時後將丟擲SQLException，

如設為0則無限期等待。單位毫秒，預設為0；
connectionTesterClassName： 通過實現ConnectionTester或QueryConnectionTester的類來測試連線，類名需設定為全限定名。預設為 com.mchange.v2.C3P0.impl.DefaultConnectionTester；
idleConnectionTestPeriod：隔多少秒檢查所有連線池中的空閒連線，預設為0表示不檢查；
initialPoolSize：初始化時建立的連線數，應在minPoolSize與maxPoolSize之間取值。預設為3；
maxIdleTime：最大空閒時間，超過空閒時間的連線將被丟棄。為0或負數則永不丟棄。預設為0；
maxPoolSize：連線池中保留的最大連線數。預設為15；
maxStatements：JDBC的標準引數，用以控制資料來源內載入的PreparedStatement數量。

但由於預快取的Statement屬 於單個Connection而不是整個連線池。所以設定這個引數需要考慮到多方面的因素，

如果maxStatements與 maxStatementsPerConnection均為0，則快取被關閉。預設為0；
maxStatementsPerConnection：連線池內單個連線所擁有的最大快取Statement數。預設為0；
numHelperThreads：C3P0是非同步操作的，緩慢的JDBC操作通過幫助程式完成。擴充套件這些操作可以有效的提升效能，

通過多執行緒實現多個操作同時被執行。預設為3；
preferredTestQuery：定義所有連線測試都執行的測試語句。在使用連線測試的情況下這個引數能顯著提高測試速度。

測試的表必須在初始資料來源的時候就存在。預設為null；
propertyCycle： 使用者修改系統配置引數執行前最多等待的秒數。預設為300；
testConnectionOnCheckout：因效能消耗大請只在需要的時候使用它。如果設為true那麼在每個connection提交的時候都 將校驗其有效性。建議使用idleConnectionTestPeriod或automaticTestTable
等方法來提升連線測試的效能。預設為false；
testConnectionOnCheckin：如果設為true那麼在取得連線的同時將校驗連線的有效性。預設為false。

讀配置檔案的方式引用屬性：

<bean id="propertyConfigurer" class="org.springframework.beans.factory.config.PropertyPlaceholderConfigurer"> 
<property name="location" value="/WEB-INF/jdbc.properties"/> 
</bean> 
<bean id="dataSource" class="org.apache.commons.dbcp.BasicDataSource" destroy-method="close"> 
<property name="driverClassName" value="${jdbc.driverClassName}" /> 
<property name="url" value="${jdbc.url}" /> 
<property name="username" value="${jdbc.username}" /> 
<property name="password" value="${jdbc.password}" /> 
</bean> 

在jdbc.properties屬性檔案中定義屬性值：
jdbc.driverClassName= com.mysql.jdbc.Driver
jdbc.url= jdbc:mysql://localhost:3309/sampledb
jdbc.username=root
jdbc.password=1234
提示 經常有開發者在${xxx}的前後不小心鍵入一些空格，這些空格字元將和變數合併後作為屬性的值。

如： <property name="username" value=" ${jdbc.username} "></property> 的屬性配置項，

在前後都有空格，被解析後，username的值為“ 1234 ”，這將造成最終的錯誤，因此需要特別小心。

相關文章