CKTIS / Java
Map.get — odczyt wartości według klucza
Użyj `map.get(key)`, aby odczytać zapisaną wartość. Jeśli mapa dopuszcza wartości `null`, sam wynik nie pozwala odróżnić braku klucza od wpisu z wartością `null`.
Wersja: Java SE 21
Składnia
V get(Object key); // instance method declared by java.util.Map<K, V>
map.get(key) // call with one key argumentW Java SE 21 Map.get to metoda instancji interfejsu java.util.Map<K, V>: V get(Object key). Zapis Map.get() to skrót nazwy, a nie przeciążenie bez argumentów: wywołaj map.get(key). Metoda zwraca zapisaną wartość albo null, gdy nie ma wpisu. Kontrakt opisuje dopasowanie przez Objects.equals(key, k), gdzie k to zapisany klucz. W HashMap inna instancja równego klucza może znaleźć ten sam wpis. Klucze równe według equals muszą mieć ten sam hashCode; nie zmieniaj cech wpływających na równość klucza, dopóki jest w mapie.
Dla Map<Integer, Long> wyrażenie Long total = totals.get(7); odczytuje wcześniej obliczoną wartość bez rzutowania. Literał 7 ma typ int i przy wywołaniu jest opakowywany do Integer. Zadeklarowany typ parametru to Object, nie K. Surowy Map (bez argumentów typu) zwraca Object. Aby przypisać wynik do String lub Integer, potrzebujesz jawnego rzutowania, np. (String) raw.get(key) lub (Integer) raw.get(key). Niezgodna wartość różna od null powoduje wtedy ClassCastException. Preferuj mapy z argumentami typu.
Jeśli mapa dopuszcza wartości null, get nie odróżnia braku klucza od wpisu z wartością null. Użyj containsKey(key), aby sprawdzić obecność; przy współbieżnych zmianach oba wywołania nie stanowią jednej operacji atomowej. getOrDefault(key, fallback) zwraca fallback tylko przy braku wpisu. Niedozwolony typ klucza może spowodować ClassCastException, a niedozwolony klucz null — NullPointerException, zależnie od implementacji. true i false odczytuj według konkretnych kluczy, bez polegania na kolejności iteracji. Konwersja wyniku null z typu opakowującego do typu prostego, np. Boolean na boolean, powoduje NullPointerException.
W LinkedHashMap z kolejnością według dostępu (accessOrder = true w konstruktorze) trafienie przenosi wpis na koniec kolejności iteracji, nawet gdy wartość to null; brak wpisu nie zmienia kolejności. W trybie kolejności wstawiania get nie zmienia kolejności.
Gdy wiele wątków zapisuje wyniki, użyj np. ConcurrentHashMap, która nie dopuszcza kluczy ani wartości null. Gdy wątek główny pomyślnie zakończy join() dla każdego wątku roboczego, ich zapisy są dla niego widoczne. Odczytuj według rosnących indeksów żądań, aby otrzymać kolejność żądań, a nie kolejność ukończenia. Samo join() nie zabezpiecza wcześniejszych równoczesnych zapisów do zwykłej HashMap.
Przykłady
import java.util.HashMap;
import java.util.LinkedHashMap;
import java.util.Map;
public class MapGetDemo {
record Key(int id) {}
public static void main(String[] args) {
Map<Key, Long> totals = new HashMap<>();
totals.put(new Key(7), 6L * 7);
totals.put(new Key(8), null);
Long total = totals.get(new Key(7));
System.out.println("total: " + total);
for (int id : new int[] {8, 9}) {
Key key = new Key(id);
System.out.println(id + ": " + totals.get(key) + ", present: " + totals.containsKey(key));
}
Map<String, Boolean> flags = Map.of("a", true, "b", false);
System.out.println("flags: " + flags.get("a") + ", " + flags.get("b"));
Map<String, Integer> recent = new LinkedHashMap<>(16, 0.75f, true);
recent.put("a", 1);
recent.put("b", 2);
System.out.println("before: " + recent.keySet());
System.out.println("get a: " + recent.get("a"));
System.out.println("after: " + recent.keySet());
}
}Wynik
total: 42 8: null, present: true 9: null, present: false flags: true, false before: [a, b] get a: 1 after: [b, a]
Nowy `Key(7)` znajduje zapisaną wartość `42`. Dla `8` i `9` metoda `get` zwraca `null`, ale tylko `8` jest w mapie. Flagi są odczytywane jawnie w kolejności `a`, `b`. W ostatniej mapie odczyt `a` zmienia kolejność z `[a, b]` na `[b, a]`.
Powiązane lekcje
- Java · Lekcja 13 · Zaawansowany · Wersja: 2
- Java · Lekcja 17 · Zaawansowany · Wersja: 2
- Java · Lekcja 18 · Zaawansowany · Wersja: 2
- Java · Lekcja 36 · Zaawansowany · Wersja: 2
- Java · Lekcja 35 · Podstawowy · Wersja: 2
- Java · Lekcja 42 · Podstawowy · Wersja: 2
- Java · Lekcja 58 · Podstawowy · Wersja: 2
- Java · Lekcja 40 · Średniozaawansowany · Wersja: 2
- Java · Lekcja 43 · Średniozaawansowany · Wersja: 2
Źródła
- Map (Java SE 21 & JDK 21) — get(Object)
- Map (Java SE 21 & JDK 21) — getOrDefault(Object, V)
- HashMap (Java SE 21 & JDK 21) — get(Object)
- Object (Java SE 21 & JDK 21) — hashCode()
- LinkedHashMap (Java SE 21 & JDK 21)
- ConcurrentHashMap (Java SE 21 & JDK 21) — get(Object)
- Java Language Specification, Java SE 21 — §4.8 Raw Types
- Java Language Specification, Java SE 21 — Chapter 5. Conversions and Contexts
- Java Language Specification, Java SE 21 — §17.4.5 Happens-before Order