Class FinalizableReferenceQueue

java.lang.Object

jnr.ffi.util.ref.FinalizableReferenceQueue

public class FinalizableReferenceQueue
extends Object

A reference queue with an associated background thread that dequeues references and invokes FinalizableReference.finalizeReferent() on them.

Keep a strong reference to this object until all of the associated referents have been finalized. If this object is garbage collected earlier, the backing thread will not invoke finalizeReferent() on the remaining references.

Since:

2.0 (imported from Google Collections Library)

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
(package private) static class	FinalizableReferenceQueue.DecoupledLoader	Try to load Finalizer in its own class loader.
(package private) static class	FinalizableReferenceQueue.DirectLoader	Loads Finalizer directly using the current class loader.
(package private) static interface	FinalizableReferenceQueue.FinalizerLoader	Loads Finalizer.class.
(package private) static class	FinalizableReferenceQueue.SystemLoader	Tries to load Finalizer from the system class loader.

Field Summary

Fields

Modifier and Type	Field	Description
private static final String	FINALIZER_CLASS_NAME
private static final Map<FinalizableReferenceQueue, Boolean>	finalizerQueues
private static final Logger	logger
(package private) final ReferenceQueue<Object>	queue	The actual reference queue that our background thread will poll.
private static final Method	startFinalizer	Reference to Finalizer.startFinalizer().
(package private) final boolean	threadStarted	Whether or not the background thread started successfully.

Constructor Summary

Constructors

Constructor	Description
FinalizableReferenceQueue()	Constructs a new queue.

Method Summary

Modifier and Type	Method	Description
(package private) void	cleanUp()	Repeatedly dequeues references from the queue and invokes FinalizableReference.finalizeReferent() on them until the queue is empty.
static void	cleanUpAll()
(package private) static Method	getStartFinalizer(Class<?> finalizer)	Looks up Finalizer.startFinalizer().
private static Class<?>	loadFinalizer(FinalizableReferenceQueue.FinalizerLoader... loaders)	Iterates through the given loaders until it finds one that can load Finalizer.
private void	pollReferenceQueue()

Methods inherited from class Object

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

Field Details

logger

private static final Logger logger

FINALIZER_CLASS_NAME

private static final String FINALIZER_CLASS_NAME

See Also:

• Constant Field Values

startFinalizer

private static final Method startFinalizer

Reference to Finalizer.startFinalizer().

finalizerQueues

private static final Map<FinalizableReferenceQueue, Boolean> finalizerQueues

queue

final ReferenceQueue<Object> queue

The actual reference queue that our background thread will poll.

threadStarted

final boolean threadStarted

Whether or not the background thread started successfully.

Constructor Details

FinalizableReferenceQueue

public FinalizableReferenceQueue()

Constructs a new queue.

Method Details

cleanUp

void cleanUp()

Repeatedly dequeues references from the queue and invokes FinalizableReference.finalizeReferent() on them until the queue is empty. This method is a no-op if the background thread was created successfully.

pollReferenceQueue

private void pollReferenceQueue()

loadFinalizer

private static Class<?> loadFinalizer(FinalizableReferenceQueue.FinalizerLoader... loaders)

Iterates through the given loaders until it finds one that can load Finalizer.

Returns:

Finalizer.class

getStartFinalizer

static Method getStartFinalizer(Class<?> finalizer)

Looks up Finalizer.startFinalizer().

cleanUpAll

public static void cleanUpAll()