C3P0连接池使用教程

 转载请注明原文地址：http://www.cnblogs.com/ygj0930/p/6405861.html

 在项目中的应用见： https://github.com/ygj0930/CoupleSpace

    一般我们在项目中操作数据库时，都是每次需要操作数据库就建立一个连接，操作完成后释放连接。因为jdbc没有保持连接的能力，一旦超过一定时间没有使用（大约几百毫秒），连接就会被自动释放掉。而每次新建连接都需要140毫秒左右的时间，所以耗费时间比较多。若使用C3P0连接池来池化连接，随时取用，则平均每次取用只需要10-20毫秒。这在高并发随机访问数据库的时候对效率的提升有很大帮助。

    C3P0连接池会根据你的配置来初始化N个数据库连接，空闲T时间后连接过期又会自动新建K个连接使得连接池总有空闲的数据库连接等待被取用。我们只需通过dataSourse.getConnection()即可从线程池中取用一个已经连接好的空闲连接，执行数据库操作。然后“断开”（放回）这个连接，把这个连接的使用权放回连接池。真正的数据库连接的创建与释放是由C3P0在后台自动完成的，我们花的只是取用与释放占用权的时间。全程耗时10+毫秒，比原来提高了几十倍。

    下面介绍一种C3P0的三层式使用。与一般的C3P0使用方式不同，三层式把数据库操作分为了三部分：C3P0操作类C3P0Utils、封装了一次数据库操作的VO对象DBUtils_BO、数据库操作类DBUtils。下面一一讲解：

    一：C3P0Utils：负责从连接池获取一个连接、放回一个连接。

    这里主要是C3P0连接池的使用。步骤如下:

    1：下载C3P0工具包：  https://sourceforge.net/projects/c3p0/files/latest/download?source=files

    解压出来后得到3个jar包，导入你的项目中。

    2：对C3P0连接池进行配置。

    主要包括：初始化连接池时建立多少个连接、连接池最少多少个连接最多容纳多少连接、每个连接的生存时间、连接池能同时允许多少个操作进行，以及对具体数据库连接的配置：数据库的驱动、数据库的URL、数据库登录名、数据库密码、对这个数据库的连接池的细化配置（比如初始化时建立多少连接，最多最少连接数等等）。一个数据库的连接池配置用一个<named-config name="标识"> </name-config>节点来定义。在C3P0Utils中创建连接池时把  “标识”  作为连接池的构造函数的参数传入，则C3P0在配置文件中找到同名节点，按照这个节点的配置来创建相应配置的连接池。配置步骤如下：

    在src目录下新建一个名叫  c3p0-config.xml  的文件，注意，必须是这个文件名。

    然后在这个文件中进行配置上面讲到的各项：

<?xml version="1.0" encoding="UTF-8"?>
<c3p0-config>
   <!--默认配置-->
    <default-config>  
        <property name="initialPoolSize">10</property>  
        <property name="maxIdleTime">30</property>  
        <property name="maxPoolSize">100</property>  
        <property name="minPoolSize">10</property>  
        <property name="maxStatements">200</property>  
    </default-config>  
  
   <!--配置连接池mysql-->
    <named-config name="mysql">  
        <property name="driverClass">com.mysql.jdbc.Driver</property>  
        <property name="jdbcUrl">jdbc:mysql://localhost:3306/CoupleSpace</property>  
        <property name="user">root</property>  
        <property name="password">root</property>  
        <property name="initialPoolSize">10</property>  
        <property name="maxIdleTime">30</property>  
        <property name="maxPoolSize">100</property>  
        <property name="minPoolSize">10</property>  
        <property name="maxStatements">200</property>  
    </named-config>  
    
    <!--配置连接池2-->
    ......
    <!--配置连接池3-->
    ......
    <!--配置连接池4-->
    ......
</c3p0-config>

    更细致化的有以下配置：

