不管通過(guò)何種持久化技術(shù),都必須通過(guò)數(shù)據(jù)連接訪問(wèn)數(shù)據(jù)庫(kù),在Spring中,數(shù)據(jù)連接是通過(guò)數(shù)據(jù)源獲得的。在以往的應(yīng)用中,數(shù)據(jù)源一般是 Web應(yīng)用服務(wù)器提供的。在Spring中,你不但可以通過(guò)JNDI獲取應(yīng)用服務(wù)器的數(shù)據(jù)源,也可以直接在Spring容器中配置數(shù)據(jù)源,此外,你還可以通過(guò)代碼的方式創(chuàng)建一個(gè)數(shù)據(jù)源,以便進(jìn)行無(wú)依賴的單元測(cè)試 配置一個(gè)數(shù)據(jù)源 Spring在第三方依賴包中包含了兩個(gè)數(shù)據(jù)源的實(shí)現(xiàn)類包,其一是Apache的DBCP,其二是 C3P0??梢栽赟pring配置文件中利用這兩者中任何一個(gè)配置數(shù)據(jù)源。 DBCP數(shù)據(jù)源 DBCP類包位于 /lib/jakarta-commons/commons-dbcp.jar,DBCP是一個(gè)依賴 Jakarta commons-pool對(duì)象池機(jī)制的數(shù)據(jù)庫(kù)連接池,所以在類路徑下還必須包括/lib/jakarta- commons/commons-pool.jar。下面是使用DBCP配置MySql數(shù)據(jù)源的配置片斷: 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()方法關(guān)閉數(shù)據(jù)源,所以必須設(shè)定destroy-method=”close”屬性,以便Spring容器關(guān)閉時(shí),數(shù)據(jù)源能夠正常關(guān)閉。除以上必須的數(shù)據(jù)源屬性外,還有一些常用的屬性: defaultAutoCommit:設(shè)置從數(shù)據(jù)源中返回的連接是否采用自動(dòng)提交機(jī)制,默認(rèn)值為 true; defaultReadOnly:設(shè)置數(shù)據(jù)源是否僅能執(zhí)行只讀操作, 默認(rèn)值為 false; maxActive:最大連接數(shù)據(jù)庫(kù)連接數(shù),設(shè)置為0時(shí),表示沒(méi)有限制; maxIdle:最大等待連接中的數(shù)量,設(shè)置為0時(shí),表示沒(méi)有限制; maxWait:最大等待秒數(shù),單位為毫秒, 超過(guò)時(shí)間會(huì)報(bào)出錯(cuò)誤信息; validationQuery:用于驗(yàn)證連接是否成功的查詢SQL語(yǔ)句,SQL語(yǔ)句必須至少要返回一行數(shù)據(jù),如你可以簡(jiǎn)單地設(shè)置為:“select count(*) from user”; removeAbandoned:是否自我中斷,默認(rèn)是 false ; removeAbandonedTimeout:幾秒后數(shù)據(jù)連接會(huì)自動(dòng)斷開(kāi),在removeAbandoned為true,提供該值; logAbandoned:是否記錄中斷事件, 默認(rèn)為 false; C3P0數(shù)據(jù)源 C3P0是一個(gè)開(kāi)放源代碼的JDBC數(shù)據(jù)源實(shí)現(xiàn)項(xiàng)目,它在lib目錄中與Hibernate一起發(fā)布,實(shí)現(xiàn)了JDBC3和JDBC2擴(kuò)展規(guī)范說(shuō)明的 Connection 和Statement 池。C3P0類包位于/lib/c3p0/c3p0-0.9.0.4.jar。下面是使用C3P0配置一個(gè) Oracle數(shù)據(jù)源: 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一樣提供了一個(gè)用于關(guān)閉數(shù)據(jù)源的close()方法,這樣我們就可以保證Spring容器關(guān)閉時(shí)數(shù)據(jù)源能夠成功釋放。 C3P0擁有比DBCP更豐富的配置屬性,通過(guò)這些屬性,可以對(duì)數(shù)據(jù)源進(jìn)行各種有效的控制: acquireIncrement:當(dāng)連接池中的連接用完時(shí),C3P0一次性創(chuàng)建新連接的數(shù)目; acquireRetryAttempts:定義在從數(shù)據(jù)庫(kù)獲取新連接失敗后重復(fù)嘗試獲取的次數(shù),默認(rèn)為30; acquireRetryDelay:兩次連接中間隔時(shí)間,單位毫秒,默認(rèn)為1000; autoCommitOnClose:連接關(guān)閉時(shí)默認(rèn)將所有未提交的操作回滾。默認(rèn)為false; automaticTestTable: C3P0將建一張名為T(mén)est的空表,并使用其自帶的查詢語(yǔ)句進(jìn)行測(cè)試。如果定義了這個(gè)參數(shù),那么屬性preferredTestQuery將被忽略。你不能在這張Test表上進(jìn)行任何操作,它將中為C3P0測(cè)試所用,默認(rèn)為null; breakAfterAcquireFailure:獲取連接失敗將會(huì)引起所有等待獲取連接的線程拋出異常。但是數(shù)據(jù)源仍有效保留,并在下次調(diào) 用getConnection()的時(shí)候繼續(xù)嘗試獲取連接。如果設(shè)為true,那么在嘗試獲取連接失敗后該數(shù)據(jù)源將申明已斷開(kāi)并永久關(guān)閉。默認(rèn)為 false; checkoutTimeout:當(dāng)連接池用完時(shí)客戶端調(diào)用getConnection()后等待獲取新連接的時(shí)間,超時(shí)后將拋出SQLException,如設(shè)為0則無(wú)限期等待。單位毫秒,默認(rèn)為0; connectionTesterClassName:通過(guò)實(shí)現(xiàn)ConnectionTester或QueryConnectionTester的類來(lái)測(cè)試連接,類名需設(shè)置為全限定名。默認(rèn)為 com.mchange.v2.C3P0.impl.DefaultConnectionTester; idleConnectionTestPeriod:隔多少秒檢查所有連接池中的空閑連接,默認(rèn)為0表示不檢查; initialPoolSize:初始化時(shí)創(chuàng)建的連接數(shù),應(yīng)在minPoolSize與maxPoolSize之間取值。默認(rèn)為3; maxIdleTime:最大空閑時(shí)間,超過(guò)空閑時(shí)間的連接將被丟棄。為0或負(fù)數(shù)則永不丟棄。默認(rèn)為0; maxPoolSize:連接池中保留的最大連接數(shù)。默認(rèn)為15; maxStatements:JDBC的標(biāo)準(zhǔn)參數(shù),用以控制數(shù)據(jù)源內(nèi)加載的PreparedStatement數(shù)量。但由于預(yù)緩存的Statement屬于單個(gè)Connection而不是整個(gè)連接池。所以設(shè)置這個(gè)參數(shù)需要考慮到多方面的因素,如果maxStatements與 maxStatementsPerConnection均為0,則緩存被關(guān)閉。默認(rèn)為0; maxStatementsPerConnection:連接池內(nèi)單個(gè)連接所擁有的最大緩存Statement數(shù)。默認(rèn)為0; numHelperThreads:C3P0是異步操作的,緩慢的JDBC操作通過(guò)幫助進(jìn)程完成。擴(kuò)展這些操作可以有效的提升性能,通過(guò)多線程實(shí)現(xiàn)多個(gè)操作同時(shí)被執(zhí)行。默認(rèn)為3; preferredTestQuery:定義所有連接測(cè)試都執(zhí)行的測(cè)試語(yǔ)句。在使用連接測(cè)試的情況下這個(gè)參數(shù)能顯著提高測(cè)試速度。測(cè)試的表必須在初始數(shù)據(jù)源的時(shí)候就存在。默認(rèn)為null; propertyCycle: 用戶修改系統(tǒng)配置參數(shù)執(zhí)行前最多等待的秒數(shù)。默認(rèn)為300; testConnectionOnCheckout:因性能消耗大請(qǐng)只在需要的時(shí)候使用它。如果設(shè)為true那么在每個(gè)connection提交的時(shí)候都將校驗(yàn)其有效性。建議使用idleConnectionTestPeriod或automaticTestTable 等方法來(lái)提升連接測(cè)試的性能。默認(rèn)為false; testConnectionOnCheckin:如果設(shè)為true那么在取得連接的同時(shí)將校驗(yàn)連接的有效性。默認(rèn)為false。 讀配置文件的方式引用屬性: <bean id="propertyConfigurer" > <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 提示經(jīng)常有開(kāi)發(fā)者在${xxx}的前后不小心鍵入一些空格,這些空格字符將和變量合并后作為屬性的值。如:的屬性配置項(xiàng),在前后都有空格,被解析后,username的值為“ 1234 ”,這將造成最終的錯(cuò)誤,因此需要特別小心。 獲取JNDI數(shù)據(jù)源 如果應(yīng)用配置在高性能的應(yīng)用服務(wù)器(如WebLogic或Websphere等)上,我們可能更希望使用應(yīng)用服務(wù)器本身提供的數(shù)據(jù)源。應(yīng)用服務(wù)器的數(shù)據(jù)源使用JNDI開(kāi)放調(diào)用者使用,Spring為此專門(mén)提供引用JNDI資源的JndiObjectFactoryBean類。下面是一個(gè)簡(jiǎn)單的配置: xml 代碼 <bean id="dataSource" class="org.springframework.jndi.JndiObjectFactoryBean"> <property name="jndiName" value="java:comp/env/jdbc/bbt"/> </bean> 通過(guò)jndiName指定引用的JNDI數(shù)據(jù)源名稱。 Spring 2.0為獲取J2EE資源提供了一個(gè)jee命名空間,通過(guò)jee命名空間,可以有效地簡(jiǎn)化J2EE資源的引用。下面是使用jee命名空間引用JNDI數(shù)據(jù)源的配置: xml 代碼 <beans xmlns=http://www./schema/beans xmlns:xsi=http://www./2001/XMLSchema-instance xmlns:jee=http://www./schema/jee xsi:schemaLocation="http://www./schema/beans http://www./schema/beans/spring-beans-2.0.xsd http://www./schema/jee http://www./schema/jee/spring-jee-2.0.xsd"> <jee:jndi-lookup id="dataSource" jndi-name=" java:comp/env/jdbc/bbt"/> </beans> Spring的數(shù)據(jù)源實(shí)現(xiàn)類 Spring本身也提供了一個(gè)簡(jiǎn)單的數(shù)據(jù)源實(shí)現(xiàn)類DriverManagerDataSource ,它位于org.springframework.jdbc.datasource包中。這個(gè)類實(shí)現(xiàn)了javax.sql.DataSource接口,但它并沒(méi)有提供池化連接的機(jī)制,每次調(diào)用getConnection()獲取新連接時(shí),只是簡(jiǎn)單地創(chuàng)建一個(gè)新的連接。因此,這個(gè)數(shù)據(jù)源類比較適合在單元測(cè)試或簡(jiǎn)單的獨(dú)立應(yīng)用中使用,因?yàn)樗恍枰~外的依賴類。 下面,我們來(lái)看一下DriverManagerDataSource的簡(jiǎn)單使用:當(dāng)然,我們也可以通過(guò)配置的方式直接使用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(); 小結(jié) 不管采用何種持久化技術(shù),都需要定義數(shù)據(jù)源。Spring附帶了兩個(gè)數(shù)據(jù)源的實(shí)現(xiàn)類包,你可以自行選擇進(jìn)行定義。在實(shí)際部署時(shí),我們可能會(huì)直接采用應(yīng)用服務(wù)器本身提供的數(shù)據(jù)源,這時(shí),則可以通過(guò)JndiObjectFactoryBean或jee命名空間引用JNDI中的數(shù)據(jù)源。 DBCP與C3PO配置的區(qū)別: 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> dbcp配置中文版本 翻譯自apache 官方文檔,原文請(qǐng)見(jiàn)http://commons./dbcp/configuration.html。
參數(shù)描述username傳遞給JDBC驅(qū)動(dòng)的用于建立連接的用戶名password傳遞給JDBC驅(qū)動(dòng)的用于建立連接的密碼url傳遞給JDBC驅(qū)動(dòng)的用于建立連接的URLdriverClassName使用的JDBC驅(qū)動(dòng)的完整有效的java 類名connectionProperties當(dāng)建立新連接時(shí)被發(fā)送給JDBC驅(qū)動(dòng)的連接參數(shù),格式必須是 [propertyName=property;]* 注意:參數(shù)user/password將被明確傳遞,所以不需要包括在這里。
參數(shù)默認(rèn)值描述defaultAutoCommittrue連接池創(chuàng)建的連接的默認(rèn)的auto-commit狀態(tài)defaultReadOnlydriver default連接池創(chuàng)建的連接的默認(rèn)的read-only狀態(tài). 如果沒(méi)有設(shè)置則setReadOnly方法將不會(huì)被調(diào)用. (某些驅(qū)動(dòng)不支持只讀模式,比如:Informix) defaultTransactionIsolationdriver default連接池創(chuàng)建的連接的默認(rèn)的TransactionIsolation狀態(tài). 下面列表當(dāng)中的某一個(gè): (參考javadoc)
NONE
READ_COMMITTED
READ_UNCOMMITTED
REPEATABLE_READ
SERIALIZABLE defaultCatalog 連接池創(chuàng)建的連接的默認(rèn)的catalog
參數(shù)默認(rèn)值描述initialSize0初始化連接:連接池啟動(dòng)時(shí)創(chuàng)建的初始化連接數(shù)量,1.2版本后支持 maxActive8最大活動(dòng)連接:連接池在同一時(shí)間能夠分配的最大活動(dòng)連接的數(shù)量, 如果設(shè)置為非正數(shù)則表示不限制 maxIdle8最大空閑連接:連接池中容許保持空閑狀態(tài)的最大連接數(shù)量,超過(guò)的空閑連接將被釋放,如果設(shè)置為負(fù)數(shù)表示不限制 minIdle0最小空閑連接:連接池中容許保持空閑狀態(tài)的最小連接數(shù)量,低于這個(gè)數(shù)量將創(chuàng)建新的連接,如果設(shè)置為0則不創(chuàng)建 maxWait無(wú)限最大等待時(shí)間:當(dāng)沒(méi)有可用連接時(shí),連接池等待連接被歸還的最大時(shí)間(以毫秒計(jì)數(shù)),超過(guò)時(shí)間則拋出異常,如果設(shè)置為-1表示無(wú)限等待
參數(shù)默認(rèn)值描述validationQuery SQL查詢,用來(lái)驗(yàn)證從連接池取出的連接,在將連接返回給調(diào)用者之前.如果指定,則查詢必須是一個(gè)SQL SELECT并且必須返回至少一行記錄 testOnBorrowtrue指明是否在從池中取出連接前進(jìn)行檢驗(yàn),如果檢驗(yàn)失敗,則從池中去除連接并嘗試取出另一個(gè). 注意: 設(shè)置為true后如果要生效,validationQuery參數(shù)必須設(shè)置為非空字符串 testOnReturnfalse指明是否在歸還到池中前進(jìn)行檢驗(yàn) 注意: 設(shè)置為true后如果要生效,validationQuery參數(shù)必須設(shè)置為非空字符串 testWhileIdlefalse指明連接是否被空閑連接回收器(如果有)進(jìn)行檢驗(yàn).如果檢測(cè)失敗,則連接將被從池中去除. 注意: 設(shè)置為true后如果要生效,validationQuery參數(shù)必須設(shè)置為非空字符串 timeBetweenEvictionRunsMillis-1在空閑連接回收器線程運(yùn)行期間休眠的時(shí)間值,以毫秒為單位. 如果設(shè)置為非正數(shù),則不運(yùn)行空閑連接回收器線程 numTestsPerEvictionRun3在每次空閑連接回收器線程(如果有)運(yùn)行時(shí)檢查的連接數(shù)量 minEvictableIdleTimeMillis1000 * 60 * 30連接在池中保持空閑而不被空閑連接回收器線程(如果有)回收的最小時(shí)間值,單位毫秒
參數(shù)默認(rèn)值描述poolPreparedStatementsfalse開(kāi)啟池的prepared statement 池功能maxOpenPreparedStatements不限制statement池能夠同時(shí)分配的打開(kāi)的statements的最大數(shù)量, 如果設(shè)置為0表示不限制 這里可以開(kāi)啟PreparedStatements池. 當(dāng)開(kāi)啟時(shí), 將為每個(gè)連接創(chuàng)建一個(gè)statement池,并且被下面方法創(chuàng)建的PreparedStatements將被緩存起來(lái): * public PreparedStatement prepareStatement(String sql) * public PreparedStatement prepareStatement(String sql, int resultSetType, int resultSetConcurrency) 注意: 確認(rèn)連接還有剩余資源可以留給其他statement
參數(shù)默認(rèn)值描述accessToUnderlyingConnectionAllowedfalse控制PoolGuard是否容許獲取底層連接 如果容許則可以使用下面的方式來(lái)獲取底層連接: Connection conn = ds.getConnection(); Connection dconn = ((DelegatingConnection) conn).getInnermostDelegate(); ... conn.close();
默認(rèn)false不開(kāi)啟, 這是一個(gè)有潛在危險(xiǎn)的功能, 不適當(dāng)?shù)木幋a會(huì)造成傷害.(關(guān)閉底層連接或者在守護(hù)連接已經(jīng)關(guān)閉的情況下繼續(xù)使用它).請(qǐng)謹(jǐn)慎使用,并且僅當(dāng)需要直接訪問(wèn)驅(qū)動(dòng)的特定功能時(shí)使用. 注意: 不要關(guān)閉底層連接, 只能關(guān)閉前面的那個(gè).
參數(shù)默認(rèn)值描述removeAbandonedfalse標(biāo)記是否刪除泄露的連接,如果他們超過(guò)了removeAbandonedTimout的限制.如果設(shè)置為true, 連接被認(rèn)為是被泄露并且可以被刪除,如果空閑時(shí)間超過(guò)removeAbandonedTimeout. 設(shè)置為true可以為寫(xiě)法糟糕的沒(méi)有關(guān)閉連接的程序修復(fù)數(shù)據(jù)庫(kù)連接. removeAbandonedTimeout300泄露的連接可以被刪除的超時(shí)值, 單位秒logAbandonedfalse標(biāo)記當(dāng)Statement或連接被泄露時(shí)是否打印程序的stack traces日志。被泄露的Statements和連接的日志添加在每個(gè)連接打開(kāi)或者生成新的Statement,因?yàn)樾枰蓅tack trace。 如果開(kāi)啟"removeAbandoned",那么連接在被認(rèn)為泄露時(shí)可能被池回收. 這個(gè)機(jī)制在(getNumIdle() < 2) and (getNumActive() > getMaxActive() - 3)時(shí)被觸發(fā). 舉例當(dāng)maxActive=20, 活動(dòng)連接為18,空閑連接為1時(shí)可以觸發(fā)"removeAbandoned".但是活動(dòng)連接只有在沒(méi)有被使用的時(shí)間超過(guò)"removeAbandonedTimeout"時(shí)才被刪除,默認(rèn)300秒.在resultset中游歷不被計(jì)算為被使用.
|