WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

WeakHashMap: Einträge setzen, lesen, prüfen und zählen

Lerne fünf Operationen von `WeakHashMap` in Java SE 21 kennen und erfahre, wie schwache Schlüssel, starke Werte und `null` ihre Ergebnisse beeinflussen.

Version: Java SE 21

Syntax

java.util.WeakHashMap<K, V> (Java SE 21)
public V put(K key, V value)
public V get(Object key)
public boolean containsKey(Object key)
public boolean containsValue(Object value)
public int size()

java.util.WeakHashMap<K, V> hält Schlüssel ungleich null über schwache Referenzen und Werte über starke Referenzen. Wird ein Schlüsselobjekt nur noch schwach erreichbar, kann der Garbage Collector (GC) seine schwache Referenz löschen. Danach kann die Map den Eintrag entfernen. Dafür gibt es keine garantierte Frist. Ein direkter oder indirekter Pfad aus starken Referenzen vom Wert zu seinem eigenen Schlüssel kann das verhindern.

Die Schlüsselsuche nutzt hashCode() und equals(), nicht nur die Objektidentität (==). Ein anderes, gleiches Objekt kann einen Eintrag finden, hält aber das gespeicherte Schlüsselobjekt nicht allein am Leben. Ein null-Schlüssel und null-Werte sind zulässig.

put(K key, V value) legt eine Zuordnung an oder ersetzt den Wert zu einem gleichen Schlüssel. Die Methode liefert den bisherigen Wert oder null, wenn keine Zuordnung vorhanden war oder ihr Wert null war. get(Object key) liefert den aktuellen Wert; null kann sowohl eine fehlende Zuordnung als auch einen zugeordneten null-Wert bedeuten. containsKey(Object key) prüft, ob unabhängig vom Wert eine Zuordnung existiert, und unterscheidet diese Fälle. Zwei Aufrufe ergeben jedoch keine atomare Beobachtung.

containsValue(Object value) prüft, ob mindestens eine Zuordnung einen gleichen Wert hat; auch nach null kann gesucht werden. size() zählt die Zuordnungen zum Zeitpunkt des Aufrufs, einschließlich derer mit dem Wert null. Ergebnisse können sich ohne Schreibzugriff der Anwendung ändern, wenn die Map Einträge nach dem Löschen ihrer Schlüsselreferenzen durch den GC entfernt.

Die Map bietet weder TTL (zeitgesteuerten Ablauf) noch LRU (Verdrängung des am längsten nicht verwendeten Eintrags). Sie ist nicht threadsicher. Collections.synchronizedMap(...) kann gemeinsame Zugriffe synchronisieren, verhindert aber keine GC-bedingte Bereinigung.

Beispiele

import java.lang.ref.Reference;
import java.util.WeakHashMap;

public class WeakHashMapDemo {
    record Key(int id) {}

    public static void main(String[] args) {
        var map = new WeakHashMap<Key, String>();
        var stored = new Key(1);
        var equal = new Key(1);
        var missing = new Key(2);

        System.out.println("first put: " + map.put(stored, "draft"));
        System.out.println("replacement put: " + map.put(equal, "ready"));
        map.put(null, null);

        System.out.println("get(equal): " + map.get(equal));
        System.out.println("get(null): " + map.get(null));
        System.out.println("get(missing): " + map.get(missing));
        System.out.println("containsKey(null): " + map.containsKey(null));
        System.out.println("containsKey(missing): " + map.containsKey(missing));
        System.out.println("containsValue(null): " + map.containsValue(null));
        System.out.println("size: " + map.size());

        Reference.reachabilityFence(stored);
        Reference.reachabilityFence(equal);
    }
}

Ergebnis

first put: null
replacement put: draft
get(equal): ready
get(null): null
get(missing): null
containsKey(null): true
containsKey(missing): false
containsValue(null): true
size: 2

`equal` ist ein anderes, aber zu `stored` gleiches Objekt: Es ersetzt `draft` durch `ready`, ohne eine Zuordnung hinzuzufügen. `get` liefert sowohl für den `null`-Schlüssel als auch für `missing` den Wert `null`, aber nur der erste Schlüssel ist vorhanden. `Reference.reachabilityFence` hält beide Schlüsselobjekte bis zur letzten Ausgabe stark erreichbar; der Zeitpunkt der GC-Bereinigung wird nicht getestet.

Zugehörige Lektionen

  • Java · Lektion 18 · Fortgeschritten · Version: 2

Quellen