priorityblockingqueue.html

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

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

<A NAME="add(java.lang.Object)"><!-- --></A><A NAME="add(E)"><!-- --></A><H3>
add</H3>
<PRE>
public boolean <B>add</B>(<A HREF="PriorityBlockingQueue.html" title="PriorityBlockingQueue 中的类型参数">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="PriorityBlockingQueue.html" title="PriorityBlockingQueue 中的类型参数">E</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="PriorityBlockingQueue.html" title="PriorityBlockingQueue 中的类型参数">E</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="PriorityBlockingQueue.html" title="PriorityBlockingQueue 中的类型参数">E</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>。
<DD><CODE><A HREF="../../lang/ClassCastException.html" title="java.lang 中的类">ClassCastException</A></CODE> - 如果根据优先级队列的排序规则，无法将指定的元素与优先级队列中当前的元素进行比较。</DL>
</DD>
</DL>
<HR>

<A NAME="comparator()"><!-- --></A><H3>
comparator</H3>
<PRE>
public <A HREF="../Comparator.html" title="java.util 中的接口">Comparator</A>&lt;? super <A HREF="PriorityBlockingQueue.html" title="PriorityBlockingQueue 中的类型参数">E</A>&gt; <B>comparator</B>()</PRE>
<DL>
<DD>返回对此集合进行排序的比较器，或者如果此集合根据其元素的自然顺序排序（使用 <tt>Comparable</tt>），则返回 <tt>null</tt>。
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>

<DT><B>返回：</B><DD>对此集合进行排序的比较器，或者如果此集合根据其元素的自然顺序排序，则返回 <tt>null</tt>。</DL>
</DD>
</DL>
<HR>

<A NAME="offer(java.lang.Object)"><!-- --></A><A NAME="offer(E)"><!-- --></A><H3>
offer</H3>
<PRE>
public boolean <B>offer</B>(<A HREF="PriorityBlockingQueue.html" title="PriorityBlockingQueue 中的类型参数">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="PriorityBlockingQueue.html" title="PriorityBlockingQueue 中的类型参数">E</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="PriorityBlockingQueue.html" title="PriorityBlockingQueue 中的类型参数">E</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/ClassCastException.html" title="java.lang 中的类">ClassCastException</A></CODE> - 如果根据优先级队列的排序规则无法将指定的元素与优先级队列中当前的元素进行比较。
<DD><CODE><A HREF="../../lang/NullPointerException.html" title="java.lang 中的类">NullPointerException</A></CODE> - 如果指定的元素为 <tt>null</tt>。</DL>
</DD>
</DL>
<HR>

<A NAME="put(java.lang.Object)"><!-- --></A><A NAME="put(E)"><!-- --></A><H3>
put</H3>
<PRE>
public void <B>put</B>(<A HREF="PriorityBlockingQueue.html" title="PriorityBlockingQueue 中的类型参数">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="PriorityBlockingQueue.html" title="PriorityBlockingQueue 中的类型参数">E</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/ClassCastException.html" title="java.lang 中的类">ClassCastException</A></CODE> - 如果根据优先级队列的排序规则无法将该元素与优先级队列中当前的元素进行比较。
<DD><CODE><A HREF="../../lang/NullPointerException.html" title="java.lang 中的类">NullPointerException</A></CODE> - 如果指定的元素为 <tt>null</tt>。</DL>
</DD>
</DL>
<HR>

<A NAME="offer(java.lang.Object,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="PriorityBlockingQueue.html" title="PriorityBlockingQueue 中的类型参数">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="PriorityBlockingQueue.html" title="PriorityBlockingQueue 中的类型参数">E</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/ClassCastException.html" title="java.lang 中的类">ClassCastException</A></CODE> - 如果根据优先级队列的排序规则无法将该元素与优先级队列中当前的元素进行比较。
<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="PriorityBlockingQueue.html" title="PriorityBlockingQueue 中的类型参数">E</A> <B>take</B>()
       throws <A HREF="../../lang/InterruptedException.html" title="java.lang 中的类">InterruptedException</A></PRE>
<DL>
<DD><B>从接口 <CODE><A HREF="BlockingQueue.html#take()">BlockingQueue</A></CODE> 复制的描述</B></DD>
<DD>检索并移除此队列的头部，如果此队列不存在任何元素，则一直等待。
<P>
<DD><DL>
<DT><B>指定者：</B><DD>接口 <CODE><A HREF="BlockingQueue.html" title="java.util.concurrent 中的接口">BlockingQueue</A>&lt;<A HREF="PriorityBlockingQueue.html" title="PriorityBlockingQueue 中的类型参数">E</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()"><!-- --></A><H3>
poll</H3>
<PRE>
public <A HREF="PriorityBlockingQueue.html" title="PriorityBlockingQueue 中的类型参数">E</A> <B>poll</B>()</PRE>
<DL>
<DD><B>从接口 <CODE><A HREF="../Queue.html#poll()">Queue</A></CODE> 复制的描述</B></DD>
<DD>检索并移除此队列的头，如果此队列为空，则返回 <tt>null</tt>。
<P>
<DD><DL>
<DT><B>指定者：</B><DD>接口 <CODE><A HREF="../Queue.html" title="java.util 中的接口">Queue</A>&lt;<A HREF="PriorityBlockingQueue.html" title="PriorityBlockingQueue 中的类型参数">E</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="poll(long, java.util.concurrent.TimeUnit)"><!-- --></A><H3>
poll</H3>
<PRE>
public <A HREF="PriorityBlockingQueue.html" title="PriorityBlockingQueue 中的类型参数">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><B>从接口 <CODE><A HREF="BlockingQueue.html#poll(long, java.util.concurrent.TimeUnit)">BlockingQueue</A></CODE> 复制的描述</B></DD>
<DD>检索并移除此队列的头部，如果此队列中没有任何元素，则等待指定等待的时间（如果有必要）。
<P>
<DD><DL>
<DT><B>指定者：</B><DD>接口 <CODE><A HREF="BlockingQueue.html" title="java.util.concurrent 中的接口">BlockingQueue</A>&lt;<A HREF="PriorityBlockingQueue.html" title="PriorityBlockingQueue 中的类型参数">E</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="peek()"><!-- --></A><H3>
peek</H3>
<PRE>
public <A HREF="PriorityBlockingQueue.html" title="PriorityBlockingQueue 中的类型参数">E</A> <B>peek</B>()</PRE>
<DL>
<DD><B>从接口 <CODE><A HREF="../Queue.html#peek()">Queue</A></CODE> 复制的描述</B></DD>
<DD>检索，但是不移除此队列的头，如果此队列为空，则返回 <tt>null</tt>。
<P>
<DD><DL>
<DT><B>指定者：</B><DD>接口 <CODE><A HREF="../Queue.html" title="java.util 中的接口">Queue</A>&lt;<A HREF="PriorityBlockingQueue.html" title="PriorityBlockingQueue 中的类型参数">E</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="PriorityBlockingQueue.html" title="PriorityBlockingQueue 中的类型参数">E</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="PriorityBlockingQueue.html" title="PriorityBlockingQueue 中的类型参数">E</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="remainingCapacity()"><!-- --></A><H3>
remainingCapacity</H3>
<PRE>
public int <B>remainingCapacity</B>()</PRE>
<DL>
<DD>总是返回 <tt>Integer.MAX_VALUE</tt>，因为 <tt>PriorityBlockingQueue</tt> 没有容量限制。
<P>
<DD><DL>
<DT><B>指定者：</B><DD>接口 <CODE><A HREF="BlockingQueue.html" title="java.util.concurrent 中的接口">BlockingQueue</A>&lt;<A HREF="PriorityBlockingQueue.html" title="PriorityBlockingQueue 中的类型参数">E</A>&gt;</CODE> 中的 <CODE><A HREF="BlockingQueue.html#remainingCapacity()">remainingCapacity</A></CODE></DL>
</DD>
<DD><DL>

<DT><B>返回：</B><DD><tt>Integer.MAX_VALUE</tt></DL>
</DD>
</DL>
<HR>

<A NAME="remove(java.lang.Object)"><!-- --></A><H3>
remove</H3>
<PRE>
public boolean <B>remove</B>(<A HREF="../../lang/Object.html" title="java.lang 中的类">Object</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="PriorityBlockingQueue.html" title="PriorityBlockingQueue 中的类型参数">E</A>&gt;</CODE> 中的 <CODE><A HREF="../Collection.html#remove(java.lang.Object)">remove</A></CODE><DT><B>覆盖：</B><DD>类 <CODE><A HREF="../AbstractCollection.html" title="java.util 中的类">AbstractCollection</A>&lt;<A HREF="PriorityBlockingQueue.html" title="PriorityBlockingQueue 中的类型参数">E</A>&gt;</CODE> 中的 <CODE><A HREF="../AbstractCollection.html#remove(java.lang.Object)">remove</A></CODE></DL>