Класс PriorityBlockingQueue<E>

PriorityBlockingQueue

public PriorityBlockingQueue()

PriorityBlockingQueue

public PriorityBlockingQueue(int initialCapacity)

Параметры:

initialCapacity - исходная ёмкость для этой очереди с приоритетами

Исключения:

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

PriorityBlockingQueue

public PriorityBlockingQueue(int initialCapacity, Comparator<? super E> comparator)

Параметры:

initialCapacity - исходная ёмкость для этой очереди с приоритетами

comparator - компаратор, который будет использоваться для упорядочивания этой очереди с приоритетами. Если null, будет использоваться естественный порядок элементов.

Исключения:

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

PriorityBlockingQueue

public PriorityBlockingQueue(Collection<? extends E> c)

Параметры:

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

Исключения:

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

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

add

public boolean add(E e)

Унаследовано от:

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

Унаследовано от:

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

Унаследовано от:

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

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

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

Параметры:

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

Возвращает:

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

Исключения:

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

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

offer

public boolean offer(E e)

Унаследовано от:

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

Унаследовано от:

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

Параметры:

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

Возвращает:

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

Исключения:

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

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

put

public void put(E e)

Унаследовано от:

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

Параметры:

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

Исключения:

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

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

offer

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

Унаследовано от:

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

Параметры:

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

timeout - Этот параметр игнорируется, так как метод никогда не блокируется

unit - Этот параметр игнорируется, так как метод никогда не блокируется

Возвращает:

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

Исключения:

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

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

poll

public E poll()

Унаследовано от:

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

Возвращает:

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

take

public E take() throws InterruptedException

Унаследовано от:

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

Возвращает:

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

Исключения:

InterruptedException - если произошла ошибка прерывания во время ожидания

poll

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

Унаследовано от:

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

Параметры:

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

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

Возвращает:

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

Исключения:

InterruptedException - если произошла ошибка прерывания во время ожидания

peek

public E peek()

Унаследовано от:

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

Возвращает:

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

comparator

public Comparator<? super E> comparator()

Возвращает:

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

size

public int size()

Унаследовано от:

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

Возвращает:

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

remainingCapacity

public int remainingCapacity()

Унаследовано от:

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

Возвращает:

Integer.MAX_VALUE всегда

удалить

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 если эта очередь содержит указанный элемент

drainTo

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

Указано в:

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

Параметры:

c - набор, в который нужно перенести элементы

Возвращает:

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

Исключение:

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

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

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

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

drainTo

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

Указано в:

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

Параметры:

c - набор, в который нужно перенести элементы

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

Возвращает:

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

Исключение:

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

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

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

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

очистить

public void clear()

Указано в:

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

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

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

toArray

public Object[] toArray()

Указано в:

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

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

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

Возвращает:

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

toArray

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 Iterator<E> iterator()

Указано в:

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

Указано в:

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

Указано в:

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

Возвращает:

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

spliterator

public Spliterator<E> spliterator()

Указано в:

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

Указано в:

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

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

Spliterator дополнительно сообщает Spliterator.SUBSIZED.

Возвращает:

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

С:

1.8

removeIf

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

Указано в:

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

Параметры:

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

Возвращает:

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

Исключение:

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

removeAll

public boolean removeAll(Collection<?> c)

Указано в:

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

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

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

Параметры:

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

Возвращает:

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

Исключения:

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

См. также:

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

retainAll

public boolean retainAll(Collection<?> c)

Указано в:

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

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

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

Параметры:

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

Возвращает:

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

Исключения:

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

См. также:

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

forEach

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

Указано в:

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

Параметры:

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

Исключения:

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