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