Spec-Zone .ru
спецификации, руководства, описания, API
|
E
- тип элементов сохранен в этом набореpublic abstract class AbstractQueue<E> extends AbstractCollection<E> implements Queue<E>
Queue
операции. Реализации в этом class являются соответствующими, когда основная реализация не позволяет элементы null. Методы add
, remove
, и element
основаны на offer
, poll
, и peek
, соответственно, но выдайте исключения вместо того, чтобы указать на отказ через возвраты null или false. Реализация Queue, которая расширяет этот class, должна минимально определить метод Queue.offer(E)
который не разрешает вставку элементов null, наряду с методами Queue.peek()
, Queue.poll()
, Collection.size()
, и Collection.iterator()
. Как правило, дополнительные методы будут переопределены также. Если эти требования не могут быть удовлетворены, рассмотрите вместо этого разделение на подклассы AbstractCollection
.
Этот class является элементом Платформы Наборов Java.
Модификатор | Конструктор и Описание |
---|---|
protected |
AbstractQueue()
Конструктор для использования подклассами.
|
Модификатор и Тип | Метод и Описание |
---|---|
boolean |
add(E e)
Вставляет указанный элемент в эту очередь, если возможно сделать так сразу, не нарушая ограничения емкости, возвращая true на успех и бросая IllegalStateException, если никакое пространство не в настоящий момент доступно.
|
boolean |
addAll(Collection<? extends E> c)
Добавляют все элементы в указанном наборе этой очереди.
|
void |
clear()
Удаляет все элементы от этой очереди.
|
E |
element()
Получает, но не удаляет, глава этой очереди.
|
E |
remove()
Получает и удаляет главу этой очереди.
|
contains, containsAll, isEmpty, iterator, remove, removeAll, retainAll, size, toArray, toArray, toString
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
contains, containsAll, equals, hashCode, isEmpty, iterator, parallelStream, remove, removeAll, removeIf, retainAll, size, spliterator, stream, toArray, toArray
forEach
protected AbstractQueue()
public boolean add(E e)
Эта реализация возвращает true, если offer успешно выполняется, еще бросает IllegalStateException.
add
в интерфейсе Collection<E>
add
в интерфейсе Queue<E>
add
в class AbstractCollection<E>
e
- элемент, чтобы добавитьCollection.add(E)
)IllegalStateException
- если элемент не может быть добавлен в это время из-за ограничений емкостиClassCastException
- если class указанного элемента препятствует тому, чтобы это было добавлено к этой очереди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
в class AbstractCollection<E>
public boolean addAll(Collection<? extends E> c)
Эта реализация выполняет итерации по указанному набору, и добавляет каждый элемент, возвращенный iterator этой очереди, поочередно. Исключение на этапе выполнения встречалось, пытаясь добавить, что элемент (включая, в частности элемент null) могут привести к только некоторым из элементов, успешно добавленных, когда связанное исключение выдается.
addAll
в интерфейсе Collection<E>
addAll
в class AbstractCollection<E>
c
- набор, содержащий элементы, которые будут добавлены к этой очередиClassCastException
- если class элемента указанного набора препятствует тому, чтобы это было добавлено к этой очередиNullPointerException
- если указанный набор содержит нулевой элемент, и эта очередь не разрешает нулевые элементы, или если указанный набор является нулемIllegalArgumentException
- если некоторое свойство элемента указанного набора препятствует тому, чтобы это было добавлено к этой очереди, или если указанный набор является этой очередьюIllegalStateException
- если не все элементы могут быть добавлены в это время из-за ограничений вставкиadd(Object)
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2013, Oracle и/или его филиалы. Все права защищены.
Проект сборка-b92