K - 由该地图维护的键的类型
V - 映射值的类型
public class ConcurrentHashMap<K,V> extends AbstractMap<K,V> implements ConcurrentMap<K,V>, Serializable
Hashtable ，并且包括对应于每个方法的方法版本Hashtable 。
不过，尽管所有操作都是线程安全的，检索操作并不意味着锁定，并没有为防止所有访问的方式锁定整个表的任何支持。
这个类可以在依赖于线程安全性的程序中与Hashtable完全互Hashtable ，但不依赖于其同步细节。
检索操作（包括get ）通常不阻止，因此可能与更新操作重叠（包括put和remove ）。 检索反映了最近完成的更新操作的结果。 （更正式地，对于给定密钥的更新操作熊之前发生与任何（非空关系）检索该键报告经更新的值。）对于聚合操作，比如putAll和clear ，并发检索可能反映插入或移除只有一些条目。 类似地，迭代器，分割器和枚举返回在反映迭代器/枚举创建过程中或之后反映哈希表状态的元素。 他们不抛出ConcurrentModificationException 。 然而，迭代器被设计为一次只能由一个线程使用。 请记住，骨料状态方法的结果，包括size ， isEmpty和containsValue通常是有用的，只有当一个地图没有发生在其他线程并发更新。 否则，这些方法的结果反映了可能足以用于监视或估计目的的瞬态状态，但不适用于程序控制。
当存在太多的冲突（即，具有不同的哈希码但是以表的大小为模数落入相同的时隙的密钥）时，该表被动态扩展，并且每个映射保持大致两个bin的预期平均效果（对应于0.75负载因素阈值调整大小）。 由于映射被添加和删除，这个平均值可能会有很大差异，但是总的来说，这为哈希表保留了普遍接受的时间/空间权衡。 然而，调整这个或任何其他类型的散列表可能是相对较慢的操作。 如果可能，最好提供一个尺寸估计作为可选的initialCapacity构造函数参数。 附加的可选的loadFactor构造函数参数提供了另外的手段，通过指定在计算给定数量的元素时要分配的空间量时使用的表密度来定制初始表容量。 此外，为了与此类的先前版本兼容，构造函数可以可选地指定预期的concurrencyLevel作为内部大小调整的附加提示。 请注意，使用完全相同的许多键hashCode()是降低任何哈希表的hashCode()的一种可靠的方法。 为了改善影响，当按键为Comparable时，该类可以使用键之间的比较顺序来帮助打破关系。
甲Set投影一个的ConcurrentHashMap可以（使用被创建newKeySet()或newKeySet(int) ），或观察（使用keySet(Object)时仅键是感兴趣的，并且被映射的值是（可能瞬时）不使用或全部取相同的映射值。
ConcurrentHashMap可以通过使用LongAdder值并通过computeIfAbsent进行初始化，将其用作可缩放的频率映射（直方图或多集的形式）。 例如，要向ConcurrentHashMap<String,LongAdder> freqs添加计数，可以使用freqs.computeIfAbsent(k -> new LongAdder()).increment();
此类及其视图和迭代器实现所有的可选方法Map个Iterator接口。
像Hashtable但不像HashMap ，这个类不允许 null用作键或值。
ConcurrentHashMaps支持一组顺序和并行批量操作，与大多数Stream方法不同，它们被设计为安全并且经常明智地应用，即使是由其他线程同时更新的映射; 例如，当计算共享注册表中的值的快照摘要时。 有三种操作，每种具有四种形式，接受键，值，条目和（键，值）参数和/或返回值的函数。 由于ConcurrentHashMap的元素不以任何特定的方式排序，并且可能会在不同的并行执行中以不同的顺序进行处理，因此提供的函数的正确性不应取决于任何排序，也不应依赖于可能瞬时变化的任何其他对象或值计算进行中; 除了每一个行动，理想情况下都是无副作用的。 对Map.Entry对象的批量操作不支持方法setValue 。
这些批量操作接受一个parallelismThreshold参数。 如果估计当前地图大小小于给定阈值，则方法依次进行。 使用Long.MAX_VALUE的值Long.MAX_VALUE抑制所有的并行性。 使用1的值可以通过划分为足够的子任务来完全利用用于所有并行计算的ForkJoinPool.commonPool()来实现最大并行度。 通常，您最初将选择其中一个极值，然后测量使用中间值之间的性能，从而降低开销与吞吐量之间的关系。
批量操作的并发属性遵循ConcurrentHashMap的并发属性：从get(key)返回的任何非空结果和相关的访问方法与相关的插入或更新都有一个发生之前的关系。 任何批量操作的结果都反映了这些每个元素关系的组成（但是除非以某种方式已知是静态的，它们并不一定是相对于整个地图的原子）。 相反，因为映射中的键和值从不为空，所以null作为目前缺乏任何结果的可靠原子指标。 为了保持此属性，null用作所有非标量缩减操作的隐含基础。 对于double，long和int版本，基础应该是当与任何其他值组合时返回其他值（更正式地，它应该是减少的标识元素）。 大多数常见的减少具有这些属性; 例如，使用基数0或最小值与基准MAX_VALUE计算和。
作为参数提供的搜索和转换函数应该类似地返回null以指示缺少任何结果（在这种情况下不被使用）。 在映射缩减的情况下，这也使得转换可以用作过滤器，如果不应该组合元素，返回null（或者在原始专业化的情况下，身份基础）。 在使用它们进行搜索或减少操作之前，您可以通过在“null意味着现在没有任何内容”规则下自行构建复合转换和过滤。
接受和/或返回Entry参数的方法维护键值关联。 例如，当找到最大价值的钥匙时，它们可能是有用的。 请注意，可以使用new AbstractMap.SimpleEntry(k,v)提供“plain”Entry new AbstractMap.SimpleEntry(k,v) 。
批量操作可能突然完成，抛出在应用程序中遇到的异常。 在处理这样的异常时，请注意，其他并发执行的函数也可能引发异常，或者如果没有发生第一个异常，则会这样做。
与顺序形式相比，加速比是常见的，但不能保证。 如果并行计算的基础工作比计算本身更昂贵，则涉及小地图上的简短功能的并行操作可能比顺序形式执行得更慢。 类似地，如果所有处理器正忙于执行不相关的任务，并行化可能不会导致太多的实际并行。
所有任务方法的所有参数都必须为非空值。
| Modifier and Type | Class and Description |
|---|---|
static class |
ConcurrentHashMap.KeySetView<K,V>
ConcurrentHashMap视图为 Set的关键字，其中可以通过映射到公共值来选择添加。
|
AbstractMap.SimpleEntry<K,V>, AbstractMap.SimpleImmutableEntry<K,V>| Constructor and Description |
|---|
ConcurrentHashMap()
创建一个新的，空的地图与默认的初始表大小（16）。
|
ConcurrentHashMap(int initialCapacity)
创建一个新的空的地图，其初始表格大小适应指定数量的元素，而不需要动态调整大小。
|
ConcurrentHashMap(int initialCapacity, float loadFactor)
根据给定的元素数量（
initialCapacity ）和初始表密度（
loadFactor ），创建一个新的，空的地图，初始的表格大小。
|
ConcurrentHashMap(int initialCapacity, float loadFactor, int concurrencyLevel)
创建具有基于给定数量的元件（初始表大小的新的空映射
initialCapacity ），表密度（
loadFactor ），和同时更新线程（数
concurrencyLevel ）。
|
ConcurrentHashMap(Map<? extends K,? extends V> m)
创建与给定地图相同的映射的新地图。
|
| Modifier and Type | Method and Description |
|---|---|
void |
clear()
从这张地图中删除所有的映射。
|
V |
compute(K key, BiFunction<? super K,? super V,? extends V> remappingFunction)
尝试计算用于指定键和其当前映射的值的映射（或
null如果没有当前映射）。
|
V |
computeIfAbsent(K key, Function<? super K,? extends V> mappingFunction)
如果指定的键尚未与值相关联，则尝试使用给定的映射函数计算其值，并将其输入到此映射中，除非
null 。
|
V |
computeIfPresent(K key, BiFunction<? super K,? super V,? extends V> remappingFunction)
如果存在指定键的值，则尝试计算给出键的新映射及其当前映射值。
|
boolean |
contains(Object value)
传统方法测试如果一些键映射到此表中的指定值。
|
boolean |
containsKey(Object key)
测试此表中的指定对象是否为键。
|
boolean |
containsValue(Object value)
如果此映射将一个或多个键映射到指定的值，则返回
true 。
|
Enumeration<V> |
elements()
返回此表中值的枚举。
|
Set<Map.Entry<K,V>> |
entrySet()
返回此地图中包含的映射的 Set视图。
|
boolean |
equals(Object o)
将指定的对象与此映射进行比较以获得相等性。
|
void |
forEach(BiConsumer<? super K,? super V> action)
对此映射中的每个条目执行给定的操作，直到所有条目都被处理或操作引发异常。
|
void |
forEach(long parallelismThreshold, BiConsumer<? super K,? super V> action)
对每个（键，值）执行给定的动作。
|
<U> void |
forEach(long parallelismThreshold, BiFunction<? super K,? super V,? extends U> transformer, Consumer<? super U> action)
对每个（key，value）的每个非空变换执行给定的动作。
|
void |
forEachEntry(long parallelismThreshold, Consumer<? super Map.Entry<K,V>> action)
对每个条目执行给定的操作。
|
<U> void |
forEachEntry(long parallelismThreshold, Function<Map.Entry<K,V>,? extends U> transformer, Consumer<? super U> action)
对每个条目的每个非空变换执行给定的操作。
|
void |
forEachKey(long parallelismThreshold, Consumer<? super K> action)
对每个键执行给定的动作。
|
<U> void |
forEachKey(long parallelismThreshold, Function<? super K,? extends U> transformer, Consumer<? super U> action)
对每个键的每个非空变换执行给定的动作。
|
void |
forEachValue(long parallelismThreshold, Consumer<? super V> action)
对每个值执行给定的操作。
|
<U> void |
forEachValue(long parallelismThreshold, Function<? super V,? extends U> transformer, Consumer<? super U> action)
对每个值的每个非空转换执行给定的动作。
|
V |
get(Object key)
返回到指定键所映射的值，或
null如果此映射包含该键的映射。
|
V |
getOrDefault(Object key, V defaultValue)
返回指定键映射到的值，如果此映射不包含该键的映射，则返回给定的默认值。
|
int |
hashCode()
返回此 Map的哈希代码值，即映射中每个键值对的总和，即key.hashCode() ^ value.hashCode() 。
|
boolean |
isEmpty()
如果此地图不包含键值映射，则返回
true 。
|
Enumeration<K> |
keys()
返回此表中键的枚举。
|
ConcurrentHashMap.KeySetView<K,V> |
keySet()
返回此地图中包含的键的 Set视图。
|
ConcurrentHashMap.KeySetView<K,V> |
keySet(V mappedValue)
返回此地图中键的 Set视图，使用给定的公用映射值进行任何添加（即Collection.add(E)和Collection.addAll(Collection) ）。
|
long |
mappingCount()
返回映射数。
|
V |
merge(K key, V value, BiFunction<? super V,? super V,? extends V> remappingFunction)
如果指定的键尚未与（非空）值相关联，则将其与给定值相关联。
|
static <K> ConcurrentHashMap.KeySetView<K,Boolean> |
newKeySet()
创建一个新的 Set支持的ConcurrentHashMap从给定的类型到Boolean.TRUE 。
|
static <K> ConcurrentHashMap.KeySetView<K,Boolean> |
newKeySet(int initialCapacity)
创建一个新的 Set支持的ConcurrentHashMap从给定的类型到Boolean.TRUE 。
|
V |
put(K key, V value)
将指定的键映射到此表中的指定值。
|
void |
putAll(Map<? extends K,? extends V> m)
将指定地图的所有映射复制到此映射。
|
V |
putIfAbsent(K key, V value)
如果指定的键尚未与值相关联，请将其与给定值相关联。
|
<U> U |
reduce(long parallelismThreshold, BiFunction<? super K,? super V,? extends U> transformer, BiFunction<? super U,? super U,? extends U> reducer)
返回使用给定的reducer将所有（key，value）对的给定变换累加到组合值的结果，如果没有则返回null。
|
Map.Entry<K,V> |
reduceEntries(long parallelismThreshold, BiFunction<Map.Entry<K,V>,Map.Entry<K,V>,? extends Map.Entry<K,V>> reducer)
返回使用给定的reducer累加所有条目的结果，以组合值，如果没有则返回null。
|
<U> U |
reduceEntries(long parallelismThreshold, Function<Map.Entry<K,V>,? extends U> transformer, BiFunction<? super U,? super U,? extends U> reducer)
返回使用给定的reducer将所有条目的给定变换累加到组合值的结果，否则返回null。
|
double |
reduceEntriesToDouble(long parallelismThreshold, ToDoubleFunction<Map.Entry<K,V>> transformer, double basis, DoubleBinaryOperator reducer)
返回使用给定的reducer累加给定变换的结果，以组合值，给定基础作为一个标识值。
|
int |
reduceEntriesToInt(long parallelismThreshold, ToIntFunction<Map.Entry<K,V>> transformer, int basis, IntBinaryOperator reducer)
返回使用给定的reducer累加给定变换的结果，以组合值，给定基础作为一个标识值。
|
long |
reduceEntriesToLong(long parallelismThreshold, ToLongFunction<Map.Entry<K,V>> transformer, long basis, LongBinaryOperator reducer)
返回使用给定的reducer累加给定变换的结果，以组合值，给定基础作为一个标识值。
|
K |
reduceKeys(long parallelismThreshold, BiFunction<? super K,? super K,? extends K> reducer)
返回使用给定的reducer累加所有键的结果，以组合值，如果没有则返回null。
|
<U> U |
reduceKeys(long parallelismThreshold, Function<? super K,? extends U> transformer, BiFunction<? super U,? super U,? extends U> reducer)
返回使用给定的reducer累加所有键的给定变换以组合值的结果，如果没有则返回null。
|
double |
reduceKeysToDouble(long parallelismThreshold, ToDoubleFunction<? super K> transformer, double basis, DoubleBinaryOperator reducer)
返回使用给定的reducer累加所有键的给定变换的结果，以组合值，给定基础作为标识值。
|
int |
reduceKeysToInt(long parallelismThreshold, ToIntFunction<? super K> transformer, int basis, IntBinaryOperator reducer)
返回使用给定的reducer累加所有键的给定变换的结果，以组合值，给定基础作为标识值。
|
long |
reduceKeysToLong(long parallelismThreshold, ToLongFunction<? super K> transformer, long basis, LongBinaryOperator reducer)
返回使用给定的reducer累加所有键的给定变换的结果，以组合值，给定基础作为标识值。
|
double |
reduceToDouble(long parallelismThreshold, ToDoubleBiFunction<? super K,? super V> transformer, double basis, DoubleBinaryOperator reducer)
返回使用给定的reducer将所有（key，value）对的给定变换累加到结合值的结果，给定的基数作为一个标识值。
|
int |
reduceToInt(long parallelismThreshold, ToIntBiFunction<? super K,? super V> transformer, int basis, IntBinaryOperator reducer)
返回使用给定的reducer将所有（key，value）对的给定变换累加到结合值的结果，给定的基数作为一个标识值。
|
long |
reduceToLong(long parallelismThreshold, ToLongBiFunction<? super K,? super V> transformer, long basis, LongBinaryOperator reducer)
返回使用给定的reducer将所有（key，value）对的给定变换累加到结合值的结果，给定的基数作为一个标识值。
|
V |
reduceValues(long parallelismThreshold, BiFunction<? super V,? super V,? extends V> reducer)
返回使用给定的reducer累加所有值的结果，以组合值，如果没有则返回null。
|
<U> U |
reduceValues(long parallelismThreshold, Function<? super V,? extends U> transformer, BiFunction<? super U,? super U,? extends U> reducer)
返回使用给定的reducer累加所有值的给定变换以组合值的结果，否则返回null。
|
double |
reduceValuesToDouble(long parallelismThreshold, ToDoubleFunction<? super V> transformer, double basis, DoubleBinaryOperator reducer)
返回使用给定的reducer累加所有值的给定变换的结果，以组合值，给定基础作为标识值。
|
int |
reduceValuesToInt(long parallelismThreshold, ToIntFunction<? super V> transformer, int basis, IntBinaryOperator reducer)
返回使用给定的reducer累加所有值的给定变换的结果，以组合值，给定基础作为标识值。
|
long |
reduceValuesToLong(long parallelismThreshold, ToLongFunction<? super V> transformer, long basis, LongBinaryOperator reducer)
返回使用给定的reducer累加所有值的给定变换的结果，以组合值，给定基础作为标识值。
|
V |
remove(Object key)
从该地图中删除键（及其对应的值）。
|
boolean |
remove(Object key, Object value)
仅当当前映射到给定值时才删除密钥的条目。
|
V |
replace(K key, V value)
仅当当前映射到某个值时才替换该项的条目。
|
boolean |
replace(K key, V oldValue, V newValue)
仅当当前映射到给定值时才替换密钥的条目。
|
void |
replaceAll(BiFunction<? super K,? super V,? extends V> function)
将每个条目的值替换为对该条目调用给定函数的结果，直到所有条目都被处理或该函数抛出异常。
|
<U> U |
search(long parallelismThreshold, BiFunction<? super K,? super V,? extends U> searchFunction)
通过在每个（键，值）上应用给定的搜索函数返回非空结果，如果没有则返回null。
|
<U> U |
searchEntries(long parallelismThreshold, Function<Map.Entry<K,V>,? extends U> searchFunction)
返回一个非空结果，从每个条目应用给定的搜索函数，如果没有，则返回null。
|
<U> U |
searchKeys(long parallelismThreshold, Function<? super K,? extends U> searchFunction)
返回一个非空结果，在每个键上应用给定的搜索功能，如果没有，返回null。
|
<U> U |
searchValues(long parallelismThreshold, Function<? super V,? extends U> searchFunction)
返回一个非空结果，对每个值应用给定的搜索函数，如果没有，返回null。
|
int |
size()
返回此地图中键值映射的数量。
|
String |
toString()
返回此地图的字符串表示形式。
|
Collection<V> |
values()
返回此地图中包含的值的 Collection视图。
|
clonepublic ConcurrentHashMap()
public ConcurrentHashMap(int initialCapacity)
initialCapacity - 该实现执行内部大小调整以适应这许多元素。
IllegalArgumentException - 元素的初始容量是否为负
public ConcurrentHashMap(Map<? extends K,? extends V> m)
m - 地图
public ConcurrentHashMap(int initialCapacity,
float loadFactor)
initialCapacity ）和初始表格密度（
loadFactor ）创建一个新的，空的地图，初始的表格大小。
initialCapacity - 初始容量。
考虑到指定的负载因子，实现执行内部大小调整以适应这许多元素。
loadFactor - 用于建立初始表大小的负载因子（表密度）
IllegalArgumentException - 如果元件的初始容量为负值或负载系数为非正值
public ConcurrentHashMap(int initialCapacity,
float loadFactor,
int concurrencyLevel)
initialCapacity ），表密度（
loadFactor ），和同时更新线程（数
concurrencyLevel ）。
initialCapacity - 初始容量。
考虑到指定的负载因子，实现执行内部大小调整以适应这许多元素。
loadFactor - 用于建立初始表大小的负载因子（表密度）
concurrencyLevel - 同时更新线程的估计数。
实现可以将此值用作大小提示。
IllegalArgumentException - 如果初始容量为负值或负载因子或并发级别为非正性
public int size()
public boolean isEmpty()
public V get(Object key)
null如果此映射包含该键的映射。
更正式地，如果该映射包含从键k到值v ，使得key.equals(k) ，则该方法返回v ; 否则返回null 。 （最多可以有一个这样的映射。）
get在界面
Map<K,V>
get在
AbstractMap<K,V>
key - 要返回其关联值的键
null
NullPointerException - 如果指定的键为空
public boolean containsKey(Object key)
containsKey在接口
Map<K,V>
containsKey在类别
AbstractMap<K,V>
key - 可能的关键
true当且仅当指定的对象是此表中的键，由equals方法确定;
false否则
NullPointerException - 如果指定的键为空
public boolean containsValue(Object value)
true 。
注意：此方法可能需要完全遍历地图，并且比方法containsKey慢得多。
containsValue在界面
Map<K,V>
containsValue在类别
AbstractMap<K,V>
value - 要在此地图中存在的值要进行测试
true如果该地图将一个或多个键映射到指定的值
NullPointerException - 如果指定的值为空
public V put(K key, V value)
可以通过使用等于原始密钥的密钥调用get方法来检索该值。
put在界面
Map<K,V>
put在类别
AbstractMap<K,V>
key - 指定值与之关联的键
value - 要与指定键相关联的值
key ，或
null如果没有映射为
key
NullPointerException - 如果指定的键或值为空
public void putAll(Map<? extends K,? extends V> m)
public V remove(Object key)
remove在界面
Map<K,V>
remove在类别
AbstractMap<K,V>
key - 需要删除的关键
key ，或
null如果没有映射为
key
NullPointerException - 如果指定的键为空
public void clear()
public ConcurrentHashMap.KeySetView<K,V> keySet()
Set视图。
该集合由地图支持，因此对地图的更改将反映在集合中，反之亦然。
该组支持元件移除，即从该映射中相应的映射，经由Iterator.remove ， Set.remove ， removeAll ， retainAll和clear操作。
它不支持add或addAll操作。
视图的迭代器和拼接器是weakly consistent 。
视图的spliterator报告Spliterator.CONCURRENT ， Spliterator.DISTINCT和Spliterator.NONNULL 。
public Collection<V> values()
Collection视图。
集合由地图支持，因此对地图的更改将反映在集合中，反之亦然。
该collection支持元素移除，即从该映射中相应的映射，经由Iterator.remove ， Collection.remove ， removeAll ， retainAll和clear操作。
它不支持add或addAll操作。
视图的迭代器和拼接器是weakly consistent 。
该视图的spliterator报告Spliterator.CONCURRENT和Spliterator.NONNULL 。
public Set<Map.Entry<K,V>> entrySet()
Set视图。
该集合由地图支持，因此对地图的更改将反映在集合中，反之亦然。
该组支持元件移除，即从映射中相应的映射，经由Iterator.remove ， Set.remove ， removeAll ， retainAll和clear操作。
视图的迭代器和拼接器是weakly consistent 。
视图的spliterator报告Spliterator.CONCURRENT ， Spliterator.DISTINCT和Spliterator.NONNULL 。
public int hashCode()
Map的哈希码值，即地图中每个键值对的总和，即key.hashCode() ^ value.hashCode() 。
hashCode在界面
Map<K,V>
hashCode在类别
AbstractMap<K,V>
Map.Entry.hashCode() ，
Object.equals(Object) ，
Set.equals(Object)
public String toString()
{} ”）中的键值映射列表（无特殊顺序）组成。
相邻映射由字符", " （逗号和空格）分隔。
每个键值映射都作为键后跟一个等号（“ = ”），后跟相关值。
toString在类别
AbstractMap<K,V>
public boolean equals(Object o)
true 。
如果在执行此方法期间同时修改了映射，则此操作可能会返回误导结果。
equals在界面
Map<K,V>
equals在类别
AbstractMap<K,V>
o - 要与此地图相等的对象进行比较
true如果指定的对象等于此映射
Object.hashCode() ， HashMap
public V putIfAbsent(K key, V value)
if (!map.containsKey(key)) return map.put(key, value); else return map.get(key);
除了动作以原子方式执行。
putIfAbsent在接口
ConcurrentMap<K,V>
putIfAbsent在界面
Map<K,V>
key - 要与其关联的指定值的键
value - 与指定键相关联的值
null
NullPointerException - 如果指定的键或值为空
public boolean remove(Object key, Object value)
if (map.containsKey(key) && Objects.equals(map.get(key), value)) { map.remove(key); return true; } else return false;
除了动作以原子方式执行。
remove在界面
ConcurrentMap<K,V>
remove在界面
Map<K,V>
key - 与指定值相关联的键
value - 预期与指定键相关联的值
true如果该值被删除
NullPointerException - 如果指定的键为空
public boolean replace(K key, V oldValue, V newValue)
if (map.containsKey(key) && Objects.equals(map.get(key), oldValue)) { map.put(key, newValue); return true; } else return false;
除了动作以原子方式执行。
replace在界面
ConcurrentMap<K,V>
replace在界面
Map<K,V>
key - 与指定值相关联的键
oldValue - 预期与指定键相关联的值
newValue - 要与指定键相关联的值
true如果该值被替换
NullPointerException - 如果任何参数为空
public V replace(K key, V value)
if (map.containsKey(key)) { return map.put(key, value); } else return null;
除了动作以原子方式执行。
replace在界面
ConcurrentMap<K,V>
replace在界面
Map<K,V>
key - 与指定值相关联的键
value - 与指定键相关联的值
null
NullPointerException - 如果指定的键或值为空
public V getOrDefault(Object key, V defaultValue)
getOrDefault中的
ConcurrentMap<K,V>
getOrDefault中的
Map<K,V>
key - 要返回其关联值的键
defaultValue - 如果此映射不包含给定键的映射，则返回的值
NullPointerException - 如果指定的键为空
public void forEach(BiConsumer<? super K,? super V> action)
ConcurrentMap复制
public void replaceAll(BiFunction<? super K,? super V,? extends V> function)
ConcurrentMap复制
replaceAll在界面
ConcurrentMap<K,V>
replaceAll在界面
Map<K,V>
function - 应用于每个条目的功能
public V computeIfAbsent(K key, Function<? super K,? extends V> mappingFunction)
null 。
整个方法调用是以原子方式执行的，因此每个键最多应用一次该函数。
在计算过程中可能会阻止其他线程对该映射进行的某些尝试更新操作，因此计算应该简单而简单，不得尝试更新此映射的任何其他映射。
computeIfAbsent在界面
ConcurrentMap<K,V>
computeIfAbsent在界面
Map<K,V>
key - 指定值与之关联的键
mappingFunction - 计算值的函数
NullPointerException - 如果指定的键或mappingFunction为空
IllegalStateException - 如果计算可检测地尝试对此地图的递归更新，否则将永远不会完成
RuntimeException - 或者如果mappingFunction这样做，则出错，在这种情况下，映射未建立
public V computeIfPresent(K key, BiFunction<? super K,? super V,? extends V> remappingFunction)
computeIfPresent在接口
ConcurrentMap<K,V>
computeIfPresent中的
Map<K,V>
key - 值可以与之相关联的键
remappingFunction - 计算值的函数
NullPointerException - 如果指定的键或remappingFunction为空
IllegalStateException - 如果计算可检测地尝试对该地图的递归更新，否则将永远不会完成
RuntimeException - 或者如果重映射功能如此，则出错，在这种情况下映射不变
public V compute(K key, BiFunction<? super K,? super V,? extends V> remappingFunction)
null如果没有当前映射）。
整个方法调用是以原子方式执行的。
在计算过程中可能会阻止其他线程对此映射进行的一些尝试更新操作，因此计算应该简单而简单，而且不得尝试更新此Map的任何其他映射。
compute中的
ConcurrentMap<K,V>
compute在接口
Map<K,V>
key - 指定值与之关联的键
remappingFunction - 计算值的函数
NullPointerException - 如果指定的键或remappingFunction为空
IllegalStateException - 如果计算可检测地尝试递归更新该映射，否则将永远不会完成
RuntimeException - 或者如果remappingFunction这样做，则出错，在这种情况下映射不变
public V merge(K key, V value, BiFunction<? super V,? super V,? extends V> remappingFunction)
null 。
整个方法调用是以原子方式执行的。
在计算过程中可能会阻止其他线程对此映射进行的一些尝试更新操作，因此计算应该简单而简单，而且不得尝试更新此Map的任何其他映射。
merge在界面
ConcurrentMap<K,V>
merge中的
Map<K,V>
key - 与其相关联的指定值的键
value - 缺席时使用的值
remappingFunction - 重新计算值（如果存在）的功能
NullPointerException - 如果指定的键或remappingFunction为空
RuntimeException - 或者如果重映射功能如此，则出错，在这种情况下映射不变
public boolean contains(Object value)
containsValue(Object)相同 ，仅存在于确保与引入 Java Collections框架之前支持此方法的Hashtable类的完全兼容性。
value - 要搜索的值
true当且仅当某些键映射到本表中的value参数，由equals方法确定;
false否则
NullPointerException - 如果指定的值为null
public Enumeration<K> keys()
keySet()
public Enumeration<V> elements()
values()
public long mappingCount()
public static <K> ConcurrentHashMap.KeySetView<K,Boolean> newKeySet()
Set，由一个ConcurrentHashMap支持，从给定的类型到Boolean.TRUE 。
K - 返回集合的元素类型
public static <K> ConcurrentHashMap.KeySetView<K,Boolean> newKeySet(int initialCapacity)
Set支持的ConcurrentHashMap从给定类型到Boolean.TRUE 。
K - 返回的集合的元素类型
initialCapacity - 该实现执行内部大小调整以适应这许多元素。
IllegalArgumentException - 如果元素的初始容量为负数
public ConcurrentHashMap.KeySetView<K,V> keySet(V mappedValue)
Set视图，使用给定的公共映射值进行任何添加（即Collection.add(E)和Collection.addAll(Collection) ）。
这当然只适用于从这个视图中为所有添加使用相同的值。
mappedValue - 用于任何添加的映射值
NullPointerException - 如果mappedValue为空
public void forEach(long parallelismThreshold,
BiConsumer<? super K,? super V> action)
parallelismThreshold - 并行执行此操作所需的元素的（估计）数量
action - 行动
public <U> void forEach(long parallelismThreshold,
BiFunction<? super K,? super V,? extends U> transformer,
Consumer<? super U> action)
U -
U的返回类型
parallelismThreshold - 并行执行此操作所需的元素的（估计）数量
transformer - 返回元素的变换的函数，如果没有变换，则返回null（在这种情况下，不应用动作）
action - 行动
public <U> U search(long parallelismThreshold,
BiFunction<? super K,? super V,? extends U> searchFunction)
U - 搜索功能的返回类型
parallelismThreshold - 并行执行此操作所需的元素数量（估计）
searchFunction - 成功返回非空结果的函数，否则为null
public <U> U reduce(long parallelismThreshold,
BiFunction<? super K,? super V,? extends U> transformer,
BiFunction<? super U,? super U,? extends U> reducer)
U -
U的返回类型
parallelismThreshold - 并行执行此操作所需的元素的（估计）数量
transformer - 返回元素的变换的函数，如果没有转换，则返回null（在这种情况下，它不合并）
reducer - 交换联想组合函数
public double reduceToDouble(long parallelismThreshold,
ToDoubleBiFunction<? super K,? super V> transformer,
double basis,
DoubleBinaryOperator reducer)
parallelismThreshold - 并行执行此操作所需的元素的（估计）数量
transformer - 返回元素
transformer的函数
basis - 减少的身份（初始默认值）
reducer - 交换联想组合函数
public long reduceToLong(long parallelismThreshold,
ToLongBiFunction<? super K,? super V> transformer,
long basis,
LongBinaryOperator reducer)
parallelismThreshold - 并行执行此操作所需的元素的（估计）数量
transformer - 返回元素的变换的函数
basis - 减少的身份（初始默认值）
reducer - 交换联想组合函数
public int reduceToInt(long parallelismThreshold,
ToIntBiFunction<? super K,? super V> transformer,
int basis,
IntBinaryOperator reducer)
parallelismThreshold - 并行执行此操作所需的元素的（估计）数量
transformer - 返回元素的变换的函数
basis - 减少的身份（初始默认值）
reducer - 交换联想组合功能
public void forEachKey(long parallelismThreshold,
Consumer<? super K> action)
parallelismThreshold - 并行执行此操作所需的元素的（估计）数量
action - 动作
public <U> void forEachKey(long parallelismThreshold,
Function<? super K,? extends U> transformer,
Consumer<? super U> action)
U -
U的返回类型
parallelismThreshold - 并行执行此操作所需的元素的（估计）数量
transformer - 返回元素的变换的函数，如果没有变换则为null（在这种情况下，不应用动作）
action - 行动
public <U> U searchKeys(long parallelismThreshold,
Function<? super K,? extends U> searchFunction)
U - 搜索功能的返回类型
parallelismThreshold - 并行执行此操作所需的元素的（估计）数量
searchFunction - 成功返回非空结果的函数，否则为null
public K reduceKeys(long parallelismThreshold, BiFunction<? super K,? super K,? extends K> reducer)
parallelismThreshold - 并行执行此操作所需的元素的（估计）数量
reducer - 交换联想组合函数
public <U> U reduceKeys(long parallelismThreshold,
Function<? super K,? extends U> transformer,
BiFunction<? super U,? super U,? extends U> reducer)
U -
U的返回类型
parallelismThreshold - 并行执行此操作所需的元素的（估计）数量
transformer - 返回元素的变换的函数，如果没有转换，则返回null（在这种情况下，它不被组合）
reducer - 交换联想组合功能
public double reduceKeysToDouble(long parallelismThreshold,
ToDoubleFunction<? super K> transformer,
double basis,
DoubleBinaryOperator reducer)
parallelismThreshold - 并行执行此操作所需的元素数量（估计）
transformer - 返回元素的变换的函数
basis - 减少的身份（初始默认值）
reducer - 交换联想组合功能
public long reduceKeysToLong(long parallelismThreshold,
ToLongFunction<? super K> transformer,
long basis,
LongBinaryOperator reducer)
parallelismThreshold - 并行执行此操作所需的元素的（估计）数量
transformer - 返回元素
transformer的函数
basis - 减少的身份（初始默认值）
reducer - 交换联想组合功能
public int reduceKeysToInt(long parallelismThreshold,
ToIntFunction<? super K> transformer,
int basis,
IntBinaryOperator reducer)
parallelismThreshold - 并行执行此操作所需的元素的（估计）数量
transformer - 返回元素
transformer的函数
basis - 减少的身份（初始默认值）
reducer - 交换联想组合函数
public void forEachValue(long parallelismThreshold,
Consumer<? super V> action)
parallelismThreshold - 并行执行此操作所需的元素的（估计）数量
action - 行动
public <U> void forEachValue(long parallelismThreshold,
Function<? super V,? extends U> transformer,
Consumer<? super U> action)
U -
U的返回类型
parallelismThreshold - 并行执行此操作所需的元素的（估计）数量
transformer - 返回元素的变换的函数，如果没有变换则为null（在这种情况下，不应用动作）
action - 行动
public <U> U searchValues(long parallelismThreshold,
Function<? super V,? extends U> searchFunction)
U - 搜索功能的返回类型
parallelismThreshold - 并行执行此操作所需的元素的（估计）数量
searchFunction - 成功返回非空结果的函数，否则为null
public V reduceValues(long parallelismThreshold, BiFunction<? super V,? super V,? extends V> reducer)
parallelismThreshold - 并行执行此操作所需的元素数量（估计）
reducer - 一种交换联想组合函数
public <U> U reduceValues(long parallelismThreshold,
Function<? super V,? extends U> transformer,
BiFunction<? super U,? super U,? extends U> reducer)
U -
U的返回类型
parallelismThreshold - 并行执行此操作所需的元素的（估计）数量
transformer - 一个返回元素变换的函数，如果没有变换，则返回null（在这种情况下不组合）
reducer - 一种交换联想组合函数
public double reduceValuesToDouble(long parallelismThreshold,
ToDoubleFunction<? super V> transformer,
double basis,
DoubleBinaryOperator reducer)
parallelismThreshold - 并行执行此操作所需的元素的（估计）数量
transformer - 返回元素
transformer的函数
basis - 减少的身份（初始默认值）
reducer - 交换联想组合函数
public long reduceValuesToLong(long parallelismThreshold,
ToLongFunction<? super V> transformer,
long basis,
LongBinaryOperator reducer)
parallelismThreshold - 并行执行此操作所需的元素的（估计）数量
transformer - 返回元素
transformer的函数
basis - 减少的身份（初始默认值）
reducer - 交换联想组合功能
public int reduceValuesToInt(long parallelismThreshold,
ToIntFunction<? super V> transformer,
int basis,
IntBinaryOperator reducer)
parallelismThreshold - 并行执行此操作所需的元素的（估计）数量
transformer - 返回元素
transformer的函数
basis - 减少的身份（初始默认值）
reducer - 交换联想组合功能
public void forEachEntry(long parallelismThreshold,
Consumer<? super Map.Entry<K,V>> action)
parallelismThreshold - 并行执行此操作所需的元素的（估计）数量
action - 行动
public <U> void forEachEntry(long parallelismThreshold,
Function<Map.Entry<K,V>,? extends U> transformer,
Consumer<? super U> action)
U -
U的返回类型
parallelismThreshold - 并行执行此操作所需的元素数量（估计）
transformer - 返回元素的变换的函数，如果没有变换则为null（在这种情况下，不应用动作）
action - 行动
public <U> U searchEntries(long parallelismThreshold,
Function<Map.Entry<K,V>,? extends U> searchFunction)
U - 搜索功能的返回类型
parallelismThreshold - 并行执行此操作所需的元素的（估计）数量
searchFunction - 成功返回非空结果的函数，否则为null
public Map.Entry<K,V> reduceEntries(long parallelismThreshold, BiFunction<Map.Entry<K,V>,Map.Entry<K,V>,? extends Map.Entry<K,V>> reducer)
parallelismThreshold - 并行执行此操作所需的元素的（估计）数量
reducer - 交换联想组合功能
public <U> U reduceEntries(long parallelismThreshold,
Function<Map.Entry<K,V>,? extends U> transformer,
BiFunction<? super U,? super U,? extends U> reducer)
U -
U的返回类型
parallelismThreshold - 并行执行此操作所需的元素的（估计）数量
transformer - 返回元素的变换的函数，如果没有转换，则返回null（在这种情况下，它不合并）
reducer - 交换联想组合功能
public double reduceEntriesToDouble(long parallelismThreshold,
ToDoubleFunction<Map.Entry<K,V>> transformer,
double basis,
DoubleBinaryOperator reducer)
parallelismThreshold - 并行执行此操作所需的元素的（估计）数量
transformer - 返回元素
transformer的函数
basis - 减少的身份（初始默认值）
reducer - 一种交换联想组合函数
public long reduceEntriesToLong(long parallelismThreshold,
ToLongFunction<Map.Entry<K,V>> transformer,
long basis,
LongBinaryOperator reducer)
parallelismThreshold - 并行执行此操作所需的元素的（估计）数量
transformer - 返回元素
transformer的函数
basis - 减少的身份（初始默认值）
reducer - 交换联想组合功能
public int reduceEntriesToInt(long parallelismThreshold,
ToIntFunction<Map.Entry<K,V>> transformer,
int basis,
IntBinaryOperator reducer)
parallelismThreshold - 并行执行此操作所需的元素数量（估计）
transformer - 返回元素的变换的函数
basis - 减少的身份（初始默认值）
reducer - 交换联想组合功能
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.