首页 > 代码库 > Apache DBCP总览和常用参数说明等
Apache DBCP总览和常用参数说明等
DBCP(DataBase connection pool),数据库连接池。是 apache 上的一个 java 连接池项目。由于建立数据库连接是一个非常耗时耗资源的行为，所以通过连接池预先同数据库建立一些连接，放在内存中，应用程序需要建立数据库连接时直接到连接池中申请一个就行，用完后再放回去。
也是 tomcat、hibernate等开源工具使用的连接池组件。
DBCP版本已经整体升级到2.0时代，并且在jar包上做了升级，诸如org.apache.commons.dbcp2.BasicDataSource。
Jar包为：commons-dbcp2-2.0.1.jar
- DBCP 2.0.1 for JDBC 4.1 (Java 7+)
- DBCP 1.4 for JDBC 4 (Java 6)
- DBCP 1.3 for JDBC 3 (Java 1.4 and Java 5)
必须配置的参数
Username 建立数据库连接的用户名；
Password 建立数据库连接的密码；
URL 传递给JDBC驱动的用于建立连接的URL
DriverClassName 使用的JDBC驱动的完整有效的java 类名
connectionProperties 当建立新连接时被发送给JDBC驱动的连接参数，格式必须是key=value格式
连接池相关配置
initialSize 初始化连接:连接池启动时创建的初始化连接数量
maxActive 最大活动连接：连接池在同一时间能够分配的最大活动连接的数量，类似于并发量，设为0表示无限制 ，2.0版本中，已经去掉该方法，对应替代的方法为：setMaxTotal();
maxIdle 最大空闲连接:连接池中容许保持空闲状态的最大连接数量,超过的空闲连接将被释放,如果设置为负数表示不限制。
minIdle 最小空闲连接:连接池中容许保持空闲状态的最小连接数量,低于这个数量将创建新的连接,如果设置为0则不创建
maxWait 最大建立连接等待时间:当没有可用连接时,连接池等待连接被归还的最大时间(以毫秒计数),超过时间则抛出异常,如果设置为-1表示无限等，2.0中已经去掉该方法，替代方法为：setMaxWaitMillis();
其他相关配置
removeAbandoned 是否自动回收超时连接
removeAbandonedTimeout 设置超时时间有一个要注意的地方，超时时间=现在的时间-程序中创建Connection的时间，如果 maxActive比较大，比如超过100，那么removeAbandonedTimeout可以设置长一点比如180，也就是三分钟无响应的连接进行回收，当然应用的不同设置长度也不同。
timeBetweenEvictionRunsMillis， minEvictableIdleTimeMillis一起使用,每timeBetweenEvictionRunsMillis毫秒秒检查一次连接池中空闲的连接,把空闲时间超过minEvictableIdleTimeMillis毫秒的连接断开,直到连接池中的连接数到minIdle为止
testOnBorrow、testOnReturn、testWhileIdle ，这些属性的意义是取得、返回对象和空闲时是否进行验证，检查对象是否有效，默认都为false即不验证。所以当使用DBCP时，数据库连接因为某种原因断掉后，再从连接池中取得连接又不进行验证，这时取得的连接实际已经时无效的数据库连接了。网上很多说DBCP的bug应该都是如此吧，只有把这些属性设为true，再提供_validationQuery语句就可以保证数据库连接始终有效了。
一个普通的简单示例：
package test.ffm83.commons.dbcp;
import org.apache.commons.dbcp.BasicDataSource;
import org.apache.commons.dbcp.BasicDataSourceFactory;
import org.apache.commons.lang.StringUtils;
import java.sql.PreparedStatement;
import java.sql.ResultSet;
import java.sql.SQLException;
import java.sql.Connection;
import java.util.Properties;
/* 通过dbcp连接oracle数据库
* 使用1.4版本实现
* @author 范芳铭
* */
public classDbcpUsage {
private static BasicDataSource dataSource =null;
public DbcpUsage() {
}
public static void init() {
if (dataSource !=null) {
try {
dataSource.close();
}catch(Exception e) {
e.printStackTrace();
}
dataSource =null;
}
try {
Propertiesp = newProperties();
p.setProperty("driverClassName","oracle.jdbc.driver.OracleDriver");
p.setProperty("url","jdbc:oracle:thin:@192.168.19.1:1521:fanfangming");
p.setProperty("password","ffm");
p.setProperty("username","ffm");
p.setProperty("maxActive","30");
p.setProperty("maxIdle","10");
p.setProperty("maxWait","1000");
p.setProperty("removeAbandoned","false");
p.setProperty("removeAbandonedTimeout","120");
p.setProperty("testOnBorrow","true");
p.setProperty("logAbandoned","true");
dataSource =(BasicDataSource) BasicDataSourceFactory
.createDataSource(p);
}catch(Exception e) {
e.printStackTrace();
}
}
public static synchronized ConnectiongetConnection()throwsSQLException {
if (dataSource ==null) {
init();
}
Connectionconn = null;
if (dataSource !=null) {
conn= dataSource.getConnection();
}
return conn;
}
public static void main(String[] args)throws Exception {
Connectioncon = null;
try {
con= DbcpUsage.getConnection();
Stringsql = " select sysdate from dual ";
PreparedStatementps = con.prepareStatement(sql);
ResultSetrs = ps.executeQuery();
while (rs.next()) {
Stringvalue = http://www.mamicode.com/rs.getString("sysdate");
System.out.println(StringUtils.center(value+",数据库连接成功", 50,"-"));
}
}catch(Exception e) {
e.printStackTrace();
}finally{
if (con !=null) {
con.close();
}
}
}
}
运行如下：
----------2014-12-1612:38:32.0,数据库连接成功-----------
Apache DBCP总览和常用参数说明等