java.lang.Object
java.lang.ref.ReferenceQueue<T>
ReferenceQueue is the container on which reference objects
are enqueued when their reachability type is detected for
the referent.
- Since:
- 1.2
-
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionpoll()
Returns the next available reference from the queue if one is enqueued, null otherwise.remove()
Return the next available enqueued reference on the queue, blocking indefinitely until one is available.remove
(long timeout) Return the next available enqueued reference on the queue, blocking up to the time given until one is available.
-
Constructor Details
-
ReferenceQueue
public ReferenceQueue()Constructs a new instance of this class.
-
-
Method Details
-
poll
Returns the next available reference from the queue if one is enqueued, null otherwise. Does not wait for a reference to become available.- Returns:
- Reference next available Reference or NULL.
-
remove
Return the next available enqueued reference on the queue, blocking indefinitely until one is available.- Returns:
- Reference a Reference object if one is available, null otherwise.
- Throws:
InterruptedException
- to interrupt the wait.
-
remove
public Reference<? extends T> remove(long timeout) throws IllegalArgumentException, InterruptedException Return the next available enqueued reference on the queue, blocking up to the time given until one is available. Return null if no reference became available.- Parameters:
timeout
- maximum time spent waiting for a reference object to become available.- Returns:
- Reference a Reference object if one is available, null otherwise.
- Throws:
IllegalArgumentException
- if the wait period is negative.InterruptedException
- to interrupt the wait.
-