Map

clear

void clear ()

从该映射中删除所有映射（可选操作）。 此通话返回后，地图将为空。

compute

V compute (K key, 
                BiFunction<? super K, ? super V, ? extends V> remappingFunction)

尝试计算指定键和其当前映射值的映射（如果没有当前映射， null ）。 例如，要将String msg创建或附加到值映射：

 map.compute(key, (k, v) -> (v == null) ? msg : v.concat(msg))

如果重新映射函数返回null ，映射将被删除（如果最初不存在，则保持不存在）。 如果重映射函数本身抛出一个（未经检查的）异常，则重新抛出异常，并且当前映射保持不变。

重新映射函数不应该在计算过程中修改此映射。

computeIfAbsent

V computeIfAbsent (K key, 
                Function<? super K, ? extends V> mappingFunction)

如果指定的键尚未与值关联（或映射到 null ），则尝试使用给定的映射函数计算其值，并将其输入到此映射中，除非 null 。

如果映射函数返回null ，则不记录映射。 如果映射函数本身抛出（未经检查的）异常，则重新抛出异常，并且不记录映射。 最常见的用法是构造一个新的对象作为初始映射值或记忆结果，如下所示：

 map.computeIfAbsent(key, k -> new Value(f(k)));
 

或者实现一个多值映射， Map<K,Collection<V>> ，每个键支持多个值：

 map.computeIfAbsent(key, k -> new HashSet<V>()).add(v);
 

计算过程中映射函数不应修改此映射。

computeIfPresent

V computeIfPresent (K key, 
                BiFunction<? super K, ? super V, ? extends V> remappingFunction)

如果指定键的值存在且非空，则尝试计算给定键和其当前映射值的新映射。

如果重映射函数返回null ，则映射将被删除。 如果重映射函数本身抛出一个（未经检查的）异常，则重新抛出异常，并且当前映射保持不变。

重新映射函数不应该在计算过程中修改此映射。

containsKey

boolean containsKey (Object key)

如果此映射包含指定键的映射，则返回true 。 更正式地，返回true当且仅当该映射包含关键字k的映射，例如Objects.equals(key, k) 。 （最多可以有一个这样的映射。）

containsValue

boolean containsValue (Object value)

如果此映射将一个或多个键映射到指定值，则返回true 。 更正式地，返回true当且仅当该映射包含至少一个映射到值v例如Objects.equals(value, v) 。 对于Map接口的大多数实现，此操作可能需要时间线性地图大小。

entrySet

Set<Entry<K, V>> entrySet ()

返回此映射中包含的映射的Set视图。 该集合由地图支持，因此对地图的更改反映在集合中，反之亦然。 如果在对集合进行迭代时修改了映射（除了通过迭代器自己的remove操作或通过迭代器返回的映射条目上的setValue操作），迭代的结果是未定义的。 该组支持元件移除，即从映射中相应的映射，经由Iterator.remove ， Set.remove ， removeAll ， retainAll和clear操作。 它不支持add或addAll操作。

equals

boolean equals (Object o)

将指定的对象与此映射进行比较以获得相等性。 如果给定的对象也是一个映射，并且这两个映射表示相同的映射，则返回true 。 更正式地说，两个映射m1和m2代表相同的映射，如果是m1.entrySet().equals(m2.entrySet()) 。 这确保了equals方法可以在Map接口的不同实现中正常工作。

forEach

void forEach (BiConsumer<? super K, ? super V> action)

对此映射中的每个条目执行给定操作，直到处理完所有条目或操作抛出异常为止。 除非实现类另有规定，否则按照条目集迭代的顺序执行操作（如果指定了迭代顺序）。操作抛出的异常会中继给调用者。

get

V get (Object key)

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

更正式地说，如果这个映射包含从键k到值v的映射，例如Objects.equals(key, k) ，则该方法返回v ; 否则返回null 。 （最多可以有一个这样的映射。）

如果此映射允许空值，则返回值null 不一定表示映射不包含该键的映射; 地图也可能将键明确映射到null 。 containsKey操作可用于区分这两种情况。

getOrDefault

V getOrDefault (Object key, 
                V defaultValue)

