BoneCP学习笔记

什么是BoneCP

BoneCP 是一个快速、免费而且开源的java数据库连接池(JDBC Pool)管理工具库。如果你曾经使用过C3P0或者DBCP，那你肯定知道上面这句话的意思；如果你没用过这些，那简单的解释一下，它是一个能为你的应用管理数据库连接的工具。

官方网站：http://jolbox.com/

为什么要学习BoneCP

本着不重复发明轮子的原则，不应该在有了C3P0这种成熟的数据库连接池管理工具后再搞个新的出来，但是传说中BoneCP在快速这个特点上做到了极致，官方数据是C3P0等的25倍左右。不相信？其实我也不怎么信，正找时间自己写测试类测试呢，你也可以去试试看， 在这里下载 （现在最新版本0.6.7.2，如果你有困难，下面会具体提到在项目中怎么配置）

好吧，先看一下官方给出的华丽数据：

1.    单线程（1,000,000获得及释放数据库连接请求，连接池大小20-50）

 2.    多线程（500线程分别获取释放100个链接，连接池大小50-200）

3.    Prepared Statement (multi-threaded)（500个线程每个100次获得/释放，连接池大小20-500）

这里只应用了部分，还有其他比较多的测试数据，有兴趣就去这里 瞧瞧吧。个人还是建议自己写点代码测试一下，那样感受更深啊。

 

在介绍怎么使用之前，先来看看BoneCP的特性（Features ）：

• 高度可扩展, 快速的连接池.    注：1）不用synchronized 关键字来处理多线程对资源的争用，而是使用 java.util.concurrent 包中的锁机制；2）首次使用分区机制来分开管理数据库连接；或许还有其他原因.

• Callback (hook interceptor) mechanisms on a change of connection state.

• 利用分区技术提高性能

• 允许直接访问一个连接或者语句

• 智能调整连接池大小

• SQL语句缓存支持

• 支持异步获取数据库连接 (通过返回Future<Connection>的形式)

• 通过释放连接助理进程来释放数据库连接，提高性能.

• 通过initSQL参数在每次获取连接的时候执行SQL

• 支持数据库热切换

• 自动重试失败的数据库操作（当数据库或者网络挂掉的时候）

• JMX support

• 延迟初始化能力(Lazy initialization capable)

• 自动检测连接可用性 (keep-alives 等)

• 允许直接通过数据源而不是通过驱动来获取一个新的数据库连接（Allow obtaining of new connections via a datasource rather than via a Driver）

• Datasource/Hibernate support capable

• Debug支持准确地高亮那些已经得到但是还没有关闭的链接(Debugging hooks to highlight the exact place where a connection was obtained but not closed)

• Debug支持展示那些被关闭两次的链接地址堆栈信息(Debugging support to show stack locations of connections that were closed twice. )

• 支持自定义连接池名称.

• 干净的代码结构，TestCase代码覆盖率达到100% (over 125 JUnit tests).

• 免费的，开源的而且都是用java干的，最重要的是有很完整的javadocs支持。(Free, open source and written in 100% pure Java with complete Javadocs).

      本人鸟语有限，有些翻译不是很好，请见谅

 

好了，废话说的挺多的，看看到底怎么用吧。

怎么使用BoneCP

 

我是Maven的忠实拥护者，如果你也是，那就简单了：
你可以在你的settings.xml文件里加上下面一段，声明一个Maven仓库，如果你不想影响其他项目，那也可以在你项目的pom.xml文件里面加。

[xhtml]  view plain copy

1. <repositories>  
2.     <repository>  
3.         <releases>  
4.             <enabled>true</enabled>  
5.         </releases>  
6.         <id>bonecp-repo</id>  
7.         <name>BoneCP Repository</name>  
8.         <url>http://jolbox.com/bonecp/downloads/maven</url>  
9.     </repository>  
10. </repositories>  

然后你就可以像引用其他jar包一样引用bonecp了，下面应该很熟悉

[xhtml]  view plain copy

1. <dependency>  
2.     <groupId>com.jolbox</groupId>  
3.     <artifactId>bonecp</artifactId>  
4.     <version>0.6.7.2</version>  
5. </dependency>  

 如果你的项目直接用类似Hibernate的东东，没有配置dataSource的话，你很牛，那就加上下面这个吧
 

[xhtml]  view plain copy

1. <dependency>  
2.     <groupId>com.jolbox</groupId>  
3.     <artifactId>bonecp-provider</artifactId>  
4.     <version>0.6.7.2</version>  
5. </dependency>  

 如果这些都没有满足你,那参考这里 吧。

 

