CKTIS / Java
Map.merge(): združevanje vrednosti za en ključ
Z metodo `Map.merge()` shraniš začetno vrednost, jo združiš z obstoječo vrednostjo ali odstraniš vnos, če funkcija vrne `null`.
Različica: Java SE 21
Sintaksa
default V merge(K key, V value, BiFunction<? super V, ? super V, ? extends V> remappingFunction)
map.merge(key, value, (oldValue, incomingValue) -> combinedValue)Map.merge in Map.merge() označujeta isto privzeto metodo vmesnika java.util.Map, ki je na voljo od Jave 8. Oklepaja v imenu ne pomenita različice brez argumentov: metodo pokličeš na primerku preslikave ter ji podaš ključ, vhodno vrednost in funkcijo za združevanje (BiFunction).
Če ključa ni ali mu je prirejena vrednost null, metoda shrani in vrne vhodno vrednost, ne da bi poklicala funkcijo. Sicer funkcija prejme najprej prejšnjo in nato vhodno vrednost, ne pa ključa. Rezultat, ki ni null, nadomesti prejšnjo vrednost in ga metoda vrne. Če je rezultat null, metoda odstrani celoten vnos in vrne null.
Niti vhodna vrednost niti sama funkcija ne smeta biti null. Če preslikava podpira merge, podajanje vrednosti null namesto vhodne vrednosti ali funkcije sproži NullPointerException. Ključ null je dovoljen samo, če ga preslikava podpira. Pri nespremenljivi preslikavi, ustvarjeni z Map.of(), klic merge vedno sproži UnsupportedOperationException, tudi če je vhodna vrednost ali funkcija null.
Če funkcija sproži nepreverjano izjemo, jo merge posreduje naprej in pusti obstoječi vnos nespremenjen. Funkcija med izračunom ne sme spreminjati iste preslikave. Privzeta izvedba ne zagotavlja niti sinhronizacije niti atomarnosti; preveri dokumentacijo uporabljene izvedbe.
Za štetje uporabi Integer::sum: prvi vnos se začne pri 1, vsaka naslednja pojavitev istega ključa pa poveča števec. TOTAL je običajen ključ, ki ga primer posodobi z ločenim klicem. Ob odstranitvi drugega vnosa se ne spremeni samodejno.
Primeri
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"));
}
}Rezultat
apples=2 pears=1 TOTAL=3 merge result=null contains pears=false
`HashMap` omogoča, da ima `apples` sprva vrednost `null`, medtem ko ključa `pears` na začetku ni. Oba števca se začneta pri `1` brez klica `Integer::sum`. Na koncu funkcija, ki vrne `null`, odstrani `pears`; `containsKey` potrdi odstranitev.
Povezane lekcije
- Java · Lekcija 56 · Osnovna · Različica: 2
- Java · Lekcija 39 · Srednja · Različica: 2