proxool连接池配置示例代码

两个JAVA类：

package com.potevio.zjx.proxool;

import java.sql.Connection;
import java.sql.Date;
import java.sql.PreparedStatement;
import java.sql.ResultSet;
import java.sql.SQLException;
import java.sql.Statement;

/**
 * @author Zhou-Jingxian
 *
 */
public class DBConnect {
	private Connection conn = null;

	private Statement stmt = null;

	private PreparedStatement prepstmt = null;

	void init() throws SQLException {
		conn = ProxoolConnect.getConnection();//创建连接池连接
	}

	/**
	 * 构造数据库的连接和访问类
	 */
	public DBConnect() throws Exception {
		init();
		stmt = conn.createStatement();
	}

	public DBConnect(int resultSetType, int resultSetConcurrency)
			throws Exception {
		init();
		stmt = conn.createStatement(resultSetType, resultSetConcurrency);
	}

	/**
	 * 构造数据库的连接和访问类 预编译SQL语句
	 * 
	 * @param sql
	 *            SQL语句
	 */
	public DBConnect(String sql) throws Exception {
		init();
		this.prepareStatement(sql);
	}

	public DBConnect(String sql, int resultSetType, int resultSetConcurrency)
			throws Exception {
		init();
		this.prepareStatement(sql, resultSetType, resultSetConcurrency);
	}

	/**
	 * 返回连接
	 * 
	 * @return Connection 连接
	 */
	public Connection getConnection() {
		return conn;
	}

	/**
	 * PreparedStatement
	 * 
	 * @return sql 预设SQL语句
	 */
	public void prepareStatement(String sql) throws SQLException {
		prepstmt = conn.prepareStatement(sql);
	}

	public void prepareStatement(String sql, int resultSetType,
			int resultSetConcurrency) throws SQLException {
		prepstmt = conn.prepareStatement(sql, resultSetType,
				resultSetConcurrency);
	}

	/**
	 * 设置对应值
	 * 
	 * @param index
	 *            参数索引
	 * @param value
	 *            对应值
	 */
	public void setString(int index, String value) throws SQLException {
		prepstmt.setString(index, value);
	}

	public void setInt(int index, int value) throws SQLException {
		prepstmt.setInt(index, value);
	}

	public void setBoolean(int index, boolean value) throws SQLException {
		prepstmt.setBoolean(index, value);
	}

	public void setDate(int index, Date value) throws SQLException {
		prepstmt.setDate(index, value);
	}

	public void setLong(int index, long value) throws SQLException {
		prepstmt.setLong(index, value);
	}

	public void setFloat(int index, float value) throws SQLException {
		prepstmt.setFloat(index, value);
	}

	public void setBytes(int index, byte[] value) throws SQLException {
		prepstmt.setBytes(index, value);
	}

	public void clearParameters() throws SQLException {
		prepstmt.clearParameters();
		prepstmt = null;
	}

	/**
	 * 返回预设状态
	 */
	public PreparedStatement getPreparedStatement() {
		return prepstmt;
	}

	/**
	 * 返回状态
	 * 
	 * @return Statement 状态
	 */
	public Statement getStatement() {
		return stmt;
	}

	/**
	 * 执行SQL语句返回字段集
	 * 
	 * @param sql
	 *            SQL语句
	 * @return ResultSet 字段集
	 */
	public ResultSet executeQuery(String sql) throws SQLException {
		if (stmt != null) {
			return stmt.executeQuery(sql);
		} else
			return null;
	}

	public ResultSet executeQuery() throws SQLException {
		if (prepstmt != null) {
			return prepstmt.executeQuery();
		} else
			return null;
	}

	/**
	 * 执行SQL语句
	 * 
	 * @param sql
	 *            SQL语句
	 */
	public void executeUpdate(String sql) throws SQLException {
		if (stmt != null)
			stmt.executeUpdate(sql);
	}

	public void executeUpdate() throws SQLException {
		if (prepstmt != null)
			prepstmt.executeUpdate();
	}

	/**
	 * 关闭连接
	 */
	public void close() throws Exception {
		if (stmt != null) {
			stmt.close();
			stmt = null;
		}
		if (prepstmt != null) {
			prepstmt.close();
			prepstmt = null;
		}
		if (conn != null) {
			conn.close();
			conn=null;
		}

	}
}

 

package com.potevio.zjx.proxool;

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

/**
 * 
 * @author Zhou-Jingxian
 * 
 */
public class ProxoolConnect {

	public static Connection getConnection() throws SQLException {
		return DriverManager.getConnection("proxool.norya");
	}

	
	private ProxoolConnect() {
	}

}

 

Proxool.xml的配置文件(放在web-inf下，或者使用proxool.properties文件)：

