1. Apache-DBCP
Ø BasicDataSource 相關(guān)的參數(shù)說(shuō)明
- dataSource: 要連接的 datasource (通常我們不會(huì)定義在
server.xml)
- defaultAutoCommit: 對(duì)于事務(wù)是否 autoCommit, 默認(rèn)值為
true
- defaultReadOnly: 對(duì)于數(shù)據(jù)庫(kù)是否只能讀取, 默認(rèn)值為 false
- driverClassName:連接數(shù)據(jù)庫(kù)所用的 JDBC Driver
Class,
- maxActive: 可以從對(duì)象池中取出的對(duì)象最大個(gè)數(shù),為0則表示沒(méi)有限制,默認(rèn)為8
- maxIdle: 最大等待連接中的數(shù)量,設(shè) 0 為沒(méi)有限制
(對(duì)象池中對(duì)象最大個(gè)數(shù))
- minIdle:對(duì)象池中對(duì)象最小個(gè)數(shù)
- maxWait: 最大等待秒數(shù), 單位為 ms, 超過(guò)時(shí)間會(huì)丟出錯(cuò)誤信息
- password: 登陸數(shù)據(jù)庫(kù)所用的密碼
- url: 連接數(shù)據(jù)庫(kù)的 URL
- username: 登陸數(shù)據(jù)庫(kù)所用的帳號(hào)
- validationQuery: 驗(yàn)證連接是否成功, SQL SELECT
指令至少要返回一行
- removeAbandoned: 是否自我中斷, 默認(rèn)是 false
- removeAbandonedTimeout: 幾秒后會(huì)自我中斷,
removeAbandoned 必須為 true
- logAbandoned: 是否記錄中斷事件, 默認(rèn)為 false
- minEvictableIdleTimeMillis:大于0 ,進(jìn)行連接空閑時(shí)間判斷,或?yàn)?font face="Times New Roman">0,對(duì)空閑的連接不進(jìn)行驗(yàn)證;默認(rèn)30分鐘
-
timeBetweenEvictionRunsMillis:失效檢查線(xiàn)程運(yùn)行時(shí)間間隔,如果小于等于0,不會(huì)啟動(dòng)檢查線(xiàn)程,默認(rèn)-1
-
testOnBorrow:取得對(duì)象時(shí)是否進(jìn)行驗(yàn)證,檢查對(duì)象是否有效,默認(rèn)為false
-
testOnReturn:返回對(duì)象時(shí)是否進(jìn)行驗(yàn)證,檢查對(duì)象是否有效,默認(rèn)為false
-
testWhileIdle:空閑時(shí)是否進(jìn)行驗(yàn)證,檢查對(duì)象是否有效,默認(rèn)為false
Ø 在使用DBCP的時(shí)候,如果使用默認(rèn)值,則數(shù)據(jù)庫(kù)連接因?yàn)槟撤N原因斷掉后,再?gòu)倪B接池中取得連接又不進(jìn)行驗(yàn)證,這時(shí)取得的連接實(shí)際上就會(huì)是無(wú)效的數(shù)據(jù)庫(kù)連接。因此為了防止獲得的數(shù)據(jù)庫(kù)連接失效,在使用的時(shí)候最好保證:
- username: 登陸數(shù)據(jù)庫(kù)所用的帳號(hào)
- validationQuery:SELECT COUNT(*) FROM DUAL
- testOnBorrow、testOnReturn、testWhileIdle:最好都設(shè)為true
- minEvictableIdleTimeMillis:大于0
,進(jìn)行連接空閑時(shí)間判斷,或?yàn)?font face="Times New Roman">0,對(duì)空閑的連接不進(jìn)行驗(yàn)證
- timeBetweenEvictionRunsMillis:失效檢查線(xiàn)程運(yùn)行時(shí)間間隔,如果小于等于0,不會(huì)啟動(dòng)檢查線(xiàn)程
Ø PS:在構(gòu)造GenericObjectPool
[BasicDataSource在其createDataSource ()
方法中也會(huì)使用GenericObjectPool]
時(shí),會(huì)生成一個(gè)內(nèi)嵌類(lèi)Evictor,實(shí)現(xiàn)自Runnable接口。如果timeBetweenEvictionRunsMillis大于0,每過(guò)timeBetweenEvictionRunsMillis毫秒Evictor會(huì)調(diào)用evict()方法,檢查對(duì)象的閑置時(shí)間是否大于
minEvictableIdleTimeMillis毫秒(_minEvictableIdleTimeMillis小于等于0時(shí)則忽略,默認(rèn)為30分鐘),是則銷(xiāo)毀此對(duì)象,否則就激活并校驗(yàn)對(duì)象,然后調(diào)用ensureMinIdle方法檢查確保池中對(duì)象個(gè)數(shù)不小于_minIdle。在調(diào)用returnObject方法把對(duì)象放回對(duì)象池,首先檢查該對(duì)象是否有效,然后調(diào)用PoolableObjectFactory
的passivateObject方法使對(duì)象處于非活動(dòng)狀態(tài)。再檢查對(duì)象池中對(duì)象個(gè)數(shù)是否小于maxIdle,是則可以把此對(duì)象放回對(duì)象池,否則銷(xiāo)毀此對(duì)象
Ø 上述特性的可設(shè)置性已在代碼中驗(yàn)證,具體性能是否能實(shí)現(xiàn)有待實(shí)際驗(yàn)證
2. C3P0
Ø C3P0的官方example中使用的數(shù)據(jù)源為ComboPooledDataSource,網(wǎng)上一篇文章詳細(xì)介紹了C3P0連接池配置中各項(xiàng)含義[這些配置項(xiàng)的含義在下載解壓c3p0的壓縮包之后目錄的doc\index.html中的Configuration部分也有詳細(xì)的介紹,這里偷下懶:P],現(xiàn)摘錄如下:
<c3p0-config>
<default-config>
<!--當(dāng)連接池中的連接耗盡的時(shí)候c3p0一次同時(shí)獲取的連接數(shù)。Default: 3 -->
<property
name="acquireIncrement">3</property>
<!--定義在從數(shù)據(jù)庫(kù)獲取新連接失敗后重復(fù)嘗試的次數(shù)。Default: 30
-->
<property
name="acquireRetryAttempts">30</property>
<!--兩次連接中間隔時(shí)間,單位毫秒。Default:
1000 -->
<property
name="acquireRetryDelay">1000</property>
<!--連接關(guān)閉時(shí)默認(rèn)將所有未提交的操作回滾。Default: false
-->
<property
name="autoCommitOnClose">false</property>
<!--c3p0將建一張名為Test的空表,并使用其自帶的查詢(xún)語(yǔ)句進(jìn)行測(cè)試。如果定義了這個(gè)參數(shù)那么
屬性preferredTestQuery將被忽略。你不能在這張Test表上進(jìn)行任何操作,它將只供c3p0測(cè)試
使用。Default: null-->
<property
name="automaticTestTable">Test</property>
<!--獲取連接失敗將會(huì)引起所有等待連接池來(lái)獲取連接的線(xiàn)程拋出異常。但是數(shù)據(jù)源仍有效
保留,并在下次調(diào)用getConnection()的時(shí)候繼續(xù)嘗試獲取連接。如果設(shè)為true,那么在嘗試
獲取連接失敗后該數(shù)據(jù)源將申明已斷開(kāi)并永久關(guān)閉。Default:
false-->
<property
name="breakAfterAcquireFailure">false</property>
<!--當(dāng)連接池用完時(shí)客戶(hù)端調(diào)用getConnection()后等待獲取新連接的時(shí)間,超時(shí)后將拋出
SQLException,如設(shè)為0則無(wú)限期等待。單位毫秒。Default: 0 -->
<property
name="checkoutTimeout">100</property>
<!--通過(guò)實(shí)現(xiàn)ConnectionTester或QueryConnectionTester的類(lèi)來(lái)測(cè)試連接。類(lèi)名需制定全路徑。
Default:
com.mchange.v2.c3p0.impl.DefaultConnectionTester-->
<property
name="connectionTesterClassName"></property>
<!--指定c3p0
libraries的路徑,如果(通常都是這樣)在本地即可獲得那么無(wú)需設(shè)置,默認(rèn)null即可
Default: null-->
<property
name="factoryClassLocation">null</property>
<!--Strongly disrecommended. Setting this to true
may lead to subtle and bizarre bugs.
(文檔原文)作者強(qiáng)烈建議不使用的一個(gè)屬性-->
<property
name="forceIgnoreUnresolvedTransactions">false</property>
<!--每60秒檢查所有連接池中的空閑連接。Default: 0 -->
<property
name="idleConnectionTestPeriod">60</property>
<!--初始化時(shí)獲取三個(gè)連接,取值應(yīng)在minPoolSize與maxPoolSize之間。Default: 3
-->
<property
name="initialPoolSize">3</property>
<!--最大空閑時(shí)間,60秒內(nèi)未使用則連接被丟棄。若為0則永不丟棄。Default: 0
-->
<property
name="maxIdleTime">60</property>
<!--連接池中保留的最大連接數(shù)。Default: 15
-->
<property
name="maxPoolSize">15</property>
<!--JDBC的標(biāo)準(zhǔn)參數(shù),用以控制數(shù)據(jù)源內(nèi)加載的PreparedStatements數(shù)量。但由于預(yù)緩存的statements
屬于單個(gè)connection而不是整個(gè)連接池。所以設(shè)置這個(gè)參數(shù)需要考慮到多方面的因素。
如果maxStatements與maxStatementsPerConnection均為0,則緩存被關(guān)閉。Default:
0-->
<property
name="maxStatements">100</property>
<!--maxStatementsPerConnection定義了連接池內(nèi)單個(gè)連接所擁有的最大緩存statements數(shù)。Default: 0 -->
<property
name="maxStatementsPerConnection"></property>
<!--c3p0是異步操作的,緩慢的JDBC操作通過(guò)幫助進(jìn)程完成。擴(kuò)展這些操作可以有效的提升性能
通過(guò)多線(xiàn)程實(shí)現(xiàn)多個(gè)操作同時(shí)被執(zhí)行。Default:
3-->
<property
name="numHelperThreads">3</property>
<!--當(dāng)用戶(hù)調(diào)用getConnection()時(shí)使root用戶(hù)成為去獲取連接的用戶(hù)。主要用于連接池連接非c3p0
的數(shù)據(jù)源時(shí)。Default: null-->
<property
name="overrideDefaultUser">root</property>
<!--與overrideDefaultUser參數(shù)對(duì)應(yīng)使用的一個(gè)參數(shù)。Default: null-->
<property
name="overrideDefaultPassword">password</property>
<!--密碼。Default:
null-->
<property
name="password"></property>
<!--定義所有連接測(cè)試都執(zhí)行的測(cè)試語(yǔ)句。在使用連接測(cè)試的情況下這個(gè)一顯著提高測(cè)試速度。注意:
測(cè)試的表必須在初始數(shù)據(jù)源的時(shí)候就存在。Default:
null-->
<property
name="preferredTestQuery">select id from test where
id=1</property>
<!--用戶(hù)修改系統(tǒng)配置參數(shù)執(zhí)行前最多等待300秒。Default:
300 -->
<property
name="propertyCycle">300</property>
<!--因性能消耗大請(qǐng)只在需要的時(shí)候使用它。如果設(shè)為true那么在每個(gè)connection提交的
時(shí)候都將校驗(yàn)其有效性。建議使用idleConnectionTestPeriod或automaticTestTable
等方法來(lái)提升連接測(cè)試的性能。Default: false
-->
<property
name="testConnectionOnCheckout">false</property>
<!--如果設(shè)為true那么在取得連接的同時(shí)將校驗(yàn)連接的有效性。Default: false
-->
<property
name="testConnectionOnCheckin">true</property>
<!--用戶(hù)名。Default:
null-->
<property
name="user">root</property>
<!--早期的c3p0版本對(duì)JDBC接口采用動(dòng)態(tài)反射代理。在早期版本用途廣泛的情況下這個(gè)參數(shù)
允許用戶(hù)恢復(fù)到動(dòng)態(tài)反射代理以解決不穩(wěn)定的故障。最新的非反射代理更快并且已經(jīng)開(kāi)始
廣泛的被使用,所以這個(gè)參數(shù)未必有用。現(xiàn)在原先的動(dòng)態(tài)反射與新的非反射代理同時(shí)受到
支持,但今后可能的版本可能不支持動(dòng)態(tài)反射代理。Default:
false-->
<property
name="usesTraditionalReflectiveProxies">false</property>
<property
name="automaticTestTable">con_test</property>
<property
name="checkoutTimeout">30000</property>
<property
name="idleConnectionTestPeriod">30</property>
<property
name="initialPoolSize">10</property>
<property
name="maxIdleTime">30</property>
<property
name="maxPoolSize">25</property>
<property
name="minPoolSize">10</property>
<property
name="maxStatements">0</property>
<user-overrides
user="swaldman">
</user-overrides>
</default-config>
<named-config
name="dumbTestConfig">
<property
name="maxStatements">200</property>
<user-overrides user="poop">
<property
name="maxStatements">300</property>
</user-overrides>
</named-config>
</c3p0-config>
Ø 上述特性的可設(shè)置性已在代碼中驗(yàn)證,具體性能是否能實(shí)現(xiàn)有待實(shí)際驗(yàn)證
Ø 從配置項(xiàng)的內(nèi)容來(lái)看,C3P0和DBCP都有比較詳細(xì)的有關(guān)連接檢測(cè)保證的配置,我們可以看到C3P0可以控制數(shù)據(jù)源內(nèi)加載的PreparedStatements數(shù)量,并且可以設(shè)置幫助線(xiàn)程的數(shù)量來(lái)提升JDBC操作的速度,這些是DBCP未提供的;另外從網(wǎng)絡(luò)上的評(píng)價(jià)來(lái)看,DBCP出現(xiàn)Bug的頻率要大于C3P0,不過(guò)這一點(diǎn)有待于我們自己實(shí)際的檢測(cè)。
3. Proxool
Ø Proxool的使用和dbcp以及c3p0稍有不同,我們需要并且只需要在使用基本的java.sql.DriverManager之前加載org.logicalcobwebs.proxool.ProxoolDriver驅(qū)動(dòng)類(lèi),并且按照proxool定義的url格式
["proxool." + alias + ":" +
driverClass + ":" + driverUrl
,其中alias是為連接池自定義的別名]
來(lái)獲得connection;具體的可以參看proxool
doc下的UserGuide,或本文所附的示例代碼。下面對(duì)連接池的特性配置作詳細(xì)說(shuō)明
[這個(gè)是自己翻譯的,不一定準(zhǔn)確,有問(wèn)題時(shí)請(qǐng)參看doc下的Properties
~]。
n fatal-sql-exception
以逗號(hào)隔開(kāi)的異常列表,當(dāng)設(shè)置了此項(xiàng)之后,每當(dāng)出現(xiàn)SQLException時(shí)都將與列表中異常項(xiàng)作比較,如果匹配則認(rèn)為出現(xiàn)fatal異常,這將導(dǎo)致connection被丟棄,并且不論出現(xiàn)任何情況該異常將被重拋一次以通知用戶(hù)發(fā)生的情況。默認(rèn)值為null
n fatal-sql-exception-wrapper-class
如果配置了fatal-sql-exception,則默認(rèn)的操作是丟
棄引起SQLException的原因而只是拋出原始異常。使用fatal-sql-exception-wrapper-class這個(gè)特性可以將
SQLException包裝到繼承SQLException或RunTimeException的任何異常類(lèi)里。Proxool提供了兩個(gè)類(lèi)供使用
FatalSQLException和FatalRunTimeException;使用這兩個(gè)類(lèi)的話(huà)就將該選項(xiàng)設(shè)置為
'org.logicalcobwebs.proxool.FatalSQLException'或者
'org.logicalcobwebs.proxool.FatalRuntimeException'。默認(rèn)值為null
n house-keeping-sleep-time
proxool自動(dòng)偵察各個(gè)連接狀態(tài)的時(shí)間間隔(毫秒),偵察到空閑的連接就馬上回收,超時(shí)的銷(xiāo)毀,默認(rèn)值為30秒
n house-keeping-test-sql
如果偵察線(xiàn)程發(fā)現(xiàn)閑置連接,則會(huì)使用這個(gè)SQL語(yǔ)句來(lái)對(duì)這些連接進(jìn)行檢查;這項(xiàng)設(shè)置的語(yǔ)句應(yīng)該能夠被很快的執(zhí)行,例如查詢(xún)當(dāng)前時(shí)間
[info.setProperty("proxool.house-keeping-test-sql", "select
CURRENT_DATE");] 。如果不設(shè)置則該選項(xiàng)被忽略
n
injectable-connection-interface、injectable-statement-interface、injectable-prepared-statement-interface、injectable-callable-statement-interface
n jmx
如果此項(xiàng)設(shè)為true,則連接池將被以名稱(chēng)"Proxool:type=Pool,
name=<alias>"注冊(cè)為JMS
Server的MBean。默認(rèn)值為false
n jmx-agent-id
當(dāng)且僅當(dāng)jmx選項(xiàng)設(shè)為true時(shí)使用,為以逗號(hào)分隔的連接持注冊(cè)到的JMS代理名稱(chēng)列表;如果不設(shè)置則所有注冊(cè)的JMX
Server都將被使用
n maximum-active-time
線(xiàn)程最大存活時(shí)間,超過(guò)此時(shí)間的線(xiàn)程將被守護(hù)線(xiàn)程kill掉,默認(rèn)值為5分鐘
n maximum-connection-count
到數(shù)據(jù)庫(kù)的最大連接數(shù),超過(guò)了這個(gè)連接,再有請(qǐng)求時(shí),就排在隊(duì)列中等候,最大的等待請(qǐng)求數(shù)由simultaneous-build-throttle決定;默認(rèn)值為15
n maximum-connection-lifetime
連接最大存活時(shí)間,毫秒為單位,默認(rèn)值為4小時(shí)
n minimum-connection-count
不管是否被使用都保持開(kāi)放的最小連接數(shù),默認(rèn)值為5
n overload-without-refusal-lifetime
用來(lái)判斷連接池狀態(tài),如果在此選項(xiàng)設(shè)置時(shí)間內(nèi)(毫秒為單位)拒絕了連接,則認(rèn)為過(guò)負(fù)載。默認(rèn)值為60秒
n prototype-count
最少保持的空閑連接數(shù),注意與minimum-connection-count區(qū)分。默認(rèn)值為0
n simultaneous-build-throttle
最大的等待請(qǐng)求數(shù),默認(rèn)值為10
n test-before-use
如果設(shè)為true則connection在使用前將以house-keeping-test-sql設(shè)置的語(yǔ)句測(cè)試,如果測(cè)試不通過(guò)則該connection被丟棄并會(huì)重新分配一個(gè)connection。默認(rèn)為false
n test-after-use
如果設(shè)為true則connection在關(guān)閉(放回連接池)前將以house-keeping-test-sql設(shè)置的語(yǔ)句測(cè)試,如果測(cè)試不通過(guò)connection將被丟棄。默認(rèn)值為false
Ø 與其它連接池特性的設(shè)置方法不同,Proxool不提供相應(yīng)的set方法,所有特性都要以諸如info.setProperty("proxool.jmx",
"false");方式設(shè)定
Ø 上述特性的可設(shè)置性已在代碼中驗(yàn)證,具體性能是否能實(shí)現(xiàn)有待實(shí)際驗(yàn)證