CKTIS / Java
WeakHashMap – eine Map mit schwachen Schlüsseln
WeakHashMap hält Schlüssel über schwache Referenzen: Die Map allein schützt sie nicht vor der Garbage Collection. Lernen Sie put, get, containsKey, containsValue und size kennen – einschließlich des Unterschieds zwischen einem fehlenden Eintrag und einem null-Wert.
Version: 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> ist eine hashbasierte Map mit schwachen Schlüsseln. Eine schwache Referenz verhindert nicht, dass der Garbage Collector (GC) ein Objekt freigibt. Die Map kann daher einen Eintrag verlieren, nachdem sein Schlüssel eingesammelt wurde; der Zeitpunkt der Entfernung ist nicht deterministisch.
WeakHashMap.put(key, value) fügt einen Wert hinzu oder ersetzt ihn und gibt den vorherigen Wert oder null zurück (kein Eintrag oder vorheriger Wert null). WeakHashMap.get(key) gibt den Wert oder null zurück. WeakHashMap.containsKey(key) prüft, ob ein Eintrag vorhanden ist, und unterscheidet dabei zwischen Abwesenheit und einer Zuordnung zu null; WeakHashMap.containsValue(value) prüft, ob ein Wert vorhanden ist. WeakHashMap.size() gibt eine Momentaufnahme der Anzahl der Einträge zurück, die ohne explizite Änderungen sinken kann.
Der Schlüssel null und Werte null sind zulässig. Bei der Suche werden equals und hashCode berücksichtigt, nicht nur die Objektidentität. Werte werden stark referenziert: Direkte oder indirekte Referenzen der Werte auf Schlüssel können deren Freigabe verhindern. Die Map ist nicht synchronisiert; Synchronisierung verhindert keine durch den GC ausgelöste Entfernung.
Das Beispiel hält key bis zu Reference.reachabilityFence(key) erreichbar, damit die Ausgabe nicht vom GC abhängt. Es zeigt das Ersetzen eines Werts und den Unterschied zwischen get(key), das null zurückgibt, und dem Vorhandensein des Schlüssels.
Beispiele
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);
}
}
}Ergebnis
null draft ready true true 1 null true
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.