proxool数据库连接池的配置

1.首先要得到proxool.jar包配置到你的工程中去。

2.配置你的web工程的web.xml文件

加入如下代码：

 <display-name>proxool</display-name>
 <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>2</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>

3.因为你在web.xml中配置加载了一个文件proxool.xml而且他的路径是在WEB-INF文件夹的下面，所以你就加入一个proxool.xml文件。文件内容如下：（我连接的是mysql数据库）

<?xml   version="1.0"   encoding="gbk"?>  
  <!--   the   proxool   configuration   can   be   embedded   within   your   own   application's.  
  Anything   outside   the   "proxool"   tag   is   ignored.  utf-8 ISO8859_1  -->  
  <something-else-entirely>  
      <proxool>  
          <alias>mydb</alias>  

          <!--该名字表示连接你的mydb数据库，下面代码红色的部分表示你的数据库的链接采用的字符编码集为utf-8,如果不配置，会造成字符的乱码-->
          <driver-url>jdbc:mysql://localhost:3306/mydb?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="root"/>  
          </driver-properties>  
          <maximum-connection-count>10</maximum-connection-count><!-- pool max number -->  
          <minimum-connection-count>5 </minimum-connection-count><!-- pool min number -->
         
          <house-keeping-test-sql>select * from kindergarden_message</house-keeping-test-sql>  
      </proxool>  
            
  </something-else-entirely>  

4.写连接数据库的代码

红色的部分为连接的主方法，其他的类是直接调用getPoolConnection这个方法。

public Connection getPoolConnection(String poolName)
 {
  DataSource ds = null;
  Connection conn = null;
  try {
   if((conn=connectjdbcpool(poolName))==null){
    System.out.println("数据库："+poolName+"连接池无法获取，将关闭连接池！");
    ProxoolFacade.removeConnectionPool(poolName);
    System.out.println("数据库："+poolName+"连接池即将建立...");
    registerjdbcpool(poolName,"2","1");
    System.out.println("数据库："+poolName+"连接池建立！");
    return connectregister(poolName);
    
   }
  } catch (Exception e) {
   conn = getConnection();
   
   
  }
  
  return conn;
    
    
 }
 public Connection connectregister(String database) throws SQLException {
  
  try {
   return connectjdbcpool(database);

  } catch (Exception e) {
   e.printStackTrace();
   return null;
  }

}
 public Connection connectjdbcpool(String database) throws SQLException {

  try {
   //Class.forName("com.microsoft.jdbc.sqlserver.SQLServerDriver");
   return DriverManager.getConnection("proxool."+database);
  } catch (Exception e) {
   e.printStackTrace();
   return null;
  }

 }
 public void registerjdbcpool(String database,String max,String min)  {

  try {
   Class.forName("net.sourceforge.jtds.jdbc.Driver");
   // Class.forName("com.mysql.jdbc.Driver");
   Class.forName("org.logicalcobwebs.proxool.ProxoolDriver");
   
   properties_Base.setProperty("proxool.maximum-connection-count",max);
   properties_Base.setProperty("proxool.minimum-connection-count", min);
   properties_Base.setProperty("proxool.house-keeping-test-sql","SELECT top 1 id from kindergarden_mp3 ");
   properties_Base.setProperty("user", "root");
   properties_Base.setProperty("password", "root");
   alias_Base = database;
   driverClass_Base = "net.sourceforge.jtds.jdbc.Driver";
   if(database.equals("mydb")){
    driverUrl_Base = "jdbc:mysql://localhost:3306/"+database+";";
   }
   url_Base = "proxool." + alias_Base + ":" + driverClass_Base+ ":" + driverUrl_Base;
   ProxoolFacade.registerConnectionPool(url_Base, properties_Base);
   
   //return DriverManager.getConnection("proxool." + database);
  } catch (Exception e) {
   e.printStackTrace();
   //return null;
  }

 }

5.proxool.xml文件的配置参数

Properties

下面是全部的属性列表:

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: 一个线程的最大寿命.

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: 略

statistics-log-level:  略

test-before-use: 略

test-after-use: 略

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

verbose: 略.

alias                     -〉数据库连接别名（程序中需要使用的名称）
driver-url                -〉数据库驱动
driver-class                -〉驱动程序类
driver-properties            -〉联机数据库的用户和密码
minimum-connection-count     -〉最小连接数量，建议设置0以上，保证第一次连接时间
maximum-connection-count      -〉最大连接数量，如果超过最大连接数量则会抛出异常。连接数设置过多，服务器CPU和内存性能消耗很大。
simultaneous-build-throttle     -〉同时最大连接数
prototype-count                -〉一次产生连接的数量。
                                例：如果现在prototype-count设置为4个，但是现在已经有2个可以获得的连接，那么将会试图再创建2个连接。
                                                  但不能超过最大连接数。
maximum-active-time          -〉连接最大时间活动 默认5分钟
maximum-connection-lifetime      -〉连接最大生命时间 默认4小时