java.lang.ref

Класс SoftReference <T>

java.lang. Объект

java.lang.ref. Ссылка<T>

java.lang.ref. SoftReference <T>

public class SoftReference<T>
extends Reference<T>

Мягкие ссылочные объекты, которые очищаются на усмотрение сборщика "мусора" в ответ на требование памяти. Мягкие ссылки чаще всего используются, чтобы реализовать чувствительные к памяти кэши.

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

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

Прямые экземпляры этого класса могут использоваться, чтобы реализовать простые кэши; этот класс или полученные подклассы могут также использоваться в больших структурах данных, чтобы реализовать более сложные кэши. Пока референт мягкой ссылки строго достижим, то есть, находится фактически в использовании, мягкая ссылка не будет очищена. Таким образом сложный кэш может, например, предотвратить свои последний раз используемые записи от того, чтобы быть отброшенным, сохраняя сильные референты к тем записям, оставляя остающиеся записи, которые будут отброшены на усмотрение сборщика "мусора".

С тех пор:

1.2

Сводка конструктора

Конструкторы

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

Сводка метода

Методы

Модификатор и Тип	Метод и Описание
T	get() Возвраты референт этого ссылочного объекта.

Методы java.lang.ref унаследованный от класса. Ссылка

clear, enqueue, isEnqueued

Методы java.lang унаследованный от класса. Объект

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

Деталь конструктора

SoftReference

public SoftReference(T referent)

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

Параметры:

referent - возразите, что новая мягкая ссылка обратится к

SoftReference

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

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

Параметры:

referent - возразите, что новая мягкая ссылка обратится к

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

Деталь метода

добраться

public T get()

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

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

get в классе Reference<T>

Возвраты:

Объект, к которому эта ссылка обращается, или null если этот ссылочный объект был очищен