CKTIS / Java
WeakHashMap — een map met zwakke sleutels
WeakHashMap houdt sleutels vast via zwakke verwijzingen: de map beschermt ze op zichzelf niet tegen garbage collection. Leer put, get, containsKey, containsValue en size kennen, inclusief het verschil tussen een ontbrekende entry en een null-waarde.
Versie: 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> is een hashgebaseerde map met zwakke sleutels. Een zwakke verwijzing voorkomt niet dat de garbage collector (GC) een object opruimt. De map kan daardoor een entry verliezen nadat de sleutel is opgeruimd; het moment van verwijdering is niet deterministisch.
WeakHashMap.put(key, value) voegt een waarde toe of vervangt deze en geeft de vorige waarde of null terug (geen entry of een vorige waarde null). WeakHashMap.get(key) geeft de waarde of null terug. WeakHashMap.containsKey(key) controleert of er een entry is en maakt onderscheid tussen afwezigheid en een koppeling aan null; WeakHashMap.containsValue(value) controleert of een waarde aanwezig is. WeakHashMap.size() geeft een momentopname van het aantal entries, dat zonder expliciete wijzigingen kan afnemen.
De sleutel null en waarden null zijn toegestaan. Bij het zoeken worden equals en hashCode gebruikt, niet alleen de objectidentiteit. Waarden worden sterk vastgehouden: directe of indirecte verwijzingen van waarden naar sleutels kunnen voorkomen dat die sleutels worden opgeruimd. De map is niet gesynchroniseerd; synchronisatie voorkomt geen verwijdering door de GC.
Het voorbeeld houdt key bereikbaar tot Reference.reachabilityFence(key), zodat de uitvoer niet afhankelijk is van de GC. Het laat zien hoe een waarde wordt vervangen en wat het verschil is tussen get(key) dat null teruggeeft en de aanwezigheid van de sleutel.
Voorbeelden
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);
}
}
}Resultaat
null draft ready true true 1 null true
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.