现在常用的开源数据连接池主要有c3p0,dbcp 和proxool 三种,其中:
¨ hibernate 开发组推荐使用c3p0;
¨ spring 开发组推荐使用dbcp (dbcp 连接池有weblogic 连接池同样的问题,就是强行关闭连接或数据库重启后,无法reconnect ,告诉连接被重置, 这个设置可以解决);
¨ hibernate in action 推荐使用c3p0 和proxool;
下面具体就每种连接池的调研结果进行说明:
1. Apache-DBCP
Ø BasicDataSource 相关的参数说明
• dataSource: 要连接的 datasource (通常我们不会定义在 server.xml)
• defaultAutoCommit: 对于事务是否 autoCommit, 默认值为 true
• defaultReadOnly: 对于数据库是否只能读取, 默认值为 false
• driverClassName: 连接数据库所用的 JDBC Driver Class,
• maxActive: 可以从对象池中取出的对象最大个数,为0 则表示没有限制,默认为8
• maxIdle: 最大等待连接中的数量,设 0 为没有限制(对象池中对象最大个数)
• minIdle :对象池中对象最小个数
• maxWait: 最大等待秒数, 单位为 ms, 超过时间会丟出错误信息
• password: 登陆数据库所用的密码
• url: 连接数据库的 URL
• username: 登陆数据库所用的帐号
• validationQuery: 验证连接是否成功, SQL SELECT 指令至少要返回一行
• removeAbandoned: 是否自我中断, 默认是 false
• removeAbandonedTimeout: 几秒后会自我中断, removeAbandoned 必须为 true
• logAbandoned: 是否记录中断事件, 默认为 false
• minEvictableIdleTimeMillis :大于0 ,进行连接空闲时间判断,或为0 ,对空闲的连接不进行验证;默认30 分钟
• timeBetweenEvictionRunsMillis :失效检查线程运行时间间隔,如果小于等于0 ,不会启动检查线程,默认-1
• testOnBorrow :取得对象时是否进行验证,检查对象是否有效,默认为false
• testOnReturn :返回对象时是否进行验证,检查对象是否有效,默认为false
• testWhileIdle :空闲时是否进行验证,检查对象是否有效,默认为false
Ø 在使用DBCP 的时候,如果使用默认值,则数据库连接因为某种原因断掉后,再从连接池中取得连接又不进行验证,这时取得的连接实际上就会是无效的数据库连接。因此为了防止获得的数据库连接失效,在使用的时候最好保证:
• username: 登陆数据库所用的帐号
• validationQuery :SELECT COUNT(*) FROM DUAL
• testOnBorrow 、testOnReturn 、testWhileIdle :最好都设为true
• minEvictableIdleTimeMillis :大于0 ,进行连接空闲时间判断,或为0 ,对空闲的连接不进行验证
• 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 ] ,现摘录如下:
<c3p0-config>
<default-config>
<!--当连接池中的连接耗尽的时候 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">Test</property>
<!--获取连接失败将会引起所有等待连接池来获取连接的线程抛出异常。但是数据源仍有效
保留,并在下次调用 getConnection()的时候继续尝试获取连接。如果设为 true,那么在尝试
获取连接失败后该数据源将申明已断开并永久关闭。 Default: false-->
<property name="breakAfterAcquireFailure">false</property>
<!--当连接池用完时客户端调用 getConnection()后等待获取新连接的时间,超时后将抛出
SQLException,如设为 0则无限期等待。单位毫秒。 Default: 0 -->
<property name="checkoutTimeout">100</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">60</property>
<!--初始化时获取三个连接,取值应在 minPoolSize与 maxPoolSize之间。 Default: 3 -->
<property name="initialPoolSize">3</property>
<!--最大空闲时间 ,60秒内未使用则连接被丢弃。若为 0则永不丢弃。 Default: 0 -->
<property name="maxIdleTime">60</property>
<!--连接池中保留的最大连接数。 Default: 15 -->
<property name="maxPoolSize">15</property>
<!--JDBC的标准参数,用以控制数据源内加载的 PreparedStatements数量。但由于预缓存的 statements
属于单个 connection而不是整个连接池。所以设置这个参数需要考虑到多方面的因素。
如果 maxStatements与 maxStatementsPerConnection均为 0,则缓存被关闭。 Default: 0-->
<property name="maxStatements">100</property>
<!--maxStatementsPerConnection定义了连接池内单个连接所拥有的最大缓存 statements数。 Default: 0 -->
<property name="maxStatementsPerConnection"></property>
<!--c3p0是异步操作的,缓慢的 JDBC操作通过帮助进程完成。扩展这些操作可以有效的提升性能
通过多线程实现多个操作同时被执行。 Default: 3-->
<property name="numHelperThreads">3</property>
<!--当用户调用 getConnection()时使 root用户成为去获取连接的用户。主要用于连接池连接非 c3p0
的数据源时。 Default: null-->
<property name="overrideDefaultUser">root</property>
<!--与 overrideDefaultUser参数对应使用的一个参数。 Default: null-->
<property name="overrideDefaultPassword">password</property>
<!--密码。 Default: null-->
<property name="password"></property>
<!--定义所有连接测试都执行的测试语句。在使用连接测试的情况下这个一显著提高测试速度。注意:
测试的表必须在初始数据源的时候就存在。 Default: null-->
<property name="preferredTestQuery">select id from test where id=1</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">true</property>
<!--用户名。 Default: null-->
<property name="user">root</property>
<!--早期的 c3p0版本对 JDBC接口采用动态反射代理。在早期版本用途广泛的情况下这个参数
允许用户恢复到动态反射代理以解决不稳定的故障。最新的非反射代理更快并且已经开始
广泛的被使用,所以这个参数未必有用。现在原先的动态反射与新的非反射代理同时受到
支持,但今后可能的版本可能不支持动态反射代理。 Default: false-->
<property name="usesTraditionalReflectiveProxies">false</property>
<property name="automaticTestTable">con_test</property>
<property name="checkoutTimeout">30000</property>
<property name="idleConnectionTestPeriod">30</property>
<property name="initialPoolSize">10</property>
<property name="maxIdleTime">30</property>
<property name="maxPoolSize">25</property>
<property name="minPoolSize">10</property>
<property name="maxStatements">0</property>
<user-overrides user="swaldman">
</user-overrides>
</default-config>
<named-config name="dumbTestConfig">
<property name="maxStatements">200</property>
<user-overrides user="poop">
<property name="maxStatements">300</property>
</user-overrides>
</named-config>
</c3p0-config>
Ø 上述特性的可设置性已在代码中验证,具体性能是否能实现有待实际验证
Ø 从配置项的内容来看,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 ~] 。
n fatal-sql-exception
以逗号隔开的异常列表,当设置了此项之后,每当出现SQLException时都将与列表中异常项作比较,如果匹配则认为出现fatal异常,这将导致connection被丢弃,并且不论出现任何情况该异常将被重抛一次以通知用户发生的情况。默认值为null
n 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
n house-keeping-sleep-time
proxool 自动侦察各个连接状态的时间间隔( 毫秒), 侦察到空闲的连接就马上回收, 超时的销毁,默认值为30 秒
n 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
n jmx
如果此项设为true ,则连接池将被以名称"Proxool:type=Pool, name=<alias>"注册为JMS Server的MBean。默认值为false
n jmx-agent-id
当且仅当jmx选项设为true时使用,为以逗号分隔的连接持注册到的JMS代理名称列表;如果不设置则所有注册的JMX Server都将被使用
n maximum-active-time
线程最大存活时间,超过此时间的线程将被守护线程kill掉,默认值为5分钟
n maximum-connection-count
到数据库的最大连接数,超过了这个连接,再有请求时,就排在队列中等候,最大的等待请求数由simultaneous-build-throttle决定;默认值为15
n maximum-connection-lifetime
连接最大存活时间,毫秒为单位,默认值为4小时
n minimum-connection-count
不管是否被使用都保持开放 的最小连接数,默认值为5
n overload-without-refusal-lifetime
用来判断连接池状态,如果在此选项设置时间内(毫秒为单位)拒绝了连接,则认为过负载。默认值为60 秒
n prototype-count
最少保持的空闲 连接数,注意与minimum-connection-count区分。默认值为0
n simultaneous-build-throttle
最大的等待请求数,默认值为10
n test-before-use
如果设为true则connection在使用前将以house-keeping-test-sql设置的语句测试,如果测试不通过则该connection被丢弃并会重新分配一个connection。默认为false
n test-after-use
如果设为true则connection在关闭(放回连接池)前将以house-keeping-test-sql设置的语句测试,如果测试不通过connection将被丢弃。默认值为false
Ø 与其它连接池特性的设置方法不同,Proxool 不提供相应的set 方法,所有特性都要以诸如info.setProperty("proxool.jmx", "false"); 方式设定
Ø 上述特性的可设置性已在代码中验证,具体性能是否能实现有待实际验证
Ø Proxool 与DBCP 以及C3P0 的性能比较,网上众说纷纭,有待我们自己的测试;其中http://www.oioj.net/blog/user1/2853/archives/2006/298381.shtml 这篇文章对proxool 和DBCP 做了性能评测,其方法值得我们测试借鉴
¨ hibernate 开发组推荐使用c3p0;
¨ spring 开发组推荐使用dbcp (dbcp 连接池有weblogic 连接池同样的问题,就是强行关闭连接或数据库重启后,无法reconnect ,告诉连接被重置, 这个设置可以解决);
¨ hibernate in action 推荐使用c3p0 和proxool;
下面具体就每种连接池的调研结果进行说明:
1. Apache-DBCP
Ø BasicDataSource 相关的参数说明
• dataSource: 要连接的 datasource (通常我们不会定义在 server.xml)
• defaultAutoCommit: 对于事务是否 autoCommit, 默认值为 true
• defaultReadOnly: 对于数据库是否只能读取, 默认值为 false
• driverClassName: 连接数据库所用的 JDBC Driver Class,
• maxActive: 可以从对象池中取出的对象最大个数,为0 则表示没有限制,默认为8
• maxIdle: 最大等待连接中的数量,设 0 为没有限制(对象池中对象最大个数)
• minIdle :对象池中对象最小个数
• maxWait: 最大等待秒数, 单位为 ms, 超过时间会丟出错误信息
• password: 登陆数据库所用的密码
• url: 连接数据库的 URL
• username: 登陆数据库所用的帐号
• validationQuery: 验证连接是否成功, SQL SELECT 指令至少要返回一行
• removeAbandoned: 是否自我中断, 默认是 false
• removeAbandonedTimeout: 几秒后会自我中断, removeAbandoned 必须为 true
• logAbandoned: 是否记录中断事件, 默认为 false
• minEvictableIdleTimeMillis :大于0 ,进行连接空闲时间判断,或为0 ,对空闲的连接不进行验证;默认30 分钟
• timeBetweenEvictionRunsMillis :失效检查线程运行时间间隔,如果小于等于0 ,不会启动检查线程,默认-1
• testOnBorrow :取得对象时是否进行验证,检查对象是否有效,默认为false
• testOnReturn :返回对象时是否进行验证,检查对象是否有效,默认为false
• testWhileIdle :空闲时是否进行验证,检查对象是否有效,默认为false
Ø 在使用DBCP 的时候,如果使用默认值,则数据库连接因为某种原因断掉后,再从连接池中取得连接又不进行验证,这时取得的连接实际上就会是无效的数据库连接。因此为了防止获得的数据库连接失效,在使用的时候最好保证:
• username: 登陆数据库所用的帐号
• validationQuery :SELECT COUNT(*) FROM DUAL
• testOnBorrow 、testOnReturn 、testWhileIdle :最好都设为true
• minEvictableIdleTimeMillis :大于0 ,进行连接空闲时间判断,或为0 ,对空闲的连接不进行验证
• 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 ] ,现摘录如下:
<c3p0-config>
<default-config>
<!--当连接池中的连接耗尽的时候 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">Test</property>
<!--获取连接失败将会引起所有等待连接池来获取连接的线程抛出异常。但是数据源仍有效
保留,并在下次调用 getConnection()的时候继续尝试获取连接。如果设为 true,那么在尝试
获取连接失败后该数据源将申明已断开并永久关闭。 Default: false-->
<property name="breakAfterAcquireFailure">false</property>
<!--当连接池用完时客户端调用 getConnection()后等待获取新连接的时间,超时后将抛出
SQLException,如设为 0则无限期等待。单位毫秒。 Default: 0 -->
<property name="checkoutTimeout">100</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">60</property>
<!--初始化时获取三个连接,取值应在 minPoolSize与 maxPoolSize之间。 Default: 3 -->
<property name="initialPoolSize">3</property>
<!--最大空闲时间 ,60秒内未使用则连接被丢弃。若为 0则永不丢弃。 Default: 0 -->
<property name="maxIdleTime">60</property>
<!--连接池中保留的最大连接数。 Default: 15 -->
<property name="maxPoolSize">15</property>
<!--JDBC的标准参数,用以控制数据源内加载的 PreparedStatements数量。但由于预缓存的 statements
属于单个 connection而不是整个连接池。所以设置这个参数需要考虑到多方面的因素。
如果 maxStatements与 maxStatementsPerConnection均为 0,则缓存被关闭。 Default: 0-->
<property name="maxStatements">100</property>
<!--maxStatementsPerConnection定义了连接池内单个连接所拥有的最大缓存 statements数。 Default: 0 -->
<property name="maxStatementsPerConnection"></property>
<!--c3p0是异步操作的,缓慢的 JDBC操作通过帮助进程完成。扩展这些操作可以有效的提升性能
通过多线程实现多个操作同时被执行。 Default: 3-->
<property name="numHelperThreads">3</property>
<!--当用户调用 getConnection()时使 root用户成为去获取连接的用户。主要用于连接池连接非 c3p0
的数据源时。 Default: null-->
<property name="overrideDefaultUser">root</property>
<!--与 overrideDefaultUser参数对应使用的一个参数。 Default: null-->
<property name="overrideDefaultPassword">password</property>
<!--密码。 Default: null-->
<property name="password"></property>
<!--定义所有连接测试都执行的测试语句。在使用连接测试的情况下这个一显著提高测试速度。注意:
测试的表必须在初始数据源的时候就存在。 Default: null-->
<property name="preferredTestQuery">select id from test where id=1</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">true</property>
<!--用户名。 Default: null-->
<property name="user">root</property>
<!--早期的 c3p0版本对 JDBC接口采用动态反射代理。在早期版本用途广泛的情况下这个参数
允许用户恢复到动态反射代理以解决不稳定的故障。最新的非反射代理更快并且已经开始
广泛的被使用,所以这个参数未必有用。现在原先的动态反射与新的非反射代理同时受到
支持,但今后可能的版本可能不支持动态反射代理。 Default: false-->
<property name="usesTraditionalReflectiveProxies">false</property>
<property name="automaticTestTable">con_test</property>
<property name="checkoutTimeout">30000</property>
<property name="idleConnectionTestPeriod">30</property>
<property name="initialPoolSize">10</property>
<property name="maxIdleTime">30</property>
<property name="maxPoolSize">25</property>
<property name="minPoolSize">10</property>
<property name="maxStatements">0</property>
<user-overrides user="swaldman">
</user-overrides>
</default-config>
<named-config name="dumbTestConfig">
<property name="maxStatements">200</property>
<user-overrides user="poop">
<property name="maxStatements">300</property>
</user-overrides>
</named-config>
</c3p0-config>
Ø 上述特性的可设置性已在代码中验证,具体性能是否能实现有待实际验证
Ø 从配置项的内容来看,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 ~] 。
n fatal-sql-exception
以逗号隔开的异常列表,当设置了此项之后,每当出现SQLException时都将与列表中异常项作比较,如果匹配则认为出现fatal异常,这将导致connection被丢弃,并且不论出现任何情况该异常将被重抛一次以通知用户发生的情况。默认值为null
n 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
n house-keeping-sleep-time
proxool 自动侦察各个连接状态的时间间隔( 毫秒), 侦察到空闲的连接就马上回收, 超时的销毁,默认值为30 秒
n 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
n jmx
如果此项设为true ,则连接池将被以名称"Proxool:type=Pool, name=<alias>"注册为JMS Server的MBean。默认值为false
n jmx-agent-id
当且仅当jmx选项设为true时使用,为以逗号分隔的连接持注册到的JMS代理名称列表;如果不设置则所有注册的JMX Server都将被使用
n maximum-active-time
线程最大存活时间,超过此时间的线程将被守护线程kill掉,默认值为5分钟
n maximum-connection-count
到数据库的最大连接数,超过了这个连接,再有请求时,就排在队列中等候,最大的等待请求数由simultaneous-build-throttle决定;默认值为15
n maximum-connection-lifetime
连接最大存活时间,毫秒为单位,默认值为4小时
n minimum-connection-count
不管是否被使用都保持开放 的最小连接数,默认值为5
n overload-without-refusal-lifetime
用来判断连接池状态,如果在此选项设置时间内(毫秒为单位)拒绝了连接,则认为过负载。默认值为60 秒
n prototype-count
最少保持的空闲 连接数,注意与minimum-connection-count区分。默认值为0
n simultaneous-build-throttle
最大的等待请求数,默认值为10
n test-before-use
如果设为true则connection在使用前将以house-keeping-test-sql设置的语句测试,如果测试不通过则该connection被丢弃并会重新分配一个connection。默认为false
n test-after-use
如果设为true则connection在关闭(放回连接池)前将以house-keeping-test-sql设置的语句测试,如果测试不通过connection将被丢弃。默认值为false
Ø 与其它连接池特性的设置方法不同,Proxool 不提供相应的set 方法,所有特性都要以诸如info.setProperty("proxool.jmx", "false"); 方式设定
Ø 上述特性的可设置性已在代码中验证,具体性能是否能实现有待实际验证
Ø Proxool 与DBCP 以及C3P0 的性能比较,网上众说纷纭,有待我们自己的测试;其中http://www.oioj.net/blog/user1/2853/archives/2006/298381.shtml 这篇文章对proxool 和DBCP 做了性能评测,其方法值得我们测试借鉴