Java中的BoneCP數據庫連接池用法

在2006年8月的時候我在項目中使用過Proxool這個Java數據庫連接池，在當時的使用過程中遇到了一些問題，爲此曾寫過一篇名爲《關於Proxool使用的一點問題》的博客，網址是http://blog.csdn.net/zhoufoxcn/archive/2006/08/30/1142685.aspx，博文發佈以後有很多朋友在博文下面留言，因爲它們也遇到了類似的問題。我記得我在2006年使用Proxool的時候版本就已經是0.8.3了，最近在Hibernate中發現它也帶了這個Java數據庫連接池實現，它的版本依然是0.8.3，應該是這些年來沒有更新了。前些天研究一個項目的時候發現了項目中使用了BoneCP這個Java的數據庫連接池，抱着好奇的態度學習了一下，覺得還不錯，所以寫了這篇博文跟大家分享一下。BoneCP也是一個開源的Java數據庫連接池，它的官方網站網址是：http://jolbox.com/。
據BoneCP網站官方報告稱，BoneCP比性能排名第二的Java數據庫連接池性高高25倍以上，並且支持Hibernate和DataNucleus這樣的數據持久框架（當然支持JDBC這種直接方式了）。

• 使用BoneCP的必備條件

使用BoneCP需要如下類庫支持：
被連接的數據庫的JDBC驅動程序，這個可以到該數據庫廠商網站下載；
Google的集合框架Guava，它的網址是：http://code.google.com/p/guava-libraries/，這個需要說明的是BoneCP官方網站說的必備框架是Google Collect框架，但是這個框架已經不再支持了，而是轉爲新的集合框架Guava；
SLF4J日誌類庫（在早期的BoneCP版本中直接使用了Log4J類庫）；
JDK1.5及更高版本。
下面是測試項目中的類庫截圖：
 

也就是需要了如下Jar包：
bonecp-0.7.0.jar
mysql-connector-java-5.1.13-bin.jar
slf4j-log4j12-1.6.1.jar
slf4j-api-1.6.1.jar
log4j-1.2.16.jar
guava-r07.jar
爲了得到比較詳細的運行過程信息，需要添加一個log4j的配置文件log4j.properties，log4j.properties的文件位置如上圖，文件內容如下：
 

#log4j.rootLogger=DEBUG,CONSOLE,A1,im
log4j.rootLogger=DEBUG,CONSOLE
log4j.addivity.org.apache=true
# 應用於控制檯
log4j.appender.CONSOLE=org.apache.log4j.ConsoleAppender
log4j.appender.Threshold=DEBUG
log4j.appender.CONSOLE.Target=System.out
log4j.appender.CONSOLE.layout=org.apache.log4j.PatternLayout
log4j.appender.CONSOLE.layout.ConversionPattern=[framework] %d - %c -%-4r [%t] %-5p %c %x - %m%n
#log4j.appender.CONSOLE.layout.ConversionPattern=[start]%d{DATE}[DATE]%n%p[PRIORITY]%n%x[NDC]%n%t[THREAD] n%c[CATEGORY]%n%m[MESSAGE]%n%n
#應用於文件
#log4j.appender.FILE=org.apache.log4j.FileAppender
#log4j.appender.FILE.File=file.log
#log4j.appender.FILE.Append=false
#log4j.appender.FILE.layout=org.apache.log4j.PatternLayout
#log4j.appender.FILE.layout.ConversionPattern=[framework] %d - %c -%-4r [%t] %-5p %c %x - %m%n
# Use this layout for LogFactor 5 analysis
# 應用於文件回滾
# log4j.appender.ROLLING_FILE=org.apache.log4j.RollingFileAppender
# log4j.appender.ROLLING_FILE.Threshold=ERROR
# log4j.appender.ROLLING_FILE.File=rolling.log  //????,??????${java.home}?rolling.log
# log4j.appender.ROLLING_FILE.Append=true       //true\:??  false\:??
# log4j.appender.ROLLING_FILE.MaxFileSize=10KB   //??????
# log4j.appender.ROLLING_FILE.MaxBackupIndex=1  //???
# log4j.appender.ROLLING_FILE.layout=org.apache.log4j.PatternLayout
# log4j.appender.ROLLING_FILE.layout.ConversionPattern=[framework] %d - %c -%-4r [%t] %-5p %c %x - %m%n
#應用於socket
#log4j.appender.SOCKET=org.apache.log4j.RollingFileAppender
#log4j.appender.SOCKET.RemoteHost=localhost
#log4j.appender.SOCKET.Port=5001
#log4j.appender.SOCKET.LocationInfo=true
# Set up for Log Facter 5
#log4j.appender.SOCKET.layout=org.apache.log4j.PatternLayout
#log4j.appender.SOCET.layout.ConversionPattern=[start]%d{DATE}[DATE]%n%p[PRIORITY]%n%x[NDC]%n%t[THREAD]%n%c[CATEGORY]%n%m[MESSAGE]%n%n
# Log Factor 5 Appender
#log4j.appender.LF5_APPENDER=org.apache.log4j.lf5.LF5Appender
#log4j.appender.LF5_APPENDER.MaxNumberOfRecords=2000
# 發送日誌給郵件
#log4j.appender.MAIL=org.apache.log4j.net.SMTPAppender
#log4j.appender.MAIL.Threshold=FATAL
#log4j.appender.MAIL.BufferSize=10

