jdbc Template 介紹和 spring 連結資料來源的四種方式
<?xml version="1.0" encoding="UTF-8"?> <beans xmlns="http://www.springframework.org/schema/beans" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:aop="http://www.springframework.org/schema/aop" xmlns:context="http://www.springframework.org/schema/context" xmlns:tx="http://www.springframework.org/schema/tx"xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-2.5.xsd http://www.springframework.org/schema/aop http://www.springframework.org/schema/aop/spring-aop-2.5.xsd http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-2.5.xsd http://www.springframework.org/schema/tx http://www.springframework.org/schema/tx/spring-tx-2.5.xsd"> <bean id="dataSource" class="org.springframework.jdbc.datasource.DriverManagerDataSource"> <property name="driverClassName"> <value>oracle.jdbc.driver.OracleDriver</value> </property> <property name="url"> <value>jdbc:oracle:thin:@192.168.24.102:1521:sms</value> </property> <property name="username"> <value>test</value> </property> <property name="password"> <value>test</value> </property> </bean> </beans>
Spring本身提供了一個簡單的資料來源實現類DriverManagerDataSource ,它位於org.springframework.jdbc.datasource包中。這個類實現了javax.sql.DataSource介面,但
它並沒有提供池化連線的機制,每次呼叫getConnection()獲取新連線時,只是簡單地建立一個新的連線。因此,這個資料來源類比較適合在單元測試 或簡單的獨立應用中使用,因為它不需要額外的依賴類。
下面,我們來看一下DriverManagerDataSource的簡單使用:當然,我們也可以通過上面配置的方式直接使用DriverManagerDataSource。
DriverManagerDataSource ds = new DriverManagerDataSource (); ds.setDriverClassName("com.mysql.jdbc.Driver"); ds.setUrl("jdbc:oracle:thin:@192.168.24.102:1521:sms"); ds.setUsername("test"); ds.setPassword("test"); Connection actualCon = ds.getConnection();
第二種:DBCP資料來源
Spring在第三方依賴包中包含了兩個資料來源的實現類包,其一是Apache的DBCP,其二是 C3P0。可以在Spring配置檔案中利用這兩者中任何一個配置資料來源。
DBCP類包位於<spring_home/>/lib/jakarta-commons/commons-dbcp.jar,DBCP是一個依賴Jakarta commons-pool物件池機制的資料庫連線池,所以在類路徑下還必須包括<spring_home/>/lib/jakarta- commons/commons-pool.jar。另外還需要個commons-collections.jar包項,它是目組中的一個各種集合類和集合工具類的封裝,類似C++中的Boost庫,是對Java容器型別和演算法的補充,為Java標準的Collections API提供了相當好的補充和拓展。
下面是使用DBCP配置MySql資料來源的配置片斷:
<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/>/lib/c3p0/c3p0-0.9.0.4.jar。下面是使用C3P0配置一個 Oracle資料來源:
<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 ”,這將造成最終的錯誤,因此需要特別小心。
第四種:JNDI資料來源
如果應用配置在高效能的應用伺服器(如WebLogic或Websphere等)上,我們可能更希望使用應用伺服器本身提供的資料來源。應用伺服器的資料來源 使用JNDI開放呼叫者使用,Spring為此專門提供引用JNDI資源的JndiObjectFactoryBean類。下面是一個簡單的配置例子:
<bean id="TerasolunaSampleDataSource" class="org.springframework.jndi.JndiObjectFactoryBean"> <property name="jndiName"> <!-- Tomcatの例 --> <value>java:comp/env/jdbc/TerasolunaSampleDataSource</value> <!-- <value>jdbc/TerasolunaSampleDataSource</value> --> </property> </bean>
通過jndiName指定引用的JNDI資料來源名稱。
Spring 2.0為獲取J2EE資源提供了一個jee名稱空間,通過jee名稱空間,可以有效地簡化J2EE資源的引用。下面是使用jee名稱空間引用JNDI資料來源的配置:
<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/TerasolunaSampleDataSource"/> </beans>
附在<ContextRoot>/META-INF/context.xml的DataSource連結情報:
<Context> <Resource name="jdbc/TerasolunaSampleDataSource" type="javax.sql.DataSource" driverClassName="org.postgresql.Driver" username="togodb" password="togo" url="jdbc:postgresql://127.0.0.1:5432/method_db" maxIdle="2" maxWait="5000" maxActive="4"/> </Context>