proxool+spring[转](附proxool包)

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

        第一步：首先去http://proxool.sourceforge.net/下载一个proxool.jar文件了，我用的是proxool-0.9.0RC3.jar,现在最新版本是proxool-0.9.1.jar,我在用这个JAR包时,老是报如下错误:
严重: Servlet.service() for servlet action threw exception
java.lang.NoClassDefFoundError: org/logicalcobwebs/cglib/proxy/Callback
at org.logicalcobwebs.proxool.ConnectionPool.getConnection(ConnectionPool.java:261)
at org.logicalcobwebs.proxool.ProxoolDriver.connect(ProxoolDriver.java:89)
at java.sql.DriverManager.getConnection(Unknown Source)
at java.sql.DriverManager.getConnection(Unknown Source)

最后换用proxool-0.9.0RC3.jar无此问题,哪们知道解决办法的话,请留言.
.除了他们的查看监控台的页面有变化，其他的变化不是太大。

        第二步：就是写一个单独的proxool.xml文件放到WEB-INF文件夹下。我用的数据库是MySQL.
proxool.xml的配置如下;
<?xml version="1.0" encoding="utf-8"?>
<something-else-entirely>
<proxool>
<!--为该连接池起一个别名，在其他文件中引用。引用是：(proxool.dbPool);-->
<alias>database</alias>

<!--数据库连接信息-->
<driver-url>jdbc:mysql://localhost:3306/oa?autoReconnect=true&amp;amp;useUnicode=true&amp;amp;characterEncoding=UTF-8</driver-url>
<driver-class>com.mysql.jdbc.Driver</driver-class>
<driver-properties>
   <!--数据库连接用户名-->
   <property name="user" value="root"/>
    <!--数据库连接密码-->
   <property name="password" value="123456"/>
</driver-properties>
<!-- proxool自动侦察各个连接状态的时间间隔90000(毫秒),侦察到空闲的连接就马上回收,超时的销毁-->
<house-keeping-sleep-time>90000</house-keeping-sleep-time>
<!-- 指因没有空闲连接可以分配而在队列中等候的最大请求数,超过这个请求数的用户连接就不会被接受-->
<maximum-new-connections>20</maximum-new-connections>
<!-- 最少保持的空闲连接数-->
<prototype-count>3</prototype-count>
<!-- 允许最大连接数,超过了这个连接，再有请求时，就排在队列中等候，最大的等待请求数由maximum-new-connections决定-->
<maximum-connection-count>100</maximum-connection-count>
<!-- 最小连接数-->
<minimum-connection-count>5</minimum-connection-count>
<house-keeping-test-sql>select CURRENT_DATE</house-keeping-test-sql>
</proxool>
</something-else-entirely>

     对以上配置简单的解释：
    1.<alias> ：为该连接池起一个别名，在其他文件中引用。引用是：(proxool.database);
    2. <driver-class>com.mysql.jdbc.Driver</driver-class>
     <driver-properties>
     <property name="user" value="root" />
     <property name="password" value="123456" />
    </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如下

<?xml version="1.0" encoding="utf-8"?>
<something-else-entirely>
<proxool>
<alias>database</alias>
<driver-url>jdbc:mysql://localhost:3306/newssystem?autoReconnect=true&amp;useUnicode=true&amp;characterEncoding=UTF-8</driver-url>
<driver-class>com.mysql.jdbc.Driver</driver-class>
<driver-properties>
   <property name="user" value="root"/>
   <property name="password" value="123456"/>
</driver-properties>
<house-keeping-sleep-time>90000</house-keeping-sleep-time>
<prototype-count>3</prototype-count>
<maximum-new-connections>20</maximum-new-connections>
<maximum-connection-count>100</maximum-connection-count>
<minimum-connection-count>5</minimum-connection-count>
<house-keeping-test-sql>select CURRENT_DATE</house-keeping-test-sql>
</proxool>
</something-else-entirely>

    第三步：加载并初始化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>

    要不然你就会遇见这样的错误：
    Problem
    org.logicalcobwebs.proxool.ProxoolException: Attempt to refer to a unregistered pool by its
    alias 'database'（我也碰到了这个问题，原因是数据库连接的URL没写错，一定要认真核对！！）

      如果用过proxool与spring整合时，不少就遇到过这样的问题，其实这个问题很明显就是你的proxool.xml没有被先加载初始化，我们应该让它先加载，应该这样配置：

<!-- proxool连接池 -->
    <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>

至此,我的完整的web.xml配置如下:
<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns="http://java.sun.com/xml/ns/j2ee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" version="2.4"
xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee   http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd">
<filter>
   <filter-name>EncodingFilter</filter-name>
   <filter-class>
    com.sidi.struts.filter.EncodingFilter
   </filter-class>
</filter>
<filter-mapping>
   <filter-name>EncodingFilter</filter-name>
   <url-pattern>/*</url-pattern>
</filter-mapping>
<!--
   <filter>
   <filter-name>SecurityFilter</filter-name>
   <filter-class>com.sidi.struts.filter.SafeFilter</filter-class>
   </filter>
   <filter-mapping>
   <filter-name>SecurityFilter</filter-name>
   <url-pattern>/admin/*</url-pattern>
   </filter-mapping>
-->
<servlet>
   <servlet-name>action</servlet-name>
   <servlet-class>
    org.apache.struts.action.ActionServlet
   </servlet-class>
   <init-param>
    <param-name>config</param-name>
    <param-value>/WEB-INF/struts-config.xml</param-value>
   </init-param>
   <init-param>
    <param-name>debug</param-name>
    <param-value>3</param-value>
   </init-param>
   <init-param>
    <param-name>detail</param-name>
    <param-value>3</param-value>
   </init-param>
   <load-on-startup>0</load-on-startup>
</servlet>
<servlet-mapping>
   <servlet-name>action</servlet-name>
   <url-pattern>*.do</url-pattern>
</servlet-mapping>

<!-- proxool连接池 -->
<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>


<context-param>
       <param-name>contextConfigLocation</param-name>
       <param-value>/WEB-INF/classes/applicationContext.xml</param-value>
</context-param>

<welcome-file-list>
   <welcome-file>index.jsp</welcome-file>
</welcome-file-list>
<session-config>
   <session-timeout>20</session-timeout>
</session-config>

</web-app>

(我的这一步(暗红色部分)在实际操作中直接跳过了)
   如果访问数据库监控的话，可能有点问题，会报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.apache.commons.dbcp.BasicDataSource">
   <property name="driverClassName"
    value="com.mysql.jdbc.Driver">
   </property>
   <property name="url"
    value="jdbc:mysql://localhost:3306/oa?autoReconnect=true&amp;amp;useUnicode=true&amp;amp;characterEncoding=UTF-8">
   </property>
   <property name="username" value="root"></property>
   <property name="password" value="123456"></property>
</bean>
改为下面的-->

   <bean id="dataSource"
    class="org.springframework.jdbc.datasource.DriverManagerDataSource">
    <property name="driverClassName">
    <value>org.logicalcobwebs.proxool.ProxoolDriver</value>
    </property>
    <property name="url">
    <value>proxool.database</value>
    </property>
    </bean>

    注:这个 <property name="url">要配置成proxool.xml中的别名。其他地方不用该了。也可以与hibernate整合。与spring整合比较简单。我采用的就是上面的配置方式。

    这样就配置完了，很清晰，很简单。
如果查看监控情况的话：
    http://www.××××.com/admin 就可以查看了，如果你是本地测试：改一下路径就可以了。