commons-dbcp jar包详解

本文原文：http://blog.sina.com.cn/s/blog_5ff02a9f01013u65.html

1.dbcp简介
网络程序的设计，很多都涉及到和关系型数据库的交互操作，一般的操作方式都是使用的时候创建到数据库的连
接，然后进行各种操作，这种简单的操作方式带来的问题便是数据库的频繁的打开和关闭，以及transtion的执
行，这是一种很耗费时间和资源的操作。于是数据库缓冲池dbcp就出现了，这个包是从pool包发展出来的。
2.dbcp实现的基本流程
  1.创建enericobjectpool实例
  genericobjectpool pool = new genericobjectpool(null);
  2.创建poolableconnectionfactory
  drivermanagerconnectionfactory cf =
    new drivermanagerconnectionfactory(
    "jdbc:mysql://host/db", "username", "password");

poolableconnectionfactory pcf =
    new poolableconnectionfactory(
    cf, pool, null, "select * from mysql.db", false, true);
  3.创建和注册poolingdriver
  new poolingdriver().registerpool("mypool", pool);
  到此为止,数据库缓冲池就创建完毕了.
3.datasource的实现过程
datasource在众多的jsp容器和应用程序中都已经实现，在容器或者应用服务器启动的时候，他会读取相关的
配置文件，自动完成datasource的创建工作，我们一般只需要在服务器的配置文件中指定就可以了，这里贴出
实现的过程，便于大家理解它内部的实现机制，便于编程参考。
import javax.sql.datasource;
import java.sql.connection;
import java.sql.statement;
import java.sql.resultset;
import java.sql.sqlexception;
import org.apache.commons.dbcp.basicdatasource;
public class basicdatasourceexample {

    public static void main(string[] args) {
        // 创建basicdatasource
        system.out.println("setting up data source.");
        datasource datasource = setupdatasource(args[0]);
        system.out.println("done.");

 //创建jdbc数据源
        connection conn = null;
        statement stmt = null;
        resultset rset = null;

               try {
                       system.out.println("creating connection.");
                       conn = datasource.getconnection();
                       system.out.println("creating statement.");
                       stmt = conn.createstatement();
                       system.out.println("executing statement.");
                       rset = stmt.executequery(args[1]);
                       system.out.println("results:");
                       int numcols = rset.getmetadata().getcolumncount();
                       while(rset.next()) {
                               for(int i=1;i<=numcols;i++) {
                                       system.out.print("\t" + rset.getstring(i));
                               }
                               system.out.println("");
                       }
               } catch(sqlexception e) {
                       e.printstacktrace();
               } finally {
                       try { rset.close(); } catch(exception e) { }
                       try { stmt.close(); } catch(exception e) { }
                       try { conn.close(); } catch(exception e) { }
               }
       }
       //创建数据源
       public static datasource setupdatasource(string connecturi) {
               basicdatasource ds = new basicdatasource();
               ds.setdriverclassname("oracle.jdbc.driver.oracledriver");
               ds.setusername("scott");
               ds.setpassword("tiger");
               ds.seturl(connecturi);
               return ds;
       }
       //提示数据源状态
       public static void printdatasourcestats(datasource ds) throws sqlexception {
               basicdatasource bds = (basicdatasource) ds;
system.out.println("numactive: " + bds.getnumactive());
               system.out.println("numidle: " + bds.getnumidle());
       }
       //关闭数据源
       public static void shutdowndatasource(datasource ds) throws sqlexception {
               basicdatasource bds = (basicdatasource) ds;
               bds.close();
       }
}
例子比较简单，不再多说了~
4.tomcat中dbcp的配置
这里是以mysql作为数据库进行说明。
使用dbcp，在 server.xml 中需要设置相关的连接及 dbcp 的参数值.
  <context path="/mysqltest" docbase="mysqltest"
                                       debug="5" reloadable="true" crosscontext="true">
 
         <logger classname="org.apache.catalina.logger.filelogger"
                                 prefix="localhost_mysqltest_log." suffix=".txt"
                                 timestamp="true"/>
                               
       <resource name="jdbc/testdb"   auth="container" type="javax.sql.datasource"/>
     
       <resourceparams name="jdbc/testdb">
               <parameter>
                       <name>factory</name>
                       <value>org.apache.commons.dbcp.basicdatasourcefactory</value>
               </parameter>
               <parameter>
                       <name>maxactive</name>
                       <value>100</value>
               </parameter>
               <parameter>
                       <name>maxidle</name>
                       <value>30</value>
               </parameter>
               <parameter>
                       <name>maxwait</name>
                       <value>10000</value>
               </parameter>
               <parameter>
                       <name>username</name>
                       <value>root</value>
               </parameter>
               <parameter>
                       <name>password</name>
                       <value>admin</value>
               </parameter>
               <parameter>
                       <name>driverclassname</name>
                       <value>org.gjt.mm.mysql.driver</value>
               </parameter>
               <parameter>
                       <name>url</name>
                       <value>jdbc:mysql://localhost:3306/javatest?autoreconnect=true</value>
               </parameter>
           </resourceparams>
</context>
我们可以看到他使用的 dbcp factory 就是 org.apache.commons.dbcp.basicdatasourcefactory
5.参数说明
*datasource:要连接的 datasource (通常我们不会定义在 server.xml)
*defaultautocommit:对于事务是否 autocommit, 默认值为 true
*defaultreadonly:对于数据库是否只能读取, 默认值为 false
*driverclassname:连接数据库所用的 jdbc driver class,
*maxactive:最大连接数据库连接数,设 0 为没有限制
*maxidle:最大等待连接中的数量,设 0 为没有限制
*maxwait:最大等待秒数, 单位为 ms, 超过时间会乬出错误信息
*password:登陆数据库所用的密码
*url:连接数据库的 url
*username:登陆数据库所用的帐号
*validationquery:验证连接是否成功, sql select 指令至少要返回一行
*removeabandoned:是否自我中断, 默认是 false
*removeabandonedtimeout:几秒后会自我中断, removeabandoned 必须为 true
*logabandoned:是否记录中断事件, 默认为 false
6.总结
dbcp一般应用在数据库的使用非常频繁的情况下使用，它可以处理大量的数据库的连接请求，不失为做大型站
点的首选数据库配置
7.参考资料
*jakarta commons
http://jakarta.apache.org/commons/
*jakarta commons-dbcp
http://jakarta.apache.org/commons/dbcp
*jakarta commons-dbcp api
http://jakarta.apache.org/commons/dbcp/apidocs/index.html
*cvs资料
http://cvs.apache.org/viewcvs.cgi/jakarta-commons/dbcp/doc/