Ссылка на класс<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