CKTIS / Java
Map.merge(): обединяване на стойности за един ключ
Използвай `Map.merge()`, за да запишеш начална стойност, да я обединиш със съществуващата или да премахнеш записа, ако функцията върне `null`.
Версия: Java SE 21
Синтаксис
default V merge(K key, V value, BiFunction<? super V, ? super V, ? extends V> remappingFunction)
map.merge(key, value, (oldValue, incomingValue) -> combinedValue)Map.merge и Map.merge() означават един и същ метод по подразбиране на интерфейса java.util.Map, наличен от Java 8. Скобите в името не означават вариант без аргументи: извикваш метода върху обект на карта и подаваш ключ, входна стойност и функция за обединяване (BiFunction).
Ако ключът липсва или е свързан с null, методът записва и връща входната стойност, без да извиква функцията. В противен случай функцията получава първо старата стойност, а след това входната стойност, но не и ключа. Резултат, различен от null, замества старата стойност и се връща от метода. Резултат null премахва целия запис, а методът връща null.
Нито входната стойност, нито самата функция може да е null. Ако картата поддържа merge, подаването на null вместо входната стойност или функцията води до NullPointerException. Ключ null е допустим само ако картата го поддържа. При немодифицируема карта, създадена с Map.of(), извикването на merge винаги хвърля UnsupportedOperationException, дори ако входната стойност или функцията е null.
Ако функцията хвърли непроверявано изключение, merge го предава нататък и оставя съществуващия запис непроменен. Функцията не бива да променя същата карта по време на изчислението. Реализацията по подразбиране не гарантира нито синхронизация, нито атомарност; провери документацията на използваната реализация.
За броене използвай Integer::sum: първият запис започва от 1, а всяка следваща поява на същия ключ увеличава брояча. TOTAL е обикновен ключ, който примерът обновява с отделно извикване. Стойността му не се променя автоматично при премахване на друг запис.
Примери
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"));
}
}Резултат
apples=2 pears=1 TOTAL=3 merge result=null contains pears=false
`HashMap` позволява `apples` първоначално да е свързан с `null`, докато ключът `pears` първоначално липсва. И двата брояча започват от `1` без извикване на `Integer::sum`. Накрая функцията, която връща `null`, премахва `pears`; `containsKey` потвърждава премахването.
Свързани уроци
- Java · Урок 56 · Начално · Версия: 2
- Java · Урок 39 · Средно · Версия: 2