BoneCP配置参数说明.docx
《BoneCP配置参数说明.docx》由会员分享，可在线阅读，更多相关《BoneCP配置参数说明.docx（14页珍藏版）》请在冰豆网上搜索。
BoneCP配置参数说明
什么是BoneCP
什么是BoneCP
BoneCP是一个快速、免费而且开源的java数据库连接池（JDBCPool）管理工具库。
如果你曾经使用过C3P0或者DBCP，那你肯定知道上面这句话的意思；如果你没用过这些，那简单的解释一下，它是一个能为你的应用管理数据库连接的工具。
官方网站：
为什么要学习BoneCP
本着不重复发明轮子的原则，不应该在有了C3P0这种成熟的数据库连接池管理工具后再搞个新的出来，但是传说中BoneCP在快速这个特点上做到了极致，官方数据是C3P0等的25倍左右。
不相信？
其实我也不怎么信，正找时间自己写测试类测试呢，你也可以去试试看，在这里下载（现在最新版本0.6.7.2，如果你有困难，下面会具体提到在项目中怎么配置）
好吧，先看一下官方给出的华丽数据：
1. 单线程（1,000,000获得及释放数据库连接请求，连接池大小20-50）
2. 多线程（500线程分别获取释放100个链接，连接池大小50-200）
3. PreparedStatement（multi-threaded）（500个线程每个100次获得/释放，连接池大小20-500）
这里只应用了部分，还有其他比较多的测试数据，有兴趣就去这里瞧瞧吧。
个人还是建议自己写点代码测试一下，那样感受更深啊。
在介绍怎么使用之前，先来看看BoneCP的特性（Features）：
•高度可扩展,快速的连接池.注：
1）不用synchronized关键字来处理多线程对资源的争用，而是使用java.util.concurrent包中的锁机制；2）首次使用分区机制来分开管理数据库连接；或许还有其他原因.
•Callback（hookinterceptor）mechanismsonachangeofconnectionstate.
•利用分区技术提高性能
•允许直接访问一个连接或者语句
•智能调整连接池大小
•SQL语句缓存支持
•支持异步获取数据库连接（通过返回Future的形式）
•通过释放连接助理进程来释放数据库连接，提高性能.
•通过initSQL参数在每次获取连接的时候执行SQL
•支持数据库热切换
•自动重试失败的数据库操作（当数据库或者网络挂掉的时候）
•JMXsupport
•延迟初始化能力（Lazyinitializationcapable）
•自动检测连接可用性（keep-alives等）
•允许直接通过数据源而不是通过驱动来获取一个新的数据库连接（AllowobtainingofnewconnectionsviaadatasourceratherthanviaaDriver）
•Datasource/Hibernatesupportcapable
•Debug支持准确地高亮那些已经得到但是还没有关闭的链接（Debugginghookstohighlighttheexactplacewhereaconnectionwasobtainedbutnotclosed）
•Debug支持展示那些被关闭两次的链接地址堆栈信息（Debuggingsupporttoshowstacklocationsofconnectionsthatwereclosedtwice.）
•支持自定义连接池名称.
•干净的代码结构，TestCase代码覆盖率达到100%（over125JUnittests）.
•免费的，开源的而且都是用java干的，最重要的是有很完整的javadocs支持。
（Free,opensourceandwrittenin100%pureJavawithcompleteJavadocs）.
本人鸟语有限，有些翻译不是很好，请见谅
好了，废话说的挺多的，看看到底怎么用吧。
怎么使用BoneCP
我是Maven的忠实拥护者，如果你也是，那就简单了：
你可以在你的settings.xml文件里加上下面一段，声明一个Maven仓库，如果你不想影响其他项目，那也可以在你项目的pom.xml文件里面加。
[xhtml]viewplaincopy
1.
2.
3.
4.true
5.
6.bonecp-repo
7.BoneCPRepository
8.
9.
10.
然后你就可以像引用其他jar包一样引用bonecp了，下面应该很熟悉
[xhtml]viewplaincopy
1.
2.com.jolbox
3.bonecp
4.0.6.7.2
5.
如果你的项目直接用类似Hibernate的东东，没有配置dataSource的话，你很牛，那就加上下面这个吧
[xhtml]viewplaincopy
1.
2.com.jolbox
3.bonecp-provider
4.0.6.7.2
5.
如果这些都没有满足你,那参考这里吧。
如果你不用Spring，那应该是这样写吧：
[java]viewplaincopy
1.Class.forName（"org.hsqldb.jdbcDriver"）;//loadtheDBdriver
2.BoneCPConfigconfig=newBoneCPConfig（）;//createanewconfigurationobject
3.config.setJdbcUrl（"jdbc:
hsqldb:
mem:
test"）;//settheJDBCurl
4.config.setUsername（"sa"）;//settheusername
5.config.setPassword（""）;//setthepassword
6.config.setXXXX（...）;//（otherconfigoptionshere）
7.BoneCPconnectionPool=newBoneCP（config）;//setuptheconnectionpool
8.Connectionconnection;
9.connection=connectionPool.getConnection（）;//fetchaconnection
10....dosomethingwiththeconnectionhere...
11.connection.close（）;//closetheconnection
12.connectionPool.shutdown（）;//closetheconnectionpool
BoneCP-Spring详细配置
主要讲一下在Spring下面怎么配置，其实更简单，只要配置dataSrouce就可以搞定。
如下，具体含义见注释。
[xhtml]viewplaincopy
1.2.destroy-method="close">
3.
--数据库驱动-->
4.
5.
--相应驱动的jdbcUrl,你懂的-->
6.
7.
--数据库的用户名-->
8.
9.
--数据库的密码-->
10.
11.
--检查数据库连接池中空闲连接的间隔时间，单位是分，默认值：
240，如果要取消则设置为0-->
12.
13.
--连接池中未使用的链接最大存活时间，单位是分，默认值：
60，如果要永远存活设置为0-->
14.
15.
--每个分区最大的连接数-->
16.
17.
--每个分区最小的连接数-->
18.
19.
--分区数，默认值2，最小1，推荐3-4，视应用而定-->
20.
21.
--每次去拿数据库连接的时候一次性要拿几个,默认值：
2-->
22.
23.
--缓存preparedstatements的大小，默认值：
0-->
24.
25.
--每个分区释放链接助理进程的数量，默认值：
3，除非你的一个数据库连接的时间内做了很多工作，不然过多的助理进程会影响你的性能-->
26.
27.
其他还有些不是很常用的包括：
[java]viewplaincopy
1.connectionTestStatement：
在做keep-alive的时候的SQL语句。
2.statementsCachedPerConnection：
Noofstatementsthatcanbecachedperconnection，反正源码中不推荐使用，就别用了.
3.initSQL:
在每次到数据库取连接的时候执行的SQL语句，只执行一次。
4.closeConnectionWatch：
如果设置为true，则会增加一个线程监控关闭连接时的情况，如果关闭时出现异常，则打出错误日志，主要用于debug。
上线后记得关掉。
5.logStatementsEnabled：
如果设置为true，就会打印执行的SQL语句，如果你用了其他能打印SQL语句的框架，那就不必了。
6.acquireRetryDelay：
在获取连接失败后，第二次参试前的延迟时间，默认为7000毫秒。
7.acquireRetryAttempts：
在获取连接失败后的重试次数，默认为5次。
8.lazyInit：
如果设置为true，那么连接池不会自动创建最小连接数的链接，而是保持为空，直到有需求要获取连接。
9.transactionRecoveryEnabled：
如果设置为true，则会保存该链接上的所有活动，以备下次重试的时候使用，这里指的活动是数据库操作。
10.connectionHookClassName：
Connectionhookclassname.没看懂…
11.poolName：
上面特性中说到的自定义连接池名称。
12.disableJMX：
控制JMX的支持开关。
13.connectionTimeout：
获取连接的时候最大的等待时间，默认值为：
Long.MAX_VALUE
Spring里面怎么用这个dataSource就不说了吧，今天重点在BoneCP。
最后跑一个TestCase，看看日志
初始化的时候打印出BoneCP的配置参数，很清楚，关闭的时候也有日志输出。
[xhtml]viewplaincopy
1.2010-08-0215:
10:
22,457[BoneCPDataSource.java:
121][com.jolbox.bonecp.BoneCPDataSource]DEBUGcom.jolbox.bonecp.BoneCPDataSource:
:
JDBCURL=jdbc:
mysql:
//10.249.128.109:
3306/ali_library,Username=root,partitions=3,max（perpartition）=3,min（perpartition）=3,helperthreads=3,idlemaxage=240min,idletestperiod=30min
2.2010-08-0215:
10:
22,457[BoneCPDataSource.java:
121][com.jolbox.bonecp.BoneCPDataSource]DEBUGcom.jolbox.bonecp.BoneCPDataSource:
:
JDBCURL=jdbc:
mysql:
//10.249.128.109:
3306/ali_library,Username=root,partitions=3,max（perpartition）=3,min（perpartition）=3,helperthreads=3,idlemaxage=240min,idletestperiod=30min
3.2010-08-0215:
10:
45,958[BoneCP.java:
129][com.jolbox.bonecp.BoneCP]INFOcom.jolbox.bonecp.BoneCP:
:
Shuttingdownconnectionpool...
4.2010-08-0215:
10:
45,958[BoneCP.java:
129][com.jolbox.bonecp.BoneCP]INFOcom.jolbox.bonecp.BoneCP:
:
Shuttingdownconnectionpool...
5.2010-08-0215:
10:
45,973[BoneCP.java:
145][com.jolbox.bonecp.BoneCP]INFOcom.jolbox.bonecp.BoneCP:
:
Connectionpoolhasbeenshutdown.
6.2010-08-0215:
10:
45,973[BoneCP.java:
145][com.jolbox.bonecp.BoneCP]INFOcom.jolbox.bonecp.BoneCP:
:
Connectionpoolhasbeenshutdown
BoneCP配置参数说明
一、BoneCP配置文件格式（bonecp-config.xml）：
Xml代码
1.
xml version="1.0" encoding="UTF-8"?
>
2.
3.
4.
-- ... -->
5. ...
6.
7.
xmlversion="1.0"encoding="UTF-8"?
>
--...-->
...
二、BoneCP主要配置参数
1.jdbcUrl
设置数据库URL
2.username
设置数据库用户名
3.password
设置数据库密码
4.partitionCount
设置分区个数。
这个参数默认为1，建议3-4（根据特定应用程序而定）。
为了减少锁竞争和改善性能，从当前线程分区（thread-affinity）中获取一个connection，
也就是这个样子：
partitions[Thread.currentThread（）.getId（）%partitionCount]。
当拥有充足的短期（short-lived）的线程时候，这个参数设置越大，性能越好。
当超过一定的阀值时，连接池的维护工作就可能对性能造成一定的负面影响（仅当分区上的connection使用耗尽时）。
5.maxConnectionsPerPartition
设置每个分区含有connection最大个数。
这个参数默认为2。
如果小于2，BoneCP将设置为50。
比如：
partitionCount设置为3，maxConnectionPerPartition设置为5，你就会拥有总共15个connection。
注意：
BoneCP不会将这些connection一起创建出来，而是说在需要更多connection的时候从minConnectionsPerPartition参数开始逐步地增长connection数量。
6.minConnectionsPerPartition
设置每个分区含有connection最大小个数。
这个参数默认为0。
7.acquireIncrement
设置分区中的connection增长数量。
这个参数默认为1。
当每个分区中的connection大约快用完时，BoneCP动态批量创建connection，
这个属性控制一起创建多少个connection（不会大于maxConnectionsPerPartition）。
注意：
这个配置属于每个分区的设置。
8.poolAvailabilityThreshold
设置连接池阀值。
这个参数默认为20。
如果小于0或是大于100，BoneCP将设置为20。
连接池观察线程（PoolWatchThread）试图为每个分区维护一定数量的可用connection。
这个数量趋于maxConnectionPerPartition和minConnectionPerPartition之间。
这个参数是以百分比的形式来计算的。
例如：
设置为20，下面的条件如果成立：
FreeConnections/MaxConnections换句话来说连接池为每个分区至少维持20%数量的可用connection。
设置为0时，每当需要connection的时候，连接池就要重新创建新connection，这个时候可能导致应用程序可能会为了获得新connection而小等一会。
9.connectionTimeout
设置获取connection超时的时间。
这个参数默认为Long.MAX_VALUE;单位：
毫秒。
在调用getConnection获取connection时，获取时间超过了这个参数，就视为超时并报异常。
三、BoneCP线程配置参数
1.releaseHelperThreads
设置connection助手线程个数。
这个参数默认为3。
如果小于0，BoneCP将设置为3。
设置为0时，应用程序线程被阻塞，直到连接池执行必要地清除和回收connection，并使connection在其它线程可用。
设置大于0时，连接池在每个分区中创建助手线程处理回收关闭后的connection（应用程序会通过助手线程异步地将这个connection放置到一个临时队列中进行处理）。
对于应用程序在每个connection上处理大量工作时非常有用。
可能会降低运行速度，不过在高并发的应用中会提高性能。
2.statementReleaseHelperThreads
设置statement助手线程个数。
这个参数默认为3。
如果小于0，BoneCP将设置为3。
设置为0时，应用程序线程被阻塞，直到连接池或JDBC驱动程序关闭statement。
设置大于0时，连接池会在每个分区中创建助理线程，异步地帮助应用程序关闭statement当应用程序打开了大量的statement是非常有用的。
可能会降低运行速度，不过在高并发的应用中会提高性能。
3.maxConnectionAge
设置connection的存活时间。
这个参数默认为0，单位：
毫秒。
设置为0该功能失效。
通过ConnectionMaxAgeThread观察每个分区中的connection，不管connection是否空闲，如果这个connection距离创建的时间大于这个参数就会被清除。
当前正在使用的connection不受影响，直到返回到连接池再做处理。
4.idleMaxAge
设置connection的空闲存活时间。
这个参数默认为60，单位：
分钟。
设置为0该功能失效。
通过ConnectionTesterThread观察每个分区中的connection，如果这个connection距离最后使用的时间大于这个参数就会被清除。
注意：
这个参数仅和idleConnectionTestPeriod搭配使用，而且不要在这里设置任何挑
升级会员 