Module org.cojen.tupl

Package org.cojen.tupl.util

Class WeakPool<B>

java.lang.Object

org.cojen.tupl.util.WeakPool<B>

public class WeakPool<B>
extends Object

Utility for sharing a small set of poolable objects (like buffers) which are weakly referenced. Only one thread at a time can access pooled objects, but any number of threads can release pooled objects.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final class	WeakPool.Entry<B>	An entry which weakly references a pooled object.

Constructor Summary

Constructors

Constructor	Description
WeakPool()

Method Summary

Modifier and Type	Method	Description
WeakPool.Entry<B>	newEntry(B obj)	Create a new pooled entry which refers to the given object.
WeakPool.Entry<B>	tryAccess()	Returns an available pooled entry if any exist.

Methods inherited from class java.lang.Object

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

Constructor Details

WeakPool

public WeakPool()

Method Details

tryAccess

public WeakPool.Entry<B> tryAccess()

Returns an available pooled entry if any exist. If an entry is returned but the pooled object is null, discard the entry and try again. A strong reference to the pooled object must be maintained to ensure that it doesn't vanish too soon.

Note: This method can only be called by one thread at a time.

newEntry

public WeakPool.Entry<B> newEntry(B obj)

Create a new pooled entry which refers to the given object. This method is thread-safe.