分享

proxool连接池配置详细说明 - New - JavaEye论坛

 青青小舟 2010-10-20

      目前市面上三个主流连接池从性能上排名如下:proxool>c3p0>dbcp,proxool还提供了可视化的连接池实时监控工具,所以既稳定又方便,配置也是非常容易的事情。下面我来讲讲我如何配置proxool连接池的。
      1、下载相关资源。

      从http://proxool./站点上下载我们需要的资源,proxool-0.9.1是最新版本,解压后从lib下copy里面的2个JAR包 proxool-0.9.1.jar和 

proxool-cglib.jar至项目中去。如果不加proxool-cglib.jar的话会报 java.lang.ClassNotFoundException:org.logicalcobwebs.cglib.proxy.Callback异常。 

      2、首先在WEB-INF目录下新建一个proxool.xml文件。

Java代码
  1. <?xml version="1.0" encoding="UTF-8"?>  
  2. <proxool-config>  
  3.     <proxool>  
  4.         <alias>datasource1</alias>  
  5.         <driver-url>jdbc:mysql://localhost:3306/datasource1</driver-url>  
  6.         <driver-class>com.mysql.jdbc.Driver</driver-class>  
  7.         <driver-properties>  
  8.             <property name="user" value="root" />  
  9.             <property name="password" value="root" />  
  10.         </driver-properties>  
  11.         <house-keeping-sleep-time>90000</house-keeping-sleep-time>  
  12.         <maximum-new-connections>20</maximum-new-connections>  
  13.         <prototype-count>5</prototype-count>  
  14.         <maximum-connection-count>1000</maximum-connection-count>  
  15.         <minimum-connection-count>10</minimum-connection-count>  
  16.     </proxool>  
  17.       
  18.     <proxool>  
  19.         <alias>datasource2</alias>  
  20.         <driver-url>jdbc:sybase:Tds:localhost:16428/datasource2</driver-url>  
  21.         <driver-class>com.sybase.jdbc3.jdbc.SybDriver</driver-class>  
  22.         <driver-properties>  
  23.             <property name="user" value="dba" />  
  24.             <property name="password" value="dba" />  
  25.         </driver-properties>  
  26.         <house-keeping-sleep-time>90000</house-keeping-sleep-time>  
  27.         <maximum-new-connections>20</maximum-new-connections>  
  28.         <prototype-count>5</prototype-count>  
  29.         <maximum-connection-count>1000</maximum-connection-count>  
  30.         <minimum-connection-count>10</minimum-connection-count>  
  31.     </proxool>  
  32. </proxool-config>  

           我在里面配置了2个不同数据库的数据源,你可以根据需要配置多个,其中具体的参数属性我会在下面全部予以说明。
      3、配置web.xml文件。

Java代码
  1. <?xml version="1.0" encoding="UTF-8" ?>  
  2. <web-app version="2.5" xmlns="http://java./xml/ns/javaee"  
  3.     xmlns:xsi="http://www./2001/XMLSchema-instance"  
  4.     xsi:schemaLocation="http://java./xml/ns/javaee http://java./xml/ns/javaee/web-app_2_5.xsd">  
  5.     <servlet>  
  6.         <servlet-name>ServletConfigurator</servlet-name>  
  7.         <servlet-class>  
  8.             org.logicalcobwebs.proxool.configuration.ServletConfigurator  
  9.         </servlet-class>  
  10.         <init-param>  
  11.             <param-name>xmlFile</param-name>  
  12.             <param-value>WEB-INF/proxool.xml</param-value>  
  13.         </init-param>  
  14.         <load-on-startup>1</load-on-startup>  
  15.     </servlet>  
  16.     <servlet>  
  17.         <servlet-name>datasource_situation</servlet-name>  
  18.         <servlet-class>  
  19.             org.logicalcobwebs.proxool.admin.servlet.AdminServlet  
  20.         </servlet-class>  
  21.     </servlet>  
  22.     <servlet-mapping>  
  23.         <servlet-name>datasource_situation</servlet-name>  
  24.         <url-pattern>/datasource_situation</url-pattern>  
  25.     </servlet-mapping>  
  26.     <!-- 配置受保护域,只有Tomcat管理员才能察看连接池的信息 -->  
  27.     <security-constraint>  
  28.         <web-resource-collection>  
  29.             <web-resource-name>proxool</web-resource-name>  
  30.             <url-pattern>/datasource_situation</url-pattern>  
  31.         </web-resource-collection>  
  32.         <auth-constraint>  
  33.             <role-name>manager</role-name>  
  34.         </auth-constraint>  
  35.     </security-constraint>  
  36.     <login-config>  
  37.         <auth-method>BASIC</auth-method>  
  38.         <realm-name>proxool manager Application</realm-name>  
  39.     </login-config>  
  40.     <security-role>  
  41.         <description>  
  42.             The role that is required to log in to the Manager  
  43.             Application  
  44.         </description>  
  45.         <role-name>manager</role-name>  
  46.     </security-role>  
  47.     <error-page>  
  48.         <error-code>401</error-code>  
  49.         <location>/401.jsp</location>  
  50.     </error-page>  
  51. </web-app>  

           <load-on-startup>1</load-on-startup>用来设置加载属性,一定要保证在其他配置项之前加载。

