连接池proxool配置

  Connection Pooling Proxool                                     

原文地址: http://painisk.blogchina.com/4511289.html

SECTION 01 为何需要 connection pooling 

当我们进入了 Java 的开发世界, pool 也是一门学问, 如何让 connection 先建立好与 DB 的连结, 后来的人 可以使用已经存在于 pool 的 connection, 减少连结的时间, 这么优秀的功能, 在许多 application server 都已 经实现好了, 你只要简单地按照说明文件配置, 包括最大连结数量, 初始连结数量, 最大等待数量等等的参数, 当然, Tomcat 也有内 建 commons-dbcp 相关的 connection pooling 机制, 请查阅  Tomcat JNDI Datasource 设定 !!

而 proxool 是一个强大的 connection pooling 项目, 兼容于 jdk 1.3 以及 1.4. 也已经实现了 监控, 纪 录等等的功能, 对于一个有限制 connection 数量, 及注重 performation 的项目来说, 是一套非常完整的解决方案. 

下载区, 目前版本 0.7.2

http://sourceforge.net/projects/proxool/  


SECTION 02 设置 AdminServlet 

首先, 你要把下载 proxool 的 lib 下面所有的 jar 文件, 放到 WEB-INF/lib 下面, 

另外, 把你的 jdbc driver 也放到相同的 lib, 接著就是配置 /WEB-INF/web.xml 

web.xml

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE web-app 
PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN" 
"/WEB-INF/dtds/web-app_2_3.dtd">
<web-app>
<display-name>proxool</display-name>
<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> 

</web-app>

SECTION 03 通过 ProxoolDriver 取得 connection 

建立一个 jsp or DAO Bean, 通过 org.logicalcobwebs.proxool.ProxoolDriver 建立 Connection

test.jsp

<%@page import="java.sql.*"%>
<%
Connection connection = null;
try {
Class.forName("org.logicalcobwebs.proxool.ProxoolDriver");

connection = DriverManager.getConnection(
"proxool.test:org.gjt.mm.mysql.Driver:jdbc:mysql://localhost:3306/test",
"root",
"password"
);
} catch (Exception e) {
 out.println(e)
}
out.println("OK");
%>

SECTION 04 检视 pooling 现在状态 

执行 http://localhost:8080/proxool-test/admin ( proxool-test 是你的应用名 称 ) 如果没有任何 pool 状态的时候, 你只会看到 Pools 这几个字, 所以你先执行 http://localhost:8080 /proxool-test/test.jsp 建立一个 connection, 就可以监控 connection pooling 的状态了. 

Pools  > test -> jdbc:mysql://www:3306/test Defintition for test  URL jdbc:mysql://localhost:3306/test Driver org.gjt.mm.mysql.Driver Connections 0 (min), 15 (max) Prototyping off Connection Lifetime 11:00:00 Maximum active time 07:05:00 House keeping sleep time 30s House keeping test SQL off Fatal SQL exceptions off Statistics off Snapshot at 21:12:53  Start date 01-??-2003 21:12:30 Connections 1 (active), 0 (available), 15 (max) Served 1 Refused 0 Details # born last start lap (ms)  thread 1  21:12:31  21:12:31 22432    Thread-15 less information Proxool 0.7.2 (29-Apr-2003 00:33)

SECTION 05 使用 properties 或者 xml 来设置 DB URL 及 Driver 

可以采用 xml 配置文件, 在程序中使用 JAXPConfigurator.configure("proxool.xml", false); 配置文件设置如下 

WEB-INF/proxool.xml
<?xml version="1.0" encoding="ISO-8859-1"?>
<!-- the proxool configuration can be embedded within your own application's.
Anything outside the "proxool" tag is ignored. -->
<something-else-entirely>
  <proxool>
    <alias>xml-test</alias>
    <driver-url>jdbc:mysql://localhost:3306/test</driver-url>
    <driver-class>org.gjt.mm.mysql.Driver</driver-class>
    <driver-properties>
      <property name="user" value="root"/>
      <property name="password" value="password"/>
    </driver-properties>
    <maximum-connection-count>10</maximum-connection-count>
    <house-keeping-test-sql>select CURRENT_DATE</house-keeping-test-sql>
  </proxool>
</something-else-entirely>

也可以采用 properties, 在程序 PropertyConfigurator.configure("proxool.properties"); 文件设置 

WEB-INF/proxool.properties
jdbc-0.proxool.alias=property-test
jdbc-0.proxool.driver-url=jdbc:mysql://localhost:3306/test
jdbc-0.proxool.driver-class=org.gjt.mm.mysql.Driver
jdbc-0.user=root
jdbc-0.password=password
jdbc-0.proxool.maximum-connection-count=10
jdbc-0.proxool.house-keeping-test-sql=select CURRENT_DATE

如果在 Web 使用, 在 web.xml 也可以设置 ServletConfigurator Servlet 来注册 

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE web-app 
PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"
"/WEB-INF/dtds/web-app_2_3.dtd">
<web-app>
 <display-name>proxool</display-name>

 <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> 

</web-app>

在程序中, 只需要利用到别名就可以呼叫 connection pool 里面的 connection 来使用了 

<%@page import="java.sql.*;"%>
<%
Connection connection = null;
try {
 Class.forName("org.logicalcobwebs.proxool.ProxoolDriver");
 connection = DriverManager.getConnection("proxool.xml-test");

} catch (Exception e) {
 out.println(e);
}

out.println("ok");
%>