DelayQueue Class

Definition

[Android.Runtime.Register("java/util/concurrent/DelayQueue", DoNotGenerateAcw=true)]
[Java.Interop.JavaTypeParameters(new System.String[] { "E extends java.util.concurrent.Delayed" })]
public class DelayQueue : Java.Util.AbstractQueue, IDisposable, Java.Interop.IJavaPeerable, Java.Util.Concurrent.IBlockingQueue

[<Android.Runtime.Register("java/util/concurrent/DelayQueue", DoNotGenerateAcw=true)>]
[<Java.Interop.JavaTypeParameters(new System.String[] { "E extends java.util.concurrent.Delayed" })>]
type DelayQueue = class
    inherit AbstractQueue
    interface IBlockingQueue
    interface IQueue
    interface ICollection
    interface IIterable
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable

Inheritance

Object

Object

AbstractCollection

AbstractQueue

DelayQueue

Attributes

RegisterAttribute JavaTypeParametersAttribute

Implements

IJavaObject IJavaPeerable IIterable IBlockingQueue ICollection IQueue IDisposable

Remarks

An unbounded BlockingQueue blocking queue of Delayed elements, in which an element generally becomes eligible for removal when its delay has expired.

"expired">An element is considered <em>expired</em> when its <c>getDelay(TimeUnit.NANOSECONDS)</c> method would return a value less than or equal to zero.

"head">An element is considered the <em>head</em> of the queue if it is the element with the earliest expiration time, whether in the past or the future, if there is such an element.

"expired-head">An element is considered the <em>expired head</em> of the queue if it is the <em>expired</em> element with the earliest expiration time in the past, if there is such an element. The <em>expired head</em>, when present, is also the <em>head</em>.

While this class implements the BlockingQueue interface, it intentionally violates the general contract of BlockingQueue, in that the following methods disregard the presence of unexpired elements and only ever remove the <em>expired head</em>:

<ul> <li> #poll()<li> #poll(long,TimeUnit)<li> #take()<li> #remove()</ul>

All other methods operate on both expired and unexpired elements. For example, the #size() method returns the count of all elements. Method #peek() may return the (non-null) <em>head</em> even when take() would block waiting for that element to expire.

This queue does not permit null elements.

This class and its iterator implement all of the <em>optional</em> methods of the Collection and Iterator interfaces. The Iterator provided in method #iterator() is <em>not</em> guaranteed to traverse the elements of the DelayQueue in any particular order.

This class is a member of the Java Collections Framework.

Added in 1.5.

Java documentation for java.util.concurrent.DelayQueue.

Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.