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. 1. 1. Problem   
      2. org.logicalcobwebs.proxool.ProxoolException: Attempt to refer to a unregistered pool by its
      3. alias 'db'
      4.       如果用过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  就可以查看了，如果你是本地测试：改一下路径就可以了。
                 上面所讲述的是一个成功的配置，并在项目中成功的运用了。希望对连接池有爱好的朋友有所帮助。