Класс LinkedBlockingQueue<E>

public LinkedBlockingQueue()

public LinkedBlockingQueue(int capacity)

Параметры:

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

Исключения:

IllegalArgumentException - если capacity не больше нуля

public LinkedBlockingQueue(Collection<? extends E> c)

Параметры:

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

Исключения:

NullPointerException - если заданный набор или любой из его элементов равны null

public int size()

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

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

Возвращает:

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

public int remainingCapacity()

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

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

Возвращает:

оставшаяся ёмкость

public void put(E e) throws InterruptedException

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

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

Параметры:

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

Исключения:

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

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

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

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

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

Параметры:

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

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

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

Возвращает:

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

Исключения:

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

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

public boolean offer(E e)

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

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

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

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

Параметры:

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

Возвращает:

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

Исключения:

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

public E take() throws InterruptedException

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

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

Возвращает:

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

Исключения:

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

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

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

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

Параметры:

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

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

Возвращает:

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

Исключения:

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

public E poll()

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

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

Возвращает:

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

public E peek()

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

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

Возвращает:

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

public boolean remove(Object o)

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

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

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

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

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

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

Параметры:

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

Возвращает:

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

public boolean contains(Object o)

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

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

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

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

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

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

Параметры:

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

Возвращает:

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

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 int drainTo(Collection<? super E> c)

Specified by:

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

Parameters:

c — коллекция, в которую нужно перенести элементы

Returns:

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

Throws:

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

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

NullPointerException — если заданная коллекция равна null

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

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

Specified by:

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

Parameters:

c — коллекция, в которую нужно перенести элементы

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

Returns:

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

Throws:

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

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

NullPointerException — если заданная коллекция равна null

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

public Iterator<E> iterator()

Specified by:

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

Specified by:

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

Specified by:

iterator в классе AbstractCollection<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)

Указано в:

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

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

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

Параметры:

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

Возвращает:

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

Исключения:

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

См. также:

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