c3p0常用配置参数介绍

c3p0常用配置参数介绍

最基础的参数配置：

driverClass : 数据库驱动（比如mysql，或者oracle数据库的驱动）
jdbcUrl: jdbc数据库连接地址（例如jdbc:mysql://localhost:3306/zhanghanlun）
user：数据库用户名
password:和数据库用户名对应的数据库密码

基础的参数配置

参数	默认值	解释
initialPoolSize	3	连接池初始化时创建的连接数（介于maxPoolSize和minPoolSize之间）
maxPoolSize	15	连接池中拥有的最大连接数，如果获得新连接时会使连接总数超过这个值则不会再获取新连接，而是等待其他连接释放，所以这个值有可能会设计地很大
minPoolSize	3	连接池保持的最小连接数，后面的maxIdleTimeExcessConnections跟这个配合使用来减轻连接池的负载
acquireIncrement	3	连接池在无空闲连接可用时一次性创建的新数据库连接数

管理池大小和连接时间的配置

参数	默认值	解释
maxIdleTime	0	连接的最大空闲时间，如果超过这个时间，某个数据库连接还没有被使用，则会断开掉这个连接如果为0，则永远不会断开连接
maxConnectorAge	0	连接的最大绝对年龄，单位是秒，0表示绝对年龄无限大
maxIdleTimeExcessConnection	0	单位秒，为了减轻连接池的负载，当连接池经过数据访问高峰创建了很多连接，但是后面连接池不需要维护这么多连接，必须小于maxIdleTime.配置不为0，则将连接池的数量保持到minPoolSize

配置连接测试

参数	默认值	解释
automaticTestTable	null	如果不为null，c3p0将生成指定名称的空表，使用该表来测试连接
connectionTesterClassName	com.mchange.v2.c3p0.impl.DefaultConnectionTester	-通过实现ConnectionTester或QueryConnectionTester的类来测试连接。类名需制定全路径。
idleConnectionTestPeriod	0	每个几秒检查所有连接池中的空闲连接
preferredTestQuery	null	定义所有连接测试都执行的测试语句。在使用连接测试的情况下这个一显著提高测试速度。注意： 测试的表必须在初始数据源的时候就存在
testConnectionOnCheckin	false	如果设为true那么在取得连接的同时将校验连接的有效性
testConnectionOnCheckout	false	如果为true，在连接释放的同事将校验连接的有效性。

在这几个参数中，idleConnectionTestPeriod、testConnectionOnCheckout和testConnectuonOnCheckin控制什么时候连接将被校验检测。automaticTestTable、connectionTesterClassName和perferedTestQuery控制连接将怎么样被检测。

配置语句池

参数	默认值	解释
maxStatements	0	JDBC的标准参数，用以控制数据源内加载d的PreparedStatements数量
maxStatementsPerConnection	0	maxStatementsPerConnection定义了连接池内单个连接所拥有的最大缓存statements数
statementCacheNumDeferredCloseThreads	0	如果大于零，则语句池将延迟物理close()缓存语句直到其父连接未被任何客户端使用，或者在其内部（例如在测试中）由池本身使用。

配置数据库的中断恢复

参数	默认值	解释
acquireRetryAttempts	30	定义在从数据库获取新连接失败后重复尝试的次数
acquireRetryDelay	1000	两次连接间隔时间，单位毫秒
breakAfterAcquireFailure	false	获取连接失败将会引起所有等待连接池来获取连接的线程抛出异常。但是数据源仍有效 保留，并在下次调用getConnection()的时候继续尝试获取连接。如果设为true，那么在尝试 获取连接失败后该数据源将申明已断开并永久关闭

配置未解决的事务处理

参数	默认值	解释
autoCommitOnClose	false	连接关闭时默认将所有未提交的操作回滚。如果为true，则未提交设置为待提交而不是回滚。
forceIgnoreUnresolvedTransactions	false	官方文档建议这个不要设置为true

其他数据源配置

参数	默认值	解释
checkoutTimeout	0	当连接池用完时客户端调用getConnection()后等待获取新连接的时间，超时后将抛出SQLException,如设为0则无限期等待。单位毫秒。
factoryClassLocation	0	指定c3p0 libraries的路径，如果（通常都是这样）在本地即可获得那么无需设置，默认null即可
numHelperThreads	3	c3p0是异步操作的，缓慢的JDBC操作通过帮助进程完成。扩展这些操作可以有效的提升性能通过多线程实现多个操作同时被执行