Класс 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.