CKTIS / Java
Map.merge(): waarden voor één sleutel combineren
Gebruik `Map.merge()` om een beginwaarde op te slaan, die met een bestaande waarde te combineren of de vermelding te verwijderen als de functie `null` teruggeeft.
Versie: Java SE 21
Syntax
default V merge(K key, V value, BiFunction<? super V, ? super V, ? extends V> remappingFunction)
map.merge(key, value, (oldValue, incomingValue) -> combinedValue)Map.merge en Map.merge() verwijzen naar dezelfde standaardmethode van de interface java.util.Map, beschikbaar sinds Java 8. De haakjes in de naam betekenen niet dat er een versie zonder argumenten is: je roept de methode aan op een map-instantie met een sleutel, een meegegeven waarde en een combinatiefunctie (BiFunction).
Als de sleutel ontbreekt of aan null gekoppeld is, slaat de methode de meegegeven waarde op en geeft die terug zonder de functie aan te roepen. Anders krijgt de functie eerst de oude waarde en daarna de meegegeven waarde, niet de sleutel. Een resultaat dat niet null is, vervangt de oude waarde en wordt teruggegeven. Bij null wordt de hele vermelding verwijderd en geeft de methode null terug.
De meegegeven waarde en de functie zelf mogen niet null zijn. Als de map merge ondersteunt, leidt null voor een van beide argumenten tot een NullPointerException. Een null-sleutel mag alleen als de map die ondersteunt. Op een niet-wijzigbare map die met Map.of() is gemaakt, gooit een aanroep van merge altijd een UnsupportedOperationException, ook als de meegegeven waarde of de functie null is.
Als de functie een ongecontroleerde uitzondering gooit, geeft merge die door en blijft de bestaande vermelding ongewijzigd. De functie mag dezelfde map tijdens de berekening niet wijzigen. De standaardimplementatie garandeert geen synchronisatie of atomiciteit; raadpleeg de documentatie van je implementatie.
Gebruik Integer::sum om te tellen: de eerste vermelding krijgt de waarde 1 en elke volgende keer dat dezelfde sleutel voorkomt, gaat de teller omhoog. TOTAL is een gewone sleutel die het voorbeeld met een aparte aanroep bijwerkt. Die waarde verandert niet automatisch als je een andere vermelding verwijdert.
Voorbeelden
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"));
}
}Resultaat
apples=2 pears=1 TOTAL=3 merge result=null contains pears=false
Bij een `HashMap` kan `apples` aanvankelijk aan `null` gekoppeld zijn, terwijl `pears` nog ontbreekt. Beide tellers beginnen op `1` zonder aanroep van `Integer::sum`. Aan het eind verwijdert de functie die `null` teruggeeft de vermelding voor `pears`; `containsKey` bevestigt dat.
Gerelateerde lessen
- Java · Les 56 · Basis · Versie: 2
- Java · Les 39 · Gemiddeld · Versie: 2