CKTIS / Java
Map.merge(): Werte für einen Schlüssel zusammenführen
Mit `Map.merge()` speicherst du einen Anfangswert, kombinierst ihn mit einem vorhandenen Wert oder löschst den Eintrag, wenn die Funktion `null` liefert.
Version: Java SE 21
Syntax
default V merge(K key, V value, BiFunction<? super V, ? super V, ? extends V> remappingFunction)
map.merge(key, value, (oldValue, incomingValue) -> combinedValue)Map.merge und Map.merge() bezeichnen dieselbe Default-Methode der Schnittstelle java.util.Map, die seit Java 8 verfügbar ist. Die Klammern im Namen stehen nicht für eine Variante ohne Argumente: Du rufst die Methode auf einer Map-Instanz mit einem Schlüssel, einem übergebenen Wert und einer Kombinationsfunktion (BiFunction) auf.
Fehlt der Schlüssel oder ist ihm null zugeordnet, speichert die Methode den übergebenen Wert und gibt ihn zurück, ohne die Funktion aufzurufen. Andernfalls erhält die Funktion zuerst den bisherigen und dann den übergebenen Wert, nicht den Schlüssel. Ein Ergebnis ungleich null ersetzt den bisherigen Wert und wird zurückgegeben. Liefert die Funktion null, wird der gesamte Eintrag entfernt und die Methode gibt null zurück.
Weder der übergebene Wert noch die Funktion selbst darf null sein. Unterstützt die Map merge, führt null für eines dieser beiden Argumente zu einer NullPointerException. Ein null-Schlüssel ist nur erlaubt, wenn die Map ihn unterstützt. Bei einer nicht änderbaren Map, die mit Map.of() erstellt wurde, löst ein Aufruf von merge immer eine UnsupportedOperationException aus, auch wenn der übergebene Wert oder die Funktion null ist.
Löst die Funktion eine ungeprüfte Ausnahme aus, reicht merge sie weiter und lässt den vorhandenen Eintrag unverändert. Die Funktion sollte während der Berechnung dieselbe Map nicht ändern. Die Standardimplementierung garantiert weder Synchronisierung noch Atomarität; prüfe die Dokumentation der verwendeten Implementierung.
Zum Zählen eignet sich Integer::sum: Der erste Eintrag startet bei 1, jedes weitere Auftreten dieses Schlüssels erhöht den Zähler. TOTAL ist ein gewöhnlicher Schlüssel, den das Beispiel mit einem separaten Aufruf aktualisiert. Beim Entfernen eines anderen Eintrags ändert er sich nicht automatisch.
Beispiele
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"));
}
}Ergebnis
apples=2 pears=1 TOTAL=3 merge result=null contains pears=false
Eine `HashMap` erlaubt es, `apples` zunächst `null` zuzuordnen, während `pears` anfangs fehlt. Beide Zähler starten ohne Aufruf von `Integer::sum` bei `1`. Am Ende entfernt die Funktion, die `null` liefert, den Eintrag `pears`; `containsKey` bestätigt das.
Zugehörige Lektionen
- Java · Lektion 56 · Grundlagen · Version: 2
- Java · Lektion 39 · Mittlere Stufe · Version: 2