arrayblockingqueue.html
来自「j2se5-api-zh,java文档的中文版本」· HTML 代码 · 共 855 行 · 第 1/4 页
HTML
855 行
将指定的元素插入到此队列的尾部（如果可能），如果此队列已满，则立即返回。</TD></TR><TR BGCOLOR="white" CLASS="TableRowColor"><TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"><CODE> boolean</CODE></FONT></TD><TD><CODE><B><A HREF="ArrayBlockingQueue.html#offer(E, long, java.util.concurrent.TimeUnit)">offer</A></B>(<A HREF="ArrayBlockingQueue.html" title="ArrayBlockingQueue 中的类型参数">E</A> o, long timeout, <A HREF="TimeUnit.html" title="java.util.concurrent 中的枚举">TimeUnit</A> unit)</CODE><BR> 将指定的元素插入到此队列的尾部，如果没有可用空间，将等待指定的等待时间（如果有必要）。</TD></TR><TR BGCOLOR="white" CLASS="TableRowColor"><TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"><CODE> <A HREF="ArrayBlockingQueue.html" title="ArrayBlockingQueue 中的类型参数">E</A></CODE></FONT></TD><TD><CODE><B><A HREF="ArrayBlockingQueue.html#peek()">peek</A></B>()</CODE><BR> 检索，但是不移除此队列的头，如果此队列为空，则返回 <tt>null</tt>。</TD></TR><TR BGCOLOR="white" CLASS="TableRowColor"><TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"><CODE> <A HREF="ArrayBlockingQueue.html" title="ArrayBlockingQueue 中的类型参数">E</A></CODE></FONT></TD><TD><CODE><B><A HREF="ArrayBlockingQueue.html#poll()">poll</A></B>()</CODE><BR> 检索并移除此队列的头，如果此队列为空，则返回 <tt>null</tt>。</TD></TR><TR BGCOLOR="white" CLASS="TableRowColor"><TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"><CODE> <A HREF="ArrayBlockingQueue.html" title="ArrayBlockingQueue 中的类型参数">E</A></CODE></FONT></TD><TD><CODE><B><A HREF="ArrayBlockingQueue.html#poll(long, java.util.concurrent.TimeUnit)">poll</A></B>(long timeout, <A HREF="TimeUnit.html" title="java.util.concurrent 中的枚举">TimeUnit</A> unit)</CODE><BR> 检索并移除此队列的头部，如果此队列中没有任何元素，则等待指定等待的时间（如果有必要）。</TD></TR><TR BGCOLOR="white" CLASS="TableRowColor"><TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"><CODE> void</CODE></FONT></TD><TD><CODE><B><A HREF="ArrayBlockingQueue.html#put(E)">put</A></B>(<A HREF="ArrayBlockingQueue.html" title="ArrayBlockingQueue 中的类型参数">E</A> o)</CODE><BR> 将指定的元素添加到此队列的尾部，如果必要，将等待可用的空间。</TD></TR><TR BGCOLOR="white" CLASS="TableRowColor"><TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"><CODE> int</CODE></FONT></TD><TD><CODE><B><A HREF="ArrayBlockingQueue.html#remainingCapacity()">remainingCapacity</A></B>()</CODE><BR> 返回在无阻塞的理想情况下（不存在内存或资源约束）此队列能接受的元素数量。</TD></TR><TR BGCOLOR="white" CLASS="TableRowColor"><TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"><CODE> boolean</CODE></FONT></TD><TD><CODE><B><A HREF="ArrayBlockingQueue.html#remove(java.lang.Object)">remove</A></B>(<A HREF="../../lang/Object.html" title="java.lang 中的类">Object</A> o)</CODE><BR> 从此队列中移除指定元素的一个实例（如果存在）。</TD></TR><TR BGCOLOR="white" CLASS="TableRowColor"><TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"><CODE> int</CODE></FONT></TD><TD><CODE><B><A HREF="ArrayBlockingQueue.html#size()">size</A></B>()</CODE><BR> 返回此队列中元素的数量。</TD></TR><TR BGCOLOR="white" CLASS="TableRowColor"><TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"><CODE> <A HREF="ArrayBlockingQueue.html" title="ArrayBlockingQueue 中的类型参数">E</A></CODE></FONT></TD><TD><CODE><B><A HREF="ArrayBlockingQueue.html#take()">take</A></B>()</CODE><BR> 检索并移除此队列的头部，如果此队列不存在任何元素，则一直等待。</TD></TR><TR BGCOLOR="white" CLASS="TableRowColor"><TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"><CODE> <A HREF="../../lang/Object.html" title="java.lang 中的类">Object</A>[]</CODE></FONT></TD><TD><CODE><B><A HREF="ArrayBlockingQueue.html#toArray()">toArray</A></B>()</CODE><BR> 返回包含此 collection 中所有元素的数组。</TD></TR><TR BGCOLOR="white" CLASS="TableRowColor"><TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"><CODE><TABLE BORDER="0" CELLPADDING="0" CELLSPACING="0" SUMMARY=""><TR ALIGN="right" VALIGN=""><TD NOWRAP><FONT SIZE="-1"><CODE><T> T[]</CODE></FONT></TD></TR></TABLE></CODE></FONT></TD><TD><CODE><B><A HREF="ArrayBlockingQueue.html#toArray(T[])">toArray</A></B>(T[] a)</CODE><BR> 返回包含此 collection 中所有元素的数组；返回数组的运行时类型是指定数组的类型。</TD></TR><TR BGCOLOR="white" CLASS="TableRowColor"><TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"><CODE> <A HREF="../../lang/String.html" title="java.lang 中的类">String</A></CODE></FONT></TD><TD><CODE><B><A HREF="ArrayBlockingQueue.html#toString()">toString</A></B>()</CODE><BR> 返回此 collection 的字符串表示形式。</TD></TR></TABLE> <A NAME="methods_inherited_from_class_java.util.AbstractQueue"><!-- --></A><TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""><TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor"><TH ALIGN="left"><B>从类 java.util.<A HREF="../AbstractQueue.html" title="java.util 中的类">AbstractQueue</A> 继承的方法</B></TH></TR><TR BGCOLOR="white" CLASS="TableRowColor"><TD><CODE><A HREF="../AbstractQueue.html#add(E)">add</A>, <A HREF="../AbstractQueue.html#addAll(java.util.Collection)">addAll</A>, <A HREF="../AbstractQueue.html#element()">element</A>, <A HREF="../AbstractQueue.html#remove()">remove</A></CODE></TD></TR></TABLE> <A NAME="methods_inherited_from_class_java.util.AbstractCollection"><!-- --></A><TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""><TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor"><TH ALIGN="left"><B>从类 java.util.<A HREF="../AbstractCollection.html" title="java.util 中的类">AbstractCollection</A> 继承的方法</B></TH></TR><TR BGCOLOR="white" CLASS="TableRowColor"><TD><CODE><A HREF="../AbstractCollection.html#containsAll(java.util.Collection)">containsAll</A>, <A HREF="../AbstractCollection.html#isEmpty()">isEmpty</A>, <A HREF="../AbstractCollection.html#removeAll(java.util.Collection)">removeAll</A>, <A HREF="../AbstractCollection.html#retainAll(java.util.Collection)">retainAll</A></CODE></TD></TR></TABLE> <A NAME="methods_inherited_from_class_java.lang.Object"><!-- --></A><TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""><TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor"><TH ALIGN="left"><B>从类 java.lang.<A HREF="../../lang/Object.html" title="java.lang 中的类">Object</A> 继承的方法</B></TH></TR><TR BGCOLOR="white" CLASS="TableRowColor"><TD><CODE><A HREF="../../lang/Object.html#clone()">clone</A>, <A HREF="../../lang/Object.html#equals(java.lang.Object)">equals</A>, <A HREF="../../lang/Object.html#finalize()">finalize</A>, <A HREF="../../lang/Object.html#getClass()">getClass</A>, <A HREF="../../lang/Object.html#hashCode()">hashCode</A>, <A HREF="../../lang/Object.html#notify()">notify</A>, <A HREF="../../lang/Object.html#notifyAll()">notifyAll</A>, <A HREF="../../lang/Object.html#wait()">wait</A>, <A HREF="../../lang/Object.html#wait(long)">wait</A>, <A HREF="../../lang/Object.html#wait(long, int)">wait</A></CODE></TD></TR></TABLE> <A NAME="methods_inherited_from_class_java.util.concurrent.BlockingQueue"><!-- --></A><TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""><TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor"><TH ALIGN="left"><B>从接口 java.util.concurrent.<A HREF="BlockingQueue.html" title="java.util.concurrent 中的接口">BlockingQueue</A> 继承的方法</B></TH></TR><TR BGCOLOR="white" CLASS="TableRowColor"><TD><CODE><A HREF="BlockingQueue.html#add(E)">add</A></CODE></TD></TR></TABLE> <A NAME="methods_inherited_from_class_java.util.Queue"><!-- --></A><TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""><TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor"><TH ALIGN="left"><B>从接口 java.util.<A HREF="../Queue.html" title="java.util 中的接口">Queue</A> 继承的方法</B></TH></TR><TR BGCOLOR="white" CLASS="TableRowColor"><TD><CODE><A HREF="../Queue.html#element()">element</A>, <A HREF="../Queue.html#remove()">remove</A></CODE></TD></TR></TABLE> <A NAME="methods_inherited_from_class_java.util.Collection"><!-- --></A><TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""><TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor"><TH ALIGN="left"><B>从接口 java.util.<A HREF="../Collection.html" title="java.util 中的接口">Collection</A> 继承的方法</B></TH></TR><TR BGCOLOR="white" CLASS="TableRowColor"><TD><CODE><A HREF="../Collection.html#addAll(java.util.Collection)">addAll</A>, <A HREF="../Collection.html#containsAll(java.util.Collection)">containsAll</A>, <A HREF="../Collection.html#equals(java.lang.Object)">equals</A>, <A HREF="../Collection.html#hashCode()">hashCode</A>, <A HREF="../Collection.html#isEmpty()">isEmpty</A>, <A HREF="../Collection.html#removeAll(java.util.Collection)">removeAll</A>, <A HREF="../Collection.html#retainAll(java.util.Collection)">retainAll</A></CODE></TD></TR></TABLE> <P><!-- ========= CONSTRUCTOR DETAIL ======== --><A NAME="constructor_detail"><!-- --></A><TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""><TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor"><TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2"><B>构造方法详细信息</B></FONT></TH></TR></TABLE><A NAME="ArrayBlockingQueue(int)"><!-- --></A><H3>ArrayBlockingQueue</H3><PRE>public <B>ArrayBlockingQueue</B>(int capacity)</PRE><DL><DD>创建一个带有给定的（固定）容量和默认访问策略的 <tt>ArrayBlockingQueue</tt>。<P><DL><DT><B>参数：</B><DD><CODE>capacity</CODE> - 此队列的容量<DT><B>抛出：</B><DD><CODE><A HREF="../../lang/IllegalArgumentException.html" title="java.lang 中的类">IllegalArgumentException</A></CODE> - 如果 <tt>capacity</tt> 小于 1</DL></DL><HR><A NAME="ArrayBlockingQueue(int, boolean)"><!-- --></A><H3>ArrayBlockingQueue</H3><PRE>public <B>ArrayBlockingQueue</B>(int capacity, boolean fair)</PRE><DL><DD>创建一个具有给定的（固定）容量和指定访问策略的 <tt>ArrayBlockingQueue</tt>。<P><DL><DT><B>参数：</B><DD><CODE>capacity</CODE> - 此队列的容量<DD><CODE>fair</CODE> - 如果为 <tt>true</tt>，则按照 FIFO 顺序访问插入或移除时受阻塞线程的队列；如果为 <tt>false</tt>，则访问顺序是不确定的。<DT><B>抛出：</B><DD><CODE><A HREF="../../lang/IllegalArgumentException.html" title="java.lang 中的类">IllegalArgumentException</A></CODE> - 如果 <tt>capacity</tt> 小于 1</DL></DL><HR><A NAME="ArrayBlockingQueue(int, boolean, java.util.Collection)"><!-- --></A><H3>ArrayBlockingQueue</H3><PRE>public <B>ArrayBlockingQueue</B>(int capacity, boolean fair, <A HREF="../Collection.html" title="java.util 中的接口">Collection</A><? extends <A HREF="ArrayBlockingQueue.html" title="ArrayBlockingQueue 中的类型参数">E</A>> c)</PRE><DL><DD>创建一个具有给定的（固定）容量和指定访问策略的 <tt>ArrayBlockingQueue</tt>，它最初包含给定 collection 的元素，并以 collection 迭代器的遍历顺序添加元素。<P>⌨️ 快捷键说明
复制代码Ctrl + C
搜索代码Ctrl + F
全屏模式F11
增大字号Ctrl + =
减小字号Ctrl + -
显示快捷键?