Класс WeakReference<T>

java.lang.Object

java.lang.ref.Reference<T>

java.lang.ref.WeakReference<T>

Параметры типа:: T - тип ссылки

public non-sealed class WeakReference<T> extends Reference<T>

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

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

С:: 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)

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

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

WeakReference

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

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

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

© 1993, 2025, 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://download.java.net/java/early_access/jdk24/docs/api/java.base/java/lang/ref/WeakReference.html