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

CKTIS / Java

Map.containsKey и Map.put: наличие на ключ и стойност null

Провери дали дадена карта съдържа ключ, дори стойността му да е `null`. Виж кога `put` добавя запис или подменя стойността му и как това се различава от условното добавяне.

Версия: Java SE 21

Синтаксис

java.util.Map<K, V> — instance method signatures:
boolean containsKey(Object key)
V put(K key, V value)

Map.containsKey(Object key) връща true, ако картата съдържа запис за ключа, без да променя картата. Договорът на Map определя съвпадението чрез Objects.equals(key, k), където k е съхраненият ключ. В HashMap нов, логически равен ключ съвпада със съществуващия запис. IdentityHashMap умишлено сравнява референциите чрез == вместо това.

В карта, която допуска стойности null, като HashMap, само get(key) == null не различава липсващ запис от запис със стойност null. За да ги разграничиш, използвай containsKey. При неподходящ тип на ключа containsKey може да хвърли ClassCastException, а при недопустим ключ null — NullPointerException.

Map.put(K key, V value) създава запис за липсващ ключ или заменя стойността на съществуващ запис. Връща предишната стойност, а не новата. Резултатът null може да означава, че не е имало запис или че предишната му стойност е била null. put е незадължителна операция: ако картата не я поддържа, извикване, което би променило картата, трябва да хвърли UnsupportedOperationException. Ако извикването не би имало ефект върху картата, реализацията може да хвърли това изключение, но не е длъжна да го прави. Ограниченията за ключове и стойности зависят от реализацията.

За да добавиш запис само ако ключът липсва и да запазиш съществуваща стойност null, използвай if (!map.containsKey(key)) map.put(key, value);. За разлика от тази проверка, putIfAbsent може да замени съществуваща стойност null. Отделните проверка и запис не образуват атомарна операция спрямо други нишки.

Примери

import java.util.HashMap;
import java.util.Map;

public class MapContainsKeyDemo {
    public static void main(String[] args) {
        Map<String, String> map = new HashMap<>();
        String storedKey = new String("task");
        String equalKey = new String("task");
        String missingKey = "other";

        map.put(storedKey, null);

        System.out.println("Same reference: " + (storedKey == equalKey));
        System.out.println("Equal key: contains=" + map.containsKey(equalKey)
                + ", get=" + map.get(equalKey));
        System.out.println("Missing key: contains=" + map.containsKey(missingKey)
                + ", get=" + map.get(missingKey));

        if (!map.containsKey(equalKey)) {
            map.put(equalKey, "default");
        }
        System.out.println("After guarded insert: " + map.get(equalKey));

        System.out.println("Previous value: " + map.put(equalKey, "ready"));
        System.out.println("Current value: " + map.get(storedKey));
        System.out.println("Size: " + map.size());
    }
}

Резултат

Same reference: false
Equal key: contains=true, get=null
Missing key: contains=false, get=null
After guarded insert: null
Previous value: null
Current value: ready
Size: 1

Двата обекта `String` с текст `task` са равни, но имат различни референции. `get` връща `null` както за наличния, така и за липсващия ключ, но `containsKey` връща `true` само за наличния. Условието предотвратява добавянето на стойността по подразбиране. Безусловното `put` връща предишната стойност `null` и записва `ready`, без да увеличава размера на картата.

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

  • Java · Урок 17 · Напреднало · Версия: 2
  • Java · Урок 18 · Напреднало · Версия: 2
  • Java · Урок 39 · Средно · Версия: 2

Източници