CKTIS / Java
Map.merge() : combiner les valeurs d’une clé
Utilisez `Map.merge()` pour enregistrer une valeur initiale, la combiner avec une valeur existante ou supprimer l’entrée si la fonction renvoie `null`.
Version : Java SE 21
Syntaxe
default V merge(K key, V value, BiFunction<? super V, ? super V, ? extends V> remappingFunction)
map.merge(key, value, (oldValue, incomingValue) -> combinedValue)Map.merge et Map.merge() désignent la même méthode par défaut de l’interface java.util.Map, disponible depuis Java 8. Les parenthèses du nom ne désignent pas une version sans argument : la méthode s’appelle sur une instance de la map avec une clé, une valeur entrante et une fonction de combinaison (BiFunction).
Si la clé est absente ou associée à null, la méthode stocke et renvoie la valeur entrante sans appeler la fonction. Sinon, la fonction reçoit d’abord l’ancienne valeur, puis la valeur entrante, et non la clé. Un résultat non nul remplace l’ancienne valeur et est renvoyé. Si la fonction renvoie null, l’entrée entière est supprimée et la méthode renvoie null.
Ni la valeur entrante ni la fonction elle-même ne peuvent être null. Si la map prend en charge merge, passer null pour l’un de ces deux arguments déclenche une NullPointerException. Une clé null n’est admise que si la map l’accepte. Sur une map non modifiable créée avec Map.of(), un appel à merge lève toujours une UnsupportedOperationException, même si la valeur entrante ou la fonction vaut null.
Si la fonction lève une exception non contrôlée, merge la propage et laisse l’entrée existante inchangée. La fonction ne doit pas modifier cette même map pendant le calcul. L’implémentation par défaut ne garantit ni la synchronisation ni l’atomicité ; consultez la documentation de l’implémentation utilisée.
Pour compter, utilisez Integer::sum : la première entrée prend la valeur 1, puis chaque nouvelle occurrence de la même clé incrémente le compteur. TOTAL est une clé ordinaire que l’exemple met à jour par un appel distinct ; sa valeur ne change pas automatiquement lorsqu’une autre entrée est supprimée.
Exemples
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"));
}
}Résultat
apples=2 pears=1 TOTAL=3 merge result=null contains pears=false
`HashMap` permet d’associer initialement `apples` à `null`, tandis que `pears` est absente au départ. Les deux compteurs commencent à `1` sans appel à `Integer::sum`. À la fin, la fonction qui renvoie `null` supprime l’entrée `pears` ; `containsKey` confirme la suppression.
Leçons associées
- Java · Leçon 56 · Débutant · Version : 2
- Java · Leçon 39 · Intermédiaire · Version : 2