delayqueue.html

来自「j2se5-api-zh,java文档的中文版本」· HTML 代码 · 共 774 行 · 第 1/4 页

<TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2">
<B>方法详细信息</B></FONT></TH>
</TR>
</TABLE>

<A NAME="offer(java.util.concurrent.Delayed)"><!-- --></A><A NAME="offer(E)"><!-- --></A><H3>
offer</H3>
<PRE>
public boolean <B>offer</B>(<A HREF="DelayQueue.html" title="DelayQueue 中的类型参数">E</A>&nbsp;o)</PRE>
<DL>
<DD>将指定元素插入到此延迟队列中。
<P>
<DD><DL>
<DT><B>指定者：</B><DD>接口 <CODE><A HREF="BlockingQueue.html" title="java.util.concurrent 中的接口">BlockingQueue</A>&lt;<A HREF="DelayQueue.html" title="DelayQueue 中的类型参数">E</A> extends <A HREF="Delayed.html" title="java.util.concurrent 中的接口">Delayed</A>&gt;</CODE> 中的 <CODE><A HREF="BlockingQueue.html#offer(E)">offer</A></CODE><DT><B>指定者：</B><DD>接口 <CODE><A HREF="../Queue.html" title="java.util 中的接口">Queue</A>&lt;<A HREF="DelayQueue.html" title="DelayQueue 中的类型参数">E</A> extends <A HREF="Delayed.html" title="java.util.concurrent 中的接口">Delayed</A>&gt;</CODE> 中的 <CODE><A HREF="../Queue.html#offer(E)">offer</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>o</CODE> - 要添加的元素
<DT><B>返回：</B><DD><tt>true</tt>
<DT><B>抛出：</B>
<DD><CODE><A HREF="../../lang/NullPointerException.html" title="java.lang 中的类">NullPointerException</A></CODE> - 如果指定的元素为 <tt>null</tt>。</DL>
</DD>
</DL>
<HR>

<A NAME="put(java.util.concurrent.Delayed)"><!-- --></A><A NAME="put(E)"><!-- --></A><H3>
put</H3>
<PRE>
public void <B>put</B>(<A HREF="DelayQueue.html" title="DelayQueue 中的类型参数">E</A>&nbsp;o)</PRE>
<DL>
<DD>将指定元素添加到此延迟队列中。由于该队列是无界的，所以此方法永远不会阻塞。
<P>
<DD><DL>
<DT><B>指定者：</B><DD>接口 <CODE><A HREF="BlockingQueue.html" title="java.util.concurrent 中的接口">BlockingQueue</A>&lt;<A HREF="DelayQueue.html" title="DelayQueue 中的类型参数">E</A> extends <A HREF="Delayed.html" title="java.util.concurrent 中的接口">Delayed</A>&gt;</CODE> 中的 <CODE><A HREF="BlockingQueue.html#put(E)">put</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>o</CODE> - 要添加的元素
<DT><B>抛出：</B>
<DD><CODE><A HREF="../../lang/NullPointerException.html" title="java.lang 中的类">NullPointerException</A></CODE> - 如果指定的元素为 <tt>null</tt>。</DL>
</DD>
</DL>
<HR>

<A NAME="offer(java.util.concurrent.Delayed,long,java.util.concurrent.TimeUnit)"><!-- --></A><A NAME="offer(E, long, java.util.concurrent.TimeUnit)"><!-- --></A><H3>
offer</H3>
<PRE>
public boolean <B>offer</B>(<A HREF="DelayQueue.html" title="DelayQueue 中的类型参数">E</A>&nbsp;o,
                     long&nbsp;timeout,
                     <A HREF="TimeUnit.html" title="java.util.concurrent 中的枚举">TimeUnit</A>&nbsp;unit)</PRE>