如果你不用Spring，那应该是这样写吧：

[java]  view plain copy

1. Class.forName("org.hsqldb.jdbcDriver");     // load the DB driver  
2. BoneCPConfig config = new BoneCPConfig();   // create a new configuration object  
3. config.setJdbcUrl("jdbc:hsqldb:mem:test");  // set the JDBC url  
4. config.setUsername("sa");           // set the username  
5. config.setPassword("");             // set the password  
6. config.setXXXX(...);                // (other config options here)  
7. BoneCP connectionPool = new BoneCP(config);     // setup the connection pool  
8. Connection connection;  
9. connection = connectionPool.getConnection();    // fetch a connection  
10. ...  do something with the connection here ...  
11. connection.close();             // close the connection  
12. connectionPool.shutdown();          // close the connection pool  

  

BoneCP-Spring详细配置

主要讲一下在Spring下面怎么配置，其实更简单，只要配置dataSrouce就可以搞定。如下，具体含义见注释。

[xhtml]  view plain copy

1. <bean id="dataSource" class="com.jolbox.bonecp.BoneCPDataSource"  
2.         destroy-method="close">  
3.         <!-- 数据库驱动 -->  
4.         <property name="driverClass" value="${aliLibrary.db.driverClass}" />  
5.         <!-- 相应驱动的jdbcUrl,你懂的 -->  
6.         <property name="jdbcUrl" value="${aliLibrary.db.jdbcUrl}" />  
7.         <!-- 数据库的用户名 -->  
8.         <property name="username" value="${aliLibrary.db.username}" />  
9.         <!-- 数据库的密码 -->  
10.         <property name="password" value="${aliLibrary.db.password}" />  
11.         <!-- 检查数据库连接池中空闲连接的间隔时间，单位是分，默认值：240，如果要取消则设置为0 -->  
12.         <property name="idleConnectionTestPeriod" value="${aliLibrary.db.idleConnectionTestPeriod}" />  
13.         <!-- 连接池中未使用的链接最大存活时间，单位是分，默认值：60，如果要永远存活设置为0 -->  
14.         <property name="idleMaxAge" value="${aliLibrary.db.idleMaxAge}" />  
15.         <!-- 每个分区最大的连接数 -->  
16.         <property name="maxConnectionsPerPartition" value="${aliLibrary.db.maxConnectionsPerPartition}" />  
17.         <!-- 每个分区最小的连接数 -->  
18.         <property name="minConnectionsPerPartition" value="${aliLibrary.db.minConnectionsPerPartition}" />  
19.         <!-- 分区数 ，默认值2，最小1，推荐3-4，视应用而定-->  
20.         <property name="partitionCount" value="${aliLibrary.db.partitionCount}" />  
21.         <!-- 每次去拿数据库连接的时候一次性要拿几个,默认值：2 -->  
22.         <property name="acquireIncrement" value="${aliLibrary.db.acquireIncrement}" />  
23.         <!-- 缓存prepared statements的大小，默认值：0 -->  
24.         <property name="statementsCacheSize" value="${aliLibrary.db.statementsCacheSize}" />  
25.         <!-- 每个分区释放链接助理进程的数量，默认值：3，除非你的一个数据库连接的时间内做了很多工作，不然过多的助理进程会影响你的性能 -->  
26.         <property name="releaseHelperThreads" value="${aliLibrary.db.releaseHelperThreads}" />  
27.     </bean>  

 其他还有些不是很常用的包括：
 

[java]  view plain copy

1. connectionTestStatement：在做keep-alive的时候的SQL语句。  
2. statementsCachedPerConnection：No of statements that can be cached per connection，反正源码中不推荐使用，就别用了.  
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：Connection hook class name.没看懂…  
11. poolName：上面特性中说到的自定义连接池名称。  
12. disableJMX：控制JMX的支持开关。  
13. connectionTimeout：获取连接的时候最大的等待时间，默认值为：Long.MAX_VALUE  

  Spring里面怎么用这个dataSource就不说了吧，今天重点在BoneCP。

 

最后跑一个TestCase，看看日志

初始化的时候打印出BoneCP的配置参数，很清楚，关闭的时候也有日志输出。

[xhtml]  view plain copy

