com.oracle.svm.core.heap

Class FeebleReferenceList<T>

java.lang.Object

com.oracle.svm.core.heap.FeebleReferenceList<T>

public final class FeebleReferenceList<T>
extends Object

A feeble version of java.lang.ref.ReferenceQueue.

Method Summary

Modifier and Type	Method and Description
protected static void	clean(FeebleReference<?> fr) Clean the list state that is kept in a FeebleReference.
static <T> FeebleReferenceList<T>	factory() A factory.
static void	interruptWaiters()
boolean	isEmpty() Whether the list is empty at the time of the call.
FeebleReference<? extends T>	pop() Pop a FeebleReference off of this list.
boolean	push(FeebleReference<?> fr) Push FeebleReference on to this list if it is not already on a list.
FeebleReference<? extends T>	remove()
FeebleReference<? extends T>	remove(long timeoutMillis) Removes the next reference object in this queue, blocking until either one becomes available or the given timeout period expires.
static void	signalWaiters()

Methods inherited from class java.lang.Object

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

Method Detail

factory

public static <T> FeebleReferenceList<T> factory()

A factory.

isEmpty

public boolean isEmpty()

Whether the list is empty at the time of the call.

push

public boolean push(FeebleReference<?> fr)

Push FeebleReference on to this list if it is not already on a list. Each reference can only be enqueued once. Calls to this method may race with the collector to enqueue a reference. One call to this method may also race with other threaded trying to enqueue the same reference, or trying to enqueue other references on the same queue.

The race to enqueue a reference is resolved by having only the thread that can clear the list slot enqueue the reference on the queue.

The race to enqueue other references on the same queue is resolved by the compare-and-set of the sampled head.

pop

public FeebleReference<? extends T> pop()

Pop a FeebleReference off of this list. This method may be called by multiple threads, and so has to worry about races. So as to not worry about intervening pushes by the collector, this method is uninterruptible.

remove

public FeebleReference<? extends T> remove(long timeoutMillis)
                                    throws IllegalArgumentException,
                                           InterruptedException

Removes the next reference object in this queue, blocking until either one becomes available or the given timeout period expires.

Throws:

IllegalArgumentException

InterruptedException

remove

public FeebleReference<? extends T> remove()
                                    throws InterruptedException

Throws:

InterruptedException

interruptWaiters

public static void interruptWaiters()

signalWaiters

public static void signalWaiters()

clean

protected static void clean(FeebleReference<?> fr)

Clean the list state that is kept in a FeebleReference.