Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

WeakHashMap — mapa ze słabymi kluczami

WeakHashMap przechowuje klucze przez słabe referencje: sama mapa nie chroni ich przed odśmiecaniem. Poznaj put, get, containsKey, containsValue i size oraz różnicę między brakiem wpisu a wartością null.

Wersja: Java SE 21; repository runtime, production runtime not attested

Składnia

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> to mapa haszująca ze słabymi kluczami. Słaba referencja nie zapobiega odzyskaniu obiektu przez garbage collector (GC). Mapa może więc utracić wpis po zebraniu klucza; termin usunięcia nie jest deterministyczny.

WeakHashMap.put(key, value) dodaje lub zastępuje wartość i zwraca poprzednią albo null (brak wpisu lub poprzednia wartość null). WeakHashMap.get(key) zwraca wartość albo null. WeakHashMap.containsKey(key) sprawdza istnienie wpisu, odróżniając brak od przypisania null; WeakHashMap.containsValue(value) sprawdza obecność wartości. WeakHashMap.size() zwraca chwilową liczbę wpisów, która może maleć bez jawnych modyfikacji.

Dozwolone są klucz null i wartości null. Wyszukiwanie respektuje equals i hashCode, a nie wyłącznie tożsamość obiektów. Wartości są przechowywane silnie: ich bezpośrednia lub pośrednia referencja do klucza może uniemożliwić jego zebranie. Mapa nie jest synchronizowana; synchronizacja nie powstrzymuje usuwania przez GC.

Przykład zachowuje osiągalność key do Reference.reachabilityFence(key), aby wynik nie zależał od GC. Pokazuje zastąpienie wartości oraz różnicę między get(key) zwracającym null a obecnością klucza.

Przykłady

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);
        }
    }
}

Wynik

null
draft
ready
true
true
1
null
true

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła