数据库连接池c3p0常用配置说明及使用

Posted 2021-04-06 Cay课堂

数据库连接池c3p0常用配置说明及使用

1.最常用配置

driverClass:

    数据库驱动类（必须）

jdbcUrl：

    数据库url（必须）

user：

    数据库连接名（必须）

password：

    数据库连接密码（必须）

initialPoolSize:
    连接池初始化时创建的连接数,default : 3（建议使用）
 

minPoolSize:
    连接池保持的最小连接数,default : 3（建议使用）
 

maxPoolSize:
    连接池中拥有的最大连接数，如果获得新连接时会使连接总数超过这个值则不会再获取新连接，而是等待其他连接释放，所以这个值有可能会设计地很大,default : 15（建议使用）
 

acquireIncrement:
    连接池在无空闲连接可用时一次性创建的新数据库连接数,default : 3（建议使用）

 

2.管理连接池的大小和连接的生存时间

maxConnectionAge:
    配置连接的生存时间，超过这个时间的连接将由连接池自动断开丢弃掉。当然正在使用的连接不会马上断开，而是等待它close再断开。配置为0的时候则不会对连接的生存时间进行限制。default : 0 单位 s（不建议使用）
 

maxIdleTime:
    连接的最大空闲时间，如果超过这个时间，某个数据库连接还没有被使用，则会断开掉这个连接。如果为0，则永远不会断开连接,即回收此连接。default : 0 单位 s（建议使用）
 

maxIdleTimeExcessConnections:
    这个配置主要是为了快速减轻连接池的负载，比如连接池中连接数因为某次数据访问高峰导致创建了很多数据连接，但是后面的时间段需要的数据库连接数很少，需要快速释放，必须小于maxIdleTime。其实这个没必要配置，maxIdleTime已经配置了。default : 0 单位 s（不建议使用）

 

3.配置连接测试：

automaticTestTable:
    配置一个表名，连接池根据这个表名用自己的测试sql语句在这个空表上测试数据库连接,这个表只能由c3p0来使用，用户不能操作。default : null（不建议使用）
 

preferredTestQuery:
    与上面的automaticTestTable二者只能选一。自己实现一条SQL检测语句。default : null（建议使用）
 

idleConnectionTestPeriod:
    用来配置测试空闲连接的间隔时间。测试方式还是上面的两种之一，可以用来解决mysql8小时断开连接的问题。因为它保证连接池会每隔一定时间对空闲连接进行一次测试，从而保证有效的空闲连接能每隔一定时间访问一次数据库，将于MySQL8小时无会话的状态打破。为0则不测试。default : 0(建议使用)
 

testConnectionOnCheckin:
    如果为true，则在close的时候测试连接的有效性。default : false（不建议使用）
 

testConnectionOnCheckout:
    性能消耗大。如果为true，在每次getConnection的时候都会测试，为了提高性能,尽量不要用。default : false（不建议使用）

 

4.配置PreparedStatement缓存：

maxStatements:
    连接池为数据源缓存的PreparedStatement的总数。由于PreparedStatement属于单个Connection,所以这个数量应该根据应用中平均连接数乘以每个连接的平均PreparedStatement来计算。同时maxStatementsPerConnection的配置无效。default : 0（不建议使用）
 

maxStatementsPerConnection:
    连接池为数据源单个Connection缓存的PreparedStatement数，这个配置比maxStatements更有意义，因为它缓存的服务对象是单个数据连接，如果设置的好，肯定是可以提高性能的。为0的时候不缓存。default : 0（看情况而论）

 

5.重连相关配置 

acquireRetryAttempts:
    连接池在获得新连接失败时重试的次数，如果小于等于0则无限重试直至连接获得成功。default : 30（建议使用）
 

acquireRetryDelay:
    连接池在获得新连接时的间隔时间。default : 1000 单位ms（建议使用）
 

breakAfterAcquireFailure:
    如果为true，则当连接获取失败时自动关闭数据源，除非重新启动应用程序。所以一般不用。default : false（不建议使用）
 

checkoutTimeout:
    配置当连接池所有连接用完时应用程序getConnection的等待时间。为0则无限等待直至有其他连接释放或者创建新的连接，不为0则当时间到的时候如果仍没有获得连接，则会抛出SQLException。其实就是acquireRetryAttempts*acquireRetryDelay。default : 0（与上面两个，有重复，选择其中两个都行）

 

6.定制管理Connection的生命周期

connectionCustomizerClassName:
    用来定制Connection的管理，比如在Connection acquire 的时候设定Connection的隔离级别，或者在Connection丢弃的时候进行资源关闭，就可以通过继承一个AbstractConnectionCustomizer来实现相关方法，配置的时候使用全类名。有点类似监听器的作用。default : null（不建议使用）

 

7.配置未提交的事务处理 

