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