- C3P0是一个开源的JDBC连接池,它实现了数据源和JNDI绑定,支持JDBC3规范和JDBC2的标准扩展
- dbcp没有自动回收空闲连接的功能,c3p0有自动回收空闲连接功能,C3P0拥有比DBCP更丰富的配置属性,通过这些属性,可以对数据源进行各种有效的控制:
属性 |
描述 |
分类 |
driverClass |
数据库驱动名称 |
必须项 |
jdbcUrl |
数据库地址 |
必须项 |
user |
用户名 |
必须项 |
password |
密码 |
必须项 |
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 |
基本项(扩展) |
factoryClassLocation |
定c3p0 libraries的路径,如果(通常都是这样)在本地即可获得那么无需设置,默认null即可 |
基本项(扩展) |
forceIgnoreUnresolvedTransactions |
强制忽略未解决事务,不建议使用 |
基本项(扩展) |
overrideDefaultUser |
当用户调用getConnection()时使root用户成为去获取连接的用户。主要用于连接池连接非c3p0的数据源时。Default: null |
基本项(扩展) |
overrideDefaultPassword |
与overrideDefaultUser参数对应使用的一个参数。Default: null |
基本项(扩展) |
usesTraditionalReflectiveProxies |
早期的c3p0版本对JDBC接口采用动态反射代理。在早期版本用途广泛的情况下这个参数允许用户恢复到动态反射代理以解决不稳定的故障。最新的非反射代理更快并且已经开始广泛的被使用,所以这个参数未必有用。现在原先的动态反射与新的非反射代理同时受到支持,但今后可能的版本可能不支持动态反射代理。Default: false |
基本项(扩展) |
- 如果是c3p0-0.9.1.2版本,加入一个jar即可c3p0-0.9.1.2.jar
如果是c3p0-0.9.2之后的版本,需要加入两个jar:c3p0-0.9.X.jar和mchange-commons-java-XX.jar
- 导入ComboPooledDataSource相关依赖:
<dependency> <groupId>c3p0</groupId> <artifactId>c3p0</artifactId> <version>0.9.1.2</version> </dependency>
|
- ComboPooledDataSource和BasicDataSource一样提供了一个用于关闭数据源的close()方法,这样我们就可以保证Spring容器关闭时数据源能够成功释放。
示例
<bean id="dataSource" class="com.mchange.v2.c3p0.ComboPooledDataSource" destroy-method="close"> <property name="driverClass" value="${jdbc_driver}" /> <property name="jdbcUrl" value="${jdbc_url}" /> <property name="user" value=""${jdbc_username}" /> <property name="password" value="${jdbc_password}" /> </bean> |