AbstractMap (Java Platform SE 8 )

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

参数类型

K -钥匙的Map保持型

V -映射的值的类型

All Implemented Interfaces:

Map < k，v >

已知直接子类：

ConcurrentHashMap， ConcurrentSkipListMap， EnumMap， HashMap， IdentityHashMap， TreeMap， WeakHashMap
```
public abstract class AbstractMap<K,V>
extends Object
implements Map<K,V>
```
这个类提供了一个框架实现的 Map接口，用来降低实现该接口的努力。
为了实现一个不可修改的Map，程序员只需要扩展这个类为entrySet方法提供实现，它返回一个集合视图的映射的映射。通常情况下，返回的集合，进而实现在AbstractSet。这集不支持add或remove方法，和它的迭代器不支持remove方法。

为了实现一个可修改的Map，程序员必须重写这个类的put方法（否则抛出一个UnsupportedOperationException），和返回的迭代器的entrySet().iterator()还必须实现其remove方法。

程序员通常提供一个空（无参数）和Map构造，按推荐的Map接口规范。

这个类中的每个非抽象方法的文档都详细描述了它的实现。这些方法可以重写如果Map正在实施的承认，更有效的实现。

这个班的一员 Java Collections Framework。

从以下版本开始：

一点二

另请参见：

Map， Collection

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`static class`	`AbstractMap.SimpleEntry<K,V>` 一个维护一个键和一个值的条目。
`static class`	`AbstractMap.SimpleImmutableEntry<K,V>` 一个保持一个不可改变的键和值的条目。

Nested classes/interfaces inherited from interface java.util.Map
Map.Entry<K,V>

构造方法摘要

构造方法
Modifier	Constructor and Description
`protected`	`AbstractMap()` 唯一的构造函数。

方法摘要

所有方法接口方法抽象方法具体的方法
Modifier and Type	Method and Description
`void`	`clear()` 从这个映射中移除所有的映射（可选操作）。
`protected Object`	`clone()` 返回该 `AbstractMap`实例浅拷贝：键和值本身不是克隆。
`boolean`	`containsKey(Object key)` 返回 `true`如果这Map包含一个指定的键映射。
`boolean`	`containsValue(Object value)` 返回 `true`如果映射到指定的值的一个或多个键。
`abstract Set<Map.Entry<K,V>>`	`entrySet()` 返回一个 `Set`视图的映射包含在这个Map。
`boolean`	`equals(Object o)` 将指定的对象与此映射的相等性进行比较。
`V`	`get(Object key)` 返回指定的键映射的值，或 `null`如果这个Map不包含的键映射。
`int`	`hashCode()` 返回此映射的哈希代码值。
`boolean`	`isEmpty()` 返回 `true`如果这个Map不包含键值的映射。
`Set<K>`	`keySet()` 返回一个 `Set`的关键视图包含在这个Map。
`V`	`put(K key, V value)` 将指定的值与此映射中的指定键关联（可选操作）。
`void`	`putAll(Map<? extends K,? extends V> m)` 从指定的映射到这个Map（可选操作）复制所有的映射。
`V`	`remove(Object key)` 如果存在（可选操作），则从该Map中移除一个键的映射。
`int`	`size()` 返回这个映射中的键值映射的数目。
`String`	`toString()` 返回此映射的字符串表示形式。
`Collection<V>`	`values()` 返回一个 `Collection`的价值观包含在这个Map。

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
  - AbstractMap
```
protected AbstractMap()
```
    唯一的构造函数。（用于调用子类构造函数，通常是隐式的。）
- 方法详细信息
  - size
```
public int size()
```
    返回这个映射中的键值映射的数目。如果Map包含多 Integer.MAX_VALUE元素，返回 Integer.MAX_VALUE。
    
    Specified by:
    
    size 接口 Map<K,V>
    
    实现要求：
    
    此实现返回 entrySet().size()。
    
    结果
    
    在这个映射中的键值映射的数目
  - isEmpty
```
public boolean isEmpty()
```
    返回 true如果这个Map不包含键值的映射。
    
    Specified by:
    
    isEmpty 接口 Map<K,V>
    
    实现要求：
    
    此实现返回 size() == 0。
    
    结果
    
    true如果这个Map不包含键值的映射
  - containsValue
