Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / Java

Životni ciklus slabih, mekih i fantomskih referenci u Javi

Saznaj kad referenca vraća ciljni objekt, što ulazi u red i kako `reachabilityFence` održava objekt jako dohvatljivim.

Verzija: Java SE 21

Sintaksa

Java SE 21 · java.lang.ref (module java.base)
new WeakReference<T>(referent)
new WeakReference<T>(referent, queue)
new SoftReference<T>(referent)
new SoftReference<T>(referent, queue)
new PhantomReference<T>(referent, queue)
new ReferenceQueue<T>()

// Registered constructors accept ReferenceQueue<? super T>.
T value = reference.get();
reference.clear();
boolean added = reference.enqueue();
Reference.reachabilityFence(referent);

// For a queue of type ReferenceQueue<T>:
Reference<? extends T> ready = queue.poll();
Reference<? extends T> next = queue.remove(); // throws InterruptedException
Reference<? extends T> timed = queue.remove(timeoutMillis); // long; throws InterruptedException

U paketu java.lang.ref (modul java.base) referenca i njezin ciljni objekt dva su odvojena objekta. Kad sakupljač smeća (GC) utvrdi da je objekt slabo dohvatljiv, odnosno da nije ni jako ni meko dohvatljiv, ali da se do njega može doći preko slabe reference, briše njegove WeakReference. Ovisno o potrebi za memorijom, GC može po vlastitoj procjeni obrisati SoftReference na meko dohvatljive objekte. Virtualni stroj jamči da će sve takve meke reference biti obrisane prije nego što baci OutOfMemoryError, ali inače ne jamči vrijeme ni redoslijed. PhantomReference služi za obavijesti potrebne za čišćenje: GC je briše kad utvrdi fantomsku dohvatljivost, a njezin get() uvijek vraća null.

Konstruktori slabih i mekih referenci prihvaćaju samo ciljni objekt ili ciljni objekt i ReferenceQueue<? super T>. Konstruktor fantomske reference uvijek traži argument za red. Ako je taj argument null, referenca se ne registrira. Za slabu ili meku referencu get() vraća ciljni objekt ili null ako ga nema, primjerice nakon brisanja. Dohvati rezultat jednom, provjeri je li različit od null i upotrijebi istu lokalnu varijablu. clear() prekida vezu, ali sam ne stavlja referencu u red i ne oslobađa ciljni objekt. enqueue() briše referencu i pokušava je izričito staviti u red u kojem je registrirana; ako uspije, vraća true.

Statička metoda Reference.reachabilityFence(obj) održava obj jako dohvatljivim do kraja poziva, čak i ako ga kôd više ne upotrebljava izravno. Poziv stavi u blok finally nakon operacije za koju objekt mora ostati živ, kako bi se izvršio i u slučaju iznimke. Proslijedi sam objekt, a ne njegovu slabu, meku ili fantomsku referencu. Metoda ne pokreće ni GC ni finalizaciju; uz null nema učinka.

Iz reda ReferenceQueue<T> uklanja se Reference<? extends T>, a ne njegov ciljni objekt. poll() uklanja i vraća dostupnu referencu ili odmah vraća null. remove() čeka bez vremenskog ograničenja. Uz pozitivno ograničenje u milisekundama, remove(long timeout) nakon njegova isteka vraća null, bez jamstva rada u stvarnom vremenu. 0 znači čekanje bez ograničenja, a negativna vrijednost uzrokuje IllegalArgumentException. Obje preopterećene inačice remove bacaju InterruptedException ako se čekanje prekine.

GC stavlja registrirane reference u red pri brisanju ili poslije; trenutak nije predvidljiv. Prazan rezultat poll() ne znači da je ciljni objekt još živ. Zadrži jaku referencu na svaki registrirani objekt reference dok ti treba obavijest: sama registracija ga ne održava živim. Ne oslanjaj se na obavijesti GC-a za pravodobno zatvaranje resursa.

Primjeri

import java.lang.ref.PhantomReference;
import java.lang.ref.Reference;
import java.lang.ref.ReferenceQueue;
import java.lang.ref.SoftReference;
import java.lang.ref.WeakReference;

public class ReferenceLifecycle {
    public static void main(String[] args) throws InterruptedException {
        Object target = new Object();
        ReferenceQueue<Object> queue = new ReferenceQueue<>();
        WeakReference<Object> weak = new WeakReference<>(target, queue);
        SoftReference<Object> soft = new SoftReference<>(target);
        PhantomReference<Object> phantom = new PhantomReference<>(target, queue);

        try {
            System.out.println("weak.get() == target: " + (weak.get() == target));
            System.out.println("soft.get() == target: " + (soft.get() == target));
            weak.clear();
            soft.clear();
            System.out.println("weak.get() == null: " + (weak.get() == null));
            System.out.println("soft.get() == null: " + (soft.get() == null));
            System.out.println("poll() after clear: " + queue.poll());

            if (!weak.enqueue()) {
                throw new IllegalStateException("Expected weak reference to be enqueued");
            }
            System.out.println("remove(1000) == weak: " + (queue.remove(1000) == weak));

            System.out.println("phantom.get() == null: " + (phantom.get() == null));
            if (!phantom.enqueue()) {
                throw new IllegalStateException("Expected phantom reference to be enqueued");
            }
            System.out.println("remove() == phantom: " + (queue.remove() == phantom));
        } finally {
            Reference.reachabilityFence(target);
        }
    }
}

Rezultat

weak.get() == target: true
soft.get() == target: true
weak.get() == null: true
soft.get() == null: true
poll() after clear: null
remove(1000) == weak: true
phantom.get() == null: true
remove() == phantom: true

Barijera održava `target` jako dohvatljivim, a `enqueue()` prije svakog `remove` izričito dodaje stavku. Primjer razlikuje brisanje i stavljanje u red, ali ne pokazuje kada GC djeluje ni istek vremenskog ograničenja.

Povezane lekcije

  • Java · Lekcija 45 · Napredno · Verzija: 2

Izvori