compact1, compact2, compact3

java.util

Class EnumMap<K extends Enum<K>,V>

java.lang.Object

java.util.AbstractMap<K,V>

java.util.EnumMap<K,V>

All Implemented Interfaces:

Serializable， Cloneable， Map < k，v >

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

一种用于枚举类型键实现专业 Map。所有在一个枚举Map钥匙必须来自一个枚举类型，指定显式或隐式，当Map创建。枚举映射在内部表示为阵列。这种表示是非常紧凑和有效的。

枚举映射保持键的自然秩序（即枚举常量的声明顺序）。这反映在迭代器的集合视图中返回（keySet()，entrySet()，和values()）。

返回的迭代器的集合视图是弱一致的：他们不会扔ConcurrentModificationException他们可能或不可能的发生的同时，迭代过程中Map的任何修改的影响。

不允许空键。试图插入一个空键会把NullPointerException。尝试测试一个空键的存在或删除一个将，但是，功能正常。允许空值。

最喜欢收集实现EnumMap不同步。如果多个线程同时访问一个枚举的Map，并至少有一个线程修改的Map，它应该是同步的外部。这通常是通过同步的一些对象，自然封装枚举图完成。如果该对象不存在，Map应该是“包裹”使用Collections.synchronizedMap(java.util.Map<K, V>)方法。最好的做法是在创建时，防止意外的同步访问：

图< enumkey，V＞M=收藏。synchronizedmap（新的EnumMap < enumkey，V >（…））；

执行说明：所有基本的操作都在固定的时间内执行。他们有可能（但不保证）会比他们的HashMap更快。

这个班的一员 Java Collections Framework。

从以下版本开始：

一点五

另请参见：

EnumSet， Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class java.util.AbstractMap

AbstractMap.SimpleEntry<K,V>, AbstractMap.SimpleImmutableEntry<K,V>

Nested classes/interfaces inherited from interface java.util.Map

Map.Entry<K,V>

构造方法摘要

构造方法

Constructor and Description
EnumMap(类<K> keyType) 创建一个具有指定键型空枚举图。
EnumMap(EnumMap<K,? extends V> m) 创建与指定枚举图相同的密钥类型的枚举图，最初包含相同的映射（如果有的话）。
EnumMap(Map<K,? extends V> m) 创建一个枚举Map初始化指定的Map。

方法摘要

Modifier and Type	Method and Description
void	clear() 从这个映射中移除所有的映射。
EnumMap<K,V>	clone() 返回此枚举图浅拷贝。
boolean	containsKey(Object key) 返回 true如果这Map包含一个指定的键映射。
boolean	containsValue(Object value) 返回 true如果映射到指定的值的一个或多个键。
Set<Map.Entry<K,V>>	entrySet() 返回一个 Set视图的映射包含在这个Map。
boolean	equals(Object o) 将指定的对象与此映射的相等性进行比较。
V	get(Object key) 返回指定的键映射的值，或 null如果这个Map不包含的键映射。
int	hashCode() 返回此映射的哈希代码值。
Set<K>	keySet() 返回一个 Set的关键视图包含在这个Map。
V	put(K key, V value) 将指定的值与此映射中的指定键关联。
void	putAll(Map<? extends K,? extends V> m) 从指定的映射到该Map的所有映射。
V	remove(Object key) 如果存在的话，从这个映射中移除这个键的映射。
int	size() 返回这个映射中的键值映射的数目。
Collection<V>	values() 返回一个 Collection的价值观包含在这个Map。

Methods inherited from class java.util.AbstractMap

isEmpty, toString

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface java.util.Map

compute, computeIfAbsent, computeIfPresent, forEach, getOrDefault, merge, putIfAbsent, remove, replace, replace, replaceAll

Constructor Detail

EnumMap

public EnumMap(类<K> keyType)

创建一个具有指定键型空枚举图。

参数

keyType -该枚举类型的类对象图的关键

异常

NullPointerException -如果 keyType是空的

EnumMap

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

创建与指定枚举图相同的密钥类型的枚举图，最初包含相同的映射（如果有的话）。

参数

m -从初始化这个枚举枚举MapMap

异常

NullPointerException -如果 m是空的

EnumMap

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

创建一个枚举Map初始化指定的Map。如果指定的Map是一个 EnumMap实例，这个构造函数的行为与 EnumMap(EnumMap)。否则，指定的Map必须包含至少一个映射（为了确定新的枚举映射的键类型）。

参数

m -从初始化这个枚举的Map

异常

IllegalArgumentException -如果 m不是 EnumMap实例不包含映射

NullPointerException -如果 m是空的

方法详细信息

size

public int size()

返回这个映射中的键值映射的数目。

Specified by:

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

重写：

size 方法重写，继承类 AbstractMap<K extends Enum<K>,V>

结果

在这个映射中的键值映射的数目

containsValue

public boolean containsValue(Object value)

返回 true如果映射到指定的值的一个或多个键。

Specified by:

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

重写：

