BoneCP 学习笔记

桃扇骨 2022-06-07 04:00 102阅读 0赞

## 什么是BoneCP ##

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

官方网站：[http://jolbox.com/][http_jolbox.com]

## **为什么要学习BoneCP** ##

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

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

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

####    ![62b59da5-ac4e-3514-8b68-ce30e59cc0cf.jpg][] ####

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

![911d90f7-cf4a-3da8-884c-53060d771199.jpg][]

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

![1de9cac1-b28b-32fe-a4a1-5cd6d0c5a263.jpg][]

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

### **在介绍怎么使用之前，先来看看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文件里面加。

Xml代码   ![收藏代码][icon_star.png]

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了，下面应该很熟悉

Xml代码   ![收藏代码][icon_star.png]

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

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

Xml代码   ![收藏代码][icon_star.png]

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

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

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

Java代码   ![收藏代码][icon_star.png]

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.   
11. ...  do something with the connection here ...  
12.   
13. connection.close();             // close the connection  
14. connectionPool.shutdown();          // close the connection pool

## **BoneCP-Spring详细配置** ##

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

Xml代码   ![收藏代码][icon_star.png]

1.  <bean id="dataSource" class="com.jolbox.bonecp.BoneCPDataSource"  
2.          destroy-method="close">  
3.            
4.          <property name="driverClass" value="$\{aliLibrary.db.driverClass\}" />  
5.            
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.           
12.         <property name="idleConnectionTestPeriod" value="$\{aliLibrary.db.idleConnectionTestPeriod\}" />  
13.           
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.           
20.         <property name="partitionCount" value="$\{aliLibrary.db.partitionCount\}" />  
21.           
22.         <property name="acquireIncrement" value="$\{aliLibrary.db.acquireIncrement\}" />  
23.           
24.         <property name="statementsCacheSize" value="$\{aliLibrary.db.statementsCacheSize\}" />  
25.           
26.         <property name="releaseHelperThreads" value="$\{aliLibrary.db.releaseHelperThreads\}" />  
27.     </bean>

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

Java代码   ![收藏代码][icon_star.png]

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的配置参数，很清楚，关闭的时候也有日志输出。

Java代码   ![收藏代码][icon_star.png]

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.

[http_jolbox.com]: http://jolbox.com/
[Link 1]: http://jolbox.com/bonecp/downloads/maven/com/jolbox/bonecp/0.6.7.2/
[62b59da5-ac4e-3514-8b68-ce30e59cc0cf.jpg]: /images/20220607/d205bd70dcce46dd9d4e8811b63adaa8.png
[911d90f7-cf4a-3da8-884c-53060d771199.jpg]: /images/20220607/2535646e1f4e491993107b2171fab67b.png
[1de9cac1-b28b-32fe-a4a1-5cd6d0c5a263.jpg]: /images/20220607/ecdb134615c54bc7bdf7bd386118ddf6.png
[Link 2]: http://jolbox.com/benchmarks.html
[Features]: http://jolbox.com/features.html
[icon_star.png]: /images/20220607/d8f6b1b071e6402985034bd3324b23da.png
[Link 3]: http://jolbox.com/download.html