CKTIS / Java
Map.merge(): zlúčenie hodnôt pre jeden kľúč
Pomocou `Map.merge()` uložíš počiatočnú hodnotu, zlúčiš ju s existujúcou hodnotou alebo odstrániš záznam, ak funkcia vráti `null`.
Verzia: 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 a Map.merge() označujú tú istú predvolenú metódu rozhrania java.util.Map, dostupnú od Javy 8. Zátvorky v názve neznamenajú variant bez argumentov: metódu voláš na inštancii mapy a odovzdáš jej kľúč, vstupnú hodnotu a zlučovaciu funkciu (BiFunction).
Ak kľúč v mape nie je alebo je k nemu priradené null, metóda uloží a vráti vstupnú hodnotu bez volania funkcie. Inak funkcia dostane najprv doterajšiu a potom vstupnú hodnotu, nie kľúč. Výsledok odlišný od null nahradí doterajšiu hodnotu a metóda ho vráti. Výsledok null odstráni celý záznam a metóda vráti null.
Vstupná hodnota ani samotná funkcia nesmú byť null. Ak mapa podporuje merge, odovzdanie null namiesto vstupnej hodnoty alebo funkcie vyvolá NullPointerException. Kľúč null je povolený len vtedy, ak ho mapa podporuje. Pri nemodifikovateľnej mape vytvorenej pomocou Map.of() volanie merge vždy vyvolá UnsupportedOperationException, aj keď je vstupná hodnota alebo funkcia null.
Ak funkcia vyvolá nekontrolovanú výnimku, merge ju posunie ďalej a ponechá existujúci záznam bez zmeny. Funkcia by počas výpočtu nemala meniť tú istú mapu. Predvolená implementácia nezaručuje synchronizáciu ani atomicitu; over si vlastnosti použitej implementácie v jej dokumentácii.
Na počítanie použi Integer::sum: prvý záznam začína na 1 a každý ďalší výskyt toho istého kľúča zvýši počítadlo. TOTAL je obyčajný kľúč, ktorý príklad aktualizuje samostatným volaním. Pri odstránení iného záznamu sa automaticky nezmení.
Príklady
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"));
}
}Výsledok
apples=2 pears=1 TOTAL=3 merge result=null contains pears=false
`HashMap` umožňuje spočiatku priradiť kľúču `apples` hodnotu `null`, zatiaľ čo `pears` na začiatku chýba. Obe počítadlá začínajú na `1` bez volania `Integer::sum`. Nakoniec funkcia vracajúca `null` odstráni `pears`; `containsKey` potvrdí odstránenie.
Súvisiace lekcie
- Java · Lekcia 56 · Základná · Verzia: 2
- Java · Lekcia 39 · Stredne pokročilá · Verzia: 2