Java代码
  1. <servlet>  
  2.     <servlet-name>datasource_situation</servlet-name>  
  3.     <servlet-class>  
  4.         org.logicalcobwebs.proxool.admin.servlet.AdminServlet  
  5.     </servlet-class>  
  6. </servlet>  
  7. <servlet-mapping>  
  8.     <servlet-name>datasource_situation</servlet-name>  
  9.     <url-pattern>/datasource_situation</url-pattern>  
  10. </servlet-mapping>  

            这个属性是用来提供察看连接池信息的工具,既在域名后跟上/datasource_situation就可以查看了,当然名字可以自己定义。如果你想限制用户和密码来访问就用

Java代码
  1. <security-constraint>  
  2.         <web-resource-collection>  
  3.             <web-resource-name>proxool</web-resource-name>  
  4.             <url-pattern>/datasource_situation</url-pattern>  
  5.         </web-resource-collection>  
  6.         <auth-constraint>  
  7.             <role-name>manager</role-name>  
  8.         </auth-constraint>  
  9.     </security-constraint>  
  10.     <login-config>  
  11.         <auth-method>BASIC</auth-method>  
  12.         <realm-name>proxool manager Application</realm-name>  
  13.     </login-config>  
  14.     <security-role>  
  15.         <description>  
  16.             The role that is required to log in to the Manager  
  17.             Application  
  18.         </description>  
  19.         <role-name>manager</role-name>  
  20.     </security-role>  
  21.     <error-page>  
  22.         <error-code>401</error-code>  
  23.         <location>/401.jsp</location>  
  24.     </error-page>  

           这段配置就限定了只有输入了TOMCAT的管理员账号密码后就能登陆连接池查看工具了,如果连续三次登陆失败,进入401.jsp页面。401.jsp要加入下段代码

           response.setHeader("WWW-Authenticate", "Basic realm=\"Tomcat Manager Application\"");

      4、配置连接池连接类。

