Ссылка на класс<T>

get

public T get()

Прим. API:

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

Возвращает:

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

См. также:

• refersTo(T)

refersTo

public final boolean refersTo(T obj)

Параметры:

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

Возвращает:

true если obj является объектом-ссылочным значением этой ссылки

С тех пор:

16

clear

public void clear()

isEnqueued

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

Возвращает:

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

enqueue

public boolean enqueue()

Возвращает:

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

clone

protected Object clone() throws CloneNotSupportedException

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

clone в классе Object

Возвращает:

никогда не возвращает значение нормально

Бросает:

CloneNotSupportedException - всегда

С тех пор:

11

См. также:

• Cloneable

reachabilityFence

public static void reachabilityFence(Object ref)

Прим. API:

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

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

   int myIndex;
   Resource(...) {
     myIndex = ...
     externalResourceArray[myIndex] = ...;
     ...
   }
   protected void finalize() {
     externalResourceArray[myIndex] = null;
     ...
   }
   public void action() {
     try {
       // ...
       int i = myIndex;
       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. Продолжая приведенный выше пример, если вызов метода update можно было бы пропустить, даже если финализатор уже был выполнен (сбросив ячейку), то вы могли бы локализовать использование reachabilityFence:

 
 public void action2() {
   // ...
   Resource.update(getExternalResource());
 }
 private ExternalResource getExternalResource() {
   ExternalResource ext = externalResourceArray[myIndex];
   Reference.reachabilityFence(this);
   return ext;
 }

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

Параметры:

ref - ссылка. Если null, этот метод не оказывает никакого эффекта.

С тех пор:

9