c3p0 数据库连接池配置详细总结

不念不忘少年蓝@ 2022-04-04 19:10 281阅读 0赞

### 前言 ###

关于 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：和数据库用户名对应的数据库密码

#### 基础的参数配置 ####

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

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

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

#### 配置连接测试 ####

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

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

automaticTestTable、connectionTesterClassName 和 perferedTestQuery 控制连接将怎么样被检测

#### 配置语句池 ####

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

#### 配置数据库的中断恢复 ####

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

#### 配置未解决的事务处理 ####

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

#### 其他数据源配置 ####

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