compact1, compact2, compact3

java.util

Class AbstractQueue<E>

java.lang.Object

java.util.AbstractCollection<E>

java.util.AbstractQueue<E>

参数类型

E -元素举行此集合中的类型

All Implemented Interfaces:

Iterable ， Collection ， Queue

已知直接子类：

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。

从以下版本开始：

一点五

构造方法摘要

构造方法

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

Constructor Detail

AbstractQueue

protected AbstractQueue()

子类使用的构造函数。

方法详细信息

add

public boolean add(E e)

插入指定元素为该队列是否有可能立即这样做不违反容量限制，还 true成功后抛出 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 -如果指定元素为null，这队列不允许null元素

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 -如果指定集合包含一个null元素，这个队列不允许null元素，或者指定集合为空

IllegalArgumentException -如果指定集合的一个元素的一些特性阻止其加入队列，或者如果指定集合队列

IllegalStateException -如果不是所有的元素都可以在这个时候加入由于插入的限制

另请参见：

add(Object)