模块 wjybxx.commons.base

程序包 cn.wjybxx.base.io

类 ConcurrentArrayPool<T>

java.lang.Object

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

所有已实现的接口:

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

@ThreadSafe
public final class ConcurrentArrayPool<T>
extends Object
implements ArrayPool<T>

高性能的并发数组池实现 (未鉴定归属，可归还外部数组，适用简单场景)

作者:

wjybxx date - 2024/1/6

嵌套类概要

嵌套类

修饰符和类型	类	说明
static class	ConcurrentArrayPool.Builder<T>

字段概要

字段

修饰符和类型	字段	说明
static final ConcurrentArrayPool<byte[]>	SHARED_BYTE_ARRAY_POOL	全局共享字节数组池
static final ConcurrentArrayPool<char[]>	SHARED_CHAR_ARRAY_POOL	全局共享char数组池 -- charArray的使用频率稍低

构造器概要

构造器

构造器	说明
ConcurrentArrayPool(ConcurrentArrayPool.Builder<T> builder)

方法概要

修饰符和类型	方法	说明
T	acquire()	返回池中一个默认大小的数组
T	acquire(int minimumLength)	1.返回的数组可能大于期望的数组长度 2.默认情况下不清理
T	acquire(int minimumLength, boolean clear)
void	clear()	释放此池中的所有对象 （如果属于特殊资源，可不清理）
static <T> ConcurrentArrayPool.Builder<T>	newBuilder(Class<T> arrayType)
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

字段详细资料

SHARED_BYTE_ARRAY_POOL

public static final ConcurrentArrayPool<byte[]> SHARED_BYTE_ARRAY_POOL

全局共享字节数组池

SHARED_CHAR_ARRAY_POOL

public static final ConcurrentArrayPool<char[]> SHARED_CHAR_ARRAY_POOL

全局共享char数组池 -- charArray的使用频率稍低

构造器详细资料

ConcurrentArrayPool

public ConcurrentArrayPool(ConcurrentArrayPool.Builder<T> builder)

方法详细资料

acquire

@Nonnull
public T acquire()

从接口复制的说明: ArrayPool

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

指定者:

acquire 在接口中 ArrayPool<T>

指定者:

acquire 在接口中 ObjectPool<T>

返回:

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

acquire

public T acquire(int minimumLength)

从接口复制的说明: ArrayPool

1.返回的数组可能大于期望的数组长度 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>

newBuilder

public static <T> ConcurrentArrayPool.Builder<T> newBuilder(Class<T> arrayType)