<DL>
<DD>将指定元素插入到此延迟队列中。由于该队列是无界的，所以此方法永远不会阻塞。
<P>
<DD><DL>
<DT><B>指定者：</B><DD>接口 <CODE><A HREF="BlockingQueue.html" title="java.util.concurrent 中的接口">BlockingQueue</A>&lt;<A HREF="DelayQueue.html" title="DelayQueue 中的类型参数">E</A> extends <A HREF="Delayed.html" title="java.util.concurrent 中的接口">Delayed</A>&gt;</CODE> 中的 <CODE><A HREF="BlockingQueue.html#offer(E, long, java.util.concurrent.TimeUnit)">offer</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>o</CODE> - 要添加的元素<DD><CODE>timeout</CODE> - 因为该方法永远不会阻塞，所以忽略此参数<DD><CODE>unit</CODE> - 因为该方法永远不会阻塞，所以忽略此参数
<DT><B>返回：</B><DD><tt>true</tt>
<DT><B>抛出：</B>
<DD><CODE><A HREF="../../lang/NullPointerException.html" title="java.lang 中的类">NullPointerException</A></CODE> - 如果指定的元素为 <tt>null</tt>。</DL>
</DD>
</DL>
<HR>

<A NAME="add(java.util.concurrent.Delayed)"><!-- --></A><A NAME="add(E)"><!-- --></A><H3>
add</H3>
<PRE>
public boolean <B>add</B>(<A HREF="DelayQueue.html" title="DelayQueue 中的类型参数">E</A>&nbsp;o)</PRE>
<DL>
<DD>将指定元素添加到此队列中。
<P>
<DD><DL>
<DT><B>指定者：</B><DD>接口 <CODE><A HREF="../Collection.html" title="java.util 中的接口">Collection</A>&lt;<A HREF="DelayQueue.html" title="DelayQueue 中的类型参数">E</A> extends <A HREF="Delayed.html" title="java.util.concurrent 中的接口">Delayed</A>&gt;</CODE> 中的 <CODE><A HREF="../Collection.html#add(E)">add</A></CODE><DT><B>指定者：</B><DD>接口 <CODE><A HREF="BlockingQueue.html" title="java.util.concurrent 中的接口">BlockingQueue</A>&lt;<A HREF="DelayQueue.html" title="DelayQueue 中的类型参数">E</A> extends <A HREF="Delayed.html" title="java.util.concurrent 中的接口">Delayed</A>&gt;</CODE> 中的 <CODE><A HREF="BlockingQueue.html#add(E)">add</A></CODE><DT><B>覆盖：</B><DD>类 <CODE><A HREF="../AbstractQueue.html" title="java.util 中的类">AbstractQueue</A>&lt;<A HREF="DelayQueue.html" title="DelayQueue 中的类型参数">E</A> extends <A HREF="Delayed.html" title="java.util.concurrent 中的接口">Delayed</A>&gt;</CODE> 中的 <CODE><A HREF="../AbstractQueue.html#add(E)">add</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>o</CODE> - 要添加的元素
<DT><B>返回：</B><DD><tt>true</tt>（按照 <tt>Collection.add</tt> 的常规协定）。
<DT><B>抛出：</B>
<DD><CODE><A HREF="../../lang/NullPointerException.html" title="java.lang 中的类">NullPointerException</A></CODE> - 如果指定的元素为 <tt>null</tt>。</DL>
</DD>
</DL>
<HR>

<A NAME="take()"><!-- --></A><H3>
take</H3>
<PRE>
public <A HREF="DelayQueue.html" title="DelayQueue 中的类型参数">E</A> <B>take</B>()
                       throws <A HREF="../../lang/InterruptedException.html" title="java.lang 中的类">InterruptedException</A></PRE>
<DL>
<DD>检索并移除此队列的头部，如果此队列不存在未到期延迟的元素，则等待它。
<P>
<DD><DL>
<DT><B>指定者：</B><DD>接口 <CODE><A HREF="BlockingQueue.html" title="java.util.concurrent 中的接口">BlockingQueue</A>&lt;<A HREF="DelayQueue.html" title="DelayQueue 中的类型参数">E</A> extends <A HREF="Delayed.html" title="java.util.concurrent 中的接口">Delayed</A>&gt;</CODE> 中的 <CODE><A HREF="BlockingQueue.html#take()">take</A></CODE></DL>
</DD>
<DD><DL>

