CKTIS / Java
Map.get – načtení hodnoty podle klíče
Pomocí `map.get(key)` načteš uloženou hodnotu. Pokud mapa povoluje hodnoty `null`, samotný výsledek nerozliší chybějící klíč od klíče s přiřazenou hodnotou `null`.
Verze: Java SE 21
Syntaxe
V get(Object key); // instance method declared by java.util.Map<K, V>
map.get(key) // call with one key argumentV Java SE 21 je Map.get instanční metoda rozhraní java.util.Map<K, V> s deklarací V get(Object key). Zápis Map.get() je zkratka, nikoli přetížení bez argumentů: volej map.get(key). Metoda vrací uloženou hodnotu, nebo null, pokud záznam pro klíč neexistuje. Kontrakt Map popisuje shodu pomocí Objects.equals(key, k), kde k je uložený klíč. V HashMap může jiná, ale rovná instance klíče najít stejný záznam. Klíče rovné podle equals musí mít stejný hashCode. Neměň vlastnosti ovlivňující rovnost klíče, dokud je klíč v mapě.
U Map<Integer, Long> výraz Long total = totals.get(7); načte dříve vypočtenou hodnotu bez přetypování. Parametr je typu Object, nikoli K. Surový typ Map bez typových argumentů vrací Object. Chceš-li výsledek přiřadit do proměnné typu String nebo Integer, použij explicitní přetypování, například (String) raw.get(key) nebo (Integer) raw.get(key). Přetypování nekompatibilní hodnoty odlišné od null vyvolá ClassCastException. Dávej přednost mapám s typovými argumenty.
Pokud mapa povoluje hodnoty null, get nerozliší chybějící klíč od klíče s hodnotou null. Přítomnost ověř pomocí containsKey(key); při souběžných změnách mapy netvoří obě volání jednu atomickou operaci. getOrDefault(key, fallback) vrátí fallback jen při chybějícím záznamu. Nevhodný typ klíče může podle implementace vyvolat ClassCastException a nepovolený klíč null může vyvolat NullPointerException. Uložené hodnoty true a false načítej podle konkrétních klíčů, bez závislosti na pořadí průchodu mapou. Převod výsledku null z obalového na primitivní typ, například z Boolean na boolean, vyvolá NullPointerException.
V LinkedHashMap s pořadím podle přístupu (accessOrder = true v konstruktoru) přesune úspěšné vyhledání záznam na konec pořadí průchodu, i když má hodnotu null. Pokud záznam chybí, pořadí se nemění. V režimu s pořadím vložení get pořadí nemění.
Pokud výsledky zapisuje více vláken, použij například ConcurrentHashMap, která nepovoluje klíče ani hodnoty null. Jakmile se hlavní vlákno úspěšně vrátí z join() pro každé pracovní vlákno, uvidí jejich zápisy. Výsledky načítej podle vzestupných indexů požadavků, aby byly v pořadí zadání, nikoli dokončení. Samotné join() nezajistí bezpečnost předchozích souběžných zápisů do běžné HashMap.
Příklady
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());
}
}Výsledek
total: 42 8: null, present: true 9: null, present: false flags: true, false before: [a, b] get a: 1 after: [b, a]
Nový `Key(7)` najde uloženou hodnotu `42`. Pro `8` i `9` vrátí `get` hodnotu `null`, ale v mapě je jen `8`. Příznaky se čtou výslovně pro `a` a pak pro `b`. V poslední mapě změní načtení `a` pořadí z `[a, b]` na `[b, a]`.
Související lekce
- Java · Lekce 13 · Pokročilá · Verze: 2
- Java · Lekce 17 · Pokročilá · Verze: 2
- Java · Lekce 18 · Pokročilá · Verze: 2
- Java · Lekce 36 · Pokročilá · Verze: 2
- Java · Lekce 35 · Základní · Verze: 2
- Java · Lekce 42 · Základní · Verze: 2
- Java · Lekce 58 · Základní · Verze: 2
- Java · Lekce 40 · Středně pokročilá · Verze: 2
- Java · Lekce 43 · Středně pokročilá · Verze: 2
Zdroje
- 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