java.util

Класс AbstractQueue <E>

java.lang. Объект

java.util. AbstractCollection<E>

java.util. AbstractQueue <E>

Введите Параметры:

E - тип элементов сохранен в этом наборе

Все Реализованные Интерфейсы:

Повторяемый <E>, Набор <E>, Очередь <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, соответственно, но выдайте исключения вместо того, чтобы указать на отказ через возвраты null или false.

Реализация Queue, которая расширяет этот класс, должна минимально определить метод Queue.offer(E) который не разрешает вставку элементов null, наряду с методами Queue.peek(), Queue.poll(), Collection.size(), и Collection.iterator(). Как правило, дополнительные методы будут переопределены также. Если эти требования не могут быть удовлетворены, рассмотрите вместо этого разделение на подклассы AbstractCollection.

Этот класс является элементом Платформы Наборов Java.

С тех пор:

1.5

Сводка конструктора

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

Модификатор	Конструктор и Описание
protected	AbstractQueue() Конструктор для использования подклассами.

Сводка метода

Методы

Модификатор и Тип	Метод и Описание
boolean	add(E e) Вставляет указанный элемент в эту очередь, если возможно сделать так сразу, не нарушая ограничения емкости, возвращая true на успех и бросая IllegalStateException, если никакое пространство не в настоящий момент доступно.
boolean	addAll(Collection<? extends E> c) Добавляют все элементы в указанном наборе этой очереди.
void	clear() Удаляет все элементы от этой очереди.
E	element() Получает, но не удаляет, глава этой очереди.
E	remove() Получает и удаляет главу этой очереди.

Методы java.util унаследованный от класса. AbstractCollection

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

Методы java.lang унаследованный от класса. Объект

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

Методы, наследованные от интерфейса java.util. Очередь

offer, peek, poll

Методы, наследованные от интерфейса java.util. Набор

contains, containsAll, equals, hashCode, isEmpty, iterator, remove, removeAll, retainAll, size, toArray, toArray

Деталь конструктора

AbstractQueue

protected AbstractQueue()

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

Деталь метода

добавить

public boolean add(E e)

Вставляет указанный элемент в эту очередь, если возможно сделать так сразу, не нарушая ограничения емкости, возвращая true на успех и бросая IllegalStateException, если никакое пространство не в настоящий момент доступно.

Эта реализация возвращает true, если offer успешно выполняется, еще бросает IllegalStateException.

Определенный:

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

Определенный:

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

Переопределения:

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

Параметры:

e - элемент, чтобы добавить

Возвраты:

true (как определено Collection.add(E))

Броски:

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

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

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

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

удалить

public E remove()

Получает и удаляет главу этой очереди. Этот метод отличается от poll только в этом это выдает исключение, если эта очередь пуста.

Эта реализация возвращает результат poll, если очередь не пуста.

Определенный:

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

Возвраты:

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

Броски:

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

элемент

public E element()

Получает, но не удаляет, глава этой очереди. Этот метод отличается от peek только в этом это выдает исключение, если эта очередь пуста.

Эта реализация возвращает результат peek, если очередь не пуста.

Определенный:

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

Возвраты:

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

Броски:

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

очистить

public void clear()

Удаляет все элементы от этой очереди. Очередь будет пуста после этого вызова возвраты.

Эта реализация неоднократно вызывает poll пока это не возвращает null.

Определенный:

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

Переопределения:

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

addAll

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

Добавляют все элементы в указанном наборе этой очереди. Попытки к addAll очереди, чтобы самостоятельно привести к IllegalArgumentException. Далее, поведение этой работы неопределено, если указанный набор изменяется, в то время как работа происходит.

Эта реализация выполняет итерации по указанному набору, и добавляет каждый элемент, возвращенный iterator этой очереди, поочередно. Исключение на этапе выполнения встречалось, пытаясь добавить, что элемент (включая, в частности элемент null) могут привести к только некоторым из элементов, успешно добавленных, когда связанное исключение выдается.

Определенный:

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

Переопределения:

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

Параметры:

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

Возвраты:

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

Броски:

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

NullPointerException - если указанный набор содержит нулевой элемент, и эта очередь не разрешает нулевые элементы, или если указанный набор является нулем

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

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

См. Также:

add(Object)