Question

类型参数：

K - 此映射维护的键类型

V - 映射值的类型

所有超级接口：

Map<K,V>

所有已知实现类：

ConcurrentHashMap

---

public interface ConcurrentMap<K,V>

extends Map<K,V>

提供其他原子 putIfAbsent 、 remove 、 replace 方法的 Map 。

此接口是 Java Collections Framework 的成员。

从以下版本开始：

1.5

---

嵌套类摘要

从接口 java.util.Map 继承的嵌套类/接口
Map.Entry<K,V>

方法摘要
V	putIfAbsent(Kkey, Vvalue) 如果指定键已经不再与某个值相关联，则将它与给定值关联。
boolean	remove(Objectkey, Objectvalue) 只有目前将键的条目映射到给定值时，才移除该键的条目。
V	replace(Kkey, Vvalue) 只有目前将键的条目映射到某一值时，才替换该键的条目。
boolean	replace(Kkey, VoldValue, VnewValue) 只有目前将键的条目映射到给定值时，才替换该键的条目。

从接口 java.util.Map 继承的方法
clear, containsKey, containsValue, entrySet, equals, get, hashCode, isEmpty, keySet, put, putAll, remove, size, values

方法详细信息

putIfAbsent

V putIfAbsent(Kkey,
              Vvalue)

如果指定键已经不再与某个值相关联，则将它与给定值关联。这等价于：

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

除了原子地执行此操作之外。

参数：

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

value - 与指定键相关联的值。

返回：

以前与指定键相关联的值，或者如果该键没有映射关系，则返回 null 。如果该实现支持 null 值，则返回 null 还可以指示此映射以前曾将 null 与指定键相关联。

抛出：

UnsupportedOperationException - 如果此映射不支持 put 操作。

ClassCastException - 如果指定键或值的类不允许将其存储在此映射中。

IllegalArgumentException - 如果此键或值的某些方面不允许将其存储在此映射中。

NullPointerException - 如果此映射不允许 null 键或值，并且指定的键或值为 null 。

---

remove

boolean remove(Objectkey,
               Objectvalue)

只有目前将键的条目映射到给定值时，才移除该键的条目。操作如下：

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

除了原子地执行此操作之外。

参数：

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

value - 与指定键相关联的值。

返回：

如果该值被移除，则返回 true，否则返回 false

抛出：

UnsupportedOperationException - 如果此映射不支持 remove 操作。

NullPointerException - 如果此映射不允许 null 键或值，并且指定的键或值为 null 。

---

replace

boolean replace(Kkey,
                VoldValue,
                VnewValue)

只有目前将键的条目映射到给定值时，才替换该键的条目。操作如下：

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

除了原子地执行此操作之外。

参数：

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

oldValue - 期望与指定键相关联的值。

newValue - 与指定键相关联的值。

返回：

如果该值被替换，则返回 ture

抛出：

UnsupportedOperationException - 如果此映射不支持 put 操作。

NullPointerException - 如果此映射不允许使用 null 键或值，并且指定的键或值为 null 。

---

replace

V replace(Kkey,
          Vvalue)

只有目前将键的条目映射到某一值时，才替换该键的条目。操作如下：

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

除了原子地执行此操作之外。

参数：

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

value - 与指定键相关联的值。

返回：

以前与指定键相关联的值，或者如果该键没有映射关系，则返回 null 。如果该实现支持 null 值，则返回 null 还可以指示此映射以前曾将 null 与指定键相关联。

抛出：

UnsupportedOperationException - 如果此映射不支持 put 操作。

NullPointerException - 如果此映射不允许 null 键或值，并且指定的键或值为 null 。