KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Java

SoftReference — een soft reference

SoftReference<T> uit java.lang.ref houdt een soft reference naar een object vast. Zodra het object niet meer sterk bereikbaar is, kan de garbagecollector de referentie wissen als er geheugen nodig is. Bij het uitlezen met get() moet je rekening houden met null.

Versie: Java SE 21; repository runtime, production runtime not attested

Syntax

new SoftReference<T>(referent)
new SoftReference<T>(referent, queue)
T value = reference.get();
reference.clear();

SoftReference<T> verpakt een referentie naar een object van type T. Een object is soft bereikbaar als het niet sterk bereikbaar is, maar wel via een soft reference kan worden bereikt. Voor sterke bereikbaarheid hoef je geen referentieobjecten te doorlopen; zwakke bereikbaarheid sluit zowel sterke als soft bereikbaarheid uit.

De garbagecollector kan soft references wissen bij geheugendruk. Het tijdstip en de volgorde van wissen zijn niet gegarandeerd, maar alle soft references naar soft bereikbare objecten worden gewist voordat een OutOfMemoryError wordt gegooid. Dit mechanisme ondersteunt geheugengevoelige caches, maar garandeert geen bewaartijd en beschermt niet tegen geheugentekort.

get() geeft een sterke referentie naar het object terug of null. Sla het resultaat eenmaal op in een lokale variabele en controleer het voordat je het gebruikt. clear() wist de referentie, maar verwijdert het object of andere referenties niet en plaatst de wrapper ook niet in een wachtrij. Met de constructor SoftReference(T referent, ReferenceQueue<? super T> q) kun je een wachtrij registreren; houd de wrapper zelf bereikbaar als je een melding verwacht.

Het voorbeeld roept expliciet clear() aan, zodat de uitvoer niet afhangt van de garbagecollector. Reference.reachabilityFence(value) houdt value tot dat punt sterk bereikbaar. Daardoor is de eerste uitlezing voorspelbaar en blijft de opgeslagen snapshot beschikbaar nadat de wrapper is gewist.

Voorbeelden

import java.lang.ref.Reference;
import java.lang.ref.SoftReference;

public class SoftReferenceDemo {
    public static void main(String[] args) {
        String value = new String("cached");
        SoftReference<String> reference = new SoftReference<>(value);

        String snapshot = reference.get();
        System.out.println(snapshot);
        reference.clear();
        System.out.println(reference.get());
        System.out.println(snapshot);
        Reference.reachabilityFence(value);
    }
}

Resultaat

cached
null
cached

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen