CKTIS / Java
WeakHashMap — mapa so slabými kľúčmi
WeakHashMap uchováva kľúče pomocou slabých referencií: samotná mapa ich nechráni pred uvoľnením garbage collectorom. Spoznajte metódy put, get, containsKey, containsValue a size aj rozdiel medzi chýbajúcou položkou a hodnotou null.
Verzia: Java SE 21; repository runtime, production runtime not attested
Syntax
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 hašovacia mapa so slabými kľúčmi. Slabá referencia nebráni garbage collectoru (GC) uvoľniť objekt. Mapa preto môže stratiť položku po uvoľnení jej kľúča; okamih odstránenia nie je deterministický.
WeakHashMap.put(key, value) pridá alebo nahradí hodnotu a vráti predchádzajúcu hodnotu alebo null (položka neexistuje alebo predchádzajúca hodnota bola null). WeakHashMap.get(key) vráti hodnotu alebo null. WeakHashMap.containsKey(key) overí, či položka existuje, a rozlišuje medzi jej neprítomnosťou a priradením hodnoty null; WeakHashMap.containsValue(value) overí prítomnosť hodnoty. WeakHashMap.size() vráti okamžitý počet položiek, ktorý sa môže znížiť aj bez výslovných zmien.
Kľúč null aj hodnoty null sú povolené. Vyhľadávanie rešpektuje equals a hashCode, nielen identitu objektov. Hodnoty sa uchovávajú pomocou silných referencií: ich priame alebo nepriame odkazy na kľúče môžu zabrániť ich uvoľneniu. Mapa nie je synchronizovaná; synchronizácia nezabráni odstraňovaniu spôsobenému GC.
Príklad udržiava key dosiahnuteľný až po Reference.reachabilityFence(key), aby výsledok nezávisel od GC. Ukazuje nahradenie hodnoty a rozdiel medzi tým, keď get(key) vráti null, a tým, že kľúč v mape existuje.
Príklady
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);
}
}
}Výsledok
null draft ready true true 1 null true
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.