com.google.code.yanf4j.buffer

类 CachedBufferAllocator

java.lang.Object

com.google.code.yanf4j.buffer.CachedBufferAllocator

所有已实现的接口:

IoBufferAllocator

public class CachedBufferAllocator
extends Object
implements IoBufferAllocator

An IoBufferAllocator that caches the buffers which are likely to be reused during auto-expansion of the buffers.

In SimpleBufferAllocator, the underlying ByteBuffer of the IoBuffer is reallocated on its capacity change, which means the newly allocated bigger ByteBuffer replaces the old small ByteBuffer . Consequently, the old ByteBuffer is marked for garbage collection.

It's not a problem in most cases as long as the capacity change doesn't happen frequently. However, once it happens too often, it burdens the VM and the cost of filling the newly allocated ByteBuffer with NUL surpass the cost of accessing the cache. In 2 dual-core Opteron Italy 270 processors, CachedBufferAllocator outperformed SimpleBufferAllocator in the following situation:

• when a 32 bytes buffer is expanded 4 or more times,
• when a 64 bytes buffer is expanded 4 or more times,
• when a 128 bytes buffer is expanded 2 or more times,
• and when a 256 bytes or bigger buffer is expanded 1 or more times.

Please note the observation above is subject to change in a different environment.

CachedBufferAllocator uses ThreadLocal to store the cached buffer, allocates buffers whose capacity is power of 2 only and provides performance advantage if IoBuffer.free() is called properly.

版本:

$Rev: 671827 $, $Date: 2008-06-26 10:49:48 +0200 (Thu, 26 Jun 2008) $

作者:

The Apache MINA Project (dev@mina.apache.org)

构造器概要

构造器

构造器和说明
CachedBufferAllocator() Creates a new instance with the default parameters (#DEFAULT_MAX_POOL_SIZE and #DEFAULT_MAX_CACHED_BUFFER_SIZE).
CachedBufferAllocator(int maxPoolSize, int maxCachedBufferSize) Creates a new instance.

方法概要

方法

限定符和类型	方法和说明
IoBuffer	allocate(int requestedCapacity, boolean direct) Returns the buffer which is capable of the specified size.
ByteBuffer	allocateNioBuffer(int capacity, boolean direct) Returns the NIO buffer which is capable of the specified size.
void	dispose() Dispose of this allocator.
int	getMaxCachedBufferSize() Returns the maximum capacity of a cached buffer.
int	getMaxPoolSize() Returns the maximum number of buffers with the same capacity per thread.
IoBuffer	wrap(ByteBuffer nioBuffer) Wraps the specified NIO ByteBuffer into MINA buffer.

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

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

构造器详细资料

CachedBufferAllocator

public CachedBufferAllocator()

Creates a new instance with the default parameters (#DEFAULT_MAX_POOL_SIZE and #DEFAULT_MAX_CACHED_BUFFER_SIZE).

CachedBufferAllocator

public CachedBufferAllocator(int maxPoolSize,
                     int maxCachedBufferSize)

Creates a new instance.

参数:

maxPoolSize - the maximum number of buffers with the same capacity per thread. 0 disables this limitation.

maxCachedBufferSize - the maximum capacity of a cached buffer. A buffer whose capacity is bigger than this value is not pooled. 0 disables this limitation.

方法详细资料

getMaxPoolSize

public int getMaxPoolSize()

Returns the maximum number of buffers with the same capacity per thread. 0 means 'no limitation'.

getMaxCachedBufferSize

public int getMaxCachedBufferSize()

Returns the maximum capacity of a cached buffer. A buffer whose capacity is bigger than this value is not pooled. 0 means 'no limitation'.

allocate

public IoBuffer allocate(int requestedCapacity,
                boolean direct)

从接口复制的说明: IoBufferAllocator

Returns the buffer which is capable of the specified size.

指定者:

allocate 在接口中 IoBufferAllocator

参数:

requestedCapacity - the capacity of the buffer

direct - true to get a direct buffer, false to get a heap buffer.

allocateNioBuffer

public ByteBuffer allocateNioBuffer(int capacity,
                           boolean direct)

从接口复制的说明: IoBufferAllocator

Returns the NIO buffer which is capable of the specified size.

指定者:

allocateNioBuffer 在接口中 IoBufferAllocator

参数:

capacity - the capacity of the buffer

direct - true to get a direct buffer, false to get a heap buffer.

wrap

public IoBuffer wrap(ByteBuffer nioBuffer)

从接口复制的说明: IoBufferAllocator

Wraps the specified NIO ByteBuffer into MINA buffer.

指定者:

wrap 在接口中 IoBufferAllocator

dispose

public void dispose()

从接口复制的说明: IoBufferAllocator

Dispose of this allocator.

指定者:

dispose 在接口中 IoBufferAllocator