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.