Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

Map.merge(): łączenie wartości dla jednego klucza

Użyj `Map.merge()`, aby zapisać wartość początkową, połączyć ją z istniejącą wartością lub usunąć wpis, gdy funkcja zwróci `null`.

Wersja: Java SE 21

Składnia

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

map.merge(key, value, (oldValue, incomingValue) -> combinedValue)

Map.merge i Map.merge() oznaczają tę samą metodę domyślną interfejsu java.util.Map, dostępną od Javy 8. Nawiasy w nazwie nie oznaczają wersji bez argumentów: metodę wywołujesz na obiekcie mapy, przekazując klucz, wartość wejściową i funkcję łączącą (BiFunction).

Jeśli klucza nie ma lub przypisano mu null, metoda zapisuje i zwraca wartość wejściową bez wywoływania funkcji. W przeciwnym razie funkcja dostaje najpierw dotychczasową wartość, a potem wartość wejściową — nie dostaje klucza. Wynik różny od null zastępuje dotychczasową wartość i jest zwracany. Wynik null usuwa cały wpis, a metoda zwraca null.

Wartość wejściowa i sama funkcja nie mogą być null. Jeśli mapa obsługuje operację merge, przekazanie null zamiast wartości lub funkcji powoduje zgłoszenie NullPointerException. Klucz null jest dozwolony tylko wtedy, gdy dana mapa go obsługuje. Na niemodyfikowalnej mapie utworzonej przez Map.of() wywołanie merge zawsze zgłasza UnsupportedOperationException, nawet gdy wartość wejściowa lub funkcja to null.

Jeśli funkcja zgłosi wyjątek niekontrolowany, merge przekazuje go dalej i pozostawia dotychczasowy wpis bez zmian. Funkcja nie powinna modyfikować tej samej mapy podczas obliczeń. Implementacja domyślna nie gwarantuje ani synchronizacji, ani atomowości; sprawdź dokumentację używanej implementacji.

Do zliczania użyj Integer::sum: pierwszy wpis dostaje wartość 1, a kolejne wystąpienia tego klucza zwiększają licznik. TOTAL to zwykły klucz, który przykład aktualizuje osobnym wywołaniem; nie zmienia się automatycznie po usunięciu innego wpisu.

Przykłady

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

public class MergeDemo {
    public static void main(String[] args) {
        Map<String, Integer> counts = new HashMap<>();
        counts.put("apples", null);

        for (String item : new String[] {"apples", "pears", "apples"}) {
            counts.merge(item, 1, Integer::sum);
            counts.merge("TOTAL", 1, Integer::sum);
        }

        System.out.println("apples=" + counts.get("apples"));
        System.out.println("pears=" + counts.get("pears"));
        System.out.println("TOTAL=" + counts.get("TOTAL"));

        Integer result = counts.merge("pears", 1, (oldValue, incomingValue) -> null);
        System.out.println("merge result=" + result);
        System.out.println("contains pears=" + counts.containsKey("pears"));
    }
}

Wynik

apples=2
pears=1
TOTAL=3
merge result=null
contains pears=false

`HashMap` pozwala przypisać `null` do klucza `apples`, podczas gdy `pears` początkowo nie istnieje. Oba liczniki zaczynają od `1` bez wywołania `Integer::sum`. Na końcu funkcja zwracająca `null` usuwa `pears`; `containsKey` potwierdza usunięcie.

Powiązane lekcje

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

Źródła