ByteBufferPool (Jetty :: Project 10.0.0.beta0 API)

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

All Methods Instance Methods Abstract Methods Default Methods
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)`	Creates a new ByteBuffer of the given capacity and the given directness.
`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)
```
    Creates a new ByteBuffer of the given capacity and the given directness.
    
    Parameters:
    
    capacity - the ByteBuffer capacity
    
    direct - the ByteBuffer directness
    
    Returns:
    
    a newly allocated ByteBuffer