CKTIS / Java
java.util.Map — odwzorowanie kluczy na wartości
Map<K,V> przypisuje każdemu kluczowi najwyżej jedną wartość. Poznaj odczyt, aktualizację, obliczanie wartości oraz widoki mapy, ze szczególnym uwzględnieniem null i gwarancji implementacji.
Wersja: Java SE 21; repository runtime, production runtime not attested
Składnia
Map<K, V> map = new HashMap<>();java.util.Map<K,V> to interfejs odwzorowania kluczy na wartości; wartości mogą się powtarzać. HashMap nie gwarantuje kolejności, a TreeMap porządkuje klucze. Obsługa null zależy od implementacji. Nie zmieniaj klucza w sposób wpływający na jego porównywanie podczas przechowywania w mapie.
Map.put(k, v) dodaje lub zastępuje wartość i zwraca poprzednią; Map.remove(k) usuwa wpis i zwraca starą wartość. Obie metody zwracają null także przy braku wpisu. Map.get(k) zwraca wartość albo null; Map.containsKey(k) rozróżnia brak wpisu od przypisanego null. Map.getOrDefault(k, d) zwraca d tylko przy braku wpisu, nie zamiast przypisanego null. Map.size() liczy wpisy; Map.containsValue(v) sprawdza obecność wartości.
Map.compute(k, f) przekazuje funkcji klucz i obecną wartość lub null; wynik null usuwa wpis albo pozostawia jego brak. Map.computeIfAbsent(k, f) wywołuje funkcję przy braku wpisu lub wartości null; zapisuje wynik, jeśli jest różny od null. Zapisze więc również pusty ciąg znaków lub pustą kolekcję, jeśli funkcja zwróci taką wartość. Map.merge(k, v, f) wymaga v != null: dla braku wpisu lub wartości null zapisuje v, inaczej łączy starą wartość z v; wynik null usuwa wpis.
Map.keySet() udostępnia zbiór kluczy, Map.values() kolekcję wartości, a Map.entrySet() zbiór par Map.Entry<K,V>. To widoki powiązane z mapą, nie kopie; usuwanie przez widok usuwa wpis, jeśli operacja jest obsługiwana. Map.forEach(action) odwiedza każdą parę.
Operacje modyfikujące mogą zgłosić UnsupportedOperationException. Funkcje obliczające nie powinny modyfikować tej samej mapy. Domyślne metody Map nie gwarantują atomowości ani synchronizacji. Przykład używa TreeMap, aby wynik miał stałą kolejność.
Przykłady
import java.util.Map;
import java.util.TreeMap;
public class Main {
public static void main(String[] args) {
Map<String, Integer> counts = new TreeMap<>();
counts.put("pear", 1);
counts.merge("pear", 2, Integer::sum);
counts.computeIfAbsent("apple", key -> 1);
counts.compute("apple", (key, value) -> value + 1);
System.out.println(counts.get("pear"));
System.out.println(counts.getOrDefault("plum", 0));
System.out.println(counts.containsKey("plum"));
System.out.println(counts.containsValue(2));
System.out.println(counts.size());
System.out.println(counts.keySet());
System.out.println(counts.values());
System.out.println(counts.entrySet());
counts.forEach((key, value) -> System.out.println(key + ":" + value));
System.out.println(counts.remove("pear"));
System.out.println(counts.size());
}
}Wynik
3 0 false true 2 [apple, pear] [2, 3] [apple=2, pear=3] apple:2 pear:3 3 1
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.