autoCommitOnClose:
    连接池在回收数据库连接时是否自动提交事务。如果为false，则会回滚未提交的事务，如果为true，则会自动提交事务。default : false（不建议使用）
 

forceIgnoreUnresolvedTransactions:
    这个配置强烈不建议为true。default : false（不建议使用）一般来说事务当然由自己关闭了，为什么要让连接池来处理这种不细心问题呢？

 

8.配置debug和回收Connection

unreturnedConnectionTimeout:
    为0的时候要求所有的Connection在应用程序中必须关闭。如果不为0，则强制在设定的时间到达后回收Connection，所以必须小心设置，保证在回收之前所有数据库操作都能够完成。这种限制减少Connection未关闭情况的不是很适用。建议手动关闭。default : 0 单位 s（不建议使用）
 

debugUnreturnedConnectionStackTraces:

    如果为true并且unreturnedConnectionTimeout设为大于0的值，当所有被getConnection出去的连接unreturnedConnectionTimeout时间到的时候，就会打印出堆栈信息。只能在debug模式下适用，因为打印堆栈信息会减慢getConnection的速度default : false（不建议使用）

<c3p0-config>
    <default-config>
        <!-- 数据库驱动名 --> 
        <property name="driverClass" ></properties>

        <!-- 数据库的url --> 
        <property name="jdbcUrl" ></properties> 

        <!--当连接池中的连接耗尽的时候c3p0一次同时获取的连接数。Default: 3 -->
        <property name="acquireIncrement">3</property>

        <!--定义在从数据库获取新连接失败后重复尝试的次数。Default: 30 -->
        <property name="acquireRetryAttempts">30</property>

        <!--两次连接中间隔时间，单位毫秒。Default: 1000 -->
        <property name="acquireRetryDelay">1000</property>

        <!--连接关闭时默认将所有未提交的操作回滚。Default: false -->
        <property name="autoCommitOnClose">false</property>

        <!--c3p0将建一张名为Test的空表，并使用其自带的查询语句进行测试。如果定义了这个参数那么 属性preferredTestQuery将被忽略。你不能在这张Test表上进行任何操作，它将只供c3p0测试 
        使用。Default: null -->
        <property name="automaticTestTable"></property>

        <!--获取连接失败将会引起所有等待连接池来获取连接的线程抛出异常。但是数据源仍有效 保留，并在下次调用getConnection()的时候继续尝试获取连接。如果设为true，那么在尝试 
        获取连接失败后该数据源将申明已断开并永久关闭。Default: false -->
        <property name="breakAfterAcquireFailure">false</property>

        <!--当连接池用完时客户端调用getConnection()后等待获取新连接的时间，超时后将抛出 SQLException,如设为0则无限期等待。单位毫秒。Default: 0 -->
        <property name="checkoutTimeout">0</property>

        <!--通过实现ConnectionTester或QueryConnectionTester的类来测试连接。类名需制定全路径。 Default: 
        com.mchange.v2.c3p0.impl.DefaultConnectionTester -->
        <property name="connectionTesterClassName"></property>

        <!--指定c3p0 libraries的路径，如果（通常都是这样）在本地即可获得那么无需设置，默认null即可 Default: null -->
        <property name="factoryClassLocation">null</property>

        <!--Strongly disrecommended. Setting this to true may lead to subtle and 
        bizarre bugs. （文档原文）作者强烈建议不使用的一个属性 -->
        <property name="forceIgnoreUnresolvedTransactions">false</property>

        <!--每60秒检查所有连接池中的空闲连接。Default: 0 -->
        <property name="idleConnectionTestPeriod">0</property>

        <!--初始化时获取三个连接，取值应在minPoolSize与maxPoolSize之间。Default: 3 -->
        <property name="initialPoolSize">3</property>

        <!--最大空闲时间,指定的时间内未使用则连接被丢弃。若为0则永不丢弃。Default: 0 -->
        <property name="maxIdleTime">0</property>

        <!--连接池中保留的最大连接数。Default: 15 -->
        <property name="maxPoolSize">15</property>

        <!--JDBC的标准参数，用以控制数据源内加载的PreparedStatements数量。但由于预缓存的statements 属于单个connection而不是整个连接池。所以设置这个参数需要考虑到多方面的因素。 
        如果maxStatements与maxStatementsPerConnection均为0，则缓存被关闭。Default: 0 -->
        <property name="maxStatements">0</property>

        <!--maxStatementsPerConnection定义了连接池内单个连接所拥有的最大缓存statements数。Default: 0 -->
        <property name="maxStatementsPerConnection">0</property>

        <!--c3p0是异步操作的，缓慢的JDBC操作通过帮助进程完成。扩展这些操作可以有效的提升性能 通过多线程实现多个操作同时被执行。Default:3 -->
        <property name="numHelperThreads">3</property>

        <!--当用户调用getConnection()时使root用户成为去获取连接的用户。主要用于连接池连接非c3p0 的数据源时。Default: null -->
        <property name="overrideDefaultUser"></property>

        <!--与overrideDefaultUser参数对应使用的一个参数。Default: null -->
        <property name="overrideDefaultPassword"></property>

        <!--密码。Default: null -->
        <property name="password"></property>

        <!--定义所有连接测试都执行的测试语句。在使用连接测试的情况下这个一显著提高测试速度。注意： 测试的表必须在初始数据源的时候就存在。Default: null -->
        <property name="preferredTestQuery"></property>

        <!--用户修改系统配置参数执行前最多等待300秒。Default: 300 -->
        <property name="propertyCycle">300</property>

        <!--因性能消耗大请只在需要的时候使用它。如果设为true那么在每个connection提交的 时候都将校验其有效性。建议使用idleConnectionTestPeriod或automaticTestTable 
        等方法来提升连接测试的性能。Default: false -->
        <property name="testConnectionOnCheckout">false</property>

        <!--如果设为true那么在取得连接的同时将校验连接的有效性。Default: false -->
        <property name="testConnectionOnCheckin">false</property>

        <!--用户名。Default: null -->
        <property name="user"></property>

        <!-- 连接超时时间, default: 0。如果是0，表示无限等待 --> 
        <property name="checkoutTimeout">0</property>

        <!-- 测试空闲连接的间隔时间 default: 0 --> 
        <property name="idleConnectionTestPeriod">0</property>

        <!-- 初始化时连接数，default: 3 -->  
        <property name="initialPoolSize">3</property>

        <!-- 连接的最大空闲时间，default: 0 -->  
        <property name="maxIdleTime">0</property>

        <!-- 连接池中最大连接数，default: 15 -->  
        <property name="maxPoolSize">15</property>

         <!-- 连接池中最小连接数，default: 3 -->  
        <property name="minPoolSize">3</property>

        <!-- 连接池为数据源缓存的PreparedStatement的总数 -->  
        <property name="maxStatements">0</property> 

    </default-config>
