Class ReferenceQueue<T>

• java.lang.Object
• • java.lang.ref.ReferenceQueue<T>

public class ReferenceQueue<T>
extends Object

Reference queues, to which registered reference objects are appended by the garbage collector after the appropriate reachability changes are detected.

Since:

1.2

Constructors

ReferenceQueue

public ReferenceQueue()

Constructs a new reference-object queue.

Methods

poll

public Reference<? extends T> poll()

Polls this queue to see if a reference object is available. If one is available without further delay then it is removed from the queue and returned. Otherwise this method immediately returns null.

Returns:

A reference object, if one was immediately available, otherwise null

remove

public Reference<? extends T> remove(long timeout)
                              throws IllegalArgumentException,
                                     InterruptedException

Parameters:

timeout - If positive, block for up to timeout milliseconds while waiting for a reference to be added to this queue. If zero, block indefinitely.

Returns:

A reference object, if one was available within the specified timeout period, otherwise null

Throws:

IllegalArgumentException - If the value of the timeout argument is negative

InterruptedException - If the timeout wait is interrupted

remove

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

Removes the next reference object in this queue, blocking until one becomes available.

Returns:

A reference object, blocking until one becomes available

Throws:

InterruptedException - If the wait is interrupted