```
public boolean containsValue(Object value)
```
    返回 true如果映射到指定的值的一个或多个键。更正式地说，返回 true当且仅当该Map包含至少一个映射到一个值 v这样 (value==null ? v==null : value.equals(v))。该操作可能需要的时间线在Map的大小对于大多数的 Map接口实现。
    
    Specified by:
    
    containsValue 接口 Map<K,V>
    
    实现要求：
    
    这个实现遍历 entrySet()寻找一个指定的值项。如果找到这样一个条目， true返回。如果迭代终止没有找到这样的条目， false返回。请注意，此实现需要在Map的大小中的线性时间。
    
    参数
    
    在这张Map上 value -它的存在价值进行测试
    
    结果
    
    如果这 true映射到指定的值的一个或多个键
    
    异常
    
    ClassCastException -如果值是此Map不合适的类型（ optional）
    
    NullPointerException -如果指定的值为空，这张Map不允许空值（ optional）
  - containsKey
```
public boolean containsKey(Object key)
```
    返回 true如果这Map包含一个指定的键映射。更正式地说，返回 true当且仅当这个图中包含了一个关键的 k这样 (key==null ? k==null : key.equals(k))映射。（最多可以有一个这样的映射。）
    
    Specified by:
    
    containsKey 接口 Map<K,V>
    
    实现要求：
    
    这个实现遍历 entrySet()寻找一个具有指定键的项。如果找到这样一个条目， true返回。如果迭代终止没有找到这样的条目， false返回。请注意，这种实现需要在Map的大小的线性时间，许多实现将重写此方法。
    
    参数
    
    key键的存在，在这张Map上可以进行测试
    
    结果
    
    true如果这Map包含一个指定的键映射
    
    异常
    
    ClassCastException如果关键是这张图的不恰当的类型（ optional）
    
    NullPointerException -如果指定的键是无效的，这张Map不允许null键（ optional）
  - get
```
public V get(Object key)
```
    返回指定的键映射的值，或 null如果这个Map不包含的键映射。
    更正式地说，如果这个图中包含了从关键k到价值v这样(key==null ? k==null : key.equals(k))，映射这个方法返回v；否则返回null。（最多可以有一个这样的映射。）
    
    如果Map允许空值，那么一个null返回值不必要地表明Map不包含的键映射；也有可能是Map明确地映射到null关键。的containsKey操作可用于区分这两例。
    
    Specified by:
    
    get 接口 Map<K,V>
    
    实现要求：
    
    这个实现遍历 entrySet()寻找一个具有指定键的项。如果找到这样的条目，则返回条目的值。如果迭代终止没有找到这样的条目， null返回。请注意，这种实现需要在Map的大小的线性时间，许多实现将重写此方法。
    
    参数
    
    key -关键的相关值被返回
    
    结果
    
    值，指定的键映射，或 null如果这个Map不包含的键映射
    
    异常
    
    ClassCastException如果关键是这张图的不恰当的类型（ optional）
    
    NullPointerException -如果指定的键是无效的，这张Map不允许null键（ optional）
  - put
```
public V put(K key,
             V value)
```
    将指定的值与此映射中的指定键关联（可选操作）。如果映射以前包含一个键的映射，旧值将被指定的值替换。（图 m说含有一个关键的 k映射当且仅当 m.containsKey(k)将返回 true。）
    
    Specified by:
    
    put 接口 Map<K,V>
    
    实现要求：
    
    这个实现总是抛出一个 UnsupportedOperationException。
    
    参数
    
    key键与指定的值是相关联的
    
    value值必须与指定键关联
    
    结果
    
    与 key以前的值，或者 null如果没有映射的 key。（一 null返回也表明Map以前相关的 null与 key，如果实施支持 null值。）
    
    异常
    
    UnsupportedOperationException -如果 put操作不该Map支持
    
    ClassCastException如果类指定的键或值防止它被存储在这个Map
    
    NullPointerException -如果指定的键或值为空，这张Map不允许null键或值
    
    IllegalArgumentException如果一些属性指定的键或值防止它被存储在这个Map
  - remove
