Класс EnumMap<K extends Enum<K>,V>

public class EnumMap<K extends Enum<K>,V> extends AbstractMap<K,V> implements Serializable, Cloneable

Специализированная реализация Map для использования с ключами типа перечисления. Все ключи в карте перечислений должны принадлежать одному типу перечисления, который явно или неявно задаётся при создании карты. Карты перечислений представляются внутри как массивы. Такое представление чрезвычайно компактно и эффективно.

Карты перечислений поддерживаются в естественном порядке своих ключей (порядок, в котором объявлены константы перечисления). Это отражается в итераторах, возвращаемых представлениями коллекций (keySet(), entrySet() и values()).

Итераторы, возвращаемые представлениями коллекций, являются слабо согласованными: они никогда не будут выбрасывать ConcurrentModificationException, и они могут или не могут отражать эффекты любых изменений в карте, которые происходят во время итерации.

Ключи со значением null запрещены. Попытки вставить null-ключ вызовут NullPointerException. Однако попытки проверки на наличие null-ключа или удаления его будут работать корректно. Значения null разрешены.

Как и большинство реализаций коллекций, EnumMap не синхронизирована. Если несколько потоков одновременно обращаются к карте перечислений, и хотя бы один из потоков изменяет карту, её необходимо синхронизировать внешним образом. Это обычно достигается путём синхронизации на некотором объекте, который естественным образом инкапсулирует карту перечислений. Если такого объекта не существует, карта должна быть «оборачена» с помощью метода Collections.synchronizedMap(java.util.Map<K, V>). Это лучше всего делать на этапе создания, чтобы предотвратить случайный несинхронизированный доступ:

     Map<EnumKey, V> m
         = Collections.synchronizedMap(new EnumMap<EnumKey, V>(...));
 

Примечание к реализации: все основные операции выполняются за постоянное время. Они, скорее всего (хотя и не гарантируется), будут быстрее, чем их аналоги из HashMap.

Этот класс является членом Java Collections Framework.