#log4j.appender.MAIL.To\[email protected]

#log4j.appender.MAIL.SMTPHost=www.wusetu.com
#log4j.appender.MAIL.Subject=Log4J Message

#log4j.appender.MAIL.layout=org.apache.log4j.PatternLayout
#log4j.appender.MAIL.layout.ConversionPattern=[framework] %d - %c -%-4r [%t] %-5p %c %x - %m%n
# 用於數據庫
log4j.appender.DATABASE=org.apache.log4j.jdbc.JDBCAppender
log4j.appender.DATABASE.URL=jdbc:mysql://localhost:3306/test
log4j.appender.DATABASE.driver=com.mysql.jdbc.Driver
log4j.appender.DATABASE.user=root
log4j.appender.DATABASE.password=jeri
log4j.appender.DATABASE.sql=INSERT INTO LOG4J (Message) VALUES ('[framework] %d - %c -%-4r [%t] %-5p %c %x - %m%n')
log4j.appender.DATABASE.layout=org.apache.log4j.PatternLayout
log4j.appender.DATABASE.layout.ConversionPattern=[framework] %d - %c -%-4r [%t] %-5p %c %x - %m%n
#log4j.appender.A1=org.apache.log4j.DailyRollingFileAppender
#log4j.appender.A1.File=SampleMessages.log4j
#log4j.appender.A1.DatePattern=yyyyMMdd-HH'.log4j'
#log4j.appender.A1.layout=org.apache.log4j.xml.XMLLayout
#自定義Appender
#log4j.appender.im = net.cybercorlin.util.logger.appender.IMAppender
#log4j.appender.im.host = mail.cybercorlin.net
#log4j.appender.im.username = username
#log4j.appender.im.password = password
#log4j.appender.im.recipient = [email protected]

#log4j.appender.im.layout=org.apache.log4j.PatternLayout
#log4j.appender.im.layout.ConversionPattern =[framework] %d - %c -%-4r [%t] %-5p %c %x - %m%n

 

• 在JDBC中使用BoneCP

在JDBC中使用BoneCP相當簡單，設置一些關於數據庫連接池的參數信息，比如連接池的最大、最小連接數等。下面是一個簡單的例子：
 

package com.netskycn;
import java.sql.Connection;
import java.sql.ResultSet;
import java.sql.SQLException;
import java.sql.Statement;

import com.jolbox.bonecp.BoneCP;
import com.jolbox.bonecp.BoneCPConfig;

/** 測試bonecp數據庫連接池的工具
 * @author zhoufoxcn 周公
 * @version 0.1
 * 說明：這是一個在JDBC中使用BoneCP的例子
 * 2010-11-23
 */