```
public V remove(Object key)
```
    如果存在（可选操作），则从该Map中移除一个键的映射。更正式地说，如果这个图包含一个关键 k价值 v这样 (key==null ? k==null : key.equals(k))映射，映射被删除。（Map最多只能包含一个这样的映射。）
    回到这个Map以前相关的关键字的值，或null如果Map中没有包含的键映射。
    
    如果Map允许空值，那么一个null返回值不必要地表明Map中没有包含的键映射；也有可能是Map明确地映射到null关键。
    
    一旦调用返回的映射将不包含指定的键的映射。
    
    Specified by:
    
    remove 接口 Map<K,V>
    
    实现要求：
    
    这个实现遍历 entrySet()寻找一个具有指定键的项。如果找到这样一个条目，它的价值是与它的 getValue操作得到，入口是从集合中移除（和支持Map）和迭代器的 remove操作，和保存的返回值。如果迭代终止没有找到这样的条目， null返回。请注意，这种实现需要在Map的大小的线性时间，许多实现将重写此方法。
    请注意，此实现抛出一个UnsupportedOperationException如果entrySet迭代器不支持remove方法以及该Map包含一个指定的键映射。
    
    参数
    
    key键的映射是从Map上移除
    
    结果
    
    与 key以前的值，或者 null如果没有映射的 key。
    
    异常
    
    UnsupportedOperationException -如果 remove操作不该Map支持
    
    ClassCastException如果关键是这张图的不恰当的类型（ optional）
    
    NullPointerException -如果指定的键是无效的，这张Map不允许null键（ optional）
  - putAll
```
public void putAll(Map<? extends K,? extends V> m)
```
    从指定的映射到这个Map（可选操作）复制所有的映射。这个函数调用的效果相当，叫 put(k, v)这Map上的每一次关键 k映射中指定的值 v。当操作正在进行中时，此操作的行为是未定义的，如果指定的映射被修改的。
    
    Specified by:
    
    putAll 接口 Map<K,V>
    
    实现要求：
    
    这个实现遍历指定Map的 entrySet()收集，并称该Map的 put操作每一次进入迭代返回。
    请注意，此实现抛出一个UnsupportedOperationException如果这个Map不支持put运行指定的Map是空的。
    
    参数
    
    m映射被存储在这个Map
    
    异常
    
    UnsupportedOperationException -如果 putAll操作不该Map支持
    
    ClassCastException -如果指定Map的键或值班防止它被存储在这个Map
    
    NullPointerException -如果指定的映射是零，或者如果这个Map不允许null键或值，并指定Map包含null键或值
    
    IllegalArgumentException -如果指定Map键和值的一些性质防止它被存储在这个Map
  - clear
```
public void clear()
```
    从这个映射中移除所有的映射（可选操作）。这个调用返回后的Map将是空的。
    
    Specified by:
    
    clear 接口 Map<K,V>
    
    实现要求：
    
    这要求执行 entrySet().clear()。
    请注意，此实现抛出一个UnsupportedOperationException如果entrySet不支持clear操作。
    
    异常
    
    UnsupportedOperationException -如果 clear操作不该Map支持
  - keySet
```
public Set<K> keySet()
```
    返回一个 Set的关键视图包含在这个Map。该集合是由Map的支持，所以对Map的变化反映在集合中，反之亦然。如果Map是在设置一个迭代过程中修改（除非通过迭代器的 remove操作），迭代的结果是不确定的。设置支持元素的去除，从Map中移除相应的映射，通过 Iterator.remove， Set.remove， removeAll， retainAll，和 clear操作。它不支持 add或 addAll操作。
    
    Specified by:
    
    keySet 接口 Map<K,V>
    
    实现要求：
    
    此实现返回一个集合，子类 AbstractSet。子类的方法返回的迭代器在这个Map的 entrySet()迭代器“包装物”。的 size方法代表这Map的 size法和 contains方法代表这Map的 containsKey方法。
    该组创建第一次这种方法被调用，并响应于所有后续调用返回。没有执行同步，所以有一个轻微的机会，多个调用此方法将不会全部返回相同的集合。
    
    结果
    
    在这个Map中包含的键的一个集合视图
  - values
```
public Collection<V> values()
```
    返回一个 Collection视图的值包含在这个Map。集合是由Map支持的，所以对Map的变化反映在集合中，反之亦然。如果Map是在集合的迭代进行修改（除非通过迭代器的 remove操作），迭代的结果是不确定的。收集支持元素的去除，从Map中移除相应的映射，通过 Iterator.remove， Collection.remove， removeAll， retainAll和 clear操作。它不支持 add或 addAll操作。
    
    Specified by:
    
    values 接口 Map<K,V>
    
    实现要求：
    
    此实现返回一个集合的子类 AbstractCollection。子类的方法返回的迭代器在这个Map的 entrySet()迭代器“包装物”。的 size方法代表这Map的 size法和 contains方法代表这Map的 containsValue方法。
    该集合创建第一次这种方法被调用，并响应于所有后续调用返回。没有执行同步，所以有一个轻微的机会，多个调用此方法将不全部返回相同的集合。
    
    结果
    
    一个包含在这个Map中的值的集合视图
  - entrySet
