База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / Java

Map.get — извличане на стойност по ключ

Използвай `map.get(key)`, за да извлечеш записана стойност. Ако речникът допуска стойности `null`, само по резултата не можеш да различиш липсващ ключ от ключ със стойност `null`.

Версия: Java SE 21

Синтаксис

V get(Object key);  // instance method declared by java.util.Map<K, V>
map.get(key)       // call with one key argument

В Java SE 21 Map.get е метод на екземпляр на интерфейса java.util.Map<K, V> с декларация V get(Object key). Записът Map.get() е съкратено название, а не претоварена версия без аргументи: извикай map.get(key). Методът връща записаната стойност или null, ако няма запис за ключа. Договорът на Map описва съвпадението чрез Objects.equals(key, k), където k е записаният ключ. В HashMap друг, но равен екземпляр на ключа може да намери същия запис. Ключовете, равни според equals, трябва да имат еднакъв hashCode. Не променяй свойствата, които влияят на равенството на ключа, докато той е в речника.

При Map<Integer, Long> изразът Long total = totals.get(7); извлича по-рано изчислена стойност без явно преобразуване на типа. Параметърът е от тип Object, а не K. Суровият тип Map, без аргументи за типовете, връща Object. За да присвоиш резултата на променлива от тип String или Integer, използвай явно преобразуване като (String) raw.get(key) или (Integer) raw.get(key). Преобразуването на несъвместима стойност, различна от null, предизвиква ClassCastException. Предпочитай речници с аргументи за типовете.

Ако речникът допуска стойности null, get не различава липсващ ключ от ключ със стойност null. Провери наличието с containsKey(key); при конкурентни промени в речника двете извиквания не образуват една атомарна операция. getOrDefault(key, fallback) връща fallback само ако няма запис. В зависимост от реализацията неподходящ тип на ключа може да предизвика ClassCastException, а недопустим ключ null — NullPointerException. Извличай записаните стойности true и false по конкретните им ключове, без да разчиташ на реда на обхождане. Разопаковането на резултат null, например от Boolean към boolean, предизвиква NullPointerException.

В LinkedHashMap с ред според достъпа (accessOrder = true в конструктора) успешно търсене премества записа в края на реда на обхождане, дори ако стойността е null. Ако записът липсва, редът не се променя. В режим с ред на добавяне get не променя реда.

Ако няколко нишки записват резултати, използвай например ConcurrentHashMap, която не допуска ключове или стойности null. След като главната нишка успешно се върне от join() за всяка работна нишка, направените от тях записи са видими за нея. Извличай резултатите по възходящ индекс на заявките, за да следваш реда на заявките, а не реда на приключване. join() не прави предходните конкурентни записи в обикновена HashMap безопасни.

Примери

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());
    }
}

Резултат

total: 42
8: null, present: true
9: null, present: false
flags: true, false
before: [a, b]
get a: 1
after: [b, a]

Нов `Key(7)` намира записаната стойност `42`. За `8` и `9` методът `get` връща `null`, но в речника присъства само `8`. Флаговете се извличат изрично за `a`, а след това за `b`. В последния речник прочитането на `a` променя реда от `[a, b]` на `[b, a]`.

Свързани уроци

  • Java · Урок 13 · Напреднало · Версия: 2
  • Java · Урок 17 · Напреднало · Версия: 2
  • Java · Урок 18 · Напреднало · Версия: 2
  • Java · Урок 36 · Напреднало · Версия: 2
  • Java · Урок 35 · Начално · Версия: 2
  • Java · Урок 42 · Начално · Версия: 2
  • Java · Урок 58 · Начално · Версия: 2
  • Java · Урок 40 · Средно · Версия: 2
  • Java · Урок 43 · Средно · Версия: 2

Източници