Класс ReferenceQueue<T>

java.lang.Object

java.lang.ref.ReferenceQueue<T>

Type Parameters:: T - тип объекта ссылки

public class ReferenceQueue<T> extends Object

Очереди ссылок, в которые объекты зарегистрированных ссылок добавляются сборщиком мусора после обнаружения соответствующих изменений достижимости.

Since:: 1.2

Краткое описание конструкторов

Конструктор	Описание
`ReferenceQueue()`	Создаёт новую очередь объектов ссылок.

Краткое описание методов

Модификатор и тип	Метод	Описание
`Reference<? extends T>`	`poll()`	Проверяет очередь на наличие объекта ссылки.
`Reference<? extends T>`	`remove()`	Удаляет следующий объект ссылки из очереди, блокируясь до его появления.
`Reference<? extends T>`	`remove(long timeout)`	Удаляет следующий объект ссылки из очереди, блокируясь до его появления или истечения заданного таймаута.

Методы, объявленные в классе java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Подробное описание конструкторов

ReferenceQueue

public ReferenceQueue()

Создаёт новую очередь объектов ссылок.

Подробное описание методов

poll

public Reference<? extends T> poll()

Проверяет очередь на наличие объекта ссылки. Если объект доступен без задержки, он удаляется из очереди и возвращается. В противном случае этот метод сразу возвращает null.

Returns:: Объект ссылки, если он был сразу доступен, в противном случае null

remove

public Reference<? extends T> remove(long timeout) throws InterruptedException

Удаляет следующий объект ссылки из очереди, блокируясь до его появления или истечения заданного таймаута.

Этот метод не гарантирует реального времени: он планирует таймаут, как если бы вызывался метод Object.wait(long).

Parameters:: timeout - Если положительно, ожидать до timeout миллисекунд, пока ссылка не будет добавлена в очередь. Если ноль, ожидать неопределённо долго.
Returns:: Объект ссылки, если он был доступен в течение заданного таймаута, в противном случае null
Throws:: IllegalArgumentException - Если значение аргумента таймаута отрицательно; InterruptedException - Если ожидание таймаута прервано

remove

public Reference<? extends T> remove() throws InterruptedException

Удаляет следующий объект ссылки из очереди, блокируясь до его появления.

Returns:: Объект ссылки, блокируясь до его появления
Throws:: InterruptedException - Если ожидание прервано

© 1993, 2023, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/ref/ReferenceQueue.html