Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

Map.compute: przeliczanie wartości dla klucza

Użyj `Map.compute`, aby tą samą funkcją obliczyć wartość dla klucza obecnego lub nieobecnego w mapie. Zwróć `null` z funkcji, aby usunąć wpis.

Wersja: Java SE 21

Składnia

default V compute(K key, BiFunction<? super K, ? super V, ? extends V> remappingFunction)

Map.compute to metoda domyślna interfejsu java.util.Map<K, V>, dostępna od Javy 8. Wywołanie map.compute(key, (k, v) -> ...) uruchamia funkcję zarówno dla klucza obecnego w mapie, jak i dla klucza nieobecnego. k to przekazany klucz, a v to jego dotychczasowa wartość.

Funkcja otrzymuje v == null, gdy klucza nie ma albo gdy jest on powiązany z null. Jeśli rozróżnienie ma znaczenie, w mapie dopuszczającej wartości null, takiej jak HashMap, sprawdź obecność klucza za pomocą containsKey. Wynik funkcji inny niż null zostaje zapisany w mapie i zwrócony przez metodę. Wynik null usuwa wpis, jeśli istnieje; jeśli go nie było, nie powstaje nowy wpis. W obu tych przypadkach metoda zwraca null.

Dla porównania computeIfAbsent wywołuje funkcję tylko wtedy, gdy klucza nie ma albo jego wartością jest null, i przekazuje jej tylko klucz. computeIfPresent przekazuje klucz i wartość, ale wywołuje funkcję tylko wtedy, gdy bieżąca wartość jest różna od null.

Nie modyfikuj tej samej mapy wewnątrz funkcji. Jeśli funkcja zgłosi wyjątek niekontrolowany, metoda przekazuje go dalej i pozostawia dotychczasowe powiązanie bez zmian. Przekazanie null zamiast funkcji powoduje NullPointerException, a mapa bez obsługi tej modyfikacji może zgłosić UnsupportedOperationException. Implementacja domyślna nie gwarantuje atomowości; ConcurrentHashMap.compute gwarantuje atomowość całego wywołania, więc funkcja powinna działać krótko.

Przykłady

import java.util.HashMap;
import java.util.Map;
import java.util.function.BiFunction;

public class Main {
    public static void main(String[] args) {
        Map<String, Integer> counts = new HashMap<>();
        BiFunction<String, Integer, Integer> increment = (k, v) -> v == null ? 1 : v + 1;

        System.out.println(counts.compute("visits", increment));
        System.out.println(counts.compute("visits", increment));
        System.out.println(counts.compute("visits", (k, v) -> null));
        System.out.println(counts.containsKey("visits"));
    }
}

Wynik

1
2
null
false

Pierwsze wywołanie tworzy licznik `visits` z wartością `1`, drugie zwiększa ją do `2`, a trzecie usuwa wpis i zwraca `null`. Końcowe `false` potwierdza brak klucza; w mapie nie pozostał wpis z wartością `null`.

Powiązane lekcje

  • Java · Lekcja 39 · Średniozaawansowany · Wersja: 2

Źródła