<!--acquireIncrement：链接用完了自动增量3个。 -->
    <property name="acquireIncrement">3</property>

    <!--acquireRetryAttempts：链接失败后重新试30次。-->
    <property name="acquireRetryAttempts">30</property>
 
    <!--acquireRetryDelay；两次连接中间隔1000毫秒。 -->
    <property name="acquireRetryDelay">1000</property>
 
    <!--autoCommitOnClose：连接关闭时默认将所有未提交的操作回滚。 -->
    <property name="autoCommitOnClose">false</property>
 
    <!--automaticTestTable：c3p0测试表，没什么用。-->
    <property name="automaticTestTable">Test</property>
 
    <!--breakAfterAcquireFailure：出错时不把正在提交的数据抛弃。-->
    <property name="breakAfterAcquireFailure">false</property>
 
    <!--checkoutTimeout：100毫秒后如果sql数据没有执行完将会报错，如果设置成0，那么将会无限的等待。 --> 
    <property name="checkoutTimeout">100</property>
 
    <!--connectionTesterClassName：通过实现ConnectionTester或QueryConnectionTester的类来测试连接。类名需制定全路径。Default: com.mchange.v2.c3p0.impl.DefaultConnectionTester-->
    <property name="connectionTesterClassName"></property>
 
    <!--factoryClassLocation：指定c3p0 libraries的路径，如果（通常都是这样）在本地即可获得那么无需设置，默认null即可。-->
    <property name="factoryClassLocation">null</property>
 
    <!--forceIgnoreUnresolvedTransactions：作者强烈建议不使用的一个属性。--> 
    <property name="forceIgnoreUnresolvedTransactions">false</property>
 
    <!--idleConnectionTestPeriod：每60秒检查所有连接池中的空闲连接。--> 
    <property name="idleConnectionTestPeriod">60</property>
 
    <!--initialPoolSize：初始化时获取三个连接，取值应在minPoolSize与maxPoolSize之间。 --> 
    <property name="initialPoolSize">3</property>
 
    <!--maxIdleTime：最大空闲时间,60秒内未使用则连接被丢弃。若为0则永不丢弃。-->
    <property name="maxIdleTime">60</property>
 
    <!--maxPoolSize：连接池中保留的最大连接数。 -->
    <property name="maxPoolSize">15</property>
 
    <!--maxStatements：最大链接数。-->
    <property name="maxStatements">100</property>
 
    <!--maxStatementsPerConnection：定义了连接池内单个连接所拥有的最大缓存statements数。Default: 0  -->
    <property name="maxStatementsPerConnection"></property>
 
    <!--numHelperThreads：异步操作，提升性能通过多线程实现多个操作同时被执行。Default: 3--> 
    <property name="numHelperThreads">3</property>
 
    <!--overrideDefaultUser：当用户调用getConnection()时使root用户成为去获取连接的用户。主要用于连接池连接非c3p0的数据源时。Default: null--> 
    <property name="overrideDefaultUser">root</property>
 
    <!--overrideDefaultPassword：与overrideDefaultUser参数对应使用的一个参数。Default: null-->
    <property name="overrideDefaultPassword">password</property>
 
    <!--password：密码。Default: null--> 
    <property name="password"></property>
 
    <!--preferredTestQuery：定义所有连接测试都执行的测试语句。在使用连接测试的情况下这个一显著提高测试速度。注意： 测试的表必须在初始数据源的时候就存在。Default: null-->
    <property name="preferredTestQuery">select id from test where id=1</property>
 
    <!--propertyCycle：用户修改系统配置参数执行前最多等待300秒。Default: 300 --> 
    <property name="propertyCycle">300</property>
 
    <!--testConnectionOnCheckout：因性能消耗大请只在需要的时候使用它。Default: false -->
    <property name="testConnectionOnCheckout">false</property>
 
    <!--testConnectionOnCheckin：如果设为true那么在取得连接的同时将校验连接的有效性。Default: false -->
    <property name="testConnectionOnCheckin">true</property>
 
    <!--user：用户名。Default: null-->
    <property name="user">root</property>
 
    <!--usesTraditionalReflectiveProxies：动态反射代理。Default: false-->
    <property name="usesTraditionalReflectiveProxies">false</property>

 （另：有人试过用properties文件来配置C3P0，通过setProperties（properties）方法并不能成功设置连接池的属性，而需要一条条属性去设置setXXX(properties.get(XX))才能成功设置。我的理解是：连接池本身有一个属性叫做properties，然后调用setProperties()方法只是把配置文件赋值给了连接池的properties属性而已，而不是读取这个配置文件并把这个配置文件中的key-value对提取出来并set给连接池的相应属性。所以，还需要手动加载这个文件，并且逐条属性去设置给连接池。而我们这里用xml文件去配置的话，C3P0创建连接池时是自动根据这个文件的配置去创建的，所以配置生效。）

    3:创建C3P0Utils类，定义获取connection、释放connection的方法

public class C3p0Utils {
    static org.apache.log4j.Logger logger=org.apache.log4j.Logger.getLogger(C3p0Utils.class.getName());
    
