模块 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(ArrayPoolBuilder.SimpleArrayPoolBuilder<T> builder)
SimpleArrayPool(Class<T> arrayType, int poolSize, int defCapacity, int maxCapacity)
SimpleArrayPool(Class<T> arrayType, int poolSize, int defCapacity, int maxCapacity, boolean clear)

方法概要

修饰符和类型	方法	说明
T	acquire()	返回池中一个默认大小的数组
T	acquire(int minimumLength)	1.返回的字节数组可能大于期望的数组长度4 2.默认情况下不清理
T	acquire(int minimumLength, boolean clear)
void	clear()	释放此池中的所有对象 （如果属于特殊资源，可不清理）
void	release(T array)	归还数组到池 是否清理数组取决于配置和实现
void	release(T array, boolean clear)	归还数组到池

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

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

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

get, releaseAll

构造器详细资料

SimpleArrayPool

public SimpleArrayPool(ArrayPoolBuilder.SimpleArrayPoolBuilder<T> builder)

SimpleArrayPool

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

参数:

arrayType - 数组类型

poolSize - 池大小

defCapacity - 默认数组大小

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

SimpleArrayPool

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

参数:

arrayType - 数组类型

poolSize - 池大小

defCapacity - 默认数组大小

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

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

方法详细资料

acquire

@Nonnull
public T acquire()

从接口复制的说明: ArrayPool

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

指定者:

acquire 在接口中 ArrayPool<T>

指定者:

acquire 在接口中 ObjectPool<T>

返回:

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

acquire

public T acquire(int minimumLength)

从接口复制的说明: ArrayPool

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

指定者:

acquire 在接口中 ArrayPool<T>

参数:

minimumLength - 期望的最小数组长度

返回:

池化的字节数组

acquire

public T acquire(int minimumLength,
 boolean clear)

指定者:

acquire 在接口中 ArrayPool<T>

参数:

minimumLength - 期望的最小数组长度

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

返回:

池化的字节数组

release

public void release(T array)

从接口复制的说明: ArrayPool

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

指定者:

release 在接口中 ArrayPool<T>

指定者:

release 在接口中 ObjectPool<T>

参数:

array - 要回收的对象

release

public void release(T array,
 boolean clear)

从接口复制的说明: ArrayPool

归还数组到池

指定者:

release 在接口中 ArrayPool<T>

参数:

array - 租借的对象

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

clear

public void clear()

从接口复制的说明: ObjectPool

释放此池中的所有对象 （如果属于特殊资源，可不清理）

指定者:

clear 在接口中 ObjectPool<T>