ConcurrentHashMap

ConcurrentHashMap

ConcurrentHashMap ()

使用默认的初始表格大小（16）创建一个新的空白地图。

ConcurrentHashMap

ConcurrentHashMap (int initialCapacity)

创建一个新的空映射，其初始表大小可容纳指定数量的元素，而无需动态调整大小。

ConcurrentHashMap

ConcurrentHashMap (Map<? extends K, ? extends V> m)

使用与给定映射相同的映射创建新映射。

ConcurrentHashMap

ConcurrentHashMap (int initialCapacity, 
                float loadFactor)

根据给定的元素数量（ initialCapacity ）和初始表格密度（ loadFactor ），创建具有初始表格大小的新的空白地图。

ConcurrentHashMap

ConcurrentHashMap (int initialCapacity, 
                float loadFactor, 
                int concurrencyLevel)

创建具有基于给定数量的元件（初始表大小的新的空映射 initialCapacity ），表密度（ loadFactor ），并同时更新线程（数 concurrencyLevel ）。

clear

void clear ()

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

compute

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

尝试计算指定键和其当前映射值的映射（如果没有当前映射， null ）。 整个方法调用是以原子方式执行的。 在进行计算时，其他线程在此映射上的某些尝试更新操作可能会被阻止，因此计算应该简短并且不要尝试更新此映射的任何其他映射。

computeIfAbsent

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

如果指定的键尚未与值关联，则尝试使用给定的映射函数计算其值，并将其输入到此映射中，除非null 。 整个方法调用是以原子方式执行的，因此每个键最多应用一次该功能。 在进行计算时，其他线程在此映射上的某些尝试更新操作可能会被阻止，因此计算应该简短并且不要尝试更新此映射的任何其他映射。

computeIfPresent

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

如果指定键的值存在，则尝试计算给定键和其当前映射值的新映射。 整个方法调用是以原子方式执行的。 在进行计算时，其他线程在此映射上的某些尝试更新操作可能会被阻止，因此计算应该简短并且不要尝试更新此映射的任何其他映射。

contains

boolean contains (Object value)

测试某些键是否映射到此表中的指定值。

请注意，此方法在功能上与 containsValue(Object) ，仅用于确保与引入Java集合框架之前支持此方法的类 Hashtable完全兼容。

containsKey

boolean containsKey (Object key)

测试指定的对象是否是此表中的键。

containsValue

boolean containsValue (Object value)

如果此映射将一个或多个键映射到指定值，则返回true 。 注意：此方法可能需要全面遍历地图，并且比方法containsKey慢得多。

elements

Enumeration<V> elements ()

返回此表中值的枚举。

entrySet

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

返回此映射中映射的映射的Set视图。 该集合由地图支持，因此对地图的更改反映在集合中，反之亦然。 该组支持元件移除，即从映射中相应的映射，经由Iterator.remove ， Set.remove ， removeAll ， retainAll ，和clear操作。

视图的迭代器和分割器是 weakly consistent 。

视图的 spliterator报告 CONCURRENT ， DISTINCT ，并 NONNULL 。

equals

boolean equals (Object o)

将指定的对象与此映射进行比较以获得相等性。 如果给定对象是具有与此映射相同映射的映射，则返回true 。 如果在执行此方法期间同时修改其中一个映射，此操作可能会返回误导结果。

forEach

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

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

forEach

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

对每个（键，值）执行给定的操作。

forEach

void forEach (long parallelismThreshold, 
                BiFunction<? super K, ? super V, ? extends U> transformer, 
                Consumer<? super U> action)

对每个（键，值）的每个非空变换执行给定的操作。

forEachEntry

void forEachEntry (long parallelismThreshold, 
                Function<Entry<K, V>, ? extends U> transformer, 
                Consumer<? super U> action)

对每个条目的每个非空转换执行给定的操作。

forEachEntry

void forEachEntry (long parallelismThreshold, 
                Consumer<? super Entry<K, V>> action)

为每个条目执行给定的操作。

forEachKey

