JavaTM 2 Platform
Standard Ed. 5.0

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

类型参数:
K - 此映射维护的键类型
V - 映射值的类型
所有超级接口:
Map<K,V>
所有已知实现类:
ConcurrentHashMap

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

提供其他原子 putIfAbsentremovereplace 方法的 Map

此接口是 Java Collections Framework 的成员。

从以下版本开始:
1.5

嵌套类摘要
 
从接口 java.util.Map 继承的嵌套类/接口
Map.Entry<K,V>
 
方法摘要
 V putIfAbsent(K key, V value)
          如果指定键已经不再与某个值相关联,则将它与给定值关联。
 boolean remove(Object key, Object value)
          只有目前将键的条目映射到给定值时,才移除该键的条目。
 V replace(K key, V value)
          只有目前将键的条目映射到某一值时,才替换该键的条目。
 boolean replace(K key, V oldValue, V newValue)
          只有目前将键的条目映射到给定值时,才替换该键的条目。
 
从接口 java.util.Map 继承的方法
clear, containsKey, containsValue, entrySet, equals, get, hashCode, isEmpty, keySet, put, putAll, remove, size, values
 

方法详细信息

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 - 如果指定键或值的类不允许将其存储在此映射中。
IllegalArgumentException - 如果此键或值的某些方面不允许将其存储在此映射中。
NullPointerException - 如果此映射不允许 null 键或值,并且指定的键或值为 null

remove

boolean remove(Object key,
               Object value)
只有目前将键的条目映射到给定值时,才移除该键的条目。操作如下:
 
  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(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 - 与指定键相关联的值。
返回:
如果该值被替换,则返回 ture
抛出:
UnsupportedOperationException - 如果此映射不支持 put 操作。
NullPointerException - 如果此映射不允许使用 null 键或值,并且指定的键或值为 null

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 操作。
NullPointerException - 如果此映射不允许 null 键或值,并且指定的键或值为 null

JavaTM 2 Platform
Standard Ed. 5.0

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

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