genericobjectpool 是 apache commons pool2 的核心对象池实现,通过泛型支持任意类型对象池化管理,依赖 pooledobjectfactory 和 genericobjectpoolconfig 协同完成借还生命周期调度。

GenericObjectPool 是 Apache Commons Pool2 提供的核心对象池实现,它通过泛型支持任意类型的对象池化管理。资源的“借出”与“归还”不是手动创建/销毁,而是由池统一调度生命周期——关键在于 工厂类(PooledObjectFactory) 和 池配置(GenericObjectPoolConfig) 的协同配合。
借出对象:borrowObject() 触发完整生命周期检查
调用 borrowObject() 时,池会按顺序执行:
- 尝试从空闲队列(idle queue)中获取一个已创建、未使用且通过验证的对象;
- 若空闲队列为空或对象失效(如连接超时、校验失败),则委托 工厂的
makeObject()创建新实例; - 新对象创建后,自动调用 工厂的
activateObject()(例如重置状态、设置连接参数); - 再执行
validateObject()判断是否可用(默认返回 true,可自定义校验逻辑,如 ping 数据库连接); - 校验失败则销毁该对象,继续尝试下一个或新建,直到成功或抛出异常(如
NoSuchElementException)。
归还对象:returnObject() 不等于销毁,而是复用准备
调用 returnObject(obj) 后,池不会立即释放内存,而是:
- 先调用 工厂的
passivateObject()(例如清空缓冲区、关闭游标、重置事务状态); - 再执行
validateObject()确认对象仍健康(避免脏对象污染池); - 若校验通过,将对象放回空闲队列等待下次借用;
- 若校验失败或池已满(由
maxIdle控制),则调用destroyObject()彻底清理资源(如关闭 socket、释放句柄)。
必须自定义 PooledObjectFactory 才能正确借还
泛型本身不提供行为,所有资源管理逻辑都落在工厂实现里。以数据库连接为例:
-
makeObject():创建新Connection,可能通过DriverManager.getConnection(); -
validateObject():执行connection.isValid(1)或简单 SQL 查询; -
destroyObject():显式调用connection.close(); -
activateObject()和passivateObject():分别用于开启自动提交、重置只读状态 / 回滚未提交事务、清除警告等。
异常处理与线程安全是借还过程的隐性要求
借出失败(如连接超时)会抛出 Exception 子类(如 SQLException 包装为 RuntimeException);归还时若对象已被外部关闭或处于非法状态,validateObject() 应返回 false,触发销毁而非放入空闲队列。整个池内部已做线程安全封装,多线程并发借还无需额外同步。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南