void forEachKey (long parallelismThreshold, 
                Function<? super K, ? extends U> transformer, 
                Consumer<? super U> action)

对每个键的每个非空转换执行给定的操作。

forEachKey

void forEachKey (long parallelismThreshold, 
                Consumer<? super K> action)

对每个键执行给定的操作。

forEachValue

void forEachValue (long parallelismThreshold, 
                Function<? super V, ? extends U> transformer, 
                Consumer<? super U> action)

对每个值的每个非空变换执行给定的操作。

forEachValue

void forEachValue (long parallelismThreshold, 
                Consumer<? super V> action)

对每个值执行给定的操作。

get

V get (Object key)

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

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

getOrDefault

V getOrDefault (Object key, 
                V defaultValue)

返回指定键映射到的值，或者如果此映射不包含键映射，则返回给定的默认值。

hashCode

int hashCode ()

返回此 Map的散列码值，即，对于映射中的每个键值对， key.hashCode() ^ value.hashCode() 。

isEmpty

boolean isEmpty ()

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

该实现返回 size() == 0 。

keySet

Set<K> keySet ()

返回此映射中包含的键的Set视图。 该集合由地图支持，因此对地图的更改反映在集合中，反之亦然。 该组支持元件移除，即从该映射中相应的映射，经由Iterator.remove ， Set.remove ， removeAll ， retainAll ，和clear操作。 它不支持add或addAll操作。

该方法返回的集合保证为 ConcurrentHashMap.KeySetView的实例。

视图的迭代器和分割器是 weakly consistent 。

视图的 spliterator报告 CONCURRENT ， DISTINCT ，并 NONNULL 。

keySet

KeySetView<K, V> keySet (V mappedValue)

返回此映射中键的Set视图，使用给定的公共映射值进行任何添加（即， add(E)和addAll(Collection) ）。 这当然只适用于从该视图中为所有添加使用相同值的情况。

keys

Enumeration<K> keys ()

返回此表中键的枚举。

mappingCount

long mappingCount ()

返回映射的数量。 应该使用此方法而不是size()因为ConcurrentHashMap可能包含比可以表示为int更多的映射。 返回的值是一个估计值; 如果并发插入或删除，实际计数可能会有所不同。

merge

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

如果指定的键尚未与（非空）值相关联，则将其与给定值相关联。 否则，将该值替换为给定的重映射函数的结果，或者如果null移除。 整个方法调用是以原子方式执行的。 在进行计算时，其他线程在此映射上的某些尝试更新操作可能会被阻止，因此计算应该简短并且不要尝试更新此映射的任何其他映射。

newKeySet

KeySetView<K, Boolean> newKeySet ()

创建一个新的 Set ，由给定类型的ConcurrentHashMap支持 Boolean.TRUE 。

newKeySet

KeySetView<K, Boolean> newKeySet (int initialCapacity)

创建一个由给定类型的ConcurrentHashMap支持的新的 Set到 Boolean.TRUE 。

put

V put (K key, 
                V value)

将指定的键映射到此表中的指定值。 密钥和值都不能为空。

通过使用与原始密钥相同的密钥调用 get方法可以检索该值。

putAll

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

将指定映射中的所有映射复制到此映射。 这些映射会替换此映射对当前指定映射中的任何键的所有映射。

putIfAbsent

V putIfAbsent (K key, 
                V value)

如果指定的键尚未与值相关联，则将其与给定值相关联。 这相当于这个map ：

 if (!map.containsKey(key))
   return map.put(key, value);
 else
   return map.get(key);

reduce

U reduce (long parallelismThreshold, 
                BiFunction<? super K, ? super V, ? extends U> transformer, 
                BiFunction<? super U, ? super U, ? extends U> reducer)

返回使用给定的缩减器合并值累积所有（键，值）对的给定变换的结果，如果不是，则返回null。

reduceEntries

Entry<K, V> reduceEntries (long parallelismThreshold, 
                BiFunction<Entry<K, V>, Entry<K, V>, ? extends Entry<K, V>> reducer)

