1、下载相关资源。
从http://proxool.sourceforge.net/站点上下载我们需要的资源,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文件。
- <?xml version="1.0" encoding="UTF-8"?>
- <proxool-config>
- <proxool>
- <alias>datasource1</alias>
- <driver-url>jdbc:mysql://localhost:3306/datasource1</driver-url>
- <driver-class>com.mysql.jdbc.Driver</driver-class>
- <driver-properties>
- <property name="user" value="root" />
- <property name="password" value="root" />
- </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>
- <alias>datasource2</alias>
- <driver-url>jdbc:sybase:Tds:localhost:16428/datasource2</driver-url>
- <driver-class>com.sybase.jdbc3.jdbc.SybDriver</driver-class>
- <driver-properties>
- <property name="user" value="dba" />
- <property name="password" value="dba" />
- </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>
我在里面配置了2个不同数据库的数据源,你可以根据需要配置多个,其中具体的参数属性我会在下面全部予以说明。
3、配置web.xml文件。
- <?xml version="1.0" encoding="UTF-8" ?>
- <web-app version="2.5" xmlns="http://java.sun.com/xml/ns/javaee"
- xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
- xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd">
- <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>datasource_situation</servlet-name>
- <servlet-class>
- org.logicalcobwebs.proxool.admin.servlet.AdminServlet
- </servlet-class>
- </servlet>
- <servlet-mapping>
- <servlet-name>datasource_situation</servlet-name>
- <url-pattern>/datasource_situation</url-pattern>
- </servlet-mapping>
- <!-- 配置受保护域,只有Tomcat管理员才能察看连接池的信息 -->
- <security-constraint>
- <web-resource-collection>
- <web-resource-name>proxool</web-resource-name>
- <url-pattern>/datasource_situation</url-pattern>
- </web-resource-collection>
- <auth-constraint>
- <role-name>manager</role-name>
- </auth-constraint>
- </security-constraint>
- <login-config>
- <auth-method>BASIC</auth-method>
- <realm-name>proxool manager Application</realm-name>
- </login-config>
- <security-role>
- <description>
- The role that is required to log in to the Manager
- Application
- </description>
- <role-name>manager</role-name>
- </security-role>
- <error-page>
- <error-code>401</error-code>
- <location>/401.jsp</location>
- </error-page>
- </web-app>
<load-on-startup>1</load-on-startup>用来设置加载属性,一定要保证在其他配置项之前加载。
- <servlet>
- <servlet-name>datasource_situation</servlet-name>
- <servlet-class>
- org.logicalcobwebs.proxool.admin.servlet.AdminServlet
- </servlet-class>
- </servlet>
- <servlet-mapping>
- <servlet-name>datasource_situation</servlet-name>
- <url-pattern>/datasource_situation</url-pattern>
- </servlet-mapping>
这个属性是用来提供察看连接池信息的工具,既在域名后跟上/datasource_situation就可以查看了,当然名字可以自己定义。如果你想限制用户和密码来访问就用
- <security-constraint>
- <web-resource-collection>
- <web-resource-name>proxool</web-resource-name>
- <url-pattern>/datasource_situation</url-pattern>
- </web-resource-collection>
- <auth-constraint>
- <role-name>manager</role-name>
- </auth-constraint>
- </security-constraint>
- <login-config>
- <auth-method>BASIC</auth-method>
- <realm-name>proxool manager Application</realm-name>
- </login-config>
- <security-role>
- <description>
- The role that is required to log in to the Manager
- Application
- </description>
- <role-name>manager</role-name>
- </security-role>
- <error-page>
- <error-code>401</error-code>
- <location>/401.jsp</location>
- </error-page>
这段配置就限定了只有输入了TOMCAT的管理员帐号密码后就能登陆连接池查看工具了,如果连续三次登陆失败,进入401.jsp页面。401.jsp要加入下段代码
response.setHeader("WWW-Authenticate", "Basic realm=\"Tomcat Manager Application\"");
4、配置连接池连接类。
- public class PoolManager {
- private static int activeCount = 0;
- public PoolManager(){
- }
- /**
- * 获取连接
- * getConnection
- * @param name
- * @return
- */
- public Connection getConnection() {
- try{
- Class.forName("org.logicalcobwebs.proxool.ProxoolDriver");//proxool驱动类
- Connection conn = DriverManager.getConnection("proxool.datasource1");
- //此处的datasource1是在proxool.xml中配置的连接池别名,当然根据需要可以用datasource2
- showSnapshotInfo();
- return conn;
- }catch(Exception ex){
- ex.printStackTrace();
- }
- return null;
- }
- /**
- * 此方法可以得到连接池的信息
- * showSnapshotInfo
- */
- private void showSnapshotInfo(){
- try{
- SnapshotIF snapshot = ProxoolFacade.getSnapshot("datasource1", true);
- int curActiveCount=snapshot.getActiveConnectionCount();//获得活动连接数
- int availableCount=snapshot.getAvailableConnectionCount();//获得可得到的连接数
- int maxCount=snapshot.getMaximumConnectionCount() ;//获得总连接数
- if(curActiveCount!=activeCount)//当活动连接数变化时输出的信息
- {
- System.out.println("活动连接数:"+curActiveCount+"(active) 可得到的连接数:"+availableCount+"(available) 总连接数:"+maxCount+"(max)");
- activeCount=curActiveCount;
- }
- }catch(ProxoolException e){
- e.printStackTrace();
- }
- }
- /**
- * 获取连接
- * getConnection
- * @param name
- * @return
- */
- public Connection getConnection(String name){
- return getConnection();
- }
- /**
- * 释放连接
- * freeConnection
- * @param conn
- */
- public void freeConnection(Connection conn){
- if(conn!=null){
- try {
- conn.close();
- } catch (SQLException e) {
- e.printStackTrace();
- }
- }
- }
- /**
- * 释放连接
- * freeConnection
- * @param name
- * @param con
- */
- public void freeConnection (String name,Connection con){
- freeConnection(con);
- }
- public void getQuery() {
- try {
- Connection conn = getConnection();
- if(conn != null){
- Statement statement = conn.createStatement();
- ResultSet rs = statement.executeQuery("select * from tblgxinterface");
- int c = rs.getMetaData().getColumnCount();
- while(rs.next()){
- System.out.println();
- for(int i=1;i<=c;i++){
- System.out.print(rs.getObject(i));
- }
- }
- rs.close();
- }
- freeConnection(conn);
- } catch (SQLException e) {
- e.printStackTrace();
- }
- }
- }
下面介绍一下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 值