数据库连接池——dbcp和c3p0

数据库连接池负责分配、管理和释放数据库连接，它允许应用程序重复使用一个现有的数据库连接，而不是重复建立一个。

数据库连接池在初始化的时候将会一次性建立一定数量的数据库连接放到连接池中，这些数据库连接的数量是由最小数据库连接数设定的。无论这些数据库连接是否被使用，连接池都将一直保证至少拥有这么多的连接数量。连接池的最大数据库连接数设定了这个连接池能占有的最大连接数，当应用程序向连接池请求的连接数超过最大连接数量时，这些请求将被加入到等待队列中。

JDBC的数据库连接池使用javax.sql.DataSource来表示，DataSource只是一个接口，该接口通常由服务器提供实现，也有一些开源组织提供实现，如：dbcp、c3p0。

DataSource通常被称为数据源，它包含连接池和连接池管理两部分，习惯上把DataSource称为连接池。

—————————————分割线———————————————

一、DBCP的使用

先来看一下最原始的写法：

package com.lj95801.cla1;

import java.io.IOException;
import java.sql.Connection;
import java.sql.SQLException;

import javax.sql.DataSource;

import org.apache.commons.dbcp.BasicDataSource;
import org.apache.commons.dbcp.BasicDataSourceFactory;
import org.junit.Test;

public class DBCPTools {
	
	@Test
	public void testDBCP() throws SQLException{
		BasicDataSource dataSource = null;
		//1、创建DBCP数据源实例
		dataSource = new BasicDataSource();
		
		//2、为数据源实例指定必须的属性
		dataSource.setUsername("scott");
		dataSource.setPassword("tiger");
		dataSource.setUrl("jdbc:oracle:thin:@localhost:1521:orcl");
		dataSource.setDriverClassName("oracle.jdbc.driver.OracleDriver");
		
		//3、从数据源中获取数据库链接
		Connection connection = dataSource.getConnection();
		
		System.out.println(connection);
	}
}

下面进行改进：

①、解耦和； ②、制定其它可选的属性

1)public voidsetInitialSize(int initialSize)

Sets the initial size of the connection pool.

2)public voidsetMaxActive(int maxActive)

Sets the maximum number of active connections that can be allocated at the same time. Use a negative value for no limit.（当前连接超过这个数目的时候，后面的连接申请将会排队等待）

3）public void setMinIdle(int minIdle)

Sets the minimum number of idle connections in the pool.（当前连接池中至少有多少个连接标记为free，也就是立刻能使用的）

4) public voidsetMaxIdle(int maxIdle)

Sets the maximum number of connections that can remain idle in the pool.（标记为free的连接数目的最大值）

5)public voidsetMaxWait(long maxWait)

Sets the maxWait property.Use -1 to make the pool wait indefinitely.（最长的等待时间，maxWait是最大的等待时间，若等待超过这个时间，直接返回失败）

下面添加一些可选的配置：

package com.lj95801.cla1;

import java.io.IOException;
import java.sql.Connection;
import java.sql.SQLException;

import javax.sql.DataSource;

import org.apache.commons.dbcp.BasicDataSource;
import org.apache.commons.dbcp.BasicDataSourceFactory;
import org.junit.Test;

public class DBCPTools {
	
	@Test
	public void testDBCP() throws SQLException{
		BasicDataSource dataSource = null;
		//1、创建DBCP数据源实例
		dataSource = new BasicDataSource();
		
		//2、为数据源实例指定必须的属性
		dataSource.setUsername("scott");
		dataSource.setPassword("tiger");
		dataSource.setUrl("jdbc:oracle:thin:@localhost:1521:orcl");
		dataSource.setDriverClassName("oracle.jdbc.driver.OracleDriver");
		
		//3、指定一些可选参数，让dbcp辅助管理连接池
		//初始化就建立10个链接
		dataSource.setInitialSize(10);
		//最少要有5个链接空闲，它随时做好了被分配的准备，能够保证相应速度
		dataSource.setMinIdle(5);
		//连接池中闲置的连接数最大为20个，超过这个数目的时候会将多余的关闭，防止数据库连接泄露
		dataSource.setMaxIdle(20);
		//最大活动连接数，只允许保持20个连接，超过这个数目以后再申请的就放到等待队列中，排队等待
		dataSource.setMaxActive(20);
		//最长的等待时间，以毫秒为单位，某个申请等待超过3秒，它就会抛出异常
		dataSource.setMaxWait(3000);
		
		//4、从数据源中获取数据库链接
		Connection connection = dataSource.getConnection();
		
		System.out.println(connection);
	}
}

