CKTIS / Java
WeakHashMap — mapa s šibkimi ključi
WeakHashMap hrani ključe prek šibkih referenc: sama mapa jih ne zaščiti pred garbage collection. Spoznajte put, get, containsKey, containsValue in size ter razliko med manjkajočim vnosom in vrednostjo null.
Različica: Java SE 21; repository runtime, production runtime not attested
Sintaksa
WeakHashMap<K, V> map = new WeakHashMap<>();
V previous = map.put(key, value);
V retrieved = map.get(key);
boolean hasKey = map.containsKey(key);
boolean hasValue = map.containsValue(value);
int count = map.size();java.util.WeakHashMap<K, V> je zgoščevalna mapa s šibkimi ključi. Šibka referenca ne prepreči, da garbage collector (GC) sprosti objekt. Mapa lahko zato izgubi vnos, ko je njegov ključ zbran; čas odstranitve ni determinističen.
WeakHashMap.put(key, value) doda ali zamenja vrednost in vrne prejšnjo vrednost ali null (vnosa ni ali pa je bila prejšnja vrednost null). WeakHashMap.get(key) vrne vrednost ali null. WeakHashMap.containsKey(key) preveri, ali vnos obstaja, in razlikuje med odsotnostjo vnosa ter preslikavo na null; WeakHashMap.containsValue(value) preveri, ali je vrednost prisotna. WeakHashMap.size() vrne trenutni posnetek števila vnosov, ki se lahko zmanjša brez izrecnih sprememb.
Dovoljena sta ključ null in vrednosti null. Iskanje upošteva equals in hashCode, ne le identitete objektov. Vrednosti se hranijo z močnimi referencami: njihove neposredne ali posredne reference na ključe lahko preprečijo njihovo sprostitev. Mapa ni sinhronizirana; sinhronizacija ne prepreči odstranjevanja, ki ga povzroči GC.
Primer ohranja key dosegljiv do Reference.reachabilityFence(key), zato rezultat ni odvisen od GC. Prikazuje zamenjavo vrednosti in razliko med tem, da get(key) vrne null, ter tem, da je ključ prisoten.
Primeri
import java.lang.ref.Reference;
import java.util.WeakHashMap;
public class Main {
public static void main(String[] args) {
Object key = new Object();
WeakHashMap<Object, String> map = new WeakHashMap<>();
try {
System.out.println(map.put(key, "draft"));
System.out.println(map.put(key, "ready"));
System.out.println(map.get(key));
System.out.println(map.containsKey(key));
System.out.println(map.containsValue("ready"));
System.out.println(map.size());
map.put(key, null);
System.out.println(map.get(key));
System.out.println(map.containsKey(key));
} finally {
Reference.reachabilityFence(key);
}
}
}Rezultat
null draft ready true true 1 null true
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.