CKTIS / Java
Map.containsKey i Map.put: obecność klucza a wartość null
Sprawdź, czy mapa zawiera klucz, nawet gdy przypisano mu `null`. Zobacz, jak `put` wstawia wpis lub zastępuje jego wartość i czym to się różni od wstawiania warunkowego.
Wersja: Java SE 21
Składnia
java.util.Map<K, V> — instance method signatures:
boolean containsKey(Object key)
V put(K key, V value)Map.containsKey(Object key) zwraca true, jeśli w mapie istnieje wpis dla klucza, i nie zmienia mapy. Kontrakt Map określa dopasowanie przez Objects.equals(key, k), gdzie k to zapisany klucz. W HashMap nowy, logicznie równy klucz pasuje do istniejącego wpisu. IdentityHashMap celowo stosuje zamiast tego porównanie referencji przez ==.
W mapie dopuszczającej wartości null, takiej jak HashMap, samo get(key) == null nie rozróżnia braku wpisu od wpisu z wartością null. Użyj containsKey, aby rozróżnić te przypadki. Dla niedozwolonego typu klucza zapytanie containsKey może zgłosić ClassCastException, a dla niedozwolonego klucza null — NullPointerException.
Map.put(K key, V value) tworzy wpis dla brakującego klucza albo zastępuje wartość istniejącego wpisu. Zwraca poprzednią wartość, a nie nową. Wynik null może oznaczać brak poprzedniego wpisu lub jego poprzednią wartość null. put jest operacją opcjonalną: jeśli mapa jej nie obsługuje, wywołanie musi zgłosić UnsupportedOperationException, gdy zmieniłoby mapę. Jeśli wywołanie nie miałoby żadnego wpływu na mapę, implementacja może zgłosić ten wyjątek, ale nie musi. Ograniczenia dotyczące kluczy i wartości zależą od implementacji.
Jeśli chcesz wstawić wpis tylko wtedy, gdy klucza nie ma, i zachować istniejącą wartość null, użyj if (!map.containsKey(key)) map.put(key, value);. putIfAbsent może natomiast zastąpić istniejącą wartość null. Samo połączenie sprawdzenia i zapisu nie jest atomowe względem innych wątków.
Przykłady
import java.util.HashMap;
import java.util.Map;
public class MapContainsKeyDemo {
public static void main(String[] args) {
Map<String, String> map = new HashMap<>();
String storedKey = new String("task");
String equalKey = new String("task");
String missingKey = "other";
map.put(storedKey, null);
System.out.println("Same reference: " + (storedKey == equalKey));
System.out.println("Equal key: contains=" + map.containsKey(equalKey)
+ ", get=" + map.get(equalKey));
System.out.println("Missing key: contains=" + map.containsKey(missingKey)
+ ", get=" + map.get(missingKey));
if (!map.containsKey(equalKey)) {
map.put(equalKey, "default");
}
System.out.println("After guarded insert: " + map.get(equalKey));
System.out.println("Previous value: " + map.put(equalKey, "ready"));
System.out.println("Current value: " + map.get(storedKey));
System.out.println("Size: " + map.size());
}
}Wynik
Same reference: false Equal key: contains=true, get=null Missing key: contains=false, get=null After guarded insert: null Previous value: null Current value: ready Size: 1
Dwa obiekty `String` z tekstem `task` są równe, choć mają różne referencje. Zarówno dla obecnego, jak i brakującego klucza `get` zwraca `null`, ale tylko dla obecnego `containsKey` zwraca `true`. Warunek pomija wstawienie wartości domyślnej. Bezwarunkowe `put` zwraca poprzednie `null` i zapisuje `ready`, nie zwiększając rozmiaru mapy.
Powiązane lekcje
- Java · Lekcja 17 · Zaawansowany · Wersja: 2
- Java · Lekcja 18 · Zaawansowany · Wersja: 2
- Java · Lekcja 39 · Średniozaawansowany · Wersja: 2