База знанияИзпитен център
BGБългарски
Избери език13

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

Източници