Класс LinkedBlockingDeque<E>

public LinkedBlockingDeque()

public LinkedBlockingDeque(int capacity)

Параметры:

capacity - ёмкость этой деки

Исключения:

IllegalArgumentException - если capacity меньше 1

public LinkedBlockingDeque(Collection<? extends E> c)

Параметры:

c - коллекция элементов для первоначального заполнения

Исключения:

NullPointerException - если указанная коллекция или любой из её элементов являются null

public void addFirst(E e)

Указано в:

addFirst в интерфейсе BlockingDeque<E>

Указано в:

addFirst в интерфейсе Deque<E>

Указано в:

addFirst в интерфейсе SequencedCollection<E>

Параметры:

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

Исключения:

IllegalStateException - если эта дека заполнена

NullPointerException - если указанный элемент равен null

public void addLast(E e)

Указано в:

addLast в интерфейсе BlockingDeque<E>

Указано в:

addLast в интерфейсе Deque<E>

Указано в:

addLast в интерфейсе SequencedCollection<E>

Параметры:

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

Исключения:

IllegalStateException - если эта дека заполнена

NullPointerException - если указанный элемент равен null

public boolean offerFirst(E e)

Указано в:

offerFirst в интерфейсе BlockingDeque<E>

Указано в:

offerFirst в интерфейсе Deque<E>

Параметры:

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

Возвращает:

true, если элемент был добавлен в эту деку, иначе false

Исключения:

NullPointerException - если указанный элемент равен null

public boolean offerLast(E e)

Указано в:

offerLast в интерфейсе BlockingDeque<E>

Указано в:

offerLast в интерфейсе Deque<E>

Параметры:

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

Возвращает:

true, если элемент был добавлен в эту деку, иначе false

Исключения:

NullPointerException - если указанный элемент равен null

public void putFirst(E e) throws InterruptedException

Указано в:

putFirst в интерфейсе BlockingDeque<E>

Параметры:

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

Исключения:

NullPointerException - если указанный элемент равен null

InterruptedException - если прервано во время ожидания

public void putLast(E e) throws InterruptedException

Указано в:

putLast в интерфейсе BlockingDeque<E>

Параметры:

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

Исключения:

NullPointerException - если указанный элемент равен null

InterruptedException - если прервано во время ожидания

public boolean offerFirst(E e, long timeout, TimeUnit unit) throws InterruptedException

Указано в:

offerFirst в интерфейсе BlockingDeque<E>

Параметры:

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

timeout - как долго ждать, прежде чем отказаться, в единицах unit

unit - TimeUnit, определяющий, как интерпретировать параметр timeout

Возвращает:

true, если успешно, или false, если указанное время ожидания истечёт до освобождения места

Исключения:

NullPointerException - если указанный элемент равен null

InterruptedException - если прервано во время ожидания

public boolean offerLast(E e, long timeout, TimeUnit unit) throws InterruptedException

Указано в:

offerLast в интерфейсе BlockingDeque<E>

Параметры:

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

timeout - как долго ждать, прежде чем отказаться, в единицах unit

unit - TimeUnit, определяющий, как интерпретировать параметр timeout

Возвращает:

true, если успешно, или false, если указанное время ожидания истечёт до освобождения места

Исключения:

NullPointerException - если указанный элемент равен null

InterruptedException - если прервано во время ожидания

public E removeFirst()

Указано в:

removeFirst в интерфейсе Deque<E>

Указано в:

removeFirst в интерфейсе SequencedCollection<E>

Возвращает:

начало этой деки

Исключения:

NoSuchElementException - если эта дека пуста

public E removeLast()

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

removeLast в интерфейсе Deque<E>

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

removeLast в интерфейсе SequencedCollection<E>

Возвращает:

хвост данного дека

Выбрасывает:

NoSuchElementException - если этот дек пуст

public E pollFirst()

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

pollFirst в интерфейсе Deque<E>

Возвращает:

голову этого дека или null, если дек пуст

public E pollLast()

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

pollLast в интерфейсе Deque<E>

Возвращает:

хвост этого дека или null, если дек пуст

public E takeFirst() throws InterruptedException

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

takeFirst в интерфейсе BlockingDeque<E>

Возвращает:

голову этого дека

Выбрасывает:

InterruptedException - если прервано ожидание

public E takeLast() throws InterruptedException

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

takeLast в интерфейсе BlockingDeque<E>

Возвращает:

хвост этого дека

Выбрасывает:

InterruptedException - если прервано ожидание

public E pollFirst(long timeout, TimeUnit unit) throws InterruptedException

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

pollFirst в интерфейсе BlockingDeque<E>

Параметры:

timeout - время ожидания, прежде чем прекратить ожидание, в единицах unit

unit - TimeUnit, определяющий, как интерпретировать параметр timeout

Возвращает:

голову этого дека или null, если указанное время ожидания истекает, прежде чем элемент становится доступным

Выбрасывает:

InterruptedException - если прервано ожидание

public E pollLast(long timeout, TimeUnit unit) throws InterruptedException

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

pollLast в интерфейсе BlockingDeque<E>

Параметры:

timeout - время ожидания, прежде чем прекратить ожидание, в единицах unit

unit - TimeUnit, определяющий, как интерпретировать параметр timeout

Возвращает:

хвост этого дека или null, если указанное время ожидания истекает, прежде чем элемент становится доступным

Выбрасывает:

InterruptedException - если прервано ожидание

public E getFirst()

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

getFirst в интерфейсе Deque<E>

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

getFirst в интерфейсе SequencedCollection<E>

Возвращает:

голову этого дека

Выбрасывает:

NoSuchElementException - если этот дек пуст

public E getLast()

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

getLast в интерфейсе Deque<E>

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

getLast в интерфейсе SequencedCollection<E>

Возвращает:

хвост этого дека

Выбрасывает:

NoSuchElementException - если этот дек пуст

public E peekFirst()

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

peekFirst в интерфейсе Deque<E>

Возвращает:

голову этого дека или null, если дек пуст

public E peekLast()

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

peekLast в интерфейсе Deque<E>

Возвращает:

хвост этого дека или null, если дек пуст

public boolean removeFirstOccurrence(Object o)

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

removeFirstOccurrence в интерфейсе BlockingDeque<E>

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

removeFirstOccurrence в интерфейсе Deque<E>

Параметры:

o - элемент, который нужно удалить из этого дека, если он присутствует

Возвращает:

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

public boolean removeLastOccurrence(Object o)

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

removeLastOccurrence в интерфейсе BlockingDeque<E>

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

removeLastOccurrence в интерфейсе Deque<E>

Параметры:

o - элемент, который нужно удалить из этого дека, если он присутствует

Возвращает:

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

public boolean add(E e)

Specified by:

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

Specified by:

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

Specified by:

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

Specified by:

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

Specified by:

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

Overrides:

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

Parameters:

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

Returns:

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

Throws:

IllegalStateException - если данная очередь-дек заполнена

NullPointerException - если указанный элемент имеет значение null

public boolean offer(E e)

Specified by:

offer в интерфейсе BlockingDeque<E>

Specified by:

offer в интерфейсе BlockingQueue<E>

Specified by:

offer в интерфейсе Deque<E>

Specified by:

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

Parameters:

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

Returns:

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

Throws:

NullPointerException - если указанный элемент имеет значение null

public void put(E e) throws InterruptedException

Specified by:

put в интерфейсе BlockingDeque<E>

Specified by:

put в интерфейсе BlockingQueue<E>

Parameters:

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

Throws:

NullPointerException - если указанный элемент имеет значение null

InterruptedException - если прервано ожидание

public boolean offer(E e, long timeout, TimeUnit unit) throws InterruptedException

Specified by:

offer в интерфейсе BlockingDeque<E>

Specified by:

offer в интерфейсе BlockingQueue<E>

Parameters:

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

timeout - время ожидания, прежде чем отказаться, в единицах unit

unit - TimeUnit определяющий, как интерпретировать параметр timeout

Returns:

true, если элемент был добавлен в этот дек, иначе false

Throws:

NullPointerException - если указанный элемент имеет значение null

InterruptedException - если прервано ожидание

public E remove()

Specified by:

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

Specified by:

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

Specified by:

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

Overrides:

remove в классе AbstractQueue<E>

Returns:

голова очереди, представленной данным деком

Throws:

NoSuchElementException - если данный дек пуст

public E poll()

Specified by:

poll в интерфейсе BlockingDeque<E>

Specified by:

poll в интерфейсе Deque<E>

Specified by:

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

Returns:

голова данного дека, или null, если этот дек пуст

public E take() throws InterruptedException

Specified by:

take в интерфейсе BlockingDeque<E>

Specified by:

take в интерфейсе BlockingQueue<E>

Returns:

голова данного дека

Throws:

InterruptedException - если прервано ожидание

public E poll(long timeout, TimeUnit unit) throws InterruptedException

Specified by:

poll в интерфейсе BlockingDeque<E>

Specified by:

poll в интерфейсе BlockingQueue<E>

Parameters:

timeout - время ожидания, прежде чем отказаться, в единицах unit

unit - TimeUnit определяющий, как интерпретировать параметр timeout

Returns:

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

Throws:

InterruptedException - если прервано ожидание

public E element()

Specified by:

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

Specified by:

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

Specified by:

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

Overrides:

element в классе AbstractQueue<E>

Returns:

голова очереди, представленной данным деком

Throws:

NoSuchElementException - если этот дек пуст

public E peek()

Specified by:

peek в интерфейсе BlockingDeque<E>

Specified by:

peek в интерфейсе Deque<E>

Specified by:

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

Returns:

голова данного дека, или null, если этот дек пуст

public int remainingCapacity()

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

remainingCapacity в интерфейсе BlockingQueue<E>

Возвращает:

остающуюся ёмкость

public int drainTo(Collection<? super E> c)

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

drainTo в интерфейсе BlockingQueue<E>

Параметры:

c - коллекция для переноса элементов

Возвращает:

количество переданных элементов

Исключения:

UnsupportedOperationException - если добавление элементов не поддерживается заданной коллекцией

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

NullPointerException - если заданная коллекция имеет значение null

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

public int drainTo(Collection<? super E> c, int maxElements)

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

drainTo в интерфейсе BlockingQueue<E>

Параметры:

c - коллекция для переноса элементов

maxElements - максимальное количество элементов для переноса

Возвращает:

количество переданных элементов

Исключения:

UnsupportedOperationException - если добавление элементов не поддерживается заданной коллекцией

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

NullPointerException - если заданная коллекция имеет значение null

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

public void push(E e)

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

push в интерфейсе BlockingDeque<E>

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

push в интерфейсе Deque<E>

Параметры:

e - элемент для вставки

Исключения:

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

NullPointerException - если указанный элемент имеет значение null

public E pop()

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

pop в интерфейсе Deque<E>

Возвращает:

элемент в начале этой очереди с двойным концом (который является вершиной стека, представленного этой очередью с двойным концом)

Исключения:

NoSuchElementException - если эта очередь с двойным концом пуста

public boolean remove(Object o)

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

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

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

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

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

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

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

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

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

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

Параметры:

o - элемент, который нужно удалить из этой очереди с двойным концом, если он есть

Возвращает:

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

public int size()

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

size в интерфейсе BlockingDeque<E>

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

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

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

size в интерфейсе Deque<E>

Возвращает:

количество элементов в этой очереди с двойным концом

public boolean contains(Object o)

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

contains в интерфейсе BlockingDeque<E>

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

contains в интерфейсе BlockingQueue<E>

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

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

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

contains в интерфейсе Deque<E>

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

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

Параметры:

o - объект, который нужно проверить на наличие в этой очереди с двойным концом

Возвращает:

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

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

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

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

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

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

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

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

Параметры:

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

Возвращает:

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

Исключения:

NullPointerException - если заданная коллекция или любой из ее элементов имеют значение null

IllegalArgumentException - если коллекция — это эта очередь с двойным концом

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

См. также:

• add(Object)

public Object[] toArray()

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

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

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

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

Возвращает:

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

public <T> T[] toArray(T[] a)

 String[] y = x.toArray(new String[0]);

Specified by:

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

Overrides:

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

Type Parameters:

T - тип компонента массива, который должен содержать коллекцию

Parameters:

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

Returns:

массив, содержащий все элементы в этой очереди

Throws:

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

NullPointerException - если указанный массив равен null

public void clear()

Specified by:

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

Overrides:

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

public Iterator<E> iterator()

Specified by:

iterator в интерфейсе BlockingDeque<E>

Specified by:

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

Specified by:

iterator в интерфейсе Deque<E>

Specified by:

iterator в интерфейсе Iterable<E>

Specified by:

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

Returns:

итератор по элементам в этой очереди в правильной последовательности

public Iterator<E> descendingIterator()

Specified by:

descendingIterator в интерфейсе Deque<E>

Returns:

итератор по элементам в этой очереди в обратном порядке

public Spliterator<E> spliterator()

Specified by:

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

Specified by:

spliterator в интерфейсе Iterable<E>

Implementation Note:

Разделитель Spliterator реализует trySplit, чтобы разрешить ограниченное параллельное выполнение.

Returns:

разделитель Spliterator по элементам в этой очереди

Since:

1.8

public void forEach(Consumer<? super E> action)

Specified by:

forEach в интерфейсе Iterable<E>

Parameters:

action - действие, которое должно быть выполнено для каждого элемента

Throws:

NullPointerException - если заданное действие равно null

public boolean removeIf(Predicate<? super E> filter)

Specified by:

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

Parameters:

filter - предикат, который возвращает значение true для удаляемых элементов

Returns:

true, если были удалены какие-либо элементы

Throws:

NullPointerException - если указанный фильтр равен null

public boolean removeAll(Collection<?> c)

Specified by:

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

Overrides:

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

Parameters:

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

Returns:

true, если эта коллекция изменилась в результате вызова

Throws:

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

See Also:

• AbstractCollection.remove(Object)
• AbstractCollection.contains(Object)

public boolean retainAll(Collection<?> c)

Specified by:

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

Overrides:

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

Parameters:

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

Returns:

true, если эта коллекция изменилась в результате вызова

Throws:

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

See Also:

• AbstractCollection.remove(Object)
• AbstractCollection.contains(Object)