<?xml version="1.0" encoding="ISO-8859-1"?>

<something-else-entirely>
  <proxool>
    <alias>norya</alias>
    <driver-url>jdbc:mysql://localhost:3306/mysql</driver-url>
    <driver-class>com.mysql.jdbc.Driver</driver-class>
    <driver-properties>
      <property name="user" value="root"/>
      <property name="password" value="rootroot"/>
    </driver-properties>
    <maximum-connection-count>100</maximum-connection-count>
    <prototype-count>5</prototype-count>
    <house-keeping-test-sql>select CURRENT_DATE</house-keeping-test-sql>
    <verbose>true</verbose> 
    <statistics>10s,1m,1d</statistics>
    <statistics-log-level>DEBUG</statistics-log-level>
  </proxool>
</something-else-entirely>

 部分说明：

proxool.xml这个文件是用来设置别名的。其中<proxool>标签就是别名的设置段。

alias是别名；

driver-url是驱动的url，就是连接的url；

driver-class是驱动的类，就是数据库驱动；

driver-properties是驱动的属性，可以设置登陆数据库的用户名和密码。

maximum-connection-count是最大连接数。

 

web.xml中加入下面的代码：

<servlet>
         <servlet-name>ServletConfigurator</servlet-name>
         <servlet-class>org.logicalcobwebs.proxool.configuration.ServletConfigurator</servlet-class>
           <init-param>
                <param-name>xmlFile</param-name>
                <param-value>WEB-INF/Proxool.xml</param-value>
            </init-param>
        <load-on-startup>1</load-on-startup>
 </servlet>

 <servlet>
          <servlet-name>Admin</servlet-name>
          <servlet-class>
          org.logicalcobwebs.proxool.admin.servlet.AdminServlet
          </servlet-class>
 </servlet>

  <servlet-mapping>
          <servlet-name>Admin</servlet-name>
          <url-pattern>/admin</url-pattern>
  </servlet-mapping>


  <session-config>
        <!-- Default to 50 minute session timeouts -->
        <session-timeout>50</session-timeout>
  </session-config>

部门说明：

<servlet>

<servlet-name>ServletConfigurator</servlet-name>

<servlet-class>org.logicalcobwebs.proxool.configuration.ServletConfigurator</servlet-class>

<init-param>

<param-name>xmlFile</param-name>

<param-value>WEB-INF/proxool.xml</param-value>

</init-param>

<load-on-startup>1</load-on-startup>

</servlet>

这段标记是要求tomcat在启动的时候加载proxool驱动并且指明 proxool.xml的位置。

不写的话，上面设置的别名就没用了。 

这段标记是要求tomcat在启动的时候加载proxool驱动并且指明 proxool.xml的位置。

不写的话，上面设置的别名就没用了。

做完上面的工作后，建立连接只需要

Connection con = DriverManager.getConnection("proxool.mysql");

这一句就可以了，Class.forName也不需要了。

注：别名是可以设置多个的，我们在连接多种数据库的时候就可以设置多个别名方便访问了！！

查看proxool的状态

在工程的web.xml里添加

<servlet>

<servlet-name>Admin</servlet-name>

<servlet-class>org.logicalcobwebs.proxool.admin.servlet.AdminServlet</servlet-class>

</servlet>

<servlet-mapping>

<servlet-name>Admin</servlet-name>

<url-pattern>/admin</url-pattern>

</servlet-mapping>

就可以通过/admin来访问proxool的状态了。

 

 

导入如下包：

mysql数据库连接包，commons-logging.jar,proxool.jar

在webroot下写的测试JSP:

<%@ page contentType="text/html; charset=gb2312" language="java" import="java.sql.*"%>
<%@ page import="com.potevio.zjx.proxool.DBConnect"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=gb2312" />
<title>测试 proxool连接池配置</title>
</head>

<body>
<%
	DBConnect db=new DBConnect();
	ResultSet rst=db.executeQuery("select * from user");
	while(rst.next())
	{
		out.println(rst.getString("user")+"<BR>");
	}
%>
</body>
</html>

 Notice:

      根据需求修改对应的配置文件，这只是连接MySql数据的测试。

下面提供部分说明：

     属性列表说明:

fatal-sql-exception: 它是一个逗号分割的信息片段.当一个SQL异常发生时,他的异常信息将与这个信息片段进行比较.如果在片段中存在,那么这个异常将被认为是个致命错误(Fatal SQL Exception ).这种情况下,数据库连接将要被放弃.无论发生什么,这个异常将会被重掷以提供给消费者.用户最好自己配置一个不同的异常来抛出.

