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 实现。枚举映射中所有键都必须来自单个枚举类型，该枚举类型在创建映射时显式或隐式地指定。枚举映射在内部表示为数组。此表示形式非常紧凑且高效。

枚举映射根据其键的自然顺序 来维护（该顺序是声明枚举常量的顺序）。在 collection 视图（keySet()、entrySet() 和 values()）所返回的迭代器中反映了这一点。

由 collection 视图返回的迭代器是弱一致 的：它们不会抛出 ConcurrentModificationException，也不一定显示在迭代进行时发生的任何映射修改的效果。

不允许使用 null 键。试图插入 null 键将抛出 NullPointerException。但是，试图测试是否出现 null 键或移除 null 键将不会抛出异常。允许使用 null 值。

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

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

实现注意事项：所有基本操作都在固定时间内执行。虽然并不保证，但它们很可能比其 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。

更确切地讲，如果此映射包含满足 (key == k) 的从键 k 到值 v 的映射关系，则此方法返回 v；否则，返回 null。（最多只能有一个这样的映射关系。）

返回 null 值并不 一定 表示此映射不包含此键的映射关系；也可能是映射显式地将此键映射到了 null。containsKey 操作可以用于区分这两种情况。

指定者：

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

覆盖：

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

参数：

key - 要返回其关联值的键

返回：

指定键所映射的值；如果此映射不包含该键的映射关系，则返回 null

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

remove

public V remove(Object key)

从此映射中移除该键的映射关系（如果存在）。

指定者：

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

覆盖：

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

参数：

key - 其映射关系要从映射中移除的键

返回：

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

putAll

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

将指定映射中所有映射关系复制到此映射中。这些映射关系将替换此映射目前针对指定映射的所有键的所有映射关系。

指定者：

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

覆盖：

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

参数：

m - 存储在此映射中的映射关系

抛出：

NullPointerException - 如果指定映射为 null，或指定映射中一个或多个键为 null

clear

public void clear()

从此映射中移除所有映射关系。

指定者：

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

覆盖：

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

keySet

public Set<K> keySet()

返回此映射中所包含键的 Set 视图。 返回的 set 遵守 Map.keySet() 中描述的常规协定。该 set 的迭代器将按其自然顺序返回键（此顺序是声明枚举常量的顺序）。

指定者：

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

覆盖：

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

返回：

此枚举映射所包含键的 set 视图

values

public Collection<V> values()

返回此映射中所包含值的 Collection 视图。返回的 collection 遵守 Map.keySet() 中描述的常规协定。该 collection 的迭代器返回值是按照它们相应的键在映射中出现的顺序返回的，即按照它们的自然顺序（此顺序是声明枚举常量的顺序）。

指定者：

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

覆盖：

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

返回：

此映射中包含的值的 collection 视图

entrySet

public Set<Map.Entry<K,V>> entrySet()

返回此映射中所包含映射关系的 Set 视图。返回的 set 遵守 Map.keySet() 中描述的常规协定。该 set 的迭代器返回映射关系是按照它们的键在映射中出现的顺序返回的，即按照它们的自然顺序（此顺序是声明枚举常量的顺序）。

指定者：

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

指定者：

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

返回：

此枚举映射中包含的映射关系的 set 视图

equals

public boolean equals(Object o)

比较指定对象与此映射的相等性。如果给定对象也是一个映射，并且按照 Map.equals(Object) 协定，两个映射表示的映射关系相同，则返回 true。

指定者：

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

覆盖：

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

参数：

o - 要与此映射比较的对象

返回：

如果指定对象等于此映射，则返回 true

另请参见：

Object.hashCode(), Hashtable

clone

public EnumMap<K,V> clone()

返回此枚举映射的浅表副本。（这些值本身没有复制。）

覆盖：

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

返回：

此枚举映射的浅表副本

另请参见：

Cloneable

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。