C3P0的三种配置方式以及基本配置项详解

jopen 11年前

c3p0的配置方式分为三种，分别是
1.setters一个个地设置各个配置项
2.类路径下提供一个c3p0.properties文件
3.类路径下提供一个c3p0-config.xml文件

1.setters一个个地设置各个配置项
这种方式最繁琐，形式一般是这样：

01 Properties props = new Properties();
02 InputStream in = ConnectionManager.class.getResourceAsStream("/c3p0.properties");
03 props.load(in);
04 in.close();
05  
06 ComboPooledDataSource cpds = new ComboPooledDataSource();
07 cpds.setDriverClass(props.getProperty("driverClass"));
08 cpds.setJdbcUrl(props.getProperty("jdbcUrl"));
09 cpds.setUser(props.getProperty("user"));
10 cpds.setPassword(props.getProperty("password"));

因为繁琐，所以很不适合采用，于是文档提供了另外另种方式。

2. 类路径下提供一个c3p0.properties文件 
文件的命名必须是c3p0.properties，里面配置项的格式为：

1 c3p0.driverClass=com.mysql.jdbc.Driver
2 c3p0.jdbcUrl=jdbc:mysql://localhost:3306/jdbc
3 c3p0.user=root
4 c3p0.password=java

上面只提供了最基本的配置项，其他配置项参照 文档配置，记得是c3p0.后面加属性名就是了，最后初始化数据源的方式就是这样简单： 
1 private static ComboPooledDataSource ds = new ComboPooledDataSource();
2      
3 public static Connection getConnection() {
4     try {
5         return ds.getConnection();
6     } catch (SQLException e) {
7         throw new RuntimeException(e);
8     }
9 }

3.类路径下提供一个c3p0-config.xml文件  
这种方式使用方式与第二种差不多，但是有更多的优点 
(1).更直观明显，很类似hibernate和spring的配置 
(2).可以为多个数据源服务，提供default-config和named-config两种配置方式 
下面是一个配置模板： 
01 <c3p0-config>
02   <default-config>  
03     <property name="user">root</property>
04     <property name="password">java</property>
05     <property name="driverClass">com.mysql.jdbc.Driver</property>
06     <property name="jdbcUrl">jdbc:mysql://localhost:3306/jdbc</property>
07      
08     <property name="initialPoolSize">10</property>
09     <property name="maxIdleTime">30</property>
10     <property name="maxPoolSize">100</property>
11     <property name="minPoolSize">10</property>
12   </default-config>
13    
14   <named-config name="myApp">
15     <property name="user">root</property>
16     <property name="password">java</property>
17     <property name="driverClass">com.mysql.jdbc.Driver</property>
18     <property name="jdbcUrl">jdbc:mysql://localhost:3306/jdbc</property>
19      
20     <property name="initialPoolSize">10</property>
21     <property name="maxIdleTime">30</property>
22     <property name="maxPoolSize">100</property>
23     <property name="minPoolSize">10</property>
24   </named-config>
25 </c3p0-config>

如果要使用default-config则初始化数据源的方式与第二种一样，如果要使用named-config里面配置初始化数据源，则只要使用一个带参数的ComboPooledDataSource构造器就可以了 
1 private static ComboPooledDataSource ds = new ComboPooledDataSource("myApp");

下面整理一下从文档和网上学习到的c3p0配置的理解 (user,password,driverClass,jdbcUrl没有说的必要) 

1.基本配置项

01 acquireIncrement
02 default : 3
03 连接池在无空闲连接可用时一次性创建的新数据库连接数
04  
05 initialPoolSize
06 default : 3
07 连接池初始化时创建的连接数
08  
09 maxPoolSize
10 default : 15
11 连接池中拥有的最大连接数，如果获得新连接时会使连接总数超过这个值则不会再获取新连接，而是等待
12 其他连接释放，所以这个值有可能会设计地很大
13  
14 maxIdleTime
15 default : 0 单位 s
16 连接的最大空闲时间，如果超过这个时间，某个数据库连接还没有被使用，则会断开掉这个连接
17 如果为0，则永远不会断开连接
18  
19 minPoolSize
20 default : 3
21 连接池保持的最小连接数，后面的maxIdleTimeExcessConnections跟这个配合使用来减轻连接池的负载

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

01 maxConnectionAge
02 default : 0 单位 s
03 配置连接的生存时间，超过这个时间的连接将由连接池自动断开丢弃掉。当然正在使用的连接不会马上断开，而是等待
04 它close再断开。配置为0的时候则不会对连接的生存时间进行限制。
05  
06 maxIdleTimeExcessConnections
07 default : 0 单位 s
08 这个配置主要是为了减轻连接池的负载，比如连接池中连接数因为某次数据访问高峰导致创建了很多数据连接
09 但是后面的时间段需要的数据库连接数很少，则此时连接池完全没有必要维护那么多的连接，所以有必要将
10 断开丢弃掉一些连接来减轻负载，必须小于maxIdleTime。配置不为0，则会将连接池中的连接数量保持到minPoolSize。
11 为0则不处理。

maxIdleTime也可以归属到这一类，前面已经写出来了。

3.配置连接测试：因为连接池中的数据库连接很有可能是维持数小时的连接，很有可能因为数据库服务器的问题，网络问题等导致实际连接已经无效，但是连接池里面的连接还是有效的，如果此时获得连接肯定会发生异常，所以有必要通过测试连接来确认连接的有效性。
下面的前三项用来配置如何对连接进行测试，后三项配置对连接进行测试的时机。

01 automaticTestTable
02 default : null
03 用来配置测试连接的一种方式。配置一个表名，连接池根据这个表名创建一个空表，
04 并且用自己的测试sql语句在这个空表上测试数据库连接
05 这个表只能由c3p0来使用，用户不能操作，同时用户配置的preferredTestQuery 将会被忽略。
06  
07 preferredTestQuery
08 default : null
09 用来配置测试连接的另一种方式。与上面的automaticTestTable二者只能选一。
10 如果要用它测试连接，千万不要设为null，否则测试过程会很耗时，同时要保证sql语句中的表在数据库中一定存在。
11  
12 connectionTesterClassName
13 default :  com.mchange.v2.c3p0.impl.DefaultConnectionTester
14 连接池用来支持automaticTestTable和preferredTestQuery测试的类，必须是全类名，就像默认的那样，
15 可以通过实现UnifiedConnectionTester接口或者继承AbstractConnectionTester来定制自己的测试方法
16  
17 idleConnectionTestPeriod
18 default : 0
19 用来配置测试空闲连接的间隔时间。测试方式还是上面的两种之一，可以用来解决MySQL8小时断开连接的问题。因为它
20 保证连接池会每隔一定时间对空闲连接进行一次测试，从而保证有效的空闲连接能每隔一定时间访问一次数据库，将于MySQL
21 8小时无会话的状态打破。为0则不测试。
22  
23 testConnectionOnCheckin
24 default : false
25 如果为true，则在close的时候测试连接的有效性。为了提高测试性能，可以与idleConnectionTestPeriod搭配使用，
26 配置preferredTestQuery或automaticTestTable也可以加快测试速度。
27  
28 testConnectionOnCheckout
29 default : false
30 性能消耗大。如果为true，在每次getConnection的时候都会测试，为了提高性能，
31 可以与idleConnectionTestPeriod搭配使用，
32 配置preferredTestQuery或automaticTestTable也可以加快测试速度。

4.配置PreparedStatement缓存 
01 maxStatements
02 default : 0
03 连接池为数据源缓存的PreparedStatement的总数。由于PreparedStatement属于单个Connection,所以
04 这个数量应该根据应用中平均连接数乘以每个连接的平均PreparedStatement来计算。为0的时候不缓存，
05 同时maxStatementsPerConnection的配置无效。
06  
07 maxStatementsPerConnection
08 default : 0
09 连接池为数据源单个Connection缓存的PreparedStatement数，这个配置比maxStatements更有意义，因为
10 它缓存的服务对象是单个数据连接，如果设置的好，肯定是可以提高性能的。为0的时候不缓存。

5.重连相关配置 
01 acquireRetryAttempts
02 default : 30
03 连接池在获得新连接失败时重试的次数，如果小于等于0则无限重试直至连接获得成功
04  
05 acquireRetryDelay
06 default : 1000 单位ms
07 连接池在获得新连接时的间隔时间
08  
09 breakAfterAcquireFailure
10 default : false
11 如果为true，则当连接获取失败时自动关闭数据源，除非重新启动应用程序。所以一般不用。

个人觉得上述三个没有更改的必要，但可以将acquireRetryDelay配置地更短一些

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

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

例如： 
01 import java.sql.Connection;
02 import com.mchange.v2.c3p0.AbstractConnectionCustomizer;
03  
04 public class ConnectionCustomizer extends AbstractConnectionCustomizer{
05  
06     @Override
07     public void onAcquire(Connection c, String parentDataSourceIdentityToken)
08             throws Exception {
09         System.out.println("acquire : " + c);
10     }
11     @Override
12     public void onCheckIn(Connection c, String parentDataSourceIdentityToken)
13             throws Exception {
14         System.out.println("checkin : " + c);
15     }
16     @Override
17     public void onCheckOut(Connection c, String parentDataSourceIdentityToken)
18             throws Exception {
19         System.out.println("checkout : " + c);
20     }
21     @Override
22     public void onDestroy(Connection c, String parentDataSourceIdentityToken)
23             throws Exception {
24         System.out.println("destroy : " + c);
25     }
26 }

1 <property name="connectionCustomizerClassName">liuyun.zhuge.db.ConnectionCustomizer</property>

7.配置未提交的事务处理 
1 autoCommitOnClose
2 default : false
3 连接池在回收数据库连接时是否自动提交事务
4 如果为false，则会回滚未提交的事务
5 如果为true，则会自动提交事务
6  
7 forceIgnoreUnresolvedTransactions
8 default : false
9 这个配置强烈不建议为true。

一般来说事务当然由自己关闭了，为什么要让连接池来处理这种不细心问题呢？

8.配置debug和回收Connection

01 unreturnedConnectionTimeout
02 default : 0 单位 s
03 为0的时候要求所有的Connection在应用程序中必须关闭。如果不为0，则强制在设定的时间到达后回收
04 Connection，所以必须小心设置，保证在回收之前所有数据库操作都能够完成。这种限制减少Connection未关闭
05 情况的不是很适用。为0不对connection进行回收，即使它并没有关闭。
06  
07 debugUnreturnedConnectionStackTraces
08 default : false
09 如果为true并且unreturnedConnectionTimeout设为大于0的值，当所有被getConnection出去的连接
10 unreturnedConnectionTimeout时间到的时候，就会打印出堆栈信息。只能在debug模式下适用，因为
11 打印堆栈信息会减慢getConnection的速度

同第七项一样的，连接用完当然得close了，不要通过unreturnedConnectionTimeout让连接池来回收未关闭的连接。

9.其他配置项：因为有些配置项几乎没有自己配置的必要，使用默认值就好，所以没有再写出来

1 checkoutTimeout
2 default : 0
3 配置当连接池所有连接用完时应用程序getConnection的等待时间。为0则无限等待直至有其他连接释放
4 或者创建新的连接，不为0则当时间到的时候如果仍没有获得连接，则会抛出SQLException