Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

Map.getOrDefault: odczyt z wartością domyślną

Odczytaj wartość dla klucza z mapy. Wartość domyślna jest zwracana tylko wtedy, gdy nie ma wpisu dla klucza, a nie wtedy, gdy wpis zawiera `null`.

Wersja: Java SE 21

Składnia

java.util.Map<K, V>: default V getOrDefault(Object key, V defaultValue)
Call: map.getOrDefault(key, defaultValue)

Map.getOrDefault to domyślna metoda instancyjna interfejsu java.util.Map<K, V>, dostępna od Javy 8. Zapis Map.getOrDefault() jest skrótem używanym w dokumentacji, a nie wywołaniem bez argumentów. Wywołaj map.getOrDefault(key, defaultValue): parametr klucza ma typ Object, a wartość domyślna i wynik mają typ V.

Jeśli mapa ma wpis dla klucza, metoda zwraca zapisaną wartość, nawet jeśli jest to null, jak może się zdarzyć w HashMap. Tylko brak wpisu powoduje zwrócenie wartości domyślnej. Metoda niczego nie zapisuje ani nie zastępuje. W przeciwieństwie do get(key), które dla brakującego klucza zwraca null, pozwala podać wartość domyślną. Wyrażenie podane jako drugi argument jest obliczane przed wywołaniem, nawet jeśli jego wartość nie zostanie użyta.

Dla Map<String, Long> użyj 0L: literał typu long jest automatycznie konwertowany na Long (boxing). Przypisanie wyniku do long wykonuje konwersję odwrotną (unboxing); jeśli wynik to null, zgłaszany jest NullPointerException. Dla Map<String, Integer> możesz użyć map.getOrDefault("TOTAL", 0).

W zależności od implementacji nieodpowiedni typ klucza może spowodować ClassCastException, a klucz null może spowodować NullPointerException, jeśli mapa go nie dopuszcza. Domyślna implementacja metody nie gwarantuje synchronizacji ani atomowości; sprawdź dokumentację konkretnej mapy.

Przykłady

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

public class Main {
    public static void main(String[] args) {
        Map<String, Long> counts = new HashMap<>();
        counts.put("books", 7L);
        counts.put("pending", null);

        long books = counts.getOrDefault("books", 0L);
        long games = counts.getOrDefault("games", 0L);
        Long pending = counts.getOrDefault("pending", 0L);

        System.out.println(books);
        System.out.println(games);
        System.out.println(pending);
        System.out.println(counts.containsKey("games"));
    }
}

Wynik

7
0
null
false

`books` ma wartość `7`, a brak wpisu dla `games` daje `0`. Dla `pending` wynik to `null`, więc pozostaje w zmiennej typu `Long`. Ostatnie `false` pokazuje, że odczyt nie dodał klucza `games`.

Powiązane lekcje

  • Java · Lekcja 43 · Zaawansowany · Wersja: 2
  • Java · Lekcja 56 · Podstawowy · Wersja: 2
  • Java · Lekcja 39 · Średniozaawansowany · Wersja: 2

Źródła