CKTIS / Java
Map.merge(): combinar valores de una clave
Usa `Map.merge()` para guardar un valor inicial, combinarlo con un valor existente o eliminar la entrada cuando la función devuelva `null`.
Versión: Java SE 21
Sintaxis
default V merge(K key, V value, BiFunction<? super V, ? super V, ? extends V> remappingFunction)
map.merge(key, value, (oldValue, incomingValue) -> combinedValue)Map.merge y Map.merge() se refieren al mismo método predeterminado de la interfaz java.util.Map, disponible desde Java 8. Los paréntesis del nombre no indican una versión sin argumentos: se llama al método sobre una instancia del mapa con una clave, un valor entrante y una función de combinación (BiFunction).
Si la clave no existe o está asociada a null, el método guarda y devuelve el valor entrante sin llamar a la función. En caso contrario, la función recibe primero el valor anterior y después el entrante, no la clave. Un resultado distinto de null sustituye al valor anterior y se devuelve. Si el resultado es null, se elimina toda la entrada y el método devuelve null.
Ni el valor entrante ni la función pueden ser null. Si el mapa admite merge, pasar null en cualquiera de esos dos argumentos provoca una NullPointerException. Una clave null solo se admite si el mapa la permite. En un mapa no modificable creado con Map.of(), llamar a merge siempre lanza UnsupportedOperationException, incluso si el valor entrante o la función son null.
Si la función lanza una excepción no comprobada, merge la propaga y deja intacta la entrada existente. La función no debe modificar ese mismo mapa durante el cálculo. La implementación predeterminada no garantiza ni la sincronización ni la atomicidad; consulta la documentación de la implementación que uses.
Para contar, usa Integer::sum: la primera entrada empieza en 1 y cada aparición posterior de esa clave incrementa el contador. TOTAL es una clave normal que el ejemplo actualiza con una llamada aparte; no cambia automáticamente al eliminar otra entrada.
Ejemplos
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 que `apples` empiece asociado a `null`, mientras que `pears` no existe al principio. Ambos contadores empiezan en `1` sin llamar a `Integer::sum`. Al final, la función que devuelve `null` elimina `pears`; `containsKey` confirma la eliminación.
Lecciones relacionadas
- Java · Lección 56 · Básico · Versión: 2
- Java · Lección 39 · Intermedio · Versión: 2