为了解耦和，工具自己设置了一个工厂类： Class BasicDataSourceFactory，这个类中间提供了一个静态方法：

public static DataSource createDataSource(Properties properties)

我们只需要向其中传入Properties的对象，它就能够返回一个DataSource给我们。和前面一样，我们建立一个dbcp.properties配置文件，里面定义属性和值。注意！！属性名要遵循get和set的命名规则：get和set方法名后面的第一个字母变小写就是属性名。

username=scott
password=tiger
driverClassName=oracle.jdbc.driver.OracleDriver
url=jdbc:oracle:thin:@localhost:1521:orcl

initialSize=10
maxActive=50
minIdle=5
maxWait=5000

下面创建一个dbcp的处理工具DBCPUtils，代码如下：

package com.lj95801.utils;

import java.io.IOException;
import java.io.InputStream;
import java.sql.Connection;
import java.sql.SQLException;
import java.util.Properties;
import javax.sql.DataSource;

import org.apache.commons.dbcp.BasicDataSourceFactory;

public class DBCPUtils {
	
	private static DataSource dataSource = null;
	
	/**
	 * 利用dbcp工厂方法创建一个dataSource对象，它是“连接池”
	 * 可以从中直接获取连接。
	 * @param property_file
	 * @return
	 */
	public static DataSource createDBCPDataSource(String property_file){
		DataSource dataSource = null;
		InputStream inStream = null;
		try {
			//1、获取properties
			Properties properties = new Properties();
			inStream = 
					DBCPUtils.class.getClassLoader().getResourceAsStream(property_file);
			properties.load(inStream);
			
			//2、工厂生产，创造出dataSource
			dataSource = BasicDataSourceFactory.createDataSource(properties);
		} catch (Exception e) {
			e.printStackTrace();
		}finally{
			if(inStream != null){
				try {
					inStream.close();
				} catch (IOException e) {
					e.printStackTrace();
				}
			}
		}
		return dataSource;
	}
	
	/**
	 * 从DBCP连接池中获取数据库连接，可以直接调用这个方法。
	 * @param dbcpPropertiesFile
	 * @return
	 * @throws SQLException
	 */
	public static Connection getConnectionDBCP(String dbcpPropertiesFile) throws SQLException{
		if(dataSource == null){
			dataSource = createDBCPDataSource(dbcpPropertiesFile);
		}
		
		return dataSource.getConnection();
	}
}

二、c3p0的使用

制作一个工具C3P0Utils。

package com.lj95801.utils;

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

import com.mchange.v2.c3p0.ComboPooledDataSource;

public class C3P0Utils {
	private static ComboPooledDataSource cpds = null;
	
	/**
	 * 通过C3P0获取connection连接
	 * @param NamedConfigXML :XML文件中配置的名字，不是XML文件名
	 * @return
	 * @throws SQLException
	 */
	public static Connection getConnectionC3P0(String NamedConfigXML) throws SQLException{
		if(cpds == null){
			cpds = new ComboPooledDataSource(NamedConfigXML);
		}
		return cpds.getConnection();
	}
}

配置文件（文件名是固定的：c3p0-config.xml）：

<c3p0-config>
	<!-- This app is massive! -->
	<named-config name="HelloC3P0">
	
		<!-- 指定连接数据源的基本属性 -->
		<property name="user">scott</property>
		<property name="password">tiger</property>
		<property name="driverClass">oracle.jdbc.driver.OracleDriver</property>
		<property name="jdbcUrl">jdbc:oracle:thin:@localhost:1521:orcl</property>
		
		<!-- 若数据库连接池不足时，一次向数据库申请多少个连接 -->
		<property name="acquireIncrement">5</property>
		<!-- 初始化数据库连接池时连接的数量 -->
		<property name="initialPoolSize">5</property>
		<property name="minPoolSize">5</property>
		<property name="maxPoolSize">1000</property>

		<!-- C3P0数据库连接池可以维护的Statement的个数 -->
		<property name="maxStatements">0</property>
		<!-- 每个连接同时可以使用的Statement个数 -->
		<property name="maxStatementsPerConnection">5</property>

	</named-config>
</c3p0-config>