Класс LinkedTransferQueue<E>

public LinkedTransferQueue()

public LinkedTransferQueue(Collection<? extends E> c)

Параметры:

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

Вызывает исключение:

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

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 Spliterator<E> spliterator()

Указано в:

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

Указано в:

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

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

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

Возвращает:

Spliterator для элементов этой очереди

Начиная с версии:

1.8

public void put(E e)

Указано в:

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

Параметры:

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

Вызывает исключение:

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

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

Указано в:

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

Параметры:

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

timeout — время ожидания до отказа от попытки, в единицах unit

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

Возвращает:

true (как указано в BlockingQueue.offer)

Вызывает исключение:

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

public boolean offer(E e)

Указано в:

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

Указано в:

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

Параметры:

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

Возвращает:

true (как указано в Queue.offer(E))

Вызывает исключение:

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

public boolean add(E e)

Указано в:

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

Указано в:

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

Указано в:

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

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

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

Параметры:

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

Возвращает:

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

Вызывает исключение:

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

public boolean tryTransfer(E e)

Указано в:

tryTransfer в интерфейсе TransferQueue<E>

Параметры:

e — передаваемый элемент

Возвращает:

true, если элемент был передан; иначе — false

Вызывает исключение:

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

public void transfer(E e) throws InterruptedException

Указано в:

transfer в интерфейсе TransferQueue<E>

Параметры:

e — передаваемый элемент

Вызывает исключение:

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

InterruptedException — если ожидание было прервано; в этом случае элемент не остается в очереди

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

Указано в:

tryTransfer в интерфейсе TransferQueue<E>

Параметры:

e — передаваемый элемент

timeout — время ожидания до отказа от попытки, в единицах unit

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

Возвращает:

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

Вызывает исключение:

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

InterruptedException — если ожидание было прервано; в этом случае элемент не остается в очереди

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

Указано в:

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

Параметры:

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

Возвращает:

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

Вызывает исключение:

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

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

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

Указано в:

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

Параметры:

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

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

Возвращает:

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

Вызывает исключение:

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

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

public Iterator<E> iterator()

Указано в:

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

Указано в:

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

Указано в:

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

Возвращает:

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

public E peek()

Указано в:

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

Возвращает:

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

public boolean isEmpty()

Указано в:

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

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

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

Возвращает:

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

public boolean hasWaitingConsumer()

Указано в:

hasWaitingConsumer в интерфейсе TransferQueue<E>

Возвращает:

true, если есть хотя бы один ожидающий потребитель

public int size()

Указано в:

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

Возвращает:

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

public int getWaitingConsumerCount()

Указано в:

getWaitingConsumerCount в интерфейсе TransferQueue<E>

Возвращает:

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

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 int remainingCapacity()

Указано в:

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

Возвращает:

Integer.MAX_VALUE (как указано в BlockingQueue.remainingCapacity())

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)

public void clear()

Указано в:

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

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

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

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

Указано в:

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

Параметры:

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

Вызывает исключение:

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