Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

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

Fuentes