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

Overrides:

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, этот метод не оказывает никакого влияния.

См. Спецификацию языка Java:

12.6 Финализация экземпляров классов

С тех пор:

9