proxool连接池

最近做的一个项目中运用到了连接池技术，可能我们大家比较熟悉的开源连接池有dbcp,c3p0,proxool。对这三种连接池来说，从性能和出错率来说，proxool稍微比前两种好些。今天我主要简单的讲述一下，我在项目中成功的配置和源码。

        第一步：首先去[url]http://proxool.sourceforge.net/[/url]下载一个proxool.jar文件了，我用的是proxool-0.8.3.jar,现在最新版本是proxool-0.9.3.jar.除了他们的查看监控台的页面有变化，其他的变化不是太大。

        第二步：就是写一个单独的proxool.xml文件放到WEB-INF文件夹下。我用的数据库是MySQL.

  peoxool.xml的配置文件如下：

 <?xml version="1.0" encoding="UTF-8"?>
<proxool-config>
 <proxool>
  <alias>db</alias>
  <driver-url>jdbc:mysql://×××.×××.××.×××:3303/mydb<driver-url>
  <driver-class>com.mysql.jdbc.Driver</driver-class>
  <driver-properties>
   <property name="user" value="root" />
   <property name="password" value="*******" />
  </driver-properties>
  <house-keeping-sleep-time>90000</house-keeping-sleep-time>
  <maximum-new-connections>20</maximum-new-connections>
  <prototype-count>5</prototype-count>
  <maximum-connection-count>1000</maximum-connection-count>
  <minimum-connection-count>10</minimum-connection-count>
  </proxool>
</proxool-config>

     对以上配置简单的解释：

  1.<alias>  ：为该连接池起一个别名，在其他文件中引用。引用是：(proxool.db);

  2. <driver-class>com.mysql.jdbc.Driver</driver-class>
     <driver-properties>
     <property name="user" value="root" />
     <property name="password" value="root" />
   </driver-properties>

    这些配置大家应该比较熟悉吧。配置数据库的驱动和连接。

 3.<house-keeping-sleep-time>  ：proxool自动侦察各个连接状态的时间间隔(毫秒),侦察到空闲的连接就马上回收,超时的销毁。

 4.<maximum-new-connections>： 指因未有空闲连接可以分配而在队列中等候的最大请求数,超过这个请求数的用户连接就不会被接受。

5.<prototype-count>：最少保持的空闲连接数。

6.<maximum-connection-count>: 允许最大连接数,超过了这个连接，再有请求时，就排在队列中等候，最大的等待请求数由maximum-new-connections决定

7.<minimum-connection-count>:最小连接数

  第三步：加载并初始化proxool.xml文件。因为它是连接数据库的，其他很多模块都用到数据，所以你必须首先加载它，在web.xml中进行如下配置：如果你以前加载applicationContext.xml用的是：

<listener>
    <listener-class>
  org.springframework.web.context.ContextLoaderListener
    </listener-class>
 </listener>

  这时你必须换成如下配置：

 <servlet>
  <servlet-name>contextConfigLocation</servlet-name>
  <servlet-class>
   org.springframework.web.context.ContextLoaderServlet
  </servlet-class>
  <load-on-startup>2</load-on-startup>
 </servlet>

 要不然你就会遇见这样的错误：

1. Problem   
2. org.logicalcobwebs.proxool.ProxoolException: Attempt to refer to a unregistered pool by its
3. alias 'db'
      如果用过proxool与spring整合时，不少就遇到过这样的问题，其实这个问题很明显就是你的proxool.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>
  把<load-on-startup>的值设为1，值越小级别就越高，就先被加载初始化。一定要先于applicationContext.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>
 如果访问的话，可能有点问题，会报ISO-8859-1的问题。我们一般用的是utf-8,gbk2312.最好的解决办法就是重写源码中的AdminServlet
.java。我就是重写了这个源码。才解决了这个乱码问题。可能还有其他办法：只需简单的该一个方法就可以了。
private void printDefinitionEntry(ServletOutputStream out, String name, String value) throws IOException {
        out.println("    <tr>");
        out.print("      <td width=\"200\" valign=\"top\" style=\"" + STYLE_CAPTION + "\">");
        out.print(name);
        out.println("</td>");
        if (value != null) {
            out.print("      <td style=\"" + STYLE_DATA + "\">");
            out.print(new String(value.getBytes("ISO-8859-1"),"utf-8"));
        } else {
            out.print("      <td style=\"" + STYLE_NO_DATA + "\">off");
        }
        out.print("</td>");
        out.println("    </tr>");
    }
  上面红色的部分就是我改的部分,然后把web.xml中的
<servlet-class>
   com.jack.servlet.AdminServlet
 </servlet-class>
中<servlet-class>换成你改写的那个类。
   最后一步：整合spring和proxool。在applicationContext.xml文件中把原来数据源的配置成这样：
<bean id="dataSource"
  class="org.springframework.jdbc.datasource.DriverManagerDataSource">
  <property name="driverClassName">
   <value>org.logicalcobwebs.proxool.ProxoolDriver</value>
  </property>
  <property name="url">
   <value>proxool.db</value>
  </property>
 </bean>
   这个 <property name="url">要配置成proxool.xml中的别名。其他地方不用该了。也可以与hibernate整合。与spring整合比较简单。我采用的就是上面的配置方式。
        这样就配置完了，很清晰，很简单。如果查看监控情况的话：
[url]http://www.[/url]××××.com/admin  就可以查看了，如果你是本地测试：改一下路径就可以了。
        上面所讲述的是一个成功的配置，并在项目中成功的运用了。希望对连接池有爱好的朋友有所帮助。
-----------------------------
<?xml version="1.0" encoding="UTF-8"?>
<something-else-entirely>
     <proxool>
           <!-- 数据库连接别名（程序中需要使用的名称） -->
           <alias>fausheet</alias>
           <!-- 数据库驱动 -->
           <driver-url>jdbc:oracle:thin:@localhost:1521:inspur</driver-url>
           <!-- 驱动程序类 -->
           <driver-class>oracle.jdbc.driver.OracleDriver</driver-class>
           <!-- 联机数据库的用户和密码 -->
           <driver-properties>
                 <property name="user" value="inspur" />
                 <property name="password" value="inspur"/>
           </driver-properties>
           <!-- 最小连接数量，建议设置0以上，保证第一次连接时间 -->
           <minimum-connection-count>2</minimum-connection-count>
           <!-- 最大连接数量，如果超过最大连接数量则会抛出异常。连接数设置过多，服务器CPU和内存性能消耗很大。 -->
           <maximum-connection-count>50</maximum-connection-count>
           <!-- 同时最大连接数 -->
           <simultaneous-build-throttle>20</simultaneous-build-throttle>
           <!-- 一次产生连接的数量 -->
           <!-- 例：如果现在prototype-count设置为4个，但是现在已经有2个可以获得的连接，那么将会试图再创建2个连接。 -->
           <prototype-count>5</prototype-count>
           <!--连接最大时间活动 默认5分钟 -->
           <maximum-active-time>300000</maximum-active-time>
           <!-- 连接最大生命时间 默认4小时 这里设置为5小时-->
           <maximum-connection-lifetime>18000000</maximum-connection-lifetime>

     </proxool>
</something-else-entirely>