c3p0连接池和dbutils工具的使用

大鳥

已于 2024-12-10 15:23:35 修改

阅读量735

点赞数

CC 4.0 BY-SA版权

分类专栏： java 文章标签： java

于 2019-01-20 17:18:32 首次发布

本文链接：https://blog.youkuaiyun.com/qq_40025337/article/details/86563613

java 专栏收录该内容

6 篇文章

订阅专栏

本文介绍了Java中C3P0数据库连接池的原理和使用，包括创建配置文件、获取与释放连接的方法。同时讲解了DbUtils工具类的作用和三大核心类：DbUtils、QueryRunner及ResultSetHandler，提供了简化JDBC操作的解决方案。通过实例展示了C3P0与DbUtils的结合使用，以及常用ResultSetHandler实现类。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

最近在使用dubbo框架维护老的业务项目，其中免不了对数据库的操作，第一个问题就是数据库的连接了，最简单的方法就是使用连接池，java的数据库连接池也分很多种，例如：DBCP 、C3P0、BoneCP、Proxool、DDConnectionBroker、DBPool、XAPool、Primrose、SmartPool、MiniConnectionPoolManager及Druid等。这里简单记录下关于c3p0的一些使用，以便日后的学习。

首先了解下连接池的概念，数据库连接池的基本思想市委数据库连接建立一个“缓冲池”，预先在其中存放一定数量的连接，当项目需要时，只需从中取出，使用完毕之后再放回去。获取一个连接，系统要在背后做很多消耗资源的事情，大多时候，创建连接的时间比执行sql语句的时间还要长。用户每次请求都需要向数据库获得链接，而数据库创建连接通常需要消耗相对较大的资源，创建时间也较长。

C3P0是一个开源的JDBC连接池，目前使用它的开源项目有Hibernate，Spring等。

然后了解下c3p0的使用，

导入相关的jar包：c3p0和mysql
创建配置文件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>

3.获取、使用连接池

3.1、创建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);    
                }  
            }  
        }  
}

3.2、创建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();
    }    
}

3.3、创建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 );                

        }
}

3.4、在项目中使用连接池

主要分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);

顺便提下一个叫DbUtils工具类，配合c3p0使用也很方便！

Commons DbUtils是Apache组织提供的一个对JDBC进行简单封装的开源工具类库，使用它能够简化JDBC应用程序的开发，同时也不会影响程序的性能。

DBUtils封装了对JDBC的操作，简化了JDBC操作，可以少写代码。

三：Dbutils三个核心类介绍：

1：DbUtils：连接数据库对象----jdbc辅助方法的集合类，线程安全

构造方法：DbUtils()

作用：控制连接，控制书屋，控制驱动加载额一个类。

2：QueryRunner：SQL语句的操作对象，可以设置查询结果集的封装策略，线程安全。

构造方法：

（1）QueryRunner()：创建一个与数据库无关的QueryRunner对象，后期再操作数据库的会后，需要手动给一个Connection对象，它可以手动控制事务。

Connection.setAutoCommit(false); 设置手动管理事务

Connection.commit(); 提交事务

（2）QueryRunner(DataSource ds)：创建一个与数据库关联的queryRunner对象，后期再操作数据库的时候，不需要Connection对象，自动管理事务。

DataSource：数据库连接池对象。

构造函数与增删改查方法的组合：

QueryRunner()

update(Connection conn, String sql, Object... params)

query(Connection conn, String sql, ResultSetHandler<T> rsh, Object... params)

QueryRunner(DataSource ds)

update(String sql, Object... params)

query(String sql, ResultSetHandler<T> rsh, Object... params)

3、ResultSetHandle：封装数据的策略对象------将封装结果集中的数据，转换到另一个对象

策略：封装数据到对象的方式（示例：将数据库保存在User、保存到数组、保存到集合）

DbUtils配合c3p0的使用：

同样是导入jar包

配置c3p0-config.xml文件

<? xml version ="1.0" encoding= "UTF-8" ?>
< c3p0-config>
       <!-- 默认配置，c3p0框架默认加载这段默认配置 -->
       < default-config>
             <!-- 配置JDBC 四个基本属性 -->
             < property name ="driverClass" > com.mysql.jdbc.Driver</ property >
             < property name ="jdbcUrl" > jdbc:mysql:///数据库名</ property >
             < property name ="user" > 数据库用户名</ property >
             < property name ="password" > 数据库密码</ property >
       </ default-config> <!-- This app is massive! -->
</ c3p0-config>

创建数据库操作工具类

package cn.utils;

import java.sql.Connection;
import java.sql.SQLException;

import javax.sql.DataSource;

import com.mchange.v2.c3p0.ComboPooledDataSource;

public class JDBCUtils {

    // 获得c3p0连接池对象
    private static ComboPooledDataSource ds = new ComboPooledDataSource();

    /**
     * 获得数据库连接对象
     *
     * @return
     * @throws SQLException
     */
    public static Connection getConnection() throws SQLException {
        return ds.getConnection();
    }

    /**
     * 获得c3p0连接池对象
     * @return
     */
    public static DataSource getDataSource() {
        return ds;
    }
}

在java逻辑代码中使用DbUtils

//BeanListHandler:将查询结果的每一行封装到user对象，然后，再存入list集合
 
public void test(){
//第一步：创建queryRunner对象，用来操作sql语句
 
QueryRunner qr = new QueryRunner(JDBCUtils.getDataSource());
 
//第二步：创建sql语句
 
String sql = "select * from user";
 
//第三步：执行sql语句,params:是sql语句的参数
 
//注意，给sql语句设置参数的时候，按照user表中字段的顺序
 
try {
 
List<User> list = qr.query(sql, new BeanListHandler<User>(User.class));
 
System.out.println(list);
 
} catch (SQLException e) {
 
e.printStackTrace();
 
} 
}

ResultSetHandler具体实现类可参看具体源码，太多不叙！
其中常用的有三种
BeanHandler:将查询结果的第一行数据，封装到user对象
BeanListHandler:将查询结果的每一行封装到user对象，然后，再存入list集合
ScalarHandler:封装类似count、avg、max、min、sum。。。。函数的执行结果

个人还是比较喜欢用DbUtils的，毕竟进行一次封装用起来更方便了，以上内容有部分有个人的理解也有部分网上的借鉴

https://www.cnblogs.com/ygj0930/p/6405861.html

Dbutils学习（介绍和入门） - 深夜coding - 博客园