Pbbl (pr. pebble, pɛbəl)

A thread-safe Buffer pool that allows for the automatic reuse of Buffer objects (including ByteBuffer, CharBuffer, etc.), which can be over 30x faster than having to allocate a new Buffer.

Maven/Gradle Dependency

1. Add Pbbl as a dependency using either Maven or Gradle:

Maven:

<dependency>
  <groupId>com.github.jhg023</groupId>
  <artifactId>Pbbl</artifactId>
  <version>1.0.2</version>
</dependency>

Gradle:

implementation 'com.github.jhg023:Pbbl:1.0.2'

2. Because Pbbl is compiled with Java 11, you must require its module in your module-info.java:

module my.project {
    requires com.github.pbbl;
}

Example(s)

1. Create ByteBufferPool and manually close it:

// Create a ByteBufferPool (used to pool non-direct ByteBuffer objects).
var pool = new ByteBufferPool();

// Take a non-direct ByteBuffer (with 8 available bytes) from the pool.
// If the pool is empty, a new ByteBuffer will be created.
var buffer = pool.take(Long.BYTES);

// Do something with the ByteBuffer.
var array = buffer.putLong(42).array();

// Give the ByteBuffer back to the pool for re-use.
pool.give(buffer);

// Close the pool when finished.
pool.close();

2. Create DirectFloatBufferPool and automatically close it:

// Create a DirectFloatBufferPool (used to pool direct FloatBuffer objects).
try (var pool = new DirectFloatBufferPool()) {
    // Take a direct FloatBuffer (with 8 available floats) from the pool.
    FloatBuffer buffer = pool.take(8);
    
    // Do something with the FloatBuffer.
    buffer.put(42f);
    
    // Give the FloatBuffer back to the pool for re-use.
    pool.give(buffer);
}