<DT><B>返回：</B><DD>此队列的头部
<DT><B>抛出：</B>
<DD><CODE><A HREF="../../lang/InterruptedException.html" title="java.lang 中的类">InterruptedException</A></CODE> - 如果等待时中断。</DL>
</DD>
</DL>
<HR>

<A NAME="poll(long, java.util.concurrent.TimeUnit)"><!-- --></A><H3>
poll</H3>
<PRE>
public <A HREF="DelayQueue.html" title="DelayQueue 中的类型参数">E</A> <B>poll</B>(long&nbsp;timeout,
              <A HREF="TimeUnit.html" title="java.util.concurrent 中的枚举">TimeUnit</A>&nbsp;unit)
                       throws <A HREF="../../lang/InterruptedException.html" title="java.lang 中的类">InterruptedException</A></PRE>
<DL>
<DD>检索并移除此队列的头部，如果此队列不存在未到期延迟的元素，则在到达指定的等待时间之前，一直等待（如果有必要）。
<P>
<DD><DL>
<DT><B>指定者：</B><DD>接口 <CODE><A HREF="BlockingQueue.html" title="java.util.concurrent 中的接口">BlockingQueue</A>&lt;<A HREF="DelayQueue.html" title="DelayQueue 中的类型参数">E</A> extends <A HREF="Delayed.html" title="java.util.concurrent 中的接口">Delayed</A>&gt;</CODE> 中的 <CODE><A HREF="BlockingQueue.html#poll(long, java.util.concurrent.TimeUnit)">poll</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>timeout</CODE> - 放弃前要等待的时间长度，以 <tt>unit</tt> 为时间单位<DD><CODE>unit</CODE> - 确定如何解释 <tt>timeout</tt> 参数的 <tt>TimeUnit</tt>
<DT><B>返回：</B><DD>此队列的头部；如果在出现未到期延迟的元素之前超出了指定的等待时间，则返回 <tt>null</tt>。
<DT><B>抛出：</B>
<DD><CODE><A HREF="../../lang/InterruptedException.html" title="java.lang 中的类">InterruptedException</A></CODE> - 如果在等待时被中断。</DL>
</DD>
</DL>
<HR>

<A NAME="poll()"><!-- --></A><H3>
poll</H3>
<PRE>
public <A HREF="DelayQueue.html" title="DelayQueue 中的类型参数">E</A> <B>poll</B>()</PRE>
<DL>
<DD>检索并移除此队列的头部，如果此队列不存在未到期延迟的元素，则返回 <tt>null</tt>。
<P>
<DD><DL>
<DT><B>指定者：</B><DD>接口 <CODE><A HREF="../Queue.html" title="java.util 中的接口">Queue</A>&lt;<A HREF="DelayQueue.html" title="DelayQueue 中的类型参数">E</A> extends <A HREF="Delayed.html" title="java.util.concurrent 中的接口">Delayed</A>&gt;</CODE> 中的 <CODE><A HREF="../Queue.html#poll()">poll</A></CODE></DL>
</DD>
<DD><DL>

<DT><B>返回：</B><DD>此队列的头部，如果此队列不存在未期满延迟的元素，则返回 <tt>null</tt>。</DL>
</DD>
</DL>
<HR>

<A NAME="peek()"><!-- --></A><H3>
peek</H3>
<PRE>
public <A HREF="DelayQueue.html" title="DelayQueue 中的类型参数">E</A> <B>peek</B>()</PRE>
<DL>
<DD>检索但不移除此队列的头部，如果此队列不存在未到期延迟的元素，则返回 <tt>null</tt>。
<P>
<DD><DL>
<DT><B>指定者：</B><DD>接口 <CODE><A HREF="../Queue.html" title="java.util 中的接口">Queue</A>&lt;<A HREF="DelayQueue.html" title="DelayQueue 中的类型参数">E</A> extends <A HREF="Delayed.html" title="java.util.concurrent 中的接口">Delayed</A>&gt;</CODE> 中的 <CODE><A HREF="../Queue.html#peek()">peek</A></CODE></DL>
</DD>
<DD><DL>

