DBCP|C3P0参数详解
1.<!-- 數(shù)據(jù)源1 -->
2. <bean id="dataSource"
3. class="org.apache.commons.dbcp.BasicDataSource"
4. destroy-method="close">
5. <property name="driverClassName" value="com.mysql.jdbc.Driver"/>
6. <property name="url" value="jdbc:mysql://192.168.0.109:3306/test? useUnicode=true&characterEncoding=UTF-8"/>
7. <property name="username" value="root"/>
8. <property name="password" value="root"/>
9. <!--maxActive: 最大連接數(shù)量-->
10. <property name="maxActive" value="150"/>
11. <!--minIdle: 最小空閑連接-->
12. <property name="minIdle" value="5"/>
13. <!--maxIdle: 最大空閑連接-->
14. <property name="maxIdle" value="20"/>
15. <!--initialSize: 初始化連接-->
16. <property name="initialSize" value="30"/>
17. <!-- 連接被泄露時(shí)是否打印 -->
18. <property name="logAbandoned" value="true"/>
19. <!--removeAbandoned: 是否自動(dòng)回收超時(shí)連接-->
20. <property name="removeAbandoned" value="true"/>
21. <!--removeAbandonedTimeout: 超時(shí)時(shí)間(以秒數(shù)為單位)-->
22. <property name="removeAbandonedTimeout" value="10"/>
23. <!--maxWait: 超時(shí)等待時(shí)間以毫秒為單位-->
24. <property name="maxWait" value="1000"/>
25. <!-- 在空閑連接回收器線程運(yùn)行期間休眠的時(shí)間值,以毫秒為單位. -->
26. <property name="timeBetweenEvictionRunsMillis" value="10000"/>
27. <!-- 在每次空閑連接回收器線程(如果有)運(yùn)行時(shí)檢查的連接數(shù)量 -->
28. <property name="numTestsPerEvictionRun" value="10"/>
29. <!-- 1000 * 60 * 30 連接在池中保持空閑而不被空閑連接回收器線程-->
30. <property name="minEvictableIdleTimeMillis" value="10000"/>
31. <property name="validationQuery" value="SELECT NOW() FROM DUAL"/>
32. </bean>
?
參數(shù) 描述
username 傳遞給JDBC驅(qū)動(dòng)的用于建立連接的用戶名
password 傳遞給JDBC驅(qū)動(dòng)的用于建立連接的密碼
url 傳遞給JDBC驅(qū)動(dòng)的用于建立連接的URL
driverClassName 使用的JDBC驅(qū)動(dòng)的完整有效的java 類名
connectionProperties 當(dāng)建立新連接時(shí)被發(fā)送給JDBC驅(qū)動(dòng)的連接參數(shù)，
格式必須是 [propertyName=property;]*
注意 ：參數(shù)user/password將被明確傳遞，所以不需要包括在這里。
參數(shù) 默認(rèn)值 描述
defaultAutoCommit true 連接池創(chuàng)建的連接的默認(rèn)的auto-commit狀態(tài)
defaultReadOnly driver default 連接池創(chuàng)建的連接的默認(rèn)的read-only狀態(tài).
如果沒(méi)有設(shè)置則setReadOnly方法將不會(huì)被調(diào)用. (某些驅(qū)動(dòng)不支持只讀模式,比如:Informix)
defaultTransactionIsolation driver 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)值 描述
initialSize 0 初始化連接:連接池啟動(dòng)時(shí)創(chuàng)建的初始化連接數(shù)量,1.2版本后支持
maxActive 8 最大活動(dòng)連接:連接池在同一時(shí)間能夠分配的最大活動(dòng)連接的數(shù)量,
如果設(shè)置為非正數(shù)則表示不限制
maxIdle 8 最大空閑連接:連接池中容許保持空閑狀態(tài)的最大連接數(shù)量,超過(guò)的空閑連接將被釋放,
如果設(shè)置為負(fù)數(shù)表示不限制
minIdle 0 最小空閑連接:連接池中容許保持空閑狀態(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并且必須返回至少一行記錄
testOnBorrow true 指明是否在從池中取出連接前進(jìn)行檢驗(yàn),如果檢驗(yàn)失敗,
則從池中去除連接并嘗試取出另一個(gè).
注意: 設(shè)置為true后如果要生效,validationQuery參數(shù)必須設(shè)置為非空字符串
testOnReturn false 指明是否在歸還到池中前進(jìn)行檢驗(yàn)
注意: 設(shè)置為true后如果要生效,validationQuery參數(shù)必須設(shè)置為非空字符串
testWhileIdle false 指明連接是否被空閑連接回收器(如果有)進(jìn)行檢驗(yàn).如果檢測(cè)失敗,
則連接將被從池中去除.
注意: 設(shè)置為true后如果要生效,validationQuery參數(shù)必須設(shè)置為非空字符串
timeBetweenEvictionRunsMillis -1 在空閑連接回收器線程運(yùn)行期間休眠的時(shí)間值,以毫秒為單位.
如果設(shè)置為非正數(shù),則不運(yùn)行空閑連接回收器線程
numTestsPerEvictionRun 3 在每次空閑連接回收器線程(如果有)運(yùn)行時(shí)檢查的連接數(shù)量
minEvictableIdleTimeMillis 1000 * 60 * 30 連接在池中保持空閑而不被空閑連接回收器線程
(如果有)回收的最小時(shí)間值，單位毫秒
參數(shù) 默認(rèn)值 描述
poolPreparedStatements false 開(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)值 描述
accessToUnderlyingConnectionAllowed false 控制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)值 描述
removeAbandoned false 標(biāo)記是否刪除泄露的連接,如果他們超過(guò)了removeAbandonedTimout的限制.
如果設(shè)置為true, 連接被認(rèn)為是被泄露并且可以被刪除,如果空閑時(shí)間超過(guò)removeAbandonedTimeout.
設(shè)置為true可以為寫法糟糕的沒(méi)有關(guān)閉連接的程序修復(fù)數(shù)據(jù)庫(kù)連接.
removeAbandonedTimeout 300 泄露的連接可以被刪除的超時(shí)值, 單位秒
logAbandoned false 標(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ì)算為被使用.
?
?
<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的空表，并使用其自帶的查詢語(yǔ)句進(jìn)行測(cè)試。如果定義了這個(gè)參數(shù)那么
屬性preferredTestQuery將被忽略。你不能在這張Test表上進(jìn)行任何操作，它將只供c3p0測(cè)試
使用。Default: null-->
<property name="automaticTestTable">Test</property>
<!--獲取連接失敗將會(huì)引起所有等待連接池來(lái)獲取連接的線程拋出異常。但是數(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í)客戶端調(diào)用getConnection()后等待獲取新連接的時(shí)間，超時(shí)后將拋出
SQLException,如設(shè)為0則無(wú)限期等待。單位毫秒。Default: 0 -->
<property name="checkoutTimeout">100</property>
<!--通過(guò)實(shí)現(xiàn)ConnectionTester或QueryConnectionTester的類來(lái)測(cè)試連接。類名需制定全路徑。
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ò)多線程實(shí)現(xiàn)多個(gè)操作同時(shí)被執(zhí)行。Default: 3-->
<property name="numHelperThreads">3</property>
<!--當(dāng)用戶調(diào)用getConnection()時(shí)使root用戶成為去獲取連接的用戶。主要用于連接池連接非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>
<!--用戶修改系統(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>
<!--用戶名。Default: null-->
<property name="user">root</property>
<!--早期的c3p0版本對(duì)JDBC接口采用動(dòng)態(tài)反射代理。在早期版本用途廣泛的情況下這個(gè)參數(shù)
允許用戶恢復(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>
?
轉(zhuǎn)載于:https://www.cnblogs.com/core404/p/5785968.html
總結(jié)
以上是生活随笔為你收集整理的DBCP|C3P0参数详解的全部?jī)?nèi)容，希望文章能夠幫你解決所遇到的問(wèn)題。
- 上一篇： 算法十——深度优先搜索和广度优先搜索
- 下一篇： 数据结构九——栈