Java java.util 类 EnumMap<K extends Enum<K>,V>（JDK5）

所有类

java.util
类 EnumMap<K extends Enum<K>,V>

java.lang.Object
  java.util.AbstractMap<K,V>
      java.util.EnumMap<K,V>

所有已实现的接口：

Serializable, Cloneable, Map<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 键将不会抛出异常。允许使用 null 值。

像大多数集合一样，EnumMap 是不同步的。如果多个线程同时访问一个枚举映射，并且至少有一个线程修改该映射，则此枚举映射在外部应该是同步的。这一般通过对自然封装该枚举映射的某个对象进行同步来完成。如果不存在这样的对象，则应该使用 Collections.synchronizedMap(java.util.Map ) 方法来“包装”该枚举。最好在创建时完成这一操作，以防止意外的非同步访问：

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

实现注意事项：所有基本操作都在固定时间内执行。虽然并不保证，但它们很可能比其 HashMap 副本更快。

此类是 Java Collections Framework 的成员。

从以下版本开始：

1.5

另请参见：

EnumSet, 序列化表格

EnumMap

public EnumMap(Class<K> keyType)

创建一个具有指定键类型的空枚举映射。

参数：

keyType - 此枚举映射的键类型的 class 对象

抛出：

NullPointerException - 如果 keyType 为空

EnumMap

public EnumMap(EnumMap<K,? extends V> m)

创建一个其键类型与指定枚举映射相同的枚举映射，最初包含相同的映射关系（如果有的话）。

参数：

m - 用于初始化此枚举映射的枚举映射

抛出：

NullPointerException - 如果 m 为空

EnumMap

public EnumMap(Map<K,? extends V> m)

创建一个枚举映射，从指定映射对其初始化。如果指定的映射是一个 EnumMap 实例，则此构造方法的功能与 EnumMap(EnumMap) 相同。否则，指定的映射必须至少包含一个映射关系（以确定新枚举映射的键类型）。

参数：

m - 用于初始化此枚举映射的映射

抛出：

IllegalArgumentException - 如果 m 不是一个 EnumMap 实例，并且不包含映射关系

NullPointerException - 如果 m 为空

size

public int size()

返回此映射中的键-值映射关系数。

指定者：

接口 Map<K extends Enum<K>,V> 中的 size

覆盖：

类 AbstractMap<K extends Enum<K>,V> 中的 size

返回：

此映射中的键-值映射关系数。

containsValue

public boolean containsValue(Object value)

如果此映射将一个或多个键映射到指定值，则返回 true。

指定者：

接口 Map<K extends Enum<K>,V> 中的 containsValue

覆盖：

类 AbstractMap<K extends Enum<K>,V> 中的 containsValue

参数：

value - 将要在此映射中测试其是否存在的值

返回：

如果此映射将一个或多个键映射到此值，则返回 true

containsKey

public boolean containsKey(Object key)

如果此映射包含指定键的映射关系，则返回 true。

指定者：

接口 Map<K extends Enum<K>,V> 中的 containsKey

覆盖：

类 AbstractMap<K extends Enum<K>,V> 中的 containsKey

参数：

key - 将要在此映射中测试其是否存在的键

返回：

如果此映射包含指定键的映射关系，则返回 true

get

public V get(Object key)

返回此映射将指定键映射到的值，如果此映射不包含指定键的映射关系，则返回 null。

指定者：

接口 Map<K extends Enum<K>,V> 中的 get

覆盖：

类 AbstractMap<K extends Enum<K>,V> 中的 get

参数：

key - 与其关联的值将要返回的键

返回：

此映射要将指定键映射到的值，如果此映射不包含指定键的映射关系，则返回 null

另请参见：

AbstractMap.containsKey(Object)

put

public V put(K key,
             V value)

将指定值与此映射中指定键关联。如果该映射以前包含此键的映射关系，则将原值替换。

指定者：

接口 Map<K extends Enum<K>,V> 中的 put

覆盖：

类 AbstractMap<K extends Enum<K>,V> 中的 put

参数：

key - 指定值与其关联的键

value - 与指定键关联的值

返回：

与指定键关联的旧值，如果不存在该键的映射关系，则返回 null。（返回 null 还可能表明以前该映射将 null 与指定键关联。）

抛出：

NullPointerException - 如果指定键为 null