Class Reference<T>

public T get()

Примечание API:

Этот метод возвращает сильную ссылку на референт. Из-за этого сборщик мусора может считать его сильно достижимым до следующего цикла сборки мусора. Метод refersTo можно использовать, чтобы избежать такого усиления ссылки при проверке, является ли некоторый объект референтом объекта-ссылки; то есть используйте ref.refersTo(obj) вместо ref.get() == obj.

Возвращает:

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

См. также:

• refersTo(T)

public final boolean refersTo(T obj)

Параметры:

obj - объект для сравнения с референтом этого объекта-ссылки

Возвращает:

true, если obj является референтом этого объекта-ссылки

Начиная с версии:

16

public void clear()

Примечание API:

Возможна гонка со сборщиком мусора. К моменту вызова этого метода сборщик мусора может уже выполнять (или завершить) очистку и/или постановку этой ссылки в очередь. Чтобы избежать этой гонки, обеспечьте сильную достижимость референта до завершения вызова clear(), при необходимости используя reachabilityFence(Object).

@Deprecated(since="16") public boolean isEnqueued()

Возвращает:

true тогда и только тогда, когда этот объект-ссылка находится в связанной с ним очереди (если таковая имеется).

public boolean enqueue()

Примечание API:

Использование этого метода позволяет методам ReferenceQueue.poll() и ReferenceQueue.remove(long) связанной очереди возвращать эту ссылку, даже если референт всё ещё может быть сильно достижим.

Возвращает:

true, если этот объект-ссылка был успешно поставлен в очередь; false, если он уже был поставлен в очередь или при создании не был зарегистрирован в очереди

protected Object clone() throws CloneNotSupportedException

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

clone в классе Object

Возвращает:

нормально не возвращает управление

Выбрасывает:

CloneNotSupportedException - всегда

См. также:

• Cloneable

public static void reachabilityFence(Object ref)

Примечание API:

Обработка ссылок или финализация могут произойти после того, как объект станет недостижимым. Объект может стать недостижимым, когда виртуальная машина обнаружит, что он больше не нужен (за исключением выполнения финализатора). При оптимизации виртуальная машина может переставлять операции методов объекта так, что объект перестаёт быть нужным раньше, чем можно было бы ожидать, — в том числе во время выполнения метода этого объекта. Например, виртуальная машина может перенести загрузку значений из полей объекта на более ранний момент. Тогда сам объект больше не нужен и становится недостижимым, а метод может продолжить выполнение, используя полученные значения. Это может привести к неожиданным и нежелательным последствиям при использовании Cleaner или финализатора для очистки: возникает гонка между потоком программы, выполняющим метод, и потоком очистки, выполняющим Cleaner или финализатор. Поток очистки может освободить ресурс, после чего поток программы (всё ещё выполняющий метод) попытается обратиться к уже освобождённому ресурсу. Использование reachabilityFence может предотвратить эту гонку, гарантируя, что объект останется сильно достижимым.

Ниже приведён пример, в котором учёт состояния класса ведётся с помощью индексов массива. Здесь метод action использует reachabilityFence, чтобы гарантировать, что объект Resource не будет освобождён до завершения учёта состояния связанного ExternalResource; в частности, чтобы ячейка массива, содержащая ExternalResource, не была обнулена в методе Object.finalize(), который иначе может выполняться параллельно.

class Resource {
  private static ExternalResource[] externalResourceArray = ...

  int myIndex;
  Resource(...) {
    this.myIndex = ...
    externalResourceArray[myIndex] = ...;
    ...
  }
  protected void finalize() {
    externalResourceArray[this.myIndex] = null;
    ...
  }
  public void action() {
    try {
      // ...
      int i = this.myIndex; // last use of 'this' Resource in action()
      Resource.update(externalResourceArray[i]);
    } finally {
      Reference.reachabilityFence(this);
    }
  }
  private static void update(ExternalResource ext) {
    ext.status = ...;
  }
}

Вызов reachabilityFence размещён после вызова update, чтобы ячейка массива не была обнулена методом Object.finalize() до обновления, даже если вызов action был последним использованием этого объекта. Такое возможно, например, если в пользовательской программе используется конструкция new Resource().action();, которая не сохраняет других ссылок на этот Resource. Вызов reachabilityFence помещён в блок finally, чтобы гарантировать его выполнение на всех путях метода. Для более сложного метода могут потребоваться дополнительные меры, чтобы гарантировать достижение reachabilityFence на всех путях выполнения кода.

Метод reachabilityFence не требуется в конструкциях, которые сами обеспечивают достижимость. Например, поскольку заблокированные объекты, как правило, нельзя освободить, было бы достаточно, чтобы все обращения к объекту во всех методах класса Resource (включая finalize) выполнялись внутри блоков synchronized (this). (Кроме того, такие блоки не должны содержать бесконечных циклов или сами быть недостижимыми; это исключения из оговорки «как правило».) Однако метод reachabilityFence остаётся лучшим вариантом в случаях, когда синхронизация менее эффективна, нежелательна или невозможна, например из-за риска взаимной блокировки.

Параметры:

ref - ссылка на объект, который нужно сохранить сильно достижимым. Если null, этот метод не выполняет никаких действий.

Начиная с версии:

9