Java代码
  1. package selfservice;          
  2.          
  3. import java.sql.Connection;          
  4. import java.sql.DriverManager;          
  5. import java.sql.ResultSet;          
  6. import java.sql.SQLException;          
  7. import java.sql.Statement;          
  8.          
  9. import org.logicalcobwebs.proxool.ProxoolException;          
  10. import org.logicalcobwebs.proxool.ProxoolFacade;          
  11. import org.logicalcobwebs.proxool.admin.SnapshotIF;          
  12.          
  13.          
  14. public class PoolManager {          
  15.               
  16.     private static int activeCount = 0;          
  17.               
  18.               
  19.     public PoolManager(){          
  20.                   
  21.     }             
  22.     /**       
  23.      * 获取连接       
  24.      * getConnection       
  25.      * @param name       
  26.      * @return       
  27.      */         
  28.     public Connection getConnection() {          
  29.         try{          
  30.             Class.forName("org.logicalcobwebs.proxool.ProxoolDriver");//proxool驱动类          
  31.             Connection conn = DriverManager.getConnection("proxool.datasource1");       
  32.            //此处的datasource1是在proxool.xml中配置的连接池别名,当然根据需要可以用datasource2         
  33.             showSnapshotInfo();          
  34.                       
  35.             return conn;          
  36.         }catch(Exception ex){          
  37.             ex.printStackTrace();          
  38.         }          
  39.         return null;          
  40.     }          
  41.     /**       
  42.      * 此方法可以得到连接池的信息       
  43.      * showSnapshotInfo       
  44.      */         
  45.     private void showSnapshotInfo(){          
  46.         try{          
  47.             SnapshotIF snapshot = ProxoolFacade.getSnapshot("datasource1"true);          
  48.             int curActiveCount=snapshot.getActiveConnectionCount();//获得活动连接数          
  49.             int availableCount=snapshot.getAvailableConnectionCount();//获得可得到的连接数          
  50.             int maxCount=snapshot.getMaximumConnectionCount() ;//获得总连接数          
  51.             if(curActiveCount!=activeCount)//当活动连接数变化时输出的信息          
  52.             {          
  53.              System.out.println("活动连接数:"+curActiveCount+"(active)  可得到的连接数:"+availableCount+"(available)  总连接数:"+maxCount+"(max)");                       
  54.              activeCount=curActiveCount;          
  55.             }          
  56.         }catch(ProxoolException e){          
  57.             e.printStackTrace();          
  58.         }          
  59.     }          
  60.     /**       
  61.      * 获取连接       
  62.      * getConnection       
  63.      * @param name       
  64.      * @return       
  65.      */         
  66.     public Connection getConnection(String name){          
  67.         return getConnection();          
  68.     }          
  69.     /**       
  70.      * 释放连接       
  71.      * freeConnection       
  72.      * @param conn       
  73.      */         
  74.     public void freeConnection(Connection conn){          
  75.         if(conn!=null){          
  76.             try {          
  77.                 conn.close();          
  78.             } catch (SQLException e) {                        
  79.                 e.printStackTrace();          
  80.             }          
  81.         }          
  82.     }          
  83.     /**       
  84.      * 释放连接       
  85.      * freeConnection       
  86.      * @param name       
  87.      * @param con       
  88.      */         
  89.     public void freeConnection (String name,Connection con){          
  90.         freeConnection(con);          
  91.     }          
  92.               
  93.     public void getQuery() {                  
  94.         try {          
  95.             Connection conn = getConnection();          
  96.             if(conn != null){          
  97.                 Statement statement = conn.createStatement();          
  98.                 ResultSet rs = statement.executeQuery("select * from tblgxinterface");          
  99.                 int c = rs.getMetaData().getColumnCount();          
  100.                 while(rs.next()){                             
  101.                     System.out.println();          
  102.                     for(int i=1;i<=c;i++){          
  103.                         System.out.print(rs.getObject(i));          
  104.                     }          
  105.                 }          
  106.                 rs.close();          
  107.             }          
  108.             freeConnection(conn);          
  109.         } catch (SQLException e) {                    
  110.             e.printStackTrace();          
  111.         }          
  112.          
  113.     }          
  114.          
  115. }    

        测试成功!

        下面我来介绍一下proxool.xml文件中关于proxool各个属性的详细说明:

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:

 

jmx-agent-id:

 

jndi-name: 数据源的名称

 

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

 

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

 

maximum-connection-lifetime: 连接最大生命时间 默认4小时

 

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

 

overload-without-refusal-lifetime:

 

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

 

recently-started-threshold:  略

 

simultaneous-build-throttle:  同时最大连接数

 

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

 

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

 

test-before-use:

 

test-after-use:

 

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

 

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

 

提供一个附件,里面是proxool-0.9.1.jar和proxool-cglib.jar,欢迎下载试用。

  • lib.rar (469.3 KB)
  • 下载次数: 222

    本站是提供个人知识管理的网络存储空间,所有内容均由用户发布,不代表本站观点。请注意甄别内容中的联系方式、诱导购买等信息,谨防诈骗。如发现有害或侵权内容,请点击一键举报。
    转藏 分享 献花(0

    0条评论

    发表

    请遵守用户 评论公约

    类似文章 更多