返回指定键映射到的值 defaultValue如果此映射不包含键映射，则返回 defaultValue 。

hashCode

int hashCode ()

返回此映射的哈希码值。 地图的哈希码定义为地图entrySet()视图中每个条目的哈希码的总和。 这确保m1.equals(m2)意味着m1.hashCode()==m2.hashCode()对于任何两个地图m1和m2 ，如m2的一般合同所要求的hashCode() 。

isEmpty

boolean isEmpty ()

如果此映射不包含键 - 值映射，则返回 true 。

keySet

Set<K> keySet ()

返回此映射中包含的键的Set视图。 该集合由地图支持，因此对地图的更改反映在集合中，反之亦然。 如果在对集合进行迭代的过程中修改了映射（除了通过迭代器自己的remove操作），迭代的结果是未定义的。 该组支持元件移除，即从映射中相应的映射，经由Iterator.remove ， Set.remove ， removeAll ， retainAll ，和clear操作。 它不支持add或addAll操作。

merge

V merge (K key, 
                V value, 
                BiFunction<? super V, ? super V, ? extends V> remappingFunction)

如果指定的键尚未与某个值关联或者与null关联，则将其与给定的非空值相关联。 否则，用给定的重映射函数的结果替换关联的值，或者如果结果为null ，则将其删除。 组合键的多个映射值时，此方法可能会有用。 例如，要创建或附加一个String msg到值映射：

 map.merge(key, msg, String::concat)
 

如果重映射函数返回null ，则映射将被删除。 如果重映射函数本身抛出一个（未经检查的）异常，则重新抛出异常，并且当前映射保持不变。

重新映射函数不应该在计算过程中修改此映射。

put

V put (K key, 
                V value)

将指定的值与此映射中指定的键关联（可选操作）。 如果映射先前包含该键的映射，则旧值由指定值替换。 （当且仅当m.containsKey(k)将返回true地图m被认为包含密钥k的映射。）

putAll

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

将指定映射中的所有映射复制到此映射（可选操作）。 此调用的效果等同于在此映射上为指定映射中的密钥k至值v每个映射调用put(k, v)的效果。 如果在操作过程中修改了指定的映射，则此操作的行为未定义。

putIfAbsent

V putIfAbsent (K key, 
                V value)

如果指定的键尚未与值相关联（或映射到 null ）， null其与给定值相关联并返回 null ，否则返回当前值。

remove

boolean remove (Object key, 
                Object value)

只有在指定键当前映射到指定值时，才删除该条目。

remove

V remove (Object key)

如果该映射存在，则从该映射中除去该映射（可选操作）。 更正式地说，如果该映射包含从键k到值v映射（例如Objects.equals(key, k) ，则该映射被移除。 （地图最多可以包含一个这样的映射。）

返回此映射先前与键关联的值，或者如果映射不包含键映射，则返回 null 。

如果此映射允许空值，则返回值null 不一定表示该映射不包含该键的映射; 地图也可能明确将密钥映射到null 。

一旦调用返回，映射将不包含指定键的映射。

replace

boolean replace (K key, 
                V oldValue, 
                V newValue)

仅当当前映射到指定值时才替换指定键的条目。

replace

V replace (K key, 
                V value)

仅当指定键的条目映射到某个值时才替换该条目。

replaceAll

void replaceAll (BiFunction<? super K, ? super V, ? extends V> function)

用对该条目调用给定函数的结果替换每个条目的值，直到处理完所有条目或者该函数抛出异常。 函数抛出的异常会传递给调用者。

size

int size ()

返回此映射中键 - 值映射的数量。 如果地图包含多个Integer.MAX_VALUE元素，则返回Integer.MAX_VALUE 。

values

Collection<V> values ()

返回此映射中包含的值的Collection视图。 该集合由地图支持，因此地图的更改会反映在集合中，反之亦然。 如果在对集合进行迭代时修改了映射（除了通过迭代器自己的remove操作），迭代的结果是未定义的。 该collection支持元素移除，即从映射中相应的映射，经由Iterator.remove ， Collection.remove ， removeAll ， retainAll和clear操作。 它不支持add或addAll操作。