    //通过标识名来创建相应连接池
    static ComboPooledDataSource dataSource=new ComboPooledDataSource("mysql");
    //从连接池中取用一个连接
    public static Connection getConnection(){
        try {
            return dataSource.getConnection();
            
        } catch (Exception e) {
            logger.error("Exception in C3p0Utils!", e);
            throw new MyError("数据库连接出错!", e);            
        }
    }    
    //释放连接回连接池
     public static void close(Connection conn,PreparedStatement pst,ResultSet rs){  
            if(rs!=null){  
                try {  
                    rs.close();  
                } catch (SQLException e) {  
                    logger.error("Exception in C3p0Utils!", e);
                    throw new MyError("数据库连接关闭出错!", e);            
                }  
            }  
            if(pst!=null){  
                try {  
                    pst.close();  
                } catch (SQLException e) {  
                    logger.error("Exception in C3p0Utils!", e);
                    throw new MyError("数据库连接关闭出错!", e);    
                }  
            }  
      
            if(conn!=null){  
                try {  
                    conn.close();  
                } catch (SQLException e) {  
                    logger.error("Exception in C3p0Utils!", e);
                    throw new MyError("数据库连接关闭出错!", e);    
                }  
            }  
        }  
}

    二：创建DBUtils_BO类来封装一次数据库操作

    BO类中主要封装了一个数据库连接、一个Statement/PreStatement（推荐，更安全）、一个结果集。这样，在DAO层的一次数据库操作就可封装在这个bo对象里，直接把这个对象传给数据库操作类执行数据库操作即可。操作完成后的结果集也封装在了这个bo对象里，在需要提取结果的地方通过这个bo对象的rs字段进行结果提取即可。

public class DBUtil_BO {   
    public Connection conn = null;
    public PreparedStatement st = null;
    public ResultSet rs = null;
    public DBUtil_BO() {
        super();
    }    
}

   三：创建DBUtils数据库操作类进行具体的数据库操作

   数据库操作类主要负责执行数据库操作封装类bo对象的操作以及释放连接回连接池，并把结果封装回bo对象。

public class DBUtils {
     static org.apache.log4j.Logger logger=org.apache.log4j.Logger.getLogger(DBUtils.class.getName());
     
     
     private static void realseSource( Connection _conn, PreparedStatement _st,ResultSet _rs){        
            C3p0Utils.close(_conn,_st,_rs);
        }

        public static void realseSource(DBUtil_BO _vo){    
            if(_vo!=null){
                realseSource(_vo.conn, _vo.st, _vo.rs);
            }        
        }
        //注意：查询操作完成后，因为还需提取结果集中信息，所以仍保持连接，在结果集使用完后才通过DBUtils.realseSource()手动释放连接
        public static void executeQuery(DBUtil_BO vo)
        {        
            try{
                vo.rs = vo.st.executeQuery();
            }catch (SQLException e){            
                realseSource(vo);
                String uuid=Uuid.create().toString();
                logger.error("UUID:"+uuid+", SQL语法有误: ",e);
                throw new MyException("err.user.dao.jdbc",e,uuid);
            }    
        }
        
       //而update操作完成后就可以直接释放连接了，所以在方法末尾直接调用了realseSourse()
        public static  void executeUpdate(DBUtil_BO vo)
        {

            Connection conn = vo.conn;
            PreparedStatement st = vo.st;
            try {
                st.executeUpdate();
            } catch (SQLException e) {
                realseSource(conn, st, null);        
                String uuid=Uuid.create().toString();
                logger.error("UUID:"+uuid+", SQL语法有误: ",e);
                throw new MyException("err.user.dao.jdbc",e,uuid);
            }
            realseSource(conn, st,null );                

        }
}

    四：在项目中使用连接池

    主要分5步：

    1:创建连接池datasourse、bo、utils对象

    2:bo对象的连接是在连接池获取的，所以bo.conn=C3P0Utils.getConnection()；

    3:定义数据库操作语句sql，并用bo对象的preparestatement预处理

    4:把封装了数据库操作的bo对象传给utils对象执行数据库操作

    5:bo对象释放连接，以便下一次获取连接。（查询操作的需要显示释放）

dbBo.conn=C3p0Utils.getConnection();//取用一个连接
String sql = "select * from users where username=? and password=?";
dbBo.st=dbBo.conn.prepareStatement(sql);//预处理sql语句
dbBo.st.setString(1, name);
dbBo.st.setString(2, pass);
//此时dbBo对象已经封装了一个数据库连接以及要执行的操作            

dbUtils.executeQuery(dbBo);//通过数据库操作类来执行这个操作封装类，结果封装回这个操作封装类

//从dbBo类提取操作结果
if (dbBo.rs.next()) {
    uid =dbBo.rs.getInt("userid");
    }
//结果集遍历完了，手动释放连接回连接池
dbUtils.realseSource(dbBo);