containsValue 方法重写，继承类 AbstractMap<K extends Enum<K>,V>

参数

value -其在Map上的存在是被测试的价值

结果

如果这 true映射到该值的一个或多个键

containsKey

public boolean containsKey(Object key)

返回 true如果这Map包含一个指定的键映射。

Specified by:

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

重写：

containsKey 方法重写，继承类 AbstractMap<K extends Enum<K>,V>

参数

key -关键的在这个Map的存在是进行测试

结果

true如果这Map包含一个指定的键映射

get

public V get(Object key)

返回指定的键映射的值，或 null如果这个Map不包含的键映射。

更正式地说，如果这个图中包含了从关键k到价值v这样(key == k)映射，那么这个方法返回v；否则返回null。（最多可以有一个这样的映射。）

一个null返回值不必要地表明Map不包含的键映射；也有可能是Map明确地映射到null的关键，containsKey操作可用于区分这两例。

Specified by:

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

重写：

get 方法重写，继承类 AbstractMap<K extends Enum<K>,V>

参数

key -关键的相关值被返回

结果

值，指定的键映射，或 null如果这个Map不包含的键映射

put

public V put(K key,
             V value)

将指定的值与此映射中的指定键关联。如果映射先前包含此键的映射，旧值将被替换。

Specified by:

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

重写：

put 方法重写，继承类 AbstractMap<K extends Enum<K>,V>

参数

key -键与指定的值是相关联的

value要与指定的键相关联的值

结果

与指定的键相关联的前一个值，或 null如果没有映射的关键。（一 null返回也表明Map以前相关的 null具有指定键。）

异常

NullPointerException -如果指定的键是空的

remove

public V remove(Object key)

如果存在的话，从这个映射中移除这个键的映射。

Specified by:

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

重写：

remove 方法重写，继承类 AbstractMap<K extends Enum<K>,V>

参数

key -关键的映射是从Map上移除

结果

与指定的键相关联的前一个值，或 null如果有没有进入关键。（一 null返回也表明，此前相关的Map null具有指定键。）

putAll

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

从指定的映射到该Map的所有映射。这些映射将取代当前在指定Map中的任何键的任何映射。

Specified by:

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

重写：

putAll 方法重写，继承类 AbstractMap<K extends Enum<K>,V>

参数

m将存储在这个Map的映射

异常

NullPointerException -指定的Map是无效的，或者在指定的Map的一个或多个键无效

clear

public void clear()

从这个映射中移除所有的映射。

Specified by:

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

重写：

clear 方法重写，继承类 AbstractMap<K extends Enum<K>,V>

keySet

public Set<K> keySet()

返回一个 Set的关键视图包含在这个Map。返回的集合服从总承包 Map.keySet()概述。集合的迭代器将在他们的自然顺序返回键（即枚举常量的声明顺序）。

Specified by:

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

重写：

keySet 方法重写，继承类 AbstractMap<K extends Enum<K>,V>

结果

一组视图的关键包含在这个枚举图

values

public Collection<V> values()

返回一个 Collection的价值观包含在这个Map。返回的集合服从总承包 Map.values()概述。集合的迭代器返回的值的顺序对应的键出现在Map，这是他们的自然秩序（即枚举常量的声明顺序）。

Specified by:

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

重写：

values 方法重写，继承类 AbstractMap<K extends Enum<K>,V>

结果

一个包含在这个Map中的值的集合视图

entrySet

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

返回一个 Set视图的映射包含在这个Map。返回的集合服从总承包 Map.keySet()概述。集合的迭代器返回的顺序钥匙出现在Map的映射，这是他们的自然秩序（即枚举常量的声明顺序）。

Specified by:

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

Specified by:

entrySet 方法重写，继承类 AbstractMap<K extends Enum<K>,V>

结果

一组视图的映射包含在这个枚举图

equals

public boolean equals(Object o)

将指定的对象与此映射的相等性进行比较。返回 true如果给定的对象也是一个Map和两图表示相同的映射，如在合同规定的 Map.equals(Object)。

Specified by:

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

重写：

equals 方法重写，继承类 AbstractMap<K extends Enum<K>,V>

参数

o -是比较平等的对象与此图

结果

true指定对象是否等于这个Map

另请参见：

Object.hashCode()， HashMap

hashCode

public int hashCode()

返回此映射的哈希代码值。映射的哈希代码被定义为在Map中的每个条目的哈希代码的总和。

Specified by:

hashCode 接口 Map<K extends Enum<K>,V>

重写：

hashCode 方法重写，继承类 AbstractMap<K extends Enum<K>,V>

结果

此映射的哈希代码值

另请参见：

Map.Entry.hashCode()， Object.equals(Object)， Set.equals(Object)

clone

public EnumMap<K,V> clone()

返回此枚举图浅拷贝。（他们的价值观没有被克隆。

重写：

clone 方法重写，继承类 AbstractMap<K extends Enum<K>,V>

结果

该枚举图浅拷贝

另请参见：

Cloneable