public class MainClass {
    public static void main(String[] args) {
        BoneCP connectionPool = null;
        Connection connection = null;

        try {
            //加載JDBC驅動
            Class.forName("com.mysql.jdbc.Driver");
        } catch (Exception e) {
            e.printStackTrace();
            return;
        }

        try {
            //設置連接池配置信息
            BoneCPConfig config = new BoneCPConfig();
            //數據庫的JDBC URL
            config.setJdbcUrl("jdbc:mysql:///jobeet");
            //數據庫用戶名
            config.setUsername("root");
            //數據庫用戶密碼
            config.setPassword("jeri");
            //數據庫連接池的最小連接數
            config.setMinConnectionsPerPartition(5);
            //數據庫連接池的最大連接數
            config.setMaxConnectionsPerPartition(10);
            //
            config.setPartitionCount(1);
            //設置數據庫連接池
            connectionPool = new BoneCP(config);
            //從數據庫連接池獲取一個數據庫連接
            connection = connectionPool.getConnection(); // fetch a connection

            if (connection != null){
                System.out.println("Connection successful!");
                Statement stmt = connection.createStatement();
                ResultSet rs = stmt.executeQuery("SELECT * FROM customer");
                while(rs.next()){
                    System.out.println(rs.getInt(1)+":"+rs.getString("firstname")+","+rs.getString("lastname"));
                }
            }
            //關閉數據庫連接池
            connectionPool.shutdown();
        } catch (SQLException e) {
            e.printStackTrace();
        } finally {
            if (connection != null) {
                try {
                    connection.close();
                } catch (SQLException e) {
                    e.printStackTrace();
                }
            }
        }
    }
}

這個例子相當簡單，但是是利用BoneCP提供的連接池而不是直接使用JDBC來管理連接的。

• 使用DataSource

使用DataSource的話，代碼如下：
 

//加載數據庫驅動
Class.forName("com.mysql.jdbc.Driver");
//創建一個DataSource對象
BoneCPDataSource ds = new BoneCPDataSource();
//設置JDBC URL
ds.setJdbcUrl("jdbc:mysql:///jobeet");
//設置用戶名
ds.setUsername("sa");
//設置密碼
ds.setPassword("jeri");
//下面的代碼是設置其它可選屬性
//ds.setXXXX(...);

Connection connection;
connection = ds.getConnection();

//這裏操作數據庫
//...
//關閉數據庫連接
connection.close();
ds.close();

 

• 在Hibernate中使用BoneCP

在Hibernate中使用BoneCP除了需要上面提到的jar包之外，還需要下載一個名爲bonecp-provider-0.7.0.jar的bonecp-provider的jar包，它的下載位置是：http://jolbox.com/bonecp/downloads/maven/com/jolbox/bonecp-provider/0.7.0/bonecp-provider-0.7.0.jar。
除此之外，還需要做如下配置：
 

<!-- Hibernate SessionFactory -->
<bean id="sessionFactory" class="org.springframework.orm.hibernate.LocalSessionFactoryBean" autowire="autodetect">
    <property name="hibernateProperties">
        <props>
            <prop key="hibernate.connection.provider_class">com.jolbox.bonecp.provider.BoneCPConnectionProvider</prop>
            <prop key="hibernate.connection.driver_class">com.mysql.jdbc.Driver</prop>
            <prop key="hibernate.connection.url">jdbc:mysql://127.0.0.1/yourdb</prop>
            <prop key="hibernate.connection.username">root</prop>
            <prop key="hibernate.connection.password">abcdefgh</prop>
            <prop key="bonecp.idleMaxAge">240</prop>
            <prop key="bonecp.idleConnectionTestPeriod">60</prop>
            <prop key="bonecp.partitionCount">3</prop>
            <prop key="bonecp.acquireIncrement">10</prop>
            <prop key="bonecp.maxConnectionsPerPartition">60</prop>
            <prop key="bonecp.minConnectionsPerPartition">20</prop>
            <prop key="bonecp.statementsCacheSize">50</prop>
            <prop key="bonecp.releaseHelperThreads">3</prop>
        </props>
    </property>
</bean>

這樣就可以在Hibernate中使用BoneCP了。

周公沒有真實去測試BoneCP的性能，個人覺得它的用法確實比較簡單，並且和不再維護的Proxool相比至少它還在一直更新和維護，不失爲一個不錯的備選方案。附件是本文提到的一些必備的jar包。