Class AdaptiveByteBufAllocator

java.lang.Object

io.netty.buffer.AbstractByteBufAllocator

io.netty.buffer.AdaptiveByteBufAllocator

All Implemented Interfaces:

ByteBufAllocator, ByteBufAllocatorMetric, ByteBufAllocatorMetricProvider

@UnstableApi
public final class AdaptiveByteBufAllocator
extends AbstractByteBufAllocator
implements ByteBufAllocatorMetricProvider, ByteBufAllocatorMetric

An auto-tuning pooling ByteBufAllocator, that follows an anti-generational hypothesis.

Note: this allocator is experimental. It is recommended to roll out usage slowly, and to carefully monitor application performance in the process.

See the AdaptivePoolingAllocator class documentation for implementation details.

Field Summary

Fields inherited from interface ByteBufAllocator

DEFAULT

Modifier and Type	Field	Description
static final ByteBufAllocator	DEFAULT

Constructor Summary

Constructors

Constructor	Description
AdaptiveByteBufAllocator()
AdaptiveByteBufAllocator(boolean preferDirect)
AdaptiveByteBufAllocator(boolean preferDirect, boolean useCacheForNonEventLoopThreads)

Method Summary

Modifier and Type	Method	Description
boolean	isDirectBufferPooled()	Returns true if direct ByteBuf's are pooled
ByteBufAllocatorMetric	metric()	Returns a ByteBufAllocatorMetric for a ByteBufAllocator.
protected ByteBuf	newDirectBuffer(int initialCapacity, int maxCapacity)	Create a direct ByteBuf with the given initialCapacity and maxCapacity.
protected ByteBuf	newHeapBuffer(int initialCapacity, int maxCapacity)	Create a heap ByteBuf with the given initialCapacity and maxCapacity.
long	usedDirectMemory()	Returns the number of bytes of direct memory used by a ByteBufAllocator or -1 if unknown.
long	usedHeapMemory()	Returns the number of bytes of heap memory used by a ByteBufAllocator or -1 if unknown.

Methods inherited from class AbstractByteBufAllocator

buffer, buffer, buffer, calculateNewCapacity, compositeBuffer, compositeBuffer, compositeDirectBuffer, compositeDirectBuffer, compositeHeapBuffer, compositeHeapBuffer, directBuffer, directBuffer, directBuffer, heapBuffer, heapBuffer, heapBuffer, ioBuffer, ioBuffer, ioBuffer, toLeakAwareBuffer, toLeakAwareBuffer, toString

Modifier and Type	Method	Description
ByteBuf	buffer()	Allocate a ByteBuf.
ByteBuf	buffer(int initialCapacity)	Allocate a ByteBuf with the given initial capacity.
ByteBuf	buffer(int initialCapacity, int maxCapacity)	Allocate a ByteBuf with the given initial capacity and the given maximal capacity.
int	calculateNewCapacity(int minNewCapacity, int maxCapacity)	Calculate the new capacity of a ByteBuf that is used when a ByteBuf needs to expand by the minNewCapacity with maxCapacity as upper-bound.
CompositeByteBuf	compositeBuffer()	Allocate a CompositeByteBuf.
CompositeByteBuf	compositeBuffer(int maxNumComponents)	Allocate a CompositeByteBuf with the given maximum number of components that can be stored in it.
CompositeByteBuf	compositeDirectBuffer()	Allocate a direct CompositeByteBuf.
CompositeByteBuf	compositeDirectBuffer(int maxNumComponents)	Allocate a direct CompositeByteBuf with the given maximum number of components that can be stored in it.
CompositeByteBuf	compositeHeapBuffer()	Allocate a heap CompositeByteBuf.
CompositeByteBuf	compositeHeapBuffer(int maxNumComponents)	Allocate a heap CompositeByteBuf with the given maximum number of components that can be stored in it.
ByteBuf	directBuffer()	Allocate a direct ByteBuf.
ByteBuf	directBuffer(int initialCapacity)	Allocate a direct ByteBuf with the given initial capacity.
ByteBuf	directBuffer(int initialCapacity, int maxCapacity)	Allocate a direct ByteBuf with the given initial capacity and the given maximal capacity.
ByteBuf	heapBuffer()	Allocate a heap ByteBuf.
ByteBuf	heapBuffer(int initialCapacity)	Allocate a heap ByteBuf with the given initial capacity.
ByteBuf	heapBuffer(int initialCapacity, int maxCapacity)	Allocate a heap ByteBuf with the given initial capacity and the given maximal capacity.
ByteBuf	ioBuffer()	Allocate a ByteBuf, preferably a direct buffer which is suitable for I/O.
ByteBuf	ioBuffer(int initialCapacity)	Allocate a ByteBuf, preferably a direct buffer which is suitable for I/O.
ByteBuf	ioBuffer(int initialCapacity, int maxCapacity)	Allocate a ByteBuf, preferably a direct buffer which is suitable for I/O.
protected static ByteBuf	toLeakAwareBuffer(ByteBuf buf)
protected static CompositeByteBuf	toLeakAwareBuffer(CompositeByteBuf buf)
String	toString()

Methods inherited from class Object

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

Constructor Details

AdaptiveByteBufAllocator

public AdaptiveByteBufAllocator()

AdaptiveByteBufAllocator

public AdaptiveByteBufAllocator(boolean preferDirect)

AdaptiveByteBufAllocator

public AdaptiveByteBufAllocator(boolean preferDirect,
 boolean useCacheForNonEventLoopThreads)

Method Details

newHeapBuffer

protected ByteBuf newHeapBuffer(int initialCapacity,
 int maxCapacity)

Description copied from class: AbstractByteBufAllocator

Create a heap ByteBuf with the given initialCapacity and maxCapacity.

Specified by:

newHeapBuffer in class AbstractByteBufAllocator

newDirectBuffer

protected ByteBuf newDirectBuffer(int initialCapacity,
 int maxCapacity)

Description copied from class: AbstractByteBufAllocator

Create a direct ByteBuf with the given initialCapacity and maxCapacity.

Specified by:

newDirectBuffer in class AbstractByteBufAllocator

isDirectBufferPooled

public boolean isDirectBufferPooled()

Description copied from interface: ByteBufAllocator

Returns true if direct ByteBuf's are pooled

Specified by:

isDirectBufferPooled in interface ByteBufAllocator

usedHeapMemory

public long usedHeapMemory()

Description copied from interface: ByteBufAllocatorMetric

Returns the number of bytes of heap memory used by a ByteBufAllocator or -1 if unknown.

Specified by:

usedHeapMemory in interface ByteBufAllocatorMetric

usedDirectMemory

public long usedDirectMemory()

Description copied from interface: ByteBufAllocatorMetric

Returns the number of bytes of direct memory used by a ByteBufAllocator or -1 if unknown.

Specified by:

usedDirectMemory in interface ByteBufAllocatorMetric

metric

public ByteBufAllocatorMetric metric()

Description copied from interface: ByteBufAllocatorMetricProvider

Returns a ByteBufAllocatorMetric for a ByteBufAllocator.

Specified by:

metric in interface ByteBufAllocatorMetricProvider