返回使用给定reducer合并值的所有条目的累积结果，如果没有，则返回null。

reduceEntries

U reduceEntries (long parallelismThreshold, 
                Function<Entry<K, V>, ? extends U> transformer, 
                BiFunction<? super U, ? super U, ? extends U> reducer)

返回使用给定缩减器合并值累积给定转换的结果，如果没有，则返回null。

reduceEntriesToDouble

double reduceEntriesToDouble (long parallelismThreshold, 
                ToDoubleFunction<Entry<K, V>> transformer, 
                double basis, 
                DoubleBinaryOperator reducer)

返回使用给定缩减器合并值并将给定基础作为标识值累加给定变换的结果。

reduceEntriesToInt

int reduceEntriesToInt (long parallelismThreshold, 
                ToIntFunction<Entry<K, V>> transformer, 
                int basis, 
                IntBinaryOperator reducer)

返回使用给定缩减器合并值并将给定基础作为标识值累加给定变换的结果。

reduceEntriesToLong

long reduceEntriesToLong (long parallelismThreshold, 
                ToLongFunction<Entry<K, V>> transformer, 
                long basis, 
                LongBinaryOperator reducer)

返回使用给定缩减器合并值并将给定基础作为标识值累加给定变换的结果。

reduceKeys

K reduceKeys (long parallelismThreshold, 
                BiFunction<? super K, ? super K, ? extends K> reducer)

返回使用给定缩减器合并值累积所有键的结果，如果没有，则返回null。

reduceKeys

U reduceKeys (long parallelismThreshold, 
                Function<? super K, ? extends U> transformer, 
                BiFunction<? super U, ? super U, ? extends U> reducer)

返回使用给定的缩减器合并值累加给定所有键的转换的结果，如果没有，则返回null。

reduceKeysToDouble

double reduceKeysToDouble (long parallelismThreshold, 
                ToDoubleFunction<? super K> transformer, 
                double basis, 
                DoubleBinaryOperator reducer)

返回使用给定缩减器累加给定所有键的转换以合并值，并将给定基准作为标识值的结果。

reduceKeysToInt

int reduceKeysToInt (long parallelismThreshold, 
                ToIntFunction<? super K> transformer, 
                int basis, 
                IntBinaryOperator reducer)

返回使用给定缩减器累加给定所有键的转换以合并值，并将给定基准作为标识值的结果。

reduceKeysToLong

long reduceKeysToLong (long parallelismThreshold, 
                ToLongFunction<? super K> transformer, 
                long basis, 
                LongBinaryOperator reducer)

返回使用给定缩减器累加给定所有键的转换以合并值，并将给定基准作为标识值的结果。

reduceToDouble

double reduceToDouble (long parallelismThreshold, 
                ToDoubleBiFunction<? super K, ? super V> transformer, 
                double basis, 
                DoubleBinaryOperator reducer)

返回使用给定的缩减器将所有（键，值）对的给定变换累加以合并值，并将给定基础作为标识值的结果。

reduceToInt

int reduceToInt (long parallelismThreshold, 
                ToIntBiFunction<? super K, ? super V> transformer, 
                int basis, 
                IntBinaryOperator reducer)

返回使用给定的缩减器将所有（键，值）对的给定变换累加以合并值，并将给定基础作为标识值的结果。

reduceToLong

long reduceToLong (long parallelismThreshold, 
                ToLongBiFunction<? super K, ? super V> transformer, 
                long basis, 
                LongBinaryOperator reducer)

返回使用给定的缩减器将所有（键，值）对的给定变换累加以合并值，并将给定基础作为标识值的结果。

reduceValues

V reduceValues (long parallelismThreshold, 
                BiFunction<? super V, ? super V, ? extends V> reducer)

返回使用给定缩减器合并值累加所有值的结果，如果没有，则返回null。

reduceValues

U reduceValues (long parallelismThreshold, 
                Function<? super V, ? extends U> transformer, 
                BiFunction<? super U, ? super U, ? extends U> reducer)

