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
- 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'- 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)
- Create
ByteBufferPooland 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();- Create
DirectFloatBufferPooland 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);
}