</c3p0-config>

使用方法：

1、使用c3p0-config.xml

<!-- 自定义的c3p0-config.xml -->  
<?xml version="1.0" encoding="UTF-8"?>  

<c3p0-config>  
  <default-config>     
    <property name="driverClass">com.mysql.jdbc.Driver</property>  
    <property name="jdbcUrl">jdbc:mysql://localhost:3306/jdbc</property>  
    <property name="user">root</property>  
    <property name="password">java</property>  

    <property name="initialPoolSize">10</property>  
    <property name="maxIdleTime">30</property>  
    <property name="maxPoolSize">100</property>  
    <property name="minPoolSize">10</property>  
  </default-config>  

  <named-config name="mySource">  
    <property name="driverClass">com.mysql.jdbc.Driver</property>  
    <property name="jdbcUrl">jdbc:mysql://localhost:3306/bookstore</property>  
    <property name="user">root</property>  
    <property name="password">xxxx</property>  

    <property name="initialPoolSize">10</property>  
    <property name="maxIdleTime">30</property>  
    <property name="maxPoolSize">100</property>  
    <property name="minPoolSize">10</property>  
  </named-config>  
</c3p0-config>

//参数对应使用哪个config，如果不写，表示使用默认的config，即default-config里的配置，否则使用参数指定的named-config里的配置。
DataSource ds = new ComboPooledDataSource("mySource");

Connection conn = ds.getConnection(); 

//进行数据库操作

conn.close(); 

2、使用c3p0.properties配置文件

有如下c3p0.properties文件

driverClass=com.mysql.jdbc.Driver
jdbcUrl=jdbc:mysql:///test
user=root
password=admin
...

（1）在静态初始化中使用Properties类来加载c3p0.properties，并将读取到的property设置到DataSource上去。
代码如下：

ComboPooledDataSource ds = new ComboPooledDataSource();
Properties props = new Properties();
props.load(类名.class.getClassLoader().getResourceAsStream("c3p0.properties"));

ds.setDriverClass(props.getProperty("driverClass"));
ds.setJdbcUrl(props.getProperty("jdbcUrl"));
//...
Connection conn = ds.getConnection(); 
//数据库操作
conn.close(); 

2） 在静态初始化中使用ResourceBundle类来加载properties文件，并将读取到的property设置到DataSource上去。
代码如下：

ComboPooledDataSource ds = new ComboPooledDataSource();
ResourceBundle rb = ResourceBundle.getBundle("c3p0");//c3p0对应c3p0.properties

ds.setDriverClass(rb.getString("driverClass"));
ds.setJdbcUrl(rb.getString("jdbcUrl"));
//...
Connection conn = ds.getConnection(); 
//数据库操作
conn.close(); 

点击下方 “阅读原文” 查看更多

↓↓↓