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