org.eclipse.jetty.io

Class MappedByteBufferPool

java.lang.Object

org.eclipse.jetty.io.MappedByteBufferPool

All Implemented Interfaces:

ByteBufferPool

Direct Known Subclasses:

MappedByteBufferPool.Tagged

@ManagedObject
public class MappedByteBufferPool
extends Object

A ByteBuffer pool where ByteBuffers are held in queues that are held in a Map.

Given a capacity factor of 1024, the Map entry with key 1 holds a queue of ByteBuffers each of capacity 1024, the Map entry with key 2 holds a queue of ByteBuffers each of capacity 2048, and so on.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	MappedByteBufferPool.Tagged

Nested classes/interfaces inherited from interface org.eclipse.jetty.io.ByteBufferPool

ByteBufferPool.Bucket, ByteBufferPool.Lease

Constructor Summary

Constructors

Constructor and Description
MappedByteBufferPool() Creates a new MappedByteBufferPool with a default configuration.
MappedByteBufferPool(int factor) Creates a new MappedByteBufferPool with the given capacity factor.
MappedByteBufferPool(int factor, int maxQueueLength) Creates a new MappedByteBufferPool with the given configuration.
MappedByteBufferPool(int factor, int maxQueueLength, Function<Integer,ByteBufferPool.Bucket> newBucket) Creates a new MappedByteBufferPool with the given configuration.
MappedByteBufferPool(int factor, int maxQueueLength, Function<Integer,ByteBufferPool.Bucket> newBucket, long maxHeapMemory, long maxDirectMemory) Creates a new MappedByteBufferPool with the given configuration.

Method Summary

Modifier and Type	Method and Description
ByteBuffer	acquire(int size, boolean direct) Requests a ByteBuffer of the given size.
void	clear()
long	getDirectByteBufferCount()
long	getDirectMemory()
long	getHeapByteBufferCount()
long	getHeapMemory()
long	getMemory(boolean direct)
void	release(ByteBuffer buffer) Returns a ByteBuffer, usually obtained with ByteBufferPool.acquire(int, boolean) (but not necessarily), making it available for recycling and reuse.

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.eclipse.jetty.io.ByteBufferPool

newByteBuffer

Constructor Detail

MappedByteBufferPool

public MappedByteBufferPool()

Creates a new MappedByteBufferPool with a default configuration.

MappedByteBufferPool

public MappedByteBufferPool(int factor)

Creates a new MappedByteBufferPool with the given capacity factor.

Parameters:

factor - the capacity factor

MappedByteBufferPool

public MappedByteBufferPool(int factor,
                            int maxQueueLength)

Creates a new MappedByteBufferPool with the given configuration.

Parameters:

factor - the capacity factor

maxQueueLength - the maximum ByteBuffer queue length

MappedByteBufferPool

public MappedByteBufferPool(int factor,
                            int maxQueueLength,
                            Function<Integer,ByteBufferPool.Bucket> newBucket)

Creates a new MappedByteBufferPool with the given configuration.

Parameters:

factor - the capacity factor

maxQueueLength - the maximum ByteBuffer queue length

newBucket - the function that creates a Bucket

MappedByteBufferPool

public MappedByteBufferPool(int factor,
                            int maxQueueLength,
                            Function<Integer,ByteBufferPool.Bucket> newBucket,
                            long maxHeapMemory,
                            long maxDirectMemory)

Creates a new MappedByteBufferPool with the given configuration.

Parameters:

factor - the capacity factor

maxQueueLength - the maximum ByteBuffer queue length

newBucket - the function that creates a Bucket

maxHeapMemory - the max heap memory in bytes

maxDirectMemory - the max direct memory in bytes

Method Detail

acquire

public ByteBuffer acquire(int size,
                          boolean direct)

Description copied from interface: ByteBufferPool

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:

ByteBufferPool.release(ByteBuffer)

release

public void release(ByteBuffer buffer)

Description copied from interface: ByteBufferPool

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

Parameters:

buffer - the buffer to return

See Also:

ByteBufferPool.acquire(int, boolean)

clear

public void clear()

getDirectByteBufferCount

@ManagedAttribute(value="The number of pooled direct ByteBuffers")
public long getDirectByteBufferCount()

getHeapByteBufferCount

@ManagedAttribute(value="The number of pooled heap ByteBuffers")
public long getHeapByteBufferCount()

getDirectMemory

@ManagedAttribute(value="The bytes retained by direct ByteBuffers")
public long getDirectMemory()

getHeapMemory

@ManagedAttribute(value="The bytes retained by heap ByteBuffers")
public long getHeapMemory()

getMemory

public long getMemory(boolean direct)