compact1, compact2, compact3

java.util

Class AbstractQueue<E>

java.lang.Object

java.util.AbstractCollection<E>

java.util.AbstractQueue<E>

参数类型

E - 在此集合中保存的元素的类型

All Implemented Interfaces:

Iterable <E>， Collection <E>， Queue <E>

已知直接子类：

ArrayBlockingQueue ， ConcurrentLinkedQueue ， DelayQueue ， LinkedBlockingDeque ， LinkedBlockingQueue ， LinkedTransferQueue ， PriorityBlockingQueue ， PriorityQueue ， SynchronousQueue

public abstract class AbstractQueue<E>
extends AbstractCollection<E>
implements Queue<E>

这个类提供了一些Queue操作的骨架实现。 当基实现不允许 null个元件在这个类的实现是合适的。 方法add ， remove和element基于offer ， poll和peek ，分别，但抛出异常，而不是通过false个或null返回表示失败。

扩展此类甲Queue实现必须最低限度地限定的方法Queue.offer(E)它不允许null个元件的插入，与方法一起Queue.peek() ， Queue.poll() ， Collection.size()和Collection.iterator() 。 通常，其他方法也将被覆盖。 如果无法满足这些要求，请考虑将其分类为AbstractCollection 。

这个班是Java Collections Framework的会员 。

从以下版本开始：

1.5

构造方法摘要

构造方法

Modifier	Constructor and Description
protected	AbstractQueue() 子类使用的构造方法。

方法摘要

Modifier and Type	Method and Description
boolean	add(E e) 将指定的元素插入到此队列中，如果可以立即执行此操作而不违反容量限制， 则在成功后返回 true，如果当前没有可用空间，则抛出IllegalStateException。
boolean	addAll(Collection<? extends E> c) 将指定集合中的所有元素添加到此队列中。
void	clear() 从此队列中删除所有元素。
E	element() 检索，但不删除，这个队列的头。
E	remove() 检索并删除此队列的头。

Methods inherited from class java.util.AbstractCollection

contains, containsAll, isEmpty, iterator, remove, removeAll, retainAll, size, toArray, toArray, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface java.util.Queue

offer, peek, poll

Methods inherited from interface java.util.Collection

contains, containsAll, equals, hashCode, isEmpty, iterator, parallelStream, remove, removeAll, removeIf, retainAll, size, spliterator, stream, toArray, toArray

Methods inherited from interface java.lang.Iterable

forEach

构造方法详细信息

AbstractQueue

protected AbstractQueue()

子类使用的构造方法。

方法详细信息

add

public boolean add(E e)

将指定的元素插入到此队列中，如果可以立即执行此操作而不违反容量限制， 则在成功后返回884456489101081，如果当前没有可用空间，则抛出IllegalStateException。

如果offer成功，此实现返回true ，否则抛出一个IllegalStateException 。

Specified by:

add在接口 Collection<E>

Specified by:

add在接口 Queue<E>

重写：

add在类别 AbstractCollection<E>

参数

e - 要添加的元素

结果

true （由 Collection.add(E)指定 ）

异常

IllegalStateException - 如果由于容量限制，此时无法添加该元素

ClassCastException - 如果指定元素的类阻止将其添加到此队列中

NullPointerException - 如果指定的元素为空，并且该队列不允许空元素

IllegalArgumentException - 如果此元素的某些属性阻止将其添加到此队列

remove

public E remove()

检索并删除此队列的头。 此方法与poll不同之处在于，如果此队列为空，它将抛出异常。

除非队列为空，否则此实现返回的poll结果。

Specified by:

remove在界面 Queue<E>

结果

这个队列的头

异常

NoSuchElementException - 如果此队列为空

element

public E element()

检索，但不删除，这个队列的头。 此方法与peek的不同之处在于，如果此队列为空，它将抛出异常。

除非队列为空，否则此实现返回的peek结果。

Specified by:

element在界面 Queue<E>

结果

这个队列的头

异常

NoSuchElementException - 如果这个队列是空的

clear

public void clear()

从此队列中删除所有元素。 此呼叫返回后队列将为空。

这个实现反复调用poll ，直到它返回null 。

Specified by:

clear在界面 Collection<E>

重写：

clear在类别 AbstractCollection<E>

addAll

public boolean addAll(Collection<? extends E> c)

将指定集合中的所有元素添加到此队列中。 尝试将所有队列添加到自身会导致IllegalArgumentException 。 此外，如果在操作进行中修改了指定的集合，则此操作的行为是未定义的。

这个实现遍历指定的集合，并依次将迭代器返回的每个元素添加到此队列中。 在尝试添加元素（包括特别是null元素）时遇到的运行时异常可能会导致在抛出关联异常时只有部分元素已成功添加。

Specified by:

addAll在界面 Collection<E>

重写：

addAll在类别 AbstractCollection<E>

参数

c - 包含要添加到此队列的元素的集合

结果

true如果此队列由于调用而更改

异常

ClassCastException - 如果指定集合的元素的类阻止将其添加到此队列中

NullPointerException - 如果指定的集合包含空元素，并且此队列不允许空元素，或者如果指定的集合为空

IllegalArgumentException - 如果指定集合的元素的某些属性阻止其添加到此队列中，或者如果指定的集合是此队列

IllegalStateException - 如果不是，由于插入限制，此时可以添加所有元素

另请参见：

add(Object)