<DT><B>返回：</B><DD>此队列的头部，如果此队列不存在未到期延迟的元素，则返回 <tt>null</tt>。</DL>
</DD>
</DL>
<HR>

<A NAME="size()"><!-- --></A><H3>
size</H3>
<PRE>
public int <B>size</B>()</PRE>
<DL>
<DD><B>从类 <CODE><A HREF="../AbstractCollection.html#size()">AbstractCollection</A></CODE> 复制的描述</B></DD>
<DD>返回此 collection 中的元素数。如果该 collection 包含多于 <tt>Integer.MAX_VALUE</tt> 的元素，则返回 <tt>Integer.MAX_VALUE</tt>。
<P>
<DD><DL>
<DT><B>指定者：</B><DD>接口 <CODE><A HREF="../Collection.html" title="java.util 中的接口">Collection</A>&lt;<A HREF="DelayQueue.html" title="DelayQueue 中的类型参数">E</A> extends <A HREF="Delayed.html" title="java.util.concurrent 中的接口">Delayed</A>&gt;</CODE> 中的 <CODE><A HREF="../Collection.html#size()">size</A></CODE><DT><B>指定者：</B><DD>类 <CODE><A HREF="../AbstractCollection.html" title="java.util 中的类">AbstractCollection</A>&lt;<A HREF="DelayQueue.html" title="DelayQueue 中的类型参数">E</A> extends <A HREF="Delayed.html" title="java.util.concurrent 中的接口">Delayed</A>&gt;</CODE> 中的 <CODE><A HREF="../AbstractCollection.html#size()">size</A></CODE></DL>
</DD>
<DD><DL>

<DT><B>返回：</B><DD>此 collection 中的元素数。</DL>
</DD>
</DL>
<HR>

<A NAME="drainTo(java.util.Collection)"><!-- --></A><H3>
drainTo</H3>
<PRE>
public int <B>drainTo</B>(<A HREF="../Collection.html" title="java.util 中的接口">Collection</A>&lt;? super <A HREF="DelayQueue.html" title="DelayQueue 中的类型参数">E</A>&gt;&nbsp;c)</PRE>
<DL>
<DD><B>从接口 <CODE><A HREF="BlockingQueue.html#drainTo(java.util.Collection)">BlockingQueue</A></CODE> 复制的描述</B></DD>
<DD>移除此队列中所有可用的元素，并将它们添加到给定 collection 中。此操作可能比反复轮询此队列更有效。在试图向 <tt>c</tt> 集合中 <tt>add</tt> 元素没有成功时，可能导致在抛出相关异常时，元素会同时在两个 collection 中出现，或者在其中一个 collection 中出现，也可能在两个 collection 中都不出现。如果试图将一个队列放入自身队列中，则会导致 <tt>IllegalArgumentException</tt> 异常。此外，如果正在进行此操作时修改指定的 collection，则此操作行为是不确定的。
<P>
<DD><DL>
<DT><B>指定者：</B><DD>接口 <CODE><A HREF="BlockingQueue.html" title="java.util.concurrent 中的接口">BlockingQueue</A>&lt;<A HREF="DelayQueue.html" title="DelayQueue 中的类型参数">E</A> extends <A HREF="Delayed.html" title="java.util.concurrent 中的接口">Delayed</A>&gt;</CODE> 中的 <CODE><A HREF="BlockingQueue.html#drainTo(java.util.Collection)">drainTo</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>c</CODE> - 接收传输元素的 collection
<DT><B>返回：</B><DD>传输元素的数量。</DL>
</DD>
</DL>
<HR>

<A NAME="drainTo(java.util.Collection, int)"><!-- --></A><H3>