返回使用给定的缩减器合并值累积所有值的给定变换的结果，如果没有，则返回null。

reduceValuesToDouble

double reduceValuesToDouble (long parallelismThreshold, 
                ToDoubleFunction<? super V> transformer, 
                double basis, 
                DoubleBinaryOperator reducer)

返回使用给定的缩减器合并值并将给定基础作为标识值累加给定所有值的转换的结果。

reduceValuesToInt

int reduceValuesToInt (long parallelismThreshold, 
                ToIntFunction<? super V> transformer, 
                int basis, 
                IntBinaryOperator reducer)

返回使用给定的缩减器合并值并将给定基础作为标识值累加给定所有值的转换的结果。

reduceValuesToLong

long reduceValuesToLong (long parallelismThreshold, 
                ToLongFunction<? super V> transformer, 
                long basis, 
                LongBinaryOperator reducer)

返回使用给定的缩减器合并值并将给定基础作为标识值累加给定所有值的转换的结果。

remove

V remove (Object key)

从此映射中删除键（及其相应的值）。 如果该键不在地图中，该方法不执行任何操作。

remove

boolean remove (Object key, 
                Object value)

只有在当前映射到给定值的情况下才删除键的条目。 这相当于这个map ：

 if (map.containsKey(key)
     && Objects.equals(map.get(key), value)) {
   map.remove(key);
   return true;
 } else {
   return false;
 }

replace

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

仅当当前映射到给定值时才替换密钥的条目。 这相当于这个map ：

 if (map.containsKey(key)
     && Objects.equals(map.get(key), oldValue)) {
   map.put(key, newValue);
   return true;
 } else {
   return false;
 }

replace

V replace (K key, 
                V value)

仅当当前映射到某个值时才替换密钥的条目。 这相当于这个map ：

 if (map.containsKey(key))
   return map.put(key, value);
 else
   return null;

replaceAll

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

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

search

U search (long parallelismThreshold, 
                BiFunction<? super K, ? super V, ? extends U> searchFunction)

对每个（键，值）应用给定的搜索函数返回一个非空结果，如果没有，则返回null。 成功后，进一步的元素处理被抑制，任何其他并行调用搜索函数的结果都将被忽略。

searchEntries

U searchEntries (long parallelismThreshold, 
                Function<Entry<K, V>, ? extends U> searchFunction)

在每个条目上应用给定搜索函数返回非空结果，如果没有，则返回null。 成功后，进一步的元素处理被抑制，任何其他并行调用搜索函数的结果都将被忽略。

searchKeys

U searchKeys (long parallelismThreshold, 
                Function<? super K, ? extends U> searchFunction)

对每个键应用给定的搜索函数返回非空结果，如果不是，则返回null。 成功后，进一步的元素处理被抑制，任何其他并行调用搜索函数的结果都将被忽略。

searchValues

U searchValues (long parallelismThreshold, 
                Function<? super V, ? extends U> searchFunction)

对每个值应用给定的搜索函数返回一个非空结果，如果没有，则返回null。 成功后，进一步的元素处理被抑制，任何其他并行调用搜索函数的结果都将被忽略。

size

int size ()

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

该实现返回 entrySet().size() 。

toString

String toString ()

返回此映射的字符串表示形式。 字符串表示由大括号（“ {} ”）中包含的键值映射列表（无特定顺序）组成。 相邻映射由字符", " （逗号和空格）分隔。 每个键值映射都呈现为键后跟一个等号（“ = ”），后跟相关联的值。

values

Collection<V> values ()

返回此映射中包含的值的Collection视图。 该集合由地图支持，因此地图的更改会反映在集合中，反之亦然。 该collection支持元素移除，即从该映射中相应的映射，经由Iterator.remove ， Collection.remove ， removeAll ， retainAll ，和clear操作。 它不支持add或addAll操作。

视图的迭代器和分割器是 weakly consistent 。

该视图的 spliterator报告 CONCURRENT和 NONNULL 。