Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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

Źródła