Класс AbstractQueue<E>

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.

Конструкторы

AbstractQueue

protected AbstractQueue()

Конструктор для использования подклассами.

Методы

add

public boolean add(E e)

Определено в:

add в интерфейсе Collection<E>

Определено в:

add в интерфейсе Queue<E>

Переопределяет:

add в классе AbstractCollection<E>

Параметры:

e - элемент для добавления

Возвращает:

true (как указано в Collection.add(E))

Исключения:

IllegalStateException - если элемент не может быть добавлен в данный момент из-за ограничений на емкость

ClassCastException - если класс указанного элемента препятствует его добавлению в эту очередь

NullPointerException - если указанный элемент равен null, и эта очередь не допускает null-элементов

IllegalArgumentException - если какое-либо свойство этого элемента препятствует его добавлению в эту очередь

remove

public E remove()

Определено в:

remove в интерфейсе Queue<E>

Возвращает:

голова этой очереди

Исключения:

NoSuchElementException - если эта очередь пуста

element

public E element()

Определено в:

element в интерфейсе Queue<E>

Возвращает:

голова этой очереди

Исключения:

NoSuchElementException - если эта очередь пуста

clear

public void clear()

Определено в:

clear в интерфейсе Collection<E>

Переопределяет:

clear в классе AbstractCollection<E>

addAll

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

Определено в:

addAll в интерфейсе Collection<E>

Переопределяет:

addAll в классе AbstractCollection<E>

Параметры:

c - коллекция, содержащая элементы, которые нужно добавить в эту очередь

Возвращает:

true , если эта очередь изменилась в результате вызова

Исключения:

ClassCastException - если класс элемента указанной коллекции препятствует его добавлению в эту очередь

NullPointerException - если указанная коллекция содержит null-элемент, и эта очередь не допускает null-элементов, или если указанная коллекция равна null

IllegalArgumentException - если какое-либо свойство элемента указанной коллекции препятствует его добавлению в эту очередь, или если указанная коллекция является этой очередью

IllegalStateException - если не все элементы могут быть добавлены в данный момент из-за ограничений на вставку

См. также:

add(Object)