Package org.eclipse.jetty.io

Interface ByteBufferPool

All Known Implementing Classes:

ArrayByteBufferPool, LeakTrackingByteBufferPool, MappedByteBufferPool, MappedByteBufferPool.Tagged

public interface ByteBufferPool

A ByteBuffer pool.

Acquired buffers may be released but they do not need to; if they are released, they may be recycled and reused, otherwise they will be garbage collected as usual.

Nested Class Summary

Nested Classes

Modifier and Type	Interface	Description
static class	ByteBufferPool.Bucket
static class	ByteBufferPool.Lease

Method Summary

Modifier and Type	Method	Description
java.nio.ByteBuffer	acquire(int size, boolean direct)	Requests a ByteBuffer of the given size.
default java.nio.ByteBuffer	newByteBuffer(int capacity, boolean direct)
void	release(java.nio.ByteBuffer buffer)	Returns a ByteBuffer, usually obtained with acquire(int, boolean) (but not necessarily), making it available for recycling and reuse.

Method Detail

acquire

java.nio.ByteBuffer acquire(int size,
                            boolean direct)

Requests a ByteBuffer of the given size.

The returned buffer may have a bigger capacity than the size being requested but it will have the limit set to the given size.

Parameters:

size - the size of the buffer

direct - whether the buffer must be direct or not

Returns:

the requested buffer

See Also:

release(ByteBuffer)

release

void release(java.nio.ByteBuffer buffer)

Returns a ByteBuffer, usually obtained with acquire(int, boolean) (but not necessarily), making it available for recycling and reuse.

Parameters:

buffer - the buffer to return

See Also:

acquire(int, boolean)

newByteBuffer

default java.nio.ByteBuffer newByteBuffer(int capacity,
                                          boolean direct)