c3p0資料庫連線池資料來源配置
阿新 • • 發佈:2019-02-12
不管通過何種持久化技術,都必須通過資料連線訪問資料庫,在Spring中,資料連線是通過資料來源獲得的。在以往的應用中,資料來源一般是 Web應用伺服器提供的。在Spring中,你不但可以通過JNDI獲取應用伺服器的資料來源,也可以直接在Spring容器中配置資料來源,此外,你還可以 通過程式碼的方式建立一個數據源,以便進行無依賴的單元測試
配置一個數據源
Spring在第三方依賴包中包含了兩個資料來源的實現類包,其一是Apache的DBCP,其二是 C3P0。可以在Spring配置檔案中利用這兩者中任何一個配置資料來源。 DBCP資料來源
DBCP類包位於 /lib/jakarta-commons/commons-dbcp.jar,DBCP是一個依賴 Jakarta commons-pool物件池機制的資料庫連線池,所以在類路徑下還必須包括/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類包位於/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}的前後不小心鍵入一些空格,這些空格字元將和變數合併後作為屬性的值。如: 的屬性配置項,在前後都有空格,被解析後,username的值為“ 1234 ”,這將造成最終的錯誤,因此需要特別小心。 獲取JNDI資料來源
如果應用配置在高效能的應用伺服器(如WebLogic或Websphere等)上,我們可能更希望使用應用伺服器本身提供的資料來源。應用伺服器的資料來源 使用JNDI開放呼叫者使用,Spring為此專門提供引用JNDI資源的JndiObjectFactoryBean類。下面是一個簡單的配置: xml 程式碼
<bean id="dataSource" class="org.springframework.jndi.JndiObjectFactoryBean">
<property name="jndiName" value="java:comp/env/jdbc/bbt"/>
</bean>
通過jndiName指定引用的JNDI資料來源名稱。
Spring 2.0為獲取J2EE資源提供了一個jee名稱空間,通過jee名稱空間,可以有效地簡化J2EE資源的引用。下面是使用jee名稱空間引用JNDI資料來源的配置: xml 程式碼
<beans xmlns=http://www.springframework.org/schema/beans
xmlns:xsi=http://www.w3.org/2001/XMLSchema-instance
xmlns:jee=http://www.springframework.org/schema/jee
xsi:schemaLocation=" http://www.springframework.org/schema/beans
http://www.springframework.org/schema/beans/spring-beans-2.0.xsd
http://www.springframework.org/schema/jee
http://www.springframework.org/schema/jee/spring-jee-2.0.xsd">
<jee:jndi-lookup id="dataSource" jndi-name=" java:comp/env/jdbc/bbt"/>
</beans>
Spring的資料來源實現類
Spring本身也提供了一個簡單的資料來源實現類DriverManagerDataSource ,它位於org.springframework.jdbc.datasource包中。這個類實現了javax.sql.DataSource介面,但 它並沒有提供池化連線的機制,每次呼叫getConnection()獲取新連線時,只是簡單地建立一個新的連線。因此,這個資料來源類比較適合在單元測試 或簡單的獨立應用中使用,因為它不需要額外的依賴類。
下面,我們來看一下DriverManagerDataSource的簡單使用:當然,我們也可以通過配置的方式直接使用DriverManagerDataSource。 java 程式碼
DriverManagerDataSource ds = new DriverManagerDataSource ();
ds.setDriverClassName("com.mysql.jdbc.Driver");
ds.setUrl("jdbc:mysql://localhost:3309/sampledb");
ds.setUsername("root");
ds.setPassword("1234");
Connection actualCon = ds.getConnection();
小結 不管採用何種持久化技術,都需要定義資料來源。Spring附帶了兩個資料來源的實現類包,你可以自行選擇進行定義。在實際部署時,我們可能會直接採用應用服 務器本身提供的資料來源,這時,則可以通過JndiObjectFactoryBean或jee名稱空間引用JNDI中的資料來源。 DBCP與C3PO配置的區別: C3PO :DBCP: xml 程式碼
<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:@10.10.10.6:1521:DataBaseName</value>
</property>
<property name="user">
<value>testAdmin</value>
</property>
<property name="password">
<value>123456</value>
</property>
</bean>
xml 程式碼
<bean id="dataSource" class="org.apache.commons.dbcp.BasicDataSource" destroy-method="close">
<property name="driverClassName">
<value>oracle.jdbc.driver.OracleDriver</value>
</property>
<property name="url">
<value>jdbc:oracle:thin:@10.10.10.6:1521:DataBaseName</value>
</property>
<property name="username">
<value>testAdmin</value>
</property>
<property name="password">
<value>123456</value>
</property>
</bean>
配置一個數據源
Spring在第三方依賴包中包含了兩個資料來源的實現類包,其一是Apache的DBCP,其二是 C3P0。可以在Spring配置檔案中利用這兩者中任何一個配置資料來源。 DBCP資料來源
DBCP類包位於 /lib/jakarta-commons/commons-dbcp.jar,DBCP是一個依賴 Jakarta commons-pool物件池機制的資料庫連線池,所以在類路徑下還必須包括/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類包位於/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}的前後不小心鍵入一些空格,這些空格字元將和變數合併後作為屬性的值。如: 的屬性配置項,在前後都有空格,被解析後,username的值為“ 1234 ”,這將造成最終的錯誤,因此需要特別小心。 獲取JNDI資料來源
如果應用配置在高效能的應用伺服器(如WebLogic或Websphere等)上,我們可能更希望使用應用伺服器本身提供的資料來源。應用伺服器的資料來源 使用JNDI開放呼叫者使用,Spring為此專門提供引用JNDI資源的JndiObjectFactoryBean類。下面是一個簡單的配置: xml 程式碼
<bean id="dataSource" class="org.springframework.jndi.JndiObjectFactoryBean">
<property name="jndiName" value="java:comp/env/jdbc/bbt"/>
</bean>
通過jndiName指定引用的JNDI資料來源名稱。
Spring 2.0為獲取J2EE資源提供了一個jee名稱空間,通過jee名稱空間,可以有效地簡化J2EE資源的引用。下面是使用jee名稱空間引用JNDI資料來源的配置: xml 程式碼
<beans xmlns=http://www.springframework.org/schema/beans
xmlns:xsi=http://www.w3.org/2001/XMLSchema-instance
xmlns:jee=http://www.springframework.org/schema/jee
xsi:schemaLocation="
http://www.springframework.org/schema/beans/spring-beans-2.0.xsd
http://www.springframework.org/schema/jee
http://www.springframework.org/schema/jee/spring-jee-2.0.xsd">
<jee:jndi-lookup id="dataSource" jndi-name=" java:comp/env/jdbc/bbt"/>
</beans>
Spring的資料來源實現類
Spring本身也提供了一個簡單的資料來源實現類DriverManagerDataSource ,它位於org.springframework.jdbc.datasource包中。這個類實現了javax.sql.DataSource介面,但 它並沒有提供池化連線的機制,每次呼叫getConnection()獲取新連線時,只是簡單地建立一個新的連線。因此,這個資料來源類比較適合在單元測試 或簡單的獨立應用中使用,因為它不需要額外的依賴類。
下面,我們來看一下DriverManagerDataSource的簡單使用:當然,我們也可以通過配置的方式直接使用DriverManagerDataSource。 java 程式碼
DriverManagerDataSource ds = new DriverManagerDataSource ();
ds.setDriverClassName("com.mysql.jdbc.Driver");
ds.setUrl("jdbc:mysql://localhost:3309/sampledb");
ds.setUsername("root");
ds.setPassword("1234");
Connection actualCon = ds.getConnection();
小結 不管採用何種持久化技術,都需要定義資料來源。Spring附帶了兩個資料來源的實現類包,你可以自行選擇進行定義。在實際部署時,我們可能會直接採用應用服 務器本身提供的資料來源,這時,則可以通過JndiObjectFactoryBean或jee名稱空間引用JNDI中的資料來源。 DBCP與C3PO配置的區別: C3PO :DBCP: xml 程式碼
<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:@10.10.10.6:1521:DataBaseName</value>
</property>
<property name="user">
<value>testAdmin</value>
</property>
<property name="password">
<value>123456</value>
</property>
</bean>
xml 程式碼
<bean id="dataSource" class="org.apache.commons.dbcp.BasicDataSource" destroy-method="close">
<property name="driverClassName">
<value>oracle.jdbc.driver.OracleDriver</value>
</property>
<property name="url">
<value>jdbc:oracle:thin:@10.10.10.6:1521:DataBaseName</value>
</property>
<property name="username">
<value>testAdmin</value>
</property>
<property name="password">
<value>123456</value>
</property>
</bean>