通用数据库连接池-C3PO

 C3PO是一个开放源代码的JDBC数据连接池实现项目,实现了数据源和JNDI绑定，支持JDBC3规范和JDBC2的标准扩展。开源项目在使用：Hibernate，Spring，MYSQL等。

下载：

     https://sourceforge.net/projects/c3p0/files/latest/download?source=files二进制包。

目录：

   

其中的doc为说明文档，examples是自带的例子，lib是一些jar包，src是源码jar包。

简单使用实例（配置Oracle数据源）：

import java.beans.PropertyVetoException;
import java.sql.Connection;
import java.sql.SQLException;

import com.mchange.v2.c3p0.ComboPooledDataSource;
import com.mchange.v2.c3p0.DataSources;

public class Test {
    public static void main(String[] args) {
        ComboPooledDataSource cpds = new ComboPooledDataSource();
        try {
            // 数据源进行各种有效的控制：
            // 设置驱动
            cpds.setDriverClass("oracle.jdbc.driver.OracleDriver");
            // 设置数据库URL
            cpds.setJdbcUrl("jdbc:oracle:thin:@10.2.4.77:1521:ORCL");
            // 设置用户名
            cpds.setUser("**********");
            // 设置密码
            cpds.setPassword("**********");
            // 当连接池中的连接用完时，C3PO一次性创建新的连接数目;
            cpds.setAcquireIncrement(3);
            // 定义在从数据库获取新的连接失败后重复尝试获取的次数，默认为30;
            cpds.setAcquireRetryAttempts(30);
            // 两次连接中间隔时间默认为1000毫秒
            cpds.setAcquireRetryDelay(1000);
            // 连接关闭时默认将所有未提交的操作回滚 默认为false;
            cpds.setAutoCommitOnClose(false);
            // 获取连接失败将会引起所有等待获取连接的线程异常,但是数据源仍有效的保留,并在下次调用getConnection()的时候继续尝试获取连接.如果设为true,那么尝试获取连接失败后该数据源将申明已经断开并永久关闭.默认为false
            cpds.setBreakAfterAcquireFailure(false);
            // 当连接池用完时客户端调用getConnection()后等待获取新连接的时间,超时后将抛出SQLException,如设为0则无限期等待.单位毫秒,默认为0
            cpds.setCheckoutTimeout(0);
            // 隔多少秒检查所有连接池中的空闲连接,默认为0表示不检查;
            cpds.setIdleConnectionTestPeriod(0);
            // 初始化时创建的连接数,应在minPoolSize与maxPoolSize之间取值.默认为3
            cpds.setInitialPoolSize(10);
            // 最大空闲时间,超过空闲时间的连接将被丢弃.为0或负数据则永不丢弃.默认为0;
            cpds.setMaxIdleTime(0);
            // 连接池中保留的最大连接数据.默认为15
            cpds.setMaxPoolSize(20);
            // JDBC的标准参数,用以控制数据源内加载的PreparedStatement数据.但由于预缓存的Statement属于单个Connection而不是整个连接池.所以设置这个参数需要考滤到多方面的因素,如果maxStatements
            // 与maxStatementsPerConnection均为0,则缓存被关闭.默认为0;
            cpds.setMaxStatements(0);
            // 连接池内单个连接所拥有的最大缓存被关闭.默认为0;
            cpds.setMaxStatementsPerConnection(0);
            // C3P0是异步操作的,缓慢的JDBC操作通过帮助进程完成.扩展这些操作可以有效的提升性能,通过多数程实现多个操作同时被执行.默为为3
            cpds.setNumHelperThreads(3);
            // 用户修改系统配置参数执行前最多等待的秒数.默认为300;
            cpds.setPropertyCycle(300);
            // 获取数据连接
            Connection conn = cpds.getConnection();
            if ( conn != null) {
                System.out.println("OK");
                // 关闭连接,当前连接被连接池收回
                conn.close();
            }

        } catch (PropertyVetoException e) {
            e.printStackTrace();
        } catch (SQLException e) {
            e.printStackTrace();
        } finally {
            try {
                //关闭数据连接池
                DataSources.destroy(cpds);
            } catch (SQLException e) {
                e.printStackTrace();
            }
        }
    }
}

 注意除了导入c3p0-0.9.1.2.jar外还要导放log4j的包和数据库驱动包.

使用实例二：

将lib下的c3p0-0.9.5.2.jar和mchange-commons-java-0.2.11.jar导入eclipse中，并在工程的src下新建一个名为c3p0-config.xml，且内容为：

<?xml version="1.0" encoding="UTF-8"?>

<c3p0-config>

  <named-config name="mvcApp"> 

      <propertyname="user">root</property>

      <propertyname="password">123456</property>

      <propertyname="driverClass">com.mysql.jdbc.Driver</property>

      <propertyname="jdbcUrl">jdbc:mysql://localhost:3306/java</property>

<!—以上的user是数据库的用户，password是数据库的密码，driverClass是mysql的数据库驱动，jdbcUrl是连接数据库的url -->

       <!--当连接池中的连接耗尽的时候c3p0一次同时获取的连接数 -->

<propertyname="acquireIncrement">5</property>

<!--初始化时获取十个连接，取值应在minPoolSize与maxPoolSize之间 -->

<propertyname="initialPoolSize">10</property>

<!--连接池中保留的最小连接数 -->

<propertyname="minPoolSize">10</property>

<!--连接池中保留的最大连接数 -->

<propertyname="maxPoolSize">50</property>

<!--JDBC的标准参数，用以控制数据源内加载的PreparedStatements数量。但由于预缓存的statements属于单个connection而不是整个连接池。所以设置这个参数需要考虑到多方面的因素。如果maxStatements与maxStatementsPerConnection均为0，则缓存被关闭。Default: 0-->

<propertyname="maxStatements">20</property> 

<!--maxStatementsPerConnection定义了连接池内单个连接所拥有的最大缓存statements数。Default: 0 -->

<propertyname="maxStatementsPerConnection">5</property>

  </named-config>

</c3p0-config>

④在工程中新建一个JdbcUtils的工具类，代码如下：

import java.sql.Connection;

import java.sql.SQLException;

import javax.sql.DataSource;

import com.mchange.v2.c3p0.ComboPooledDataSource;

public class JdbcUtils {

       /**

        * 释放连接

        * @param connection

        */

       public staticvoid releaseConnection(Connection connection){

              try {

                     if(connection != null ) {

                            connection.close();

                     }

              }catch (Exception e) {

                     e.printStackTrace();

              }

       }

       privatestatic DataSource dataSource = null;

       static{

              //dataSource资源只能初始化一次

              dataSource= new ComboPooledDataSource("mvcApp");

       }

       /**

        * 获取连接

        * @return

        * @throws SQLException

        */

       public staticConnection getConnection() throws SQLException{

              returndataSource.getConnection();

       }

}

其中的mvcApp是c3p0-config.xml中named-config的name值。DataSource的实例使用ComboPooledDataSource来生成的，这样我们就可以创建一个连接池，从而减少数据库连接时间。

最后，c3p0相似的dbcp和proxool连接池，详见：

dbcp:：http://baike.baidu.com/view/920072.htm

proxool：http://baike.baidu.com/view/2098784.htm