Класс WeakReference<T>

java.lang.Object

java.lang.ref.Reference<T>

java.lang.ref.WeakReference<T>

public class WeakReference<T> extends Reference<T>

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

Предположим, что сборщик мусора в какой-то момент времени определяет, что объект является слабо достижимым. В это время он атомарно очистит все слабые ссылки на этот объект и все слабые ссылки на все другие слабо достижимые объекты, от которых этот объект достижим через цепочку сильных и мягких ссылок. В это же время он объявит все ранее слабо достижимые объекты окончательно завершаемыми. Одновременно или в некоторый более поздний момент он поставит в очередь те недавно очищенные слабые ссылки, которые зарегистрированы в очередях ссылок.

Since:: 1.2

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

Конструктор	Описание
`WeakReference(T referent)`	Создает новую слабую ссылку, которая ссылается на данный объект.
`WeakReference(T referent, ReferenceQueue<? super T> q)`	Создает новую слабую ссылку, которая ссылается на данный объект и зарегистрирована в данной очереди.

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

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

clear, clone, enqueue, get, isEnqueued, reachabilityFence, refersTo

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

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

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

WeakReference

public WeakReference(T referent)

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

Parameters:: referent - объект, на который будет ссылаться новая слабая ссылка

WeakReference

public WeakReference(T referent, ReferenceQueue<? super T> q)

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

Parameters:: referent - объект, на который будет ссылаться новая слабая ссылка; q - очередь, с которой должна быть зарегистрирована ссылка, или null, если регистрация не требуется

© 1993, 2021, 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/17/docs/api/java.base/java/lang/ref/WeakReference.html