public class DirectChannelBufferFactory extends AbstractChannelBufferFactory
ChannelBufferFactory
which pre-allocates a large chunk of direct
buffer and returns its slice on demand. Direct buffers are reclaimed via
ReferenceQueue
in most JDK implementations, and therefore they are
deallocated less efficiently than an ordinary heap buffer. Consequently,
a user will get OutOfMemoryError
when one tries to allocate small
direct buffers more often than the GC throughput of direct buffers, which
is much lower than the GC throughput of heap buffers. This factory avoids
this problem by allocating a large chunk of pre-allocated direct buffer and
reducing the number of the garbage collected internal direct buffer objects.Constructor and Description |
---|
DirectChannelBufferFactory()
Creates a new factory whose default
ByteOrder is
ByteOrder.BIG_ENDIAN . |
DirectChannelBufferFactory(ByteOrder defaultOrder)
Creates a new factory with the specified default
ByteOrder . |
DirectChannelBufferFactory(ByteOrder defaultOrder,
int preallocatedBufferCapacity)
Creates a new factory with the specified default
ByteOrder . |
DirectChannelBufferFactory(int preallocatedBufferCapacity)
Creates a new factory whose default
ByteOrder is
ByteOrder.BIG_ENDIAN . |
Modifier and Type | Method and Description |
---|---|
ChannelBuffer |
getBuffer(ByteBuffer nioBuffer)
Returns a
ChannelBuffer whose content is equal to the sub-region
of the specified nioBuffer . |
ChannelBuffer |
getBuffer(ByteOrder order,
byte[] array,
int offset,
int length)
Returns a
ChannelBuffer whose content is equal to the sub-region
of the specified array . |
ChannelBuffer |
getBuffer(ByteOrder order,
int capacity)
|
static ChannelBufferFactory |
getInstance() |
static ChannelBufferFactory |
getInstance(ByteOrder defaultEndianness) |
getBuffer, getBuffer, getDefaultOrder
public DirectChannelBufferFactory()
ByteOrder
is
ByteOrder.BIG_ENDIAN
.public DirectChannelBufferFactory(int preallocatedBufferCapacity)
ByteOrder
is
ByteOrder.BIG_ENDIAN
.public DirectChannelBufferFactory(ByteOrder defaultOrder)
ByteOrder
.defaultOrder
- the default ByteOrder
of this factorypublic static ChannelBufferFactory getInstance()
public static ChannelBufferFactory getInstance(ByteOrder defaultEndianness)
public ChannelBuffer getBuffer(ByteOrder order, int capacity)
ChannelBufferFactory
order
- the endianness of the returned ChannelBuffer
capacity
- the capacity of the returned ChannelBuffer
ChannelBuffer
with the specified endianness
and
capacity
, whose readerIndex
and writerIndex
are 0
public ChannelBuffer getBuffer(ByteOrder order, byte[] array, int offset, int length)
ChannelBufferFactory
ChannelBuffer
whose content is equal to the sub-region
of the specified array
. Depending on the factory implementation,
the returned buffer could wrap the array
or create a new copy of
the array
.order
- the endianness of the returned ChannelBuffer
array
- the byte arrayoffset
- the offset of the byte arraylength
- the length of the byte arrayChannelBuffer
with the specified content,
whose readerIndex
and writerIndex
are 0
and (length - offset)
respectivelypublic ChannelBuffer getBuffer(ByteBuffer nioBuffer)
ChannelBufferFactory
ChannelBuffer
whose content is equal to the sub-region
of the specified nioBuffer
. Depending on the factory
implementation, the returned buffer could wrap the nioBuffer
or
create a new copy of the nioBuffer
.nioBuffer
- the NIO ByteBuffer
ChannelBuffer
with the specified content,
whose readerIndex
and writerIndex
are 0
and nioBuffer.remaining()
respectivelyCopyright © 2008-2013 The Netty Project. All Rights Reserved.