（十二）C3P0连接池使用教程

一般我们在项目中操作数据库时，都是每次需要操作数据库就建立一个连接，操作完成后释放连接。因为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);