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
static void	broadcast()
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	guaranteeIsLocked()
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() Called by Target_java_lang_Thread.interrupt0() to notify waiters to check to see if they have been interrupted.

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.

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

broadcast

public static void broadcast()

signalWaiters

public static void signalWaiters()

Called by Target_java_lang_Thread.interrupt0() to notify waiters to check to see if they have been interrupted.

clean

protected static void clean(FeebleReference<?> fr)

Clean the list state that is kept in a FeebleReference.

guaranteeIsLocked

public static void guaranteeIsLocked()