CKTIS / Java
WeakHashMap — mapa sa slabim ključevima
WeakHashMap čuva ključeve putem slabih referenci: sama ih mapa ne štiti od odvoza smeća. Upoznajte put, get, containsKey, containsValue i size te razliku između nedostajućeg unosa i vrijednosti null.
Verzija: 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> hash-mapa je sa slabim ključevima. Slaba referenca ne sprječava garbage collector (GC) da oslobodi objekt. Mapa stoga može izgubiti unos nakon što se njegov ključ prikupi; trenutak uklanjanja nije deterministički.
WeakHashMap.put(key, value) dodaje ili zamjenjuje vrijednost te vraća prethodnu vrijednost ili null (unos ne postoji ili je prethodna vrijednost bila null). WeakHashMap.get(key) vraća vrijednost ili null. WeakHashMap.containsKey(key) provjerava postoji li unos i razlikuje njegovu odsutnost od mapiranja na null; WeakHashMap.containsValue(value) provjerava postoji li vrijednost. WeakHashMap.size() vraća trenutačni broj unosa, koji se može smanjiti bez izričitih izmjena.
Dopušteni su ključ null i vrijednosti null. Pretraživanje uvažava equals i hashCode, a ne samo identitet objekata. Vrijednosti se čuvaju snažnim referencama: njihove izravne ili neizravne reference na ključeve mogu spriječiti njihovo prikupljanje. Mapa nije sinkronizirana; sinkronizacija ne sprječava uklanjanje koje pokreće GC.
Primjer održava key dostupnim do Reference.reachabilityFence(key) kako rezultat ne bi ovisio o GC-u. Prikazuje zamjenu vrijednosti i razliku između toga da get(key) vraća null i toga da je ključ prisutan.
Primjeri
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
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.