Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

Map.put — wstawianie lub zastępowanie wartości

Zapisz wartość pod kluczem i odczytaj poprzednią wartość. Sprawdź, kiedy wynik `null` oznacza brak wpisu, a kiedy wpis z wartością `null`.

Wersja: Java SE 21

Składnia

V put(K key, V value)
V previous = map.put(key, value);

Map.put to metoda instancji interfejsu java.util.Map<K, V> w Java SE 21. Zapis Map.put() jest skrótową nazwą tej samej metody, a nie wywołaniem bez argumentów. Wywołaj map.put(key, value), przekazując klucz typu K i wartość typu V. Metoda dodaje wpis, jeśli klucza nie ma, albo zastępuje jego wartość. W HashMap dwa różne obiekty klucza, które są równe według equals i mają zgodne kody hashCode, trafiają do tego samego wpisu.

Metoda zwraca poprzednią wartość, nie nową. Wynik null oznacza brak wcześniejszego wpisu albo wcześniejszą wartość null, jeśli mapa ją dopuszcza. Sprawdź containsKey(key) przed zapisem, aby odróżnić te przypadki, o ile mapa nie zmieni się między operacjami. Zapisanie null jako wartości nie usuwa wpisu.

put jest operacją opcjonalną. Mapa utworzona przez Map.of zgłasza UnsupportedOperationException. Mapa może odrzucić niedozwolone null przez NullPointerException, nieodpowiedni typ przez ClassCastException lub niedozwoloną cechę klucza albo wartości przez IllegalArgumentException. Zapis przez modyfikowalny widok NavigableMap.subMap zmienia mapę bazową; klucz spoza zakresu powoduje IllegalArgumentException i nie zostaje wstawiony.

HashMap i WeakHashMap dopuszczają klucz null i wartości null. W WeakHashMap wpis może też zniknąć, gdy odśmiecacz pamięci usunie jego słabo osiągalny klucz. Po wstawieniu nowego wpisu przez put w LinkedHashMap automatycznie wywołuje się removeEldestEntry; nadpisanie tej metody pozwala usunąć najstarszy wpis przez zwrócenie true. Sama podmiana wartości nie wywołuje tej metody.

W pamięci podręcznej zapisuj tylko poprawne wyniki, jeśli tego wymaga jej polityka: na przykład pomiń put, gdy ujemny wynik oznacza błąd. Map<Class<?>, Object> nie wymusza zgodności obiektu z typem reprezentowanym przez klucz; sprawdź ją przed zapisem za pomocą type.cast(value). Jeśli wspólną mapę chroni Lock, używaj tej samej blokady przy wszystkich dostępach: wywołaj lock.lock() przed try, wykonaj zapis w try, a lock.unlock() w finally.

Przykłady

import java.util.HashMap;
import java.util.Map;

public class Main {
    public static void main(String[] args) {
        Map<String, String> statuses = new HashMap<>();
        String key = "job";
        String equalKey = new String(key);

        System.out.println(statuses.containsKey(key));
        System.out.println(statuses.put(key, "ready"));
        System.out.println(statuses.put(equalKey, null));
        System.out.println(statuses.containsKey(key));
        System.out.println(statuses.put(key, "done"));
        System.out.println(statuses.get(key));
        System.out.println(statuses.size());
    }
}

Wynik

false
null
ready
true
null
done
1

Pierwsze `null` zwrócone przez `put` oznacza brak wpisu. Równy klucz zastępuje `ready` wartością `null`, nie usuwając wpisu. Drugie `null` zwrócone przez `put` jest poprzednią wartością, a w mapie nadal jest tylko jeden wpis.

Powiązane lekcje

  • Java · Lekcja 13 · Zaawansowany · Wersja: 2
  • Java · Lekcja 17 · Zaawansowany · Wersja: 2
  • Java · Lekcja 18 · Zaawansowany · Wersja: 2
  • Java · Lekcja 20 · Zaawansowany · Wersja: 2
  • Java · Lekcja 36 · Zaawansowany · Wersja: 2
  • Java · Lekcja 35 · Podstawowy · Wersja: 2
  • Java · Lekcja 42 · Podstawowy · Wersja: 2
  • Java · Lekcja 57 · Podstawowy · Wersja: 2
  • Java · Lekcja 58 · Podstawowy · Wersja: 2
  • Java · Lekcja 40 · Średniozaawansowany · Wersja: 2

Źródła