Класс 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