1. 2010-08-02 15:10:22,457 [BoneCPDataSource.java:121] [com.jolbox.bonecp.BoneCPDataSource] DEBUG com.jolbox.bonecp.BoneCPDataSource :: JDBC URL = jdbc:mysql://10.249.128.109:3306/ali_library, Username = root, partitions = 3, max (per partition) = 3, min (per partition) = 3, helper threads = 3, idle max age = 240 min, idle test period = 30 min  
2. 2010-08-02 15:10:22,457 [BoneCPDataSource.java:121] [com.jolbox.bonecp.BoneCPDataSource] DEBUG com.jolbox.bonecp.BoneCPDataSource :: JDBC URL = jdbc:mysql://10.249.128.109:3306/ali_library, Username = root, partitions = 3, max (per partition) = 3, min (per partition) = 3, helper threads = 3, idle max age = 240 min, idle test period = 30 min  
3. 2010-08-02 15:10:45,958 [BoneCP.java:129] [com.jolbox.bonecp.BoneCP] INFO  com.jolbox.bonecp.BoneCP :: Shutting down connection pool...  
4. 2010-08-02 15:10:45,958 [BoneCP.java:129] [com.jolbox.bonecp.BoneCP] INFO  com.jolbox.bonecp.BoneCP :: Shutting down connection pool...  
5. 2010-08-02 15:10:45,973 [BoneCP.java:145] [com.jolbox.bonecp.BoneCP] INFO  com.jolbox.bonecp.BoneCP :: Connection pool has been shutdown.  
6. 2010-08-02 15:10:45,973 [BoneCP.java:145] [com.jolbox.bonecp.BoneCP] INFO  com.jolbox.bonecp.BoneCP :: Connection pool has been shutdown.   

 

二、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，下面的条件如果成立：Free Connections / MaxConnections < poolAvailabilityThreshold；就会创建出新的connection。 
换句话来说连接池为每个分区至少维持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搭配使用，而且不要在这里设置任何挑衅的参数！ 
5.idleConnectionTestPeriod 
设置测试connection的间隔时间。这个参数默认为240，单位：分钟。设置为0该功能失效。 
通过ConnectionTesterThread观察每个分区中的connection， 如果这个connection距离最后使用的时间大于这个参数并且距离上一次测试的时间大于这个参数就会向数据库发送一条测试语句，如果执行失败则将这个connection清除。 
注意：这个值仅和idleMaxAge搭配使用，而且不要在这里设置任何挑衅的参数！ 

三、BoneCP可选配置参数 
1.acquireRetryAttempts 
设置重新获取连接的次数。这个参数默认为5。 
获取某个connection失败之后会多次尝试重新连接，如果在这几次还是失败则放弃。 
2.acquireRetryDelay 
设置重新获取连接的次数间隔时间。这个参数默认为7000，单位：毫秒。如果小于等于0，BoneCP将设置为1000。 
获取connection失败之后再次尝试获取connection的间隔时间。 
3.lazyInit 
设置连接池初始化功能。这个参数默认为false。 
设置为true，连接池将会初始化为空，直到获取第一个connection。 
4.statementsCacheSize 
设置statement缓存个数。这个参数默认为0。 
5.disableJMX 
设置是否关闭JMX功能。这个参数默认为false。 
6.poolName 
设置连接池名字。用于当作JMX和助手线程名字的后缀。 

四、BoneCP调试配置参数 
1.closeConnectionWatch 
设置是开启connection关闭情况监视器功能。这个参数默认为false。 
每当调用getConnection()时，都会创建CloseThreadMonitor，监视connection有没有关闭或是关闭了两次。警告：这个参数对连接池性能有很大的负面影响，慎用！仅在调试阶段使用！ 
2.closeConnectionWatchTimeout 
设置关闭connection监视器（CloseThreadMonitor）持续多长时间。这个参数默认为0；单位：毫秒。仅当closeConnectionWatch参数设置为可用时，设置这个参数才会起作用。 
设置为0时，永远不关闭。 
3.logStatementsEnabled 
设置是否开启记录SQL语句功能。这个参数默认是false。 
将执行的SQL记录到日志里面（包括参数值）。 
4.queryExecuteTimeLimit 
设置执行SQL的超时时间。这个参数默认为0；单位：毫秒。 
当查询语句执行的时间超过这个参数，执行的情况就会被记录到日志中。 
设置为0时，该功能失效。 
5.disableConnectionTracking 
设置是否关闭connection跟踪功能。这个参数默认为false。 
设置为true，连接池则不会监控connection是否严格的关闭；设置为false，则启用跟踪功能（仅追踪通过Spring或一些事务管理等机制确保正确释放connection并放回到连接池中）。 
6.transactionRecoveryEnabled 
设置事务回放功能。这个参数默认为false。 
设置为true时，MemorizeTransactionProxy可以记录所有在connection上操作的情况，当connetion操作失败的时候会自动回放先前的操作，如果在回放期间还是失败，则抛出异常。注意：这个功能会使连接池微弱地降低运行速度。