CKTIS / Java
Map.merge(): combinare i valori di una chiave
Usa `Map.merge()` per salvare un valore iniziale, combinarlo con un valore esistente o rimuovere la voce quando la funzione restituisce `null`.
Versione: Java SE 21
Sintassi
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() indicano lo stesso metodo predefinito dell’interfaccia java.util.Map, disponibile da Java 8. Le parentesi nel nome non indicano una variante senza argomenti: il metodo si chiama su un’istanza della mappa passando una chiave, un valore in ingresso e una funzione di combinazione (BiFunction).
Se la chiave è assente o associata a null, il metodo memorizza e restituisce il valore in ingresso senza chiamare la funzione. Altrimenti, la funzione riceve prima il valore precedente e poi quello in ingresso, non la chiave. Un risultato diverso da null sostituisce il valore precedente e viene restituito. Un risultato null rimuove l’intera voce e il metodo restituisce null.
Né il valore in ingresso né la funzione possono essere null. Se la mappa supporta merge, passare null per uno di questi due argomenti provoca una NullPointerException. Una chiave null è ammessa solo se la mappa la supporta. Su una mappa non modificabile creata con Map.of(), una chiamata a merge lancia sempre una UnsupportedOperationException, anche se il valore in ingresso o la funzione è null.
Se la funzione lancia un’eccezione non controllata, merge la propaga e lascia invariata la voce esistente. La funzione non dovrebbe modificare la stessa mappa durante il calcolo. L’implementazione predefinita non garantisce né la sincronizzazione né l’atomicità; consulta la documentazione dell’implementazione usata.
Per contare, usa Integer::sum: la prima voce parte da 1 e ogni occorrenza successiva della stessa chiave incrementa il contatore. TOTAL è una chiave ordinaria che l’esempio aggiorna con una chiamata separata; non cambia automaticamente quando viene rimossa un’altra voce.
Esempi
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"));
}
}Risultato
apples=2 pears=1 TOTAL=3 merge result=null contains pears=false
`HashMap` consente di associare inizialmente `apples` a `null`, mentre `pears` inizialmente è assente. Entrambi i contatori partono da `1` senza chiamare `Integer::sum`. Alla fine, la funzione che restituisce `null` rimuove `pears`; `containsKey` conferma la rimozione.
Lezioni correlate
- Java · Lezione 56 · Base · Versione: 2
- Java · Lezione 39 · Intermedio · Versione: 2