common pool分析

项目地址

项目介绍：

Apache的Commons Pool库提供了一个对象池化API和大量的对象池实现。 与1.x系列相比common pool 2 完全重写的池化实现。 除了性能和可扩展性改进之外，common pool 2还包括强大的实例跟踪和池监视。 common pool 2需要JDK1.6或更高版本。

源码分析

1. ObjectPool接口：

   • 使用Demo：

   try {
      obj = pool.borrowObject();
      try {
          //...使用对象...
      } catch(Exception e) {
          // 使用对象过程中出现异常时，失效缓存池中的对象
          pool.invalidateObject(obj);
          // 将池化对象设置为null，防止将池化的对象返回给对象池两次
          obj = null;
      } finally {
          // 在finally中确保池化对象返还给对象池
          if(null != obj) {
              pool.returnObject(obj);
         }
      }
   } catch(Exception e) {
        // failed to borrow an object
   }
   

- ObjectPool方法如下：

![](http://upload-images.jianshu.io/upload_images/1370674-e487d0d26eec58e3.jpg?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)

方法说明：
- `borrowObject`：
    - 从对象池中获取一个实例，这个实例是通过PooledObjectFactory.makeObject新创建的，或者是以前空闲的对象，但是已经使用PooledObjectFactory.activateObject激活，然后使用PooledObjectFactory.validateObject验证的。按照约定，客户端必须使用returnObject，invalidateObject或者在子类\子接口中定义的相关方法返回借用的实例。
- `returnObject`:
    - 将实例返回到池。按照约定，obj必须是使用borrowObject()或者子类中实现的相关方法获得的。
- `invalidateObject`：
    - 使池中的对象无效。按照约定，obj必须使用borrowObject()或子类中中实现的相关方法获得。当已借用的对象（由于异常或其他问题）被确定为无效时，应使用此方法。
- `addObject`：
    - 使用工厂或其他相关机制创建对象，将其钝化，然后将其放置在空闲对象池中。 addObject对于用空闲对象“预加载”池是十分有用（可选操作）。
- `getNumIdle`：
    - 返回此池中当前空闲的实例数，可以近似认为是不用创建任何新实例的对象就可以借用的数量。 如果此信息不可用，则返回负值。
- `getNumActive`：
    - 返回当前从此池中借用的实例数。 如果此信息不可用，则返回负值。
- `clear`：
    - 清除池中处于空闲状态的任何对象，释放所有相关资源。被清空的空闲对象必须是PooledObjectFactory.destroyObject()。
- `close`:
    - 关闭此池，并释放与其关联的任何资源。在池上调用此方法后调用addObject或borrowObject将导致它们抛出IllegalStateException。如果不是所有资源都可以释放，实现应该默认失败。