java.util.concurrent
接口 ConcurrentMap<K,V>

类型参数：

K - 此映射维护的键类型

V - 映射值的类型

所有超级接口：

Map<K,V>

所有已知子接口：

ConcurrentNavigableMap<K,V>

所有已知实现类：

ConcurrentHashMap, ConcurrentSkipListMap

public interface ConcurrentMap<K,V>
extends Map<K,V>

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

内存一致性效果：当存在其他并发 collection 时，将对象放入 ConcurrentMap 之前的线程中的操作 happen-before 随后通过另一线程从 ConcurrentMap 中访问或移除该元素的操作。

此接口是 Java Collections Framework 的成员。

从以下版本开始：

1.5

putIfAbsent

V putIfAbsent(K key,
              V value)

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

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

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

参数：

key - 与指定值相关联的键

value - 与指定键相关联的值

返回：

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

抛出：

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

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

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

IllegalArgumentException - 如果指定键或值的某些属性不允许将其存储在此映射中

remove

boolean remove(Object key,
               Object value)

只有目前将键的条目映射到给定值时，才移除该键的条目。这等效于：

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

不同之处在于该操作是以原子方式 (atomically) 执行的。

参数：

key - 与指定值相关联的键

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

返回：

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

抛出：

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

ClassCastException - 如果该键或值是此映射的合适类型（可选）

NullPointerException - 如果指定键或值为 null，并且此映射不允许 null 键或值（可选）

replace

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

只有目前将键的条目映射到给定值时，才替换该键的条目。这等效于：

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

不同之处在于该操作是以原子方式执行的。

参数：

key - 与指定值相关联的键

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

newValue - 与指定键相关联的值

返回：

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

抛出：

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

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

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

IllegalArgumentException - 如果指定键或值的某些属性不允许将其存储在此映射中

replace

V replace(K key,
          V value)

只有目前将键的条目映射到某一值时，才替换该键的条目。这等效于：

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

不同之处在于该操作是以原子方式执行的。

参数：

key - 与指定值相关联的键

value - 与指定键相关联的值

返回：

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

抛出：

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

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

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

IllegalArgumentException - 如果指定键或值的某些属性不允许将其存储在此映射中

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。