CKTIS / Java
WeakHashMap: zapis, odczyt, sprawdzanie i liczba wpisów
Poznaj pięć operacji `WeakHashMap` w Java SE 21 i zobacz, jak słabe klucze, silne wartości oraz `null` wpływają na ich wyniki.
Wersja: Java SE 21
Składnia
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> przechowuje klucze inne niż null przez słabe referencje, a wartości przez silne. Gdy obiekt klucza staje się słabo osiągalny, odśmiecacz pamięci (GC) może wyczyścić słabą referencję, a mapa może potem usunąć wpis. Nie ma gwarantowanego terminu. Silna ścieżka od wartości do własnego klucza, bezpośrednia lub pośrednia, może temu zapobiec.
Wyszukiwanie klucza opiera się na hashCode() i equals(), nie na samej tożsamości (==). Inny, równy obiekt może znaleźć wpis, ale sam nie utrzymuje przy życiu zapisanego obiektu klucza. Mapa dopuszcza jeden klucz null i wartości null.
put(K key, V value) dodaje wpis lub zastępuje wartość dla równego klucza. Zwraca poprzednią wartość albo null, jeśli wpisu nie było lub poprzednią wartością było null. get(Object key) zwraca bieżącą wartość albo null zarówno dla braku wpisu, jak i dla wpisu z wartością null. containsKey(Object key) sprawdza obecność wpisu niezależnie od wartości i pozwala rozróżnić te przypadki. Dwa wywołania nie tworzą jednak jednej niepodzielnej obserwacji.
containsValue(Object value) sprawdza, czy co najmniej jeden wpis ma równą wartość; można też szukać null. size() zwraca chwilową liczbę wpisów, również tych z wartością null. Wyniki mogą się zmienić bez zapisu ze strony aplikacji, gdy mapa usunie wpisy po wyczyszczeniu referencji przez GC.
Mapa nie zapewnia ani TTL (wygaśnięcia po upływie czasu), ani LRU (usuwania najdawniej używanego wpisu). Nie jest bezpieczna wątkowo: współdzielony dostęp można synchronizować przez Collections.synchronizedMap(...), ale synchronizacja nie zatrzymuje czyszczenia związanego z GC.
Przykłady
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);
}
}Wynik
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` jest innym obiektem równym `stored`: zastępuje `draft` wartością `ready`, nie dodając wpisu. `get` zwraca `null` dla obu sprawdzanych kluczy, `null` i `missing`, ale tylko pierwszy jest obecny. `Reference.reachabilityFence` utrzymuje oba obiekty klucza silnie osiągalne do końca wypisywania; przykład nie testuje czasu działania GC.
Powiązane lekcje
- Java · Lekcja 18 · Zaawansowany · Wersja: 2