org.dromara.hutool.core.pool

接口 ObjectPool<T>

类型参数:

T - 对象类型

所有超级接口:

AutoCloseable, Closeable, Serializable

所有已知实现类:

PartitionObjectPool, PoolPartition

public interface ObjectPool<T>
extends Closeable, Serializable

对象池接口，提供：

• borrowObject() 对象借出。
• returnObject(Poolable)对象归还。

对于对象池中对象维护，通过PoolConfig.getMaxIdle()控制，规则如下：

• 如果借出量很多，则不断扩容，直到达到PoolConfig.getMaxSize()
• 如果池对象闲置超出PoolConfig.getMaxIdle()，则销毁。
• 实际使用中，池中对象可能少于PoolConfig.getMinSize()

作者:

Looly

方法概要

限定符和类型	方法和说明
Poolable<T>	borrowObject() 借出对象，流程如下： 从池中取出对象 检查对象可用性 如果无可用对象，扩容池并创建新对象 继续取对象
int	getActiveCount() 获取已经借出的对象（正在使用的）对象数
int	getIdleCount() 获取空闲对象数，即在池中的对象数
int	getTotal() 获取持有对象总数（包括空闲对象 + 正在使用对象数）
ObjectPool<T>	returnObject(Poolable<T> obj) 归还对象，流程如下： 检查对象可用性 不可用则销毁之 可用则入池

从接口继承的方法 java.io.Closeable

close

方法详细资料

borrowObject

Poolable<T> borrowObject()

借出对象，流程如下：

1. 从池中取出对象
2. 检查对象可用性
3. 如果无可用对象，扩容池并创建新对象
4. 继续取对象

返回:

对象

returnObject

ObjectPool<T> returnObject(Poolable<T> obj)

归还对象，流程如下：

1. 检查对象可用性
2. 不可用则销毁之
3. 可用则入池

参数:

obj - 对象

返回:

this

getTotal

int getTotal()

获取持有对象总数（包括空闲对象 + 正在使用对象数）

返回:

总数

getIdleCount

int getIdleCount()

获取空闲对象数，即在池中的对象数

返回:

空闲对象数，-1表示此信息不可用

getActiveCount

int getActiveCount()

获取已经借出的对象（正在使用的）对象数

返回:

正在使用的对象数，-1表示此对象不可用