Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / Java

SoftReference — měkký odkaz

SoftReference<T> z java.lang.ref uchovává měkký odkaz na objekt. Jakmile objekt přestane být silně dosažitelný, může garbage collector tento odkaz při nedostatku paměti vymazat. Při čtení pomocí get() je třeba ošetřit null.

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

Syntaxe

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

SoftReference<T> obaluje odkaz na objekt typu T. Objekt je měkce dosažitelný, pokud není silně dosažitelný, ale lze se k němu dostat přes měkký odkaz. Silná dosažitelnost nevyžaduje procházení objektů odkazů; slabá dosažitelnost vylučuje silnou i měkkou dosažitelnost.

Garbage collector může při nedostatku paměti měkké odkazy vymazat. Čas ani pořadí mazání nejsou zaručeny, všechny měkké odkazy na měkce dosažitelné objekty však budou vymazány před vyvoláním OutOfMemoryError. Tento mechanismus podporuje mezipaměti citlivé na dostupnou paměť, nezaručuje však dobu uchování ani ochranu před vyčerpáním paměti.

get() vrací silný odkaz na objekt, nebo null. Ulož výsledek jednou do lokální proměnné a před použitím ho zkontroluj. clear() odkaz vymaže, ale nesmaže objekt ani jiné odkazy a nezařadí obal do fronty. Konstruktor SoftReference(T referent, ReferenceQueue<? super T> q) umožňuje registraci do fronty; pokud očekáváš oznámení, udržuj dosažitelný samotný obal.

Příklad výslovně volá clear(), takže jeho výstup nezávisí na garbage collectoru. Reference.reachabilityFence(value) udržuje value silně dosažitelnou až do tohoto místa. První čtení je proto předvídatelné a uložený snapshot zůstává dostupný i po vymazání obalu.

Příklady

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);
    }
}

Výsledek

cached
null
cached

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje