A SoftPool is a ThreadLocal that holds a SoftReference to a pool of initializable objects. This allows us to reuse expensive objects (buffers, etc.) between invocations (the ThreadLocal), but also for those objects to be reaped if they are no longer in use.
Like a ThreadLocal, should be stored in a static field.
<init>(java.util.function.Supplier<T> initializer)Create a new SoftPool.
| name | type | description |
|---|---|---|
| initializer | java.util.function.Supplier<T> | a supplier that creates a new object when one is needed. |
borrow()Borrow an object from the pool, creating a new one if the pool is empty. Make sure to release it back to the pool when done, so that it can be reused.
Returns: an object from the pool, as defined by the initializer.
release(T value)Release an object back to the pool. If the pool is full, the object is not retained. If you don't want to reuse a borrowed object (for e.g. a StringBuilder that grew too large), just don't release it.
| name | type | description |
|---|---|---|
| value | T | the object to release back to the pool. |