```
public abstract Set<Map.Entry<K,V>> entrySet()
```
    从接口复制的描述： Map
    
    返回一个 Set视图的映射包含在这个Map。该集合是由Map的支持，所以对Map的变化反映在集合中，反之亦然。如果Map是在设置一个迭代过程中修改（除非通过迭代器的 remove操作，或通过 setValue操作返回的迭代器的映射项）的迭代的结果是不确定的。设置支持元素的去除，从Map中移除相应的映射，通过 Iterator.remove， Set.remove， removeAll， retainAll和 clear操作。它不支持 add或 addAll操作。
    
    Specified by:
    
    entrySet 接口 Map<K,V>
    
    结果
    
    映射中包含的映射的一个集合视图
  - equals
```
public boolean equals(Object o)
```
    将指定的对象与此映射的相等性进行比较。返回 true如果给定的对象也是一个Map和两图表示相同的映射。更正式地说，两个Map m1和 m2表示相同的映射，如果 m1.entrySet().equals(m2.entrySet())。这确保了 equals方法正常工作在 Map接口的不同实现。
    
    Specified by:
    
    equals 接口 Map<K,V>
    
    重写：
    
    equals 方法重写，继承类 Object
    
    实现要求：
    
    这种实现首先检查指定的对象是这个Map；如果它返回 true。然后，它会检查指定对象是否是一个Map的大小是这个Map的大小相同；如果没有，则返回 false。如果是这样的话，它遍历该图的 entrySet收集和检查指定的Map，该Map包含包含每个映射。如果指定的Map不包含这样的映射， false返回。如果迭代中完成的， true返回。
    
    参数
    
    o对象进行比较，这张Map的平等
    
    结果
    
    true指定对象是否等于这个Map
    
    另请参见：
    
    Object.hashCode()， HashMap
  - hashCode
```
public int hashCode()
```
    返回此映射的哈希代码值。一个Map的哈希码是指在Map的 entrySet()查看每个条目的散列码的总和。这确保 m1.equals(m2)意味着 m1.hashCode()==m2.hashCode()任何两图 m1和 m2，按照总承包 Object.hashCode()。
    
    Specified by:
    
    hashCode 接口 Map<K,V>
    
    重写：
    
    hashCode 方法重写，继承类 Object
    
    实现要求：
    
    这 entrySet()实现遍历，对每个元素调用 hashCode()（进入）的设定，并加入了结果。
    
    结果
    
    此映射的哈希代码值
    
    另请参见：
    
    Map.Entry.hashCode()， Object.equals(Object)， Set.equals(Object)
  - toString
```
public String toString()
```
    返回此映射的字符串表示形式。的字符串表示形式由以键值对映射关系表的映射的 entrySet视图返回的迭代器，括在大括号（ "{}"）。相邻的映射是由字符 ", "隔开（逗号和空格）。每个键值映射呈现为关键的后面紧跟一个等号（ "="）其次是相关的价值。键和值转换为字符串的 String.valueOf(Object)。
    
    重写：
    
    toString 方法重写，继承类 Object
    
    结果
    
    这个Map的一个字符串表示
  - clone
```
protected Object clone()
                throws CloneNotSupportedException
```
    返回该 AbstractMap实例浅拷贝：键和值本身不是克隆。
    
    重写：
    
    clone 方法重写，继承类 Object
    
    结果
    
    这张Map的浅本
    
    异常
    
    CloneNotSupportedException -如果对象的类不支持 Cloneable接口。子类重写 clone方法也抛出该异常表示实例无法克隆。
    
    另请参见：
    
    Cloneable

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.

Class AbstractMap<K,V>

Nested Class Summary

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

构造方法摘要

方法摘要

Methods inherited from class java.lang.Object

Methods inherited from interface java.util.Map

Constructor Detail

AbstractMap

方法详细信息

size

isEmpty

containsValue

containsKey

get

put

remove

putAll

clear

keySet

values

entrySet

equals

hashCode

toString

clone