前言

关于 c3p0 一般有这么两种配置,一种是通过 set 方法进行配置,另一种是通过在同 src 目录下的 c3p0-conflg.xml 文件或者 c3p0.properties 文件进行相关的配置。

一、c3p0 通过 set 方法进行配置

源码:

private static ComboPooledDataSource dataSource = new ComboPooledDataSource();
    /**
     * 配置 DataSource
     */
    public static void configDataSource(){
        try {
            dataSource.setDriverClass("com.mysql.jdbc.Driver");
            dataSource.setJdbcUrl("jdbc:mysql://localhost:3306/XiaoPengwei");
            dataSource.setUser("XiaoPengwei");
            dataSource.setPassword("123456");
            dataSource.setInitialPoolSize(3);
            dataSource.setMaxPoolSize(10);
            dataSource.setMinPoolSize(3);
            dataSource.setAcquireIncrement(3);
        } catch (PropertyVetoException e) {
            e.printStackTrace();
        }
    }
    /**
     * 获取 Connection 连接
     * @return
     */
    public static Connection getConnection(){
        Connection conn = null;
        try {

            conn = dataSource.getConnection();
        } catch (SQLException e) {
            e.printStackTrace();
        }
        return conn;
    }

二、c3p0 通过 c3p0-config.xml 文件进行配置

关于通过配置文件进行配置

  • 需要把 xml 文件方法同 src 文件夹下,c3p0 会扫描文件进行相关的配置
  • 在Maven依赖中要加入 c3p0 和 mysql-connector-java 依赖,版本号一定要写。

c3p0-config.xml 文件的代码:

<?xml version="1.0" encoding="UTF-8"?>
<c3p0-config>
    <!-- 默认配置先不用管,如果没有指定则使用这个配置 -->
    <default-config>
        <property name="user">zhanghanlun</property>
        <property name="password">123456</property>
        <property name="jdbcUrl">jdbc:mysql://localhost:3306/zhanghanlun</property>
        <property name="driverClass">com.mysql.jdbc.Driver</property>
        <property name="checkoutTimeout">30000</property>
        <property name="idleConnectionTestPeriod">30</property>
        <property name="initialPoolSize">3</property>
        <property name="maxIdleTime">30</property>
        <property name="maxPoolSize">100</property>
        <property name="minPoolSize">2</property>
        <property name="maxStatements">200</property>
    </default-config>
    
    <!-- 自定义命名的配置,可以通过方法调用实现 -->
    <named-config name="test">
        <property name="user">Xiaopengwei</property>
        <property name="password">123456</property>
        <property name="jdbcUrl">jdbc:mysql://localhost:3306/Xiaopengwei</property>
        <property name="driverClass">com.mysql.jdbc.Driver</property>
        <!-- 如果池中数据连接不够时一次增长多少个 -->
        <property name="acquireIncrement">5</property>
        <!-- 初始化数据库连接池时连接的数量 -->
        <property name="initialPoolSize">20</property>
        <!-- 数据库连接池中的最大的数据库连接数 -->
        <property name="maxPoolSize">25</property>
        <!-- 数据库连接池中的最小的数据库连接数 -->
        <property name="minPoolSize">5</property>
    </named-config>
</c3p0-config>

java 类中代码对应如下:

//加载名字为“test”的配置文件
    private static ComboPooledDataSource dataSource = new ComboPooledDataSource("test");
    /**
     * 获取Connection连接
     * @return
     */
    public static Connection getConnection(){
        Connection conn = null;
        try {
            conn = dataSource.getConnection();
        } catch (SQLException e) {
            e.printStackTrace();
        }
        return conn;
    }

这种方式会使 java 代码简洁很多,通常使用配置文件来创建数据库的连接池

c3p0 常用配置参数介绍

在前面的 c3p0 的相关配置中,我们看到了 c3p0 的配置参数,这里我们介绍几个常用的 c3p0 的配置参数
最基础的参数配置:

  1. driverClass : 数据库驱动(例如 mysql,或者 oracle 数据库的驱动)
  2. jdbcUrl: jdbc数据库连接地址
    (例如jdbc:mysql://localhost:3306/Xiaopengwei)
  3. user:数据库用户名
  4. 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操作通过帮助进程完成。扩展这些操作可以有效的提升性能通过多线程实现多个操作同时被执行