模块 wjybxx.commons.base

程序包 cn.wjybxx.base.io

类 SimpleArrayPool<T>

java.lang.Object

cn.wjybxx.base.io.SimpleArrayPool<T>

所有已实现的接口:

ArrayPool<T>, ObjectPool<T>, Supplier<T>

@NotThreadSafe
public final class SimpleArrayPool<T>
extends Object
implements ArrayPool<T>

简单数组池实现

作者:

wjybxx date - 2024/1/6

构造器概要

构造器

构造器	说明
SimpleArrayPool(Class<T> arrayType, int poolSize, int initCapacity)
SimpleArrayPool(Class<T> arrayType, int poolSize, int initCapacity, int maxCapacity)
SimpleArrayPool(Class<T> arrayType, int poolSize, int initCapacity, int maxCapacity, boolean clear)

方法概要

修饰符和类型	方法	说明
static <T> Consumer<T>	findClearHandler(Class<T> arrayType)
void	freeAll()	释放此池中的所有对象 （可空实现）
static boolean	isRefArray(Class<?> arrayType)
T	rent()	返回池中一个默认大小的数组
T	rent(int minimumLength)	1.返回的字节数组可能大于期望的数组长度4 2.默认情况下不清理
T	rent(int minimumLength, boolean clear)
void	returnOne(T array)	归还数组到池 是否清理数组取决于配置和实现
void	returnOne(T array, boolean clear)	归还数组到池

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

从接口继承的方法 cn.wjybxx.base.pool.ObjectPool

get, returnAll

构造器详细资料

SimpleArrayPool

public SimpleArrayPool(Class<T> arrayType,
 int poolSize,
 int initCapacity)

参数:

arrayType - 数组类型

poolSize - 池大小

initCapacity - 数组初始大小

SimpleArrayPool

public SimpleArrayPool(Class<T> arrayType,
 int poolSize,
 int initCapacity,
 int maxCapacity)

参数:

arrayType - 数组类型

poolSize - 池大小

initCapacity - 数组初始大小

maxCapacity - 数组最大大小 -- 超过大小的数组不会放入池中

SimpleArrayPool

public SimpleArrayPool(Class<T> arrayType,
 int poolSize,
 int initCapacity,
 int maxCapacity,
 boolean clear)

参数:

arrayType - 数组类型

poolSize - 池大小

initCapacity - 数组初始大小

maxCapacity - 数组最大大小 -- 超过大小的数组不会放入池中

clear - 数组归还到池时是否清理

方法详细资料

rent

@Nonnull
public T rent()

从接口复制的说明: ArrayPool

返回池中一个默认大小的数组

指定者:

rent 在接口中 ArrayPool<T>

指定者:

rent 在接口中 ObjectPool<T>

返回:

如果池中有可用的对象，则返回缓存的对象，否则返回一个新的对象

rent

public T rent(int minimumLength)

从接口复制的说明: ArrayPool

1.返回的字节数组可能大于期望的数组长度4 2.默认情况下不清理

指定者:

rent 在接口中 ArrayPool<T>

参数:

minimumLength - 期望的最小数组长度

返回:

池化的字节数组

rent

public T rent(int minimumLength,
 boolean clear)

指定者:

rent 在接口中 ArrayPool<T>

参数:

minimumLength - 期望的最小数组长度

clear - 返回前是否先清理，这对于共享池来说比较重要

返回:

池化的字节数组

returnOne

public void returnOne(T array)

从接口复制的说明: ArrayPool

归还数组到池 是否清理数组取决于配置和实现

指定者:

returnOne 在接口中 ArrayPool<T>

指定者:

returnOne 在接口中 ObjectPool<T>

参数:

array - 要回收的对象

returnOne

public void returnOne(T array,
 boolean clear)

从接口复制的说明: ArrayPool

归还数组到池

指定者:

returnOne 在接口中 ArrayPool<T>

参数:

array - 租借的对象

clear - 是否清理数组 - 只有当前池默认不清理的情况下，该参数才有效用。

freeAll

public void freeAll()

从接口复制的说明: ObjectPool

释放此池中的所有对象 （可空实现）

指定者:

freeAll 在接口中 ObjectPool<T>

isRefArray

public static boolean isRefArray(Class<?> arrayType)

findClearHandler

public static <T> Consumer<T> findClearHandler(Class<T> arrayType)