ConcurrentMap

方法摘要
`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`

方法详细信息

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。

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。

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。

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。

软件包

类

树

已过时

Java^TM 2 Platform
Standard Ed. 5.0

上一个类 下一个类

框架 无框架

摘要：嵌套 | 字段 | 构造方法 | 方法

详细信息：字段 | 构造方法 | 方法

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