Класс 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)

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

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

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

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

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

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

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

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

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

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

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

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

Параметры:

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

Возвращает:

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

Исключения:

IllegalStateException — если эта двусторонняя очередь заполнена

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

public boolean offer(E e)

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

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

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

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

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

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

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

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

Параметры:

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

Возвращает:

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

Исключения:

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

public void put(E e) throws InterruptedException

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

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

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

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

Параметры:

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

Исключения:

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

InterruptedException — если ожидание было прервано

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

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

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

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

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

Параметры:

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

timeout — время ожидания до прекращения ожидания в единицах unit

unit — TimeUnit, определяющий интерпретацию параметра timeout

Возвращает:

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

Исключения:

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

InterruptedException — если ожидание было прервано

public E remove()

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

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

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

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

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

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

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

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

Возвращает:

голову очереди, представленной этой двусторонней очередью

Исключения:

NoSuchElementException — если эта двусторонняя очередь пуста

public E poll()

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

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

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

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

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

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

Возвращает:

голову этой двусторонней очереди или null, если двусторонняя очередь пуста

public E take() throws InterruptedException

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

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

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

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

Возвращает:

голову этой двусторонней очереди

Исключения:

InterruptedException — если ожидание было прервано

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

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

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

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

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

Параметры:

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

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

Возвращает:

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

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

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

public E element()

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

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

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

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

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

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

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

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

Возвращает:

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

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

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

public E peek()

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

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

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

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

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

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

Возвращает:

начало этой двусторонней очереди или 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]);

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

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

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

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

Параметры типа:

T - тип компонентов массива, в который будет помещена коллекция

Параметры:

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

Возвращает:

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

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

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

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

public void clear()

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

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

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

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

public Iterator<E> iterator()

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

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

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

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

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

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

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

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

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

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

Возвращает:

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

public Iterator<E> descendingIterator()

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

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

Возвращает:

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

public Spliterator<E> spliterator()

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

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

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

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

Примечание по реализации:

Spliterator реализует trySplit, чтобы обеспечить ограниченный параллелизм.

Возвращает:

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

С момента:

1.8

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

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

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

Параметры:

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

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

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

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

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

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

Параметры:

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

Возвращает:

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

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

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

public boolean removeAll(Collection<?> c)

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

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

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

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

Параметры:

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

Возвращает:

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

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

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

См. также:

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

public boolean retainAll(Collection<?> c)

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

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

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

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

Параметры:

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

Возвращает:

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

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

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

См. также:

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