Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / Java

Map.merge(): combinar valores da mesma chave

Usa `Map.merge()` para guardar um valor inicial, combiná-lo com um valor existente ou remover a entrada quando a função devolve `null`.

Versão: Java SE 21

Sintaxe

default V merge(K key, V value, BiFunction<? super V, ? super V, ? extends V> remappingFunction)

map.merge(key, value, (oldValue, incomingValue) -> combinedValue)

Map.merge e Map.merge() referem-se ao mesmo método predefinido da interface java.util.Map, disponível desde Java 8. Os parênteses no nome não indicam uma versão sem argumentos: chama o método numa instância do mapa, passando uma chave, um valor de entrada e uma função de combinação (BiFunction).

Se a chave não existir ou estiver associada a null, o método guarda e devolve o valor de entrada sem chamar a função. Caso contrário, a função recebe primeiro o valor anterior e depois o valor de entrada, não a chave. Um resultado diferente de null substitui o valor anterior e é devolvido. Um resultado null remove toda a entrada e o método devolve null.

Nem o valor de entrada nem a própria função podem ser null. Se o mapa suportar merge, passar null em qualquer um desses dois argumentos provoca uma NullPointerException. Uma chave null só é permitida se o mapa a aceitar. Num mapa não modificável criado com Map.of(), uma chamada a merge lança sempre UnsupportedOperationException, mesmo que o valor de entrada ou a função seja null.

Se a função lançar uma exceção não verificada, merge propaga-a e deixa a entrada existente inalterada. A função não deve modificar o mesmo mapa durante o cálculo. A implementação predefinida não garante sincronização nem atomicidade; consulta a documentação da implementação que usas.

Para contar, usa Integer::sum: a primeira entrada começa em 1 e cada ocorrência posterior da mesma chave incrementa o contador. TOTAL é uma chave normal que o exemplo atualiza com uma chamada separada; não muda automaticamente quando se remove outra entrada.

Exemplos

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"));
    }
}

Resultado

apples=2
pears=1
TOTAL=3
merge result=null
contains pears=false

`HashMap` permite associar inicialmente `apples` a `null`, enquanto `pears` está inicialmente ausente. Ambos os contadores começam em `1` sem chamar `Integer::sum`. No fim, a função que devolve `null` remove `pears`; `containsKey` confirma a remoção.

Lições relacionadas

  • Java · Lição 56 · Básico · Versão: 2
  • Java · Lição 39 · Intermédio · Versão: 2

Fontes