Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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 argument

V 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