fatal-sql-exception-wrapper-class:正如上面所说,你最好配置一个不同的异常来重掷.利用这个属性,用户可以包装SQLException,使他变成另外一个异常.这个异常或者继承SQLException或者继承字RuntimeException.proxool
自带了2个实现:'org.logicalcobwebs.proxool.FatalSQLException' 和'org.logicalcobwebs.proxool.FatalRuntimeException'.后者更合适.

house-keeping-sleep-time: house keeper 保留线程处于睡眠状态的最长时间,house keeper 的职责就是检查各个连接的状态,并判断是否需要销毁或者创建.

house-keeping-test-sql:  如果发现了空闲的数据库连接.house keeper 将会用这个语句来测试.这个语句最好非常快的被执行.如果没有定义,测试过程将会被忽略。

injectable-connection-interface: 允许proxool实现被代理的connection对象的方法.

injectable-statement-interface: 允许proxool实现被代理的Statement 对象方法.

injectable-prepared-statement-interface: 允许proxool实现被代理的PreparedStatement 对象方法.

injectable-callable-statement-interface: 允许proxool实现被代理的CallableStatement 对象方法.

jmx: 如果属性为true，就会注册一个消息Bean到jms服务，消息Bean对象名: "Proxool:type=Pool, name=<alias>". 默认值为false.

jmx-agent-id: 一个逗号分隔的JMX代理列表(如使用MBeanServerFactory.findMBeanServer(String agentId)注册的连接池。）这个属性是仅当"jmx"属性设置为"true"才有效。所有注册jmx服务器使用这个属性是不确定的

jndi-name: 数据源的名称

maximum-active-time: 如果housekeeper 检测到某个线程的活动时间大于这个数值.它将会杀掉这个线程.所以确认一下你的服务器的带宽.然后定一个合适的值.默认是5分钟.

maximum-connection-count: 最大的数据库连接数.

maximum-connection-lifetime: 一个线程的最大寿命.

minimum-connection-count: 最小的数据库连接数

overload-without-refusal-lifetime: 这可以帮助我们确定连接池的状态。如果我们已经拒绝了一个连接在这个设定值(毫秒),然后被认为是超载。默认为60秒。

prototype-count: 连接池中可用的连接数量.如果当前的连接池中的连接少于这个数值.新的连接将被建立(假设没有超过最大可用数).例如.我们有3个活动连接2个可用连接,而我们的prototype-count是4,那么数据库连接池将试图建立另外2个连接.这和 minimum-connection-count不同. minimum-connection-count把活动的连接也计算在内.prototype-count 是spare connections 的数量.

recently-started-threshold:  这可以帮助我们确定连接池的状态,连接数少还是多或超载。只要至少有一个连接

已开始在此值(毫秒)内,或者有一些多余的可用连接,那么我们假设连接池是开启的。默认为60秒

 

simultaneous-build-throttle:  这是我们可一次建立的最大连接数。那就是新增的连接请求,但还没有可供使用的连接。由于连接可以使用多线程,在有限的时间之间建立联系从而带来可用连接，但是我们需要通过一些方式确认一些线程并不是立即响应连接请求的，默认是10。

statistics:  连接池使用状况统计。 参数“10s,1m,1d”

statistics-log-level:  日志统计跟踪类型。 参数“ERROR”或 “INFO”

test-before-use: 如果为true，在每个连接被测试前都会服务这个连接，如果一个连接失败，那么将被丢弃，另一个连接将会被处理，如果所有连接都失败，一个新的连接将会被建立。否则将会抛出一个SQLException异常。

test-after-use: 如果为true，在每个连接被测试后都会服务这个连接，使其回到连接池中，如果连接失败，那么将被废弃。

trace: 如果为true,那么每个被执行的SQL语句将会在执行期被log记录(DEBUG LEVEL).你也可以注册一个ConnectionListener (参看ProxoolFacade)得到这些信息.

verbose: 详细信息设置。 参数 bool 值

 

英文文档：http://proxool.sourceforge.net/properties.html

proxool包下载：从http://proxool.sourceforge.net/下载proxool-0.9.0RC2.jar, commons-logging.jar

 

连接数据的方法还有一种普通的JDBC连接：

Class.forName("com.mysql.jdbc.Driver");//数据库的驱动

Connection con = DriverManager.getConnection("jdbc:mysql://127.0.0.1:3306/student","root","root");//连接的url

proxool连接方法：

Class.forName("org.logicalcobwebs.proxool.ProxoolDriver");

Connection con = DriverManager.getConnection("proxool.aaa:com.mysql.jdbc.Driver:jdbc:mysql://127.0.0.1:3306/mysql","root","rootroot");

需要注意的是，Class.forName加载的是proxool的驱动。

getConnection里url的内容是("proxool.别名：数据库的驱动：连接的url")

这里的别名可以随便填写，但一定要写……