apache-DBCP基本配置介绍


本文主要介绍apache-dbcp基本参数配置和应用示例，dbcp目前最新版是1.4需要在jdk1.6的环境下运行，如果要在jdk1.4、1.5环境下运行，需要下载前一版本1.3，具体详细可以查看它的官网。 
本文结构目录分两大部分： 
一、基础参数说明
二、dbcp在spring、hibernate等应用中的配置示例
以后会陆续给出有关c3p0、proxool等相关参数介绍和应用配置实例。 
[ 一 ]、参数介绍 
[ 1 ]、基础参数说明 
defaultAutoCommit： 对于事务是否 autoCommit, 默认值为 true
defaultReadOnly：对于数据库是否只能读取, 默认值为 false
initialSize：连接池启动时创建的初始化连接数量（默认值为0）
driverClassName：连接数据库所用的 JDBC Driver Class,
url: 连接数据库的 URL
username：登陆数据库所用的帐号
password： 登陆数据库所用的密码
maxActive: 连接池中可同时连接的最大的连接数，为0则表示没有限制，默认为8
maxIdle： 连接池中最大的空闲的连接数（默认为8,设 0 为没有限制）,超过的空闲连接将被释放，如果设置为负数表示不限制（maxIdle不能设置太小，因为假如在高负载的情况下，连接的打开时间比关闭的时间快，会引起连接池中idle的个数 上升超过maxIdle，而造成频繁的连接销毁和创建)
minIdle：连接池中最小的空闲的连接数（默认为0，一般可调整5），低于这个数量会被创建新的连接（该参数越接近maxIdle，性能越好，因为连接的创建和销毁，都是需要消耗资源的；但是不能太大，因为在机器很空闲的时候，也会创建低于minidle个数的连接）
maxWait： 超过时间会丟出错误信息 最大等待时间(单位为 ms)，当没有可用连接时，连接池等待连接释放的最大时间，超过该时间限制会抛出异常，如果设置-1表示无限等待（默认为-1，一般可调整为60000ms，避免因线程池不够用，而导致请求被无限制挂起）
validationQuery： 验证连接是否成功, SQL SELECT 指令至少要返回一行
removeAbandoned：超过removeAbandonedTimeout时间后，是否进行没用连接的回收（默认为false)
removeAbandonedTimeout： 超过时间限制，回收五用的连接（默认为 300秒），removeAbandoned 必须为 true
logAbandoned： 是否记录中断事件, 默认为 false
一般优化的配置示例： 
Xml代码  
<bean id="dbcpDataSource"  
        class="org.apache.commons.dbcp.BasicDataSource"  
        destroy-method="close">  
        <property name="driverClassName"  
            value="${jdbc.driverClassName}" />  
        <property name="url" value="${jdbc.url}" />  
        <property name="username" value="${jdbc.username}" />  
        <property name="password" value="${jdbc.password}" />  
        <property name="maxActive" value="20" />  
        <property name="initialSize" value="1" />  
        <property name="maxWait" value="60000" />  
        <property name="maxIdle" value="15" />  
        <property name="minIdle" value="5" />  
        <property name="removeAbandoned" value="true" />  
        <property name="removeAbandonedTimeout" value="180" />  
        <property name="connectionProperties">  
            <value>clientEncoding=utf-8</value>  
        </property>  
    </bean>  

[ 2 ]、validate配置参数说明 
minEvictableIdleTimeMillis：大于0 ，进行连接空闲时间判断，或为0，对空闲的连接不进行验证；默认30分钟
timeBetweenEvictionRunsMillis：失效检查线程运行时间间隔，如果小于等于0，不会启动检查线程，默认-1
testOnBorrow：在进行borrowObject进行处理时，对拿到的connection进行validateObject校验，默认为false
testOnReturn：就是在进行returnObject对返回的connection进行validateObject校验，默认为false
testWhileIdle：GenericObjectPool中针对pool管理，起了一个Evict的TimerTask定时线程进行控制(可通过设置参数timeBetweenEvictionRunsMillis>0),定时对线程池中的链接进行validateObject校验，对无效的链接进行关闭后，会调用ensureMinIdle，适当建立链接保证最小的minIdle连接数，默认为false
numTestsPerEvictionRun：代表每次检查链接的数量，建议设置和maxActive一样大，这样每次可以有效检查所有的链接.
validateQuery， 代表检查的sql
validateQueryTimeout， 代表在执行检查时，通过statement设置，statement.setQueryTimeout(validationQueryTimeout)
配置示例： 
Xml代码  
<property name="testWhileIdle" value="true" />  
<property name="testOnBorrow" value="false" />  
<property name="testOnReturn" value="false" />  
<property name="validationQuery">  
    <value>select sysdate from dual</value>  
</property>  
<property name="validationQueryTimeout" value="1" />  
<property name="timeBetweenEvictionRunsMillis" value="30000" />  
<property name="numTestsPerEvictionRun" value="20" />  
[ 二 ]、dbcp在spring、hibernate等应用中的配置示例 
dbcp.jdbc.properties 
Java代码  
jdbc.driverClassName=com.mysql.jdbc.Driver  
jdbc.url=jdbc:mysql://localhost/iecms  
jdbc.username=root  
jdbc.password=  
[ 1 ]、最基本的应用 
Java代码  
package michael.jdbc.dbcp;  
  
import javax.sql.DataSource;  
import java.sql.Connection;  
import java.sql.Statement;  
import java.sql.ResultSet;  
import java.sql.SQLException;  
import java.util.Properties;  
  
import org.apache.commons.dbcp.BasicDataSource;  
  
/** 
 * @see http://sjsky.iteye.com 
 * @author michael sjsky007@gmail.com 
 */  
public class DbcpDataSourceExample {  
  
    /** 
     * @param args 
     */  
    public static void main(String[] args) {  
  
        String testSql = "select * from TB_MYTEST";  
        String cfgFileName = "dbcp.jdbc.properties";  
  
        System.out.println("Setting up data source.");  
        DataSource dataSource = setupDataSource(cfgFileName);  
        System.out.println("dataSource Done.");  
  
        printDataSourceStats(dataSource);  
  
        Connection conn = null;  
        Statement stmt = null;  
        ResultSet rset = null;  
  
        try {  
            System.out.println("Creating connection start.");  
            conn = dataSource.getConnection();  
  
            System.out.println("Creating statement start.");  
            stmt = conn.createStatement();  
  
            System.out.println("Executing statement start.");  
            rset = stmt.executeQue

补充：软件开发 , Java ,