C3P0的详细配置说明（com.mchange.v2.c3p0.ComboPooledDataSource）

Java代码  

1. [size=large]  
2. C3P0是一个开放源代码的JDBC连接池，它在lib目录中与Hibernate一起发布,包括了实现jdbc3和jdbc2扩展规范说明的Connection 和Statement 池的DataSources 对象。  
3.   
4. 　　c3p0-config>   
5.   
6. 　　<default-config>   
7.   
8. 　　<!--当连接池中的连接耗尽的时候c3p0一次同时获取的连接数。Default: 3 -->   
9.   
10. 　　<property name="acquireIncrement">3</property>   
11.   
12. 　　<!--定义在从数据库获取新连接失败后重复尝试的次数。Default: 30 -->   
13.   
14. 　　<property name="acquireRetryAttempts">30</property>   
15.   
16. 　　<!--两次连接中间隔时间，单位毫秒。Default: 1000 -->   
17.   
18. 　　<property name="acquireRetryDelay">1000</property>   
19.   
20. 　　<!--连接关闭时默认将所有未提交的操作回滚。Default: false -->   
21.   
22. 　　<property name="autoCommitOnClose">false</property>   
23.   
24. 　　<!--c3p0将建一张名为Test的空表，并使用其自带的查询语句进行测试。如果定义了这个参数那么   
25.   
26. 　　属性preferredTestQuery将被忽略。你不能在这张Test表上进行任何操作，它将只供c3p0测试   
27.   
28. 　　使用。Default: null-->   
29.   
30. 　　<property name="automaticTestTable">Test</property>   
31.   
32. 　　<!--获取连接失败将会引起所有等待连接池来获取连接的线程抛出异常。但是数据源仍有效   
33.   
34. 　　保留，并在下次调用getConnection()的时候继续尝试获取连接。如果设为true，那么在尝试   
35.   
36. 　　获取连接失败后该数据源将申明已断开并永久关闭。Default: false-->   
37.   
38. 　　<property name="breakAfterAcquireFailure">false</property>   
39.   
40. 　　<!--当连接池用完时客户端调用getConnection()后等待获取新连接的时间，超时后将抛出   
41.   
42. 　　SQLException,如设为0则无限期等待。单位毫秒。Default: 0 -->   
43.   
44. 　　<property name="checkoutTimeout">100</property>   
45.   
46. 　　<!--通过实现ConnectionTester或QueryConnectionTester的类来测试连接。类名需制定全路径。   
47.   
48. 　　Default: com.mchange.v2.c3p0.impl.DefaultConnectionTester-->   
49.   
50. 　　<property name="connectionTesterClassName"></property>   
51.   
52. 　　<!--指定c3p0 libraries的路径，如果（通常都是这样）在本地即可获得那么无需设置，默认null即可   
53.   
54. 　　Default: null-->   
55.   
56. 　　<property name="factoryClassLocation">null</property>   
57.   
58. 　　<!--Strongly disrecommended. Setting this to true may lead to subtle and bizarre bugs.   
59.   
60. 　　（文档原文）作者强烈建议不使用的一个属性-->   
61.   
62. 　　<property name="forceIgnoreUnresolvedTransactions">false</property>   
63.   
64. 　　<!--每60秒检查所有连接池中的空闲连接。Default: 0 -->   
65.   
66. 　　<property name="idleConnectionTestPeriod">60</property>   
67.   
68. 　　<!--初始化时获取三个连接，取值应在minPoolSize与maxPoolSize之间。Default: 3 -->   
69.   
70. 　　<property name="initialPoolSize">3</property>   
71.   
72. 　　<!--最大空闲时间,60秒内未使用则连接被丢弃。若为0则永不丢弃。Default: 0 -->   
73.   
74. 　　<property name="maxIdleTime">60</property>   
75.   
76. 　　<!--连接池中保留的最大连接数。Default: 15 -->   
77.   
78. 　　<property name="maxPoolSize">15</property>   
79.   
80. 　　<!--JDBC的标准参数，用以控制数据源内加载的PreparedStatements数量。但由于预缓存的statements   
81.   
82. 　　属于单个connection而不是整个连接池。所以设置这个参数需要考虑到多方面的因素。   
83.   
84. 　　如果maxStatements与maxStatementsPerConnection均为0，则缓存被关闭。Default: 0-->   
85.   
86. 　　<property name="maxStatements">100</property>   
87.   
88. 　　<!--maxStatementsPerConnection定义了连接池内单个连接所拥有的最大缓存statements数。Default: 0 -->   
89.   
90. 　　<property name="maxStatementsPerConnection"></property>   
91.   
92. 　　<!--c3p0是异步操作的，缓慢的JDBC操作通过帮助进程完成。扩展这些操作可以有效的提升性能   
93.   
94. 　　通过多线程实现多个操作同时被执行。Default: 3-->   
95.   
96. 　　<property name="numHelperThreads">3</property>   
97.   
98. 　　<!--当用户调用getConnection()时使root用户成为去获取连接的用户。主要用于连接池连接非c3p0   
99.   
100. 　　的数据源时。Default: null-->   
101.   
102. 　　<property name="overrideDefaultUser">root</property>   
103.   
104. 　　<!--与overrideDefaultUser参数对应使用的一个参数。Default: null-->   
105.   
106. 　　<property name="overrideDefaultPassword">password</property>   
107.   
108. 　　<!--密码。Default: null-->   
109.   
110. 　　<property name="password"></property>   
111.   
112. 　　<!--定义所有连接测试都执行的测试语句。在使用连接测试的情况下这个一显著提高测试速度。注意：   
113.   
114. 　　测试的表必须在初始数据源的时候就存在。Default: null-->   
115.   
116. 　　<property name="preferredTestQuery">select id from test where id=1</property>   
117.   
118. 　　<!--用户修改系统配置参数执行前最多等待300秒。Default: 300 -->   
119.   
120. 　　<property name="propertyCycle">300</property>   
121.   
122. 　　<!--因性能消耗大请只在需要的时候使用它。如果设为true那么在每个connection提交的   
123.   
124. 　　时候都将校验其有效性。建议使用idleConnectionTestPeriod或automaticTestTable   
125.   
126. 　　等方法来提升连接测试的性能。Default: false -->   
127.   
128. 　　<property name="testConnectionOnCheckout">false</property>   
129.   
130. 　　<!--如果设为true那么在取得连接的同时将校验连接的有效性。Default: false -->   
131.   
132. 　　<property name="testConnectionOnCheckin">true</property>   
133.   
134. 　　<!--用户名。Default: null-->   
135.   
136. 　　<property name="user">root</property>   
137.   
138. 　　在Hibernate（spring管理）中的配置：   
139.   
140. 　　<bean id="dataSource" class="com.mchange.v2.c3p0.ComboPooledDataSource" destroy-method="close">   
141.   
142. 　　<property name="driverClass"><value>oracle.jdbc.driver.OracleDriver</value></property>   
143.   
144. 　　<property name="jdbcUrl"><value>jdbc:oracle:thin:@localhost:1521:Test</value></property>   
145.   
146. 　　<property name="user"><value>Kay</value></property>   
147.   
148. 　　<property name="password"><value>root</value></property>   
149.   
150. 　　<!--连接池中保留的最小连接数。-->   
151.   
152. 　　<property name="minPoolSize" value="10" />   
153.   
154. 　　<!--连接池中保留的最大连接数。Default: 15 -->   
155.   
156. 　　<property name="maxPoolSize" value="100" />   
157.   
158. 　　<!--最大空闲时间,1800秒内未使用则连接被丢弃。若为0则永不丢弃。Default: 0 -->   
159.   
160. 　　<property name="maxIdleTime" value="1800" />   
161.   
162. 　　<!--当连接池中的连接耗尽的时候c3p0一次同时获取的连接数。Default: 3 -->   
163.   
164. 　　<property name="acquireIncrement" value="3" />   
165.   
166. 　　<property name="maxStatements" value="1000" />   
167.   
168. 　　<property name="initialPoolSize" value="10" />   
169.   
170. 　　<!--每60秒检查所有连接池中的空闲连接。Default: 0 -->   
171.   
172. 　　<property name="idleConnectionTestPeriod" value="60" />   
173.   
174. 　　<!--定义在从数据库获取新连接失败后重复尝试的次数。Default: 30 -->   
175.   
176. 　　<property name="acquireRetryAttempts" value="30" />   
177.   
178. 　　<property name="breakAfterAcquireFailure" value="true" />   
179.   
180. 　　<property name="testConnectionOnCheckout" value="false" />   
181.   
182. 　　</bean>  
183.   
184. 　　###########################  
185.   
186. 　　### C3P0 Connection Pool###  
187.   
188. 　　###########################  
189.   
190. 　　#hibernate.c3p0.max_size 2  
191.   
192. 　　#hibernate.c3p0.min_size 2  
193.   
194. 　　#hibernate.c3p0.timeout 5000  
195.   
196. 　　#hibernate.c3p0.max_statements 100  
197.   
198. 　　#hibernate.c3p0.idle_test_period 3000  
199.   
200. 　　#hibernate.c3p0.acquire_increment 2  
201.   
202. 　　#hibernate.c3p0.validate false  
203.   
204. 　　在hibernate.cfg.xml文件里面加入如下的配置：  
205.   
206. 　　<!-- 最大连接数 -->  
207.   
208. 　　<property name="hibernate.c3p0.max_size">20</property>  
209.   
210. 　　<!-- 最小连接数 -->  
211.   
212. 　　<property name="hibernate.c3p0.min_size">5</property>  
213.   
214. 　　<!-- 获得连接的超时时间,如果超过这个时间,会抛出异常，单位毫秒 -->  
215.   
216. 　　<property name="hibernate.c3p0.timeout">120</property>  
217.   
218. 　　<!-- 最大的PreparedStatement的数量 -->  
219.   
220. 　　<property name="hibernate.c3p0.max_statements">100</property>  
221.   
222. 　　<!-- 每隔120秒检查连接池里的空闲连接 ，单位是秒-->  
223.   
224. 　　<property name="hibernate.c3p0.idle_test_period">120</property>  
225.   
226. 　　<!-- 当连接池里面的连接用完的时候，C3P0一下获取的新的连接数 -->  
227.   
228. 　　<property name="hibernate.c3p0.acquire_increment">2</property>  
229.   
230. 　　<!-- 每次都验证连接是否可用 -->  
231.   
232. 　　<property name="hibernate.c3p0.validate">true</property>  
233. [/size]