[J2EE]DBCP、C3P0、Proxool三大连接池的配置参数说明和使用详解

1. Apache-DBCP

BasicDataSource 相关的参数说明

1. dataSource: 要连接的 datasource (通常我们不会定义在 server.xml)
2. defaultAutoCommit: 对于事务是否 autoCommit, 默认值为 true
3. defaultReadOnly: 对于数据库是否只能读取, 默认值为 false
4. driverClassName:连接数据库所用的 JDBC Driver Class,
5. maxActive: 可以从对象池中取出的对象最大个数，为0则表示没有限制，默认为8
6. maxIdle: 最大等待连接中的数量,设 0 为没有限制 （对象池中对象最大个数）
7. minIdle：对象池中对象最小个数
8. maxWait: 最大等待秒数, 单位为 ms, 超过时间会丟出错误信息
9. password: 登陆数据库所用的密码
10. url: 连接数据库的 URL
11. username: 登陆数据库所用的帐号
12. validationQuery: 验证连接是否成功, SQL SELECT 指令至少要返回一行
13. removeAbandoned: 是否自我中断, 默认是 false
14. removeAbandonedTimeout: 几秒后会自我中断, removeAbandoned 必须为 true
15. logAbandoned: 是否记录中断事件, 默认为 false
16. minEvictableIdleTimeMillis：大于0 ，进行连接空闲时间判断，或为0，对空闲的连接不进行验证；默认30分钟
17. timeBetweenEvictionRunsMillis：失效检查线程运行时间间隔，如果小于等于0，不会启动检查线程，默认-1
18. testOnBorrow：取得对象时是否进行验证，检查对象是否有效，默认为false
19. testOnReturn：返回对象时是否进行验证，检查对象是否有效，默认为false
20. testWhileIdle：空闲时是否进行验证，检查对象是否有效，默认为false

在使用 DBCP的时候，如果使用默认值，则数据库连接因为某种原因断掉后，再从连接池中取得连接又不进行验证，这时取得的连接实际上就会是无效的数据库连接。因此为了防止获得的数据库连接失效，在使用的时候最好保证：

1. isc]
2. username: 登陆数据库所用的帐号
3. validationQuery：SELECT COUNT(*) FROM DUAL
4. testOnBorrow、testOnReturn、testWhileIdle：最好都设为true
5. minEvictableIdleTimeMillis：大于0 ，进行连接空闲时间判断，或为0，对空闲的连接不进行验证
6. timeBetweenEvictionRunsMillis：失效检查线程运行时间间隔，如果小于等于0，不会启动检查线程

Ø PS:在构造 GenericObjectPool [BasicDataSource 在其createDataSource () 方法中也会使用GenericObjectPool] 时，会生成一个内嵌类 Evictor，实现自 Runnable接口。如果 timeBetweenEvictionRunsMillis大于 0，每过 timeBetweenEvictionRunsMillis毫秒 Evictor会调用 evict()方法，检查对象的闲置时间是否大于 minEvictableIdleTimeMillis毫秒（ _minEvictableIdleTimeMillis小于等于 0时则忽略，默认为 30分钟），是则销毁此对象，否则就激活并校验对象，然后调用 ensureMinIdle方法检查确保池中对象个数不小于 _minIdle。在调用 returnObject方法把对象放回对象池，首先检查该对象是否有效，然后调用 PoolableObjectFactory 的 passivateObject方法使对象处于非活动状态。再检查对象池中对象个数是否小于 maxIdle，是则可以把此对象放回对象池，否则销毁此对象
Ø 上述特性的可设置性已在代码中验证，具体性能是否能实现有待实际验证

2. C3P0


Ø C3P0的官方 example中使用的数据源为 ComboPooledDataSource，网上一篇文章详细介绍了 C3P0连接池配置中各项含义 [这些配置项的含义在下载解压 c3p0的压缩包之后目录的 doc\index.html中的 Configuration部分也有详细的介绍，这里偷下懒 :P]，现摘录如下：



3


30


1000


false


Test


false


100





null


false


60


3


60


15


100





3


root


password





select id from test where id=1


300


false


true


root


false
con_test
    30000
    30
    10
    30
    25
    10
    0
    
    


    200
    
      300
    
  


Ø 上述特性的可设置性已在代码中验证，具体性能是否能实现有待实际验证
Ø 从配置项的内容来看， C3P0和 DBCP都有比较详细的有关连接检测保证的配置，我们可以看到 C3P0可以控制数据源内加载的PreparedStatements数量，并且可以设置帮助线程的数量来提升JDBC操作的速度， 这些是DBCP未提供的；另外从网络上的评价来看， DBCP出现Bug的频率要大于C3P0，不过这一点有待于我们自己实际的检测。

3. Proxool


Ø Proxool的使用和 dbcp以及 c3p0稍有不同，我们需要并且只需要在使用基本的 java.sql.DriverManager之前加载 org.logicalcobwebs.proxool.ProxoolDriver驱动类 ,并且按照 proxool定义的 url格式 ["proxool." + alias + ":" + driverClass + ":" + driverUrl ，其中alias是为连接池自定义的别名] 来获得 connection；具体的可以参看 proxool doc下的 UserGuide，或本文所附的示例代码。下面对连接池的特性配置作详细说明 [这个是自己翻译的，不一定准确，有问题时请参看 doc下的 Properties ~]。

fatal-sql-exception
以逗号隔开的异常列表，当设置了此项之后，每当出现SQLException时都将与列表中异常项作比较，如果匹配则认为出现fatal异常，这将导致connection被丢弃，并且不论出现任何情况该异常将被重抛一次以通知用户发生的情况。默认值为 null

fatal-sql-exception-wrapper-class
如果配置了 fatal-sql-exception，则默认的操作是丢弃引起SQLException的原因而只是抛出原始异常。使用fatal-sql-exception-wrapper-class这个特性可以将 SQLException包装到继承SQLException或RunTimeException的任何异常类里。Proxool提供了两个类供使用 FatalSQLException和FatalRunTimeException；使用这两个类的话就将该选项设置为 'org.logicalcobwebs.proxool.FatalSQLException'或者 'org.logicalcobwebs.proxool.FatalRuntimeException'。默认值为 null

house-keeping-sleep-time
proxool自动侦察各个连接状态的时间间隔 (毫秒 ),侦察到空闲的连接就马上回收 ,超时的销毁，默认值为 30秒

house-keeping-test-sql
如果侦察线程发现闲置连接，则会使用这个SQL语句来对这些连接进行检查；这项设置的语句应该能够被很快的执行，例如查询当前时间 [info.setProperty("proxool.house-keeping-test-sql", "select CURRENT_DATE");] 。如果不设置则该选项被忽略
n injectable-connection-interface、 injectable-statement-interface、injectable-prepared-statement-interface、injectable-callable-statement-interface

jmx
如果此项设为 true，则连接池将被以名称"Proxool:type=Pool, name="注册为JMS Server的MBean。默认值为 false

jmx-agent-id
当且仅当jmx选项设为true时使用，为以逗号分隔的连接持注册到的JMS代理名称列表；如果不设置则所有注册的JMX Server都将被使用

maximum-active-time
线程最大存活时间，超过此时间的线程将被守护线程kill掉，默认值为5分钟

maximum-connection-count
到数据库的最大连接数，超过了这个连接，再有请求时，就排在队列中等候，最大的等待请求数由simultaneous-build-throttle决定；默认值为15

maximum-connection-lifetime
连接最大存活时间，毫秒为单位，默认值为4小时

minimum-connection-count
不管是否被使用都保持 开放的最小连接数，默认值为5

overload-without-refusal-lifetime
用来判断连接池状态，如果在此选项设置时间内（毫秒为单位）拒绝了连接，则认为过负载。默认值为 60秒

prototype-count
最少保持的 空闲连接数，注意与minimum-connection-count区分。默认值为 0

simultaneous-build-throttle
最大的等待请求数，默认值为 10

test-before-use
如果设为true则connection在使用前将以house-keeping-test-sql设置的语句测试，如果测试不通过则该connection被丢弃并会重新分配一个connection。默认为false

test-after-use
如果设为true则connection在关闭（放回连接池）前将以house-keeping-test-sql设置的语句测试，如果测试不通过connection将被丢弃。默认值为false

与其它连接池特性的设置方法不同， Proxool不提供相应的 set方法，所有特性都要以诸如 info.setProperty("proxool.jmx", "false");方式设定

上述特性的可设置性已在代码中验证，具体性能是否能实现有待实际验证

 

转自： http://www.itjszz.com/read.php?tid=535