Почему HashMap не поддерживает null?

HashMap и null: на самом деле поддерживает!

Уточнение вопроса

Утверждение в вопросе неточное. HashMap на самом деле ДА поддерживает null — и как ключ, и как значение. Но, вероятно, вопрос имеет в виду другие коллекции (ConcurrentHashMap, Hashtable) или идеальную архитектуру.

Лет разберу все аспекты.

HashMap поддерживает null

Map<String, String> map = new HashMap<>();

// Можно использовать null как ключ
map.put(null, "value");  // работает!
System.out.println(map.get(null));  // value

// Можно использовать null как значение
map.put("key", null);  // работает!
System.out.println(map.get("key"));  // null

Почему это работает

В исходном коде HashMap:

public V put(K key, V value) {
    return putVal(hash(key), key, value, false, true);
}

static final int hash(Object key) {
    int h;
    return (key == null) ? 0 : (h = key.hashCode()) ^ (h >>> 16);
}

Заметьте: если key == null, hashCode() не вызывается! Вместо этого используется hashCode = 0.

Коллекции, которые НЕ поддерживают null

1. ConcurrentHashMap

ConcurrentHashMap<String, String> map = new ConcurrentHashMap<>();

// NullPointerException!
map.put(null, "value");

Почему? ConcurrentHashMap для параллельного доступа. Null может создать race conditions и undefined behavior при синхронизации.

2. Hashtable (legacy)

Hashtable<String, String> map = new Hashtable<>();

// NullPointerException!
map.put(null, "value");

Почему? Hashtable — это синхронизированная версия HashMap из Java 1.0. Null был запрещен для безопасности.

3. TreeMap

TreeMap<String, String> map = new TreeMap<>();

// ClassCastException!
map.put(null, "value");

Почему? TreeMap использует Comparator для сортировки. Null не может быть сравнён.

4. Java Stream API

List<Integer> list = Arrays.asList(1, 2, null, 4);

// NullPointerException в .filter()
list.stream().filter(x -> x > 2);

Архитектурные причины избегать null

Хотя HashMap и поддерживает null, это считается плохой практикой:

Проблема 1: Неоднозначность

Map<String, String> map = new HashMap<>();
map.put("user", null);

String value = map.get("user");

if (value == null) {
    // Это значит что:
    // 1. Ключ не существует? ИЛИ
    // 2. Ключ существует, но значение = null?
}

Проблема 2: NullPointerException

Map<String, String> map = new HashMap<>();null
mapmap.put("key1", "value1");
mapmap.put("key2", null);

// Где будет NPE?
for (String value : map.values()) {
    int len = value.length();  // Если value = null, будет NPE!
}

Проблема 3: Неясная семантика

UserRepository repo = new UserRepository();
User user = repo.findById(null);  // что это означает?

Best Practices вместо null

1. Использовать Optional

// Вместо:
Map<String, String> map = new HashMap<>();
map.put("key", null);
String value = map.get("key");  // null?

// Лучше:
Map<String, Optional<String>> map = new HashMap<>();
map.put("key", Optional.empty());
Optional<String> value = map.get("key");

value.ifPresent(v -> System.out.println(v));

2. Использовать дефолтные значения

// Вместо:
map.put("count", null);
Integer count = map.get("count");  // null
if (count == null) count = 0;  // плохо

// Лучше:
Integer count = map.getOrDefault("count", 0);

3. Использовать computeIfAbsent

// Вместо:
if (map.get("key") == null) {
    map.put("key", computeValue());
}

// Лучше:
map.computeIfAbsent("key", k -> computeValue());

4. Явная проверка в API

// Плохо:
public void setName(String name) {
    this.name = name;  // может быть null
}

// Хорошо:
public void setName(String name) {
    Objects.requireNonNull(name, "Name cannot be null");
    this.name = name;
}

// Или с аннотациями (требует инструмента вроде SpotBugs):
public void setName(@NonNull String name) {
    this.name = name;
}

Реальный пример: кэш с null values

// НЕПРАВИЛЬНО: путаница с null
public class Cache<K, V> {
    private Map<K, V> store = new HashMap<>();
    
    public V get(K key) {
        return store.get(key);  // null может означать: нет ключа ИЛИ значение = null
    }
    
    public void put(K key, V value) {
        store.put(key, value);  // value может быть null
    }
}

// ПРАВИЛЬНО: явная семантика
public class Cache<K, V> {
    private Map<K, Optional<V>> store = new HashMap<>();
    
    public Optional<V> get(K key) {
        return store.getOrDefault(key, Optional.empty());
    }
    
    public void put(K key, V value) {
        Objects.requireNonNull(value, "Value cannot be null");
        store.put(key, Optional.of(value));
    }
}

Почему ConcurrentHashMap запретил null

// Проблема с многопоточностью:
ConcurrentHashMap<String, String> map = new ConcurrentHashMap<>();

Thread 1: map.put("key", null);
Thread 2: String val = map.get("key");
         if (val == null) {  // Запаниковал? Или действительно null?
             map.putIfAbsent("key", "default");
         }

// Race condition!
// Невозможно различить: ключ существует с null значением
// vs ключ не существует

Для потокобезопасности нужна атомарность всей операции, что невозможно с null.

Итог

• HashMap ДА поддерживает null (как ключ, так и значение)
• ConcurrentHashMap, Hashtable, TreeMap НЕ поддерживают
• Избегай null в API — используй Optional, значения по умолчанию
• Явная проверка в конструкторах и сеттерах
• Для потокобезопасности null создаёт проблемы
• Best practice: исходить из предположения, что null — ошибка программиста