Интерфейс ConcurrentMap<K,V>

default V getOrDefault(Object key, V defaultValue)

Определён в:

getOrDefault в интерфейсе Map<K,V>

Примечание по реализации:

В этой реализации предполагается, что ConcurrentMap не может содержать значения null и get() возврат null однозначно означает отсутствие ключа. Реализации, поддерживающие значения null, должны переопределить эту реализацию по умолчанию.

Параметры:

key - ключ, значение которого требуется вернуть

defaultValue - отображение ключа по умолчанию

Возвращает:

значение, сопоставленное указанному ключу, или defaultValue, если в этой карте нет отображения для ключа

Вызывает:

ClassCastException - если тип ключа не подходит для этой карты (необязательно)

NullPointerException - если указанный ключ равен null, а эта карта не допускает ключи null (необязательно)

Начиная с:

1.8

default void forEach(BiConsumer<? super K, ? super V> action)

Определён в:

forEach в интерфейсе Map<K,V>

Требования к реализации:

Реализация по умолчанию эквивалентна следующему коду для этого map:

for (Map.Entry<K,V> entry : map.entrySet()) {
  action.accept(entry.getKey(), entry.getValue());
}

Примечание по реализации:

В реализации по умолчанию предполагается, что IllegalStateException, вызванное getKey() или getValue(), означает, что запись была удалена и не может быть обработана. Обработка последующих записей продолжается.

Параметры:

action - действие, выполняемое для каждой записи

Вызывает:

NullPointerException - если указанное действие равно null

Начиная с:

1.8

V putIfAbsent(K key, V value)

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

Определён в:

putIfAbsent в интерфейсе Map<K,V>

Примечание по реализации:

Эта реализация намеренно повторно объявляет абстрактным неподходящий метод по умолчанию, предоставленный в Map.

Параметры:

key - ключ, с которым требуется связать указанное значение

value - значение, которое требуется связать с указанным ключом

Возвращает:

предыдущее значение, связанное с указанным ключом, или null, если для ключа не было отображения. (Возвращаемое значение null также может означать, что ранее карта связывала ключ с null, если реализация поддерживает значения null.)

Вызывает:

UnsupportedOperationException - если эта карта не поддерживает операцию put

ClassCastException - если класс указанного ключа или значения не позволяет сохранить его в этой карте

NullPointerException - если указанный ключ или значение равны null, а эта карта не допускает ключи или значения null

IllegalArgumentException - если какое-либо свойство указанного ключа или значения не позволяет сохранить его в этой карте

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 в интерфейсе Map<K,V>

Примечание по реализации:

Эта реализация намеренно повторно объявляет абстрактным неподходящий метод по умолчанию, предоставленный в Map.

Параметры:

key - ключ, с которым связано указанное значение

value - значение, которое, как ожидается, связано с указанным ключом

Возвращает:

true, если значение было удалено

Вызывает:

UnsupportedOperationException - если эта карта не поддерживает операцию remove

ClassCastException - если тип ключа или значения не подходит для этой карты (необязательно)

NullPointerException - если указанный ключ или значение равны null, а эта карта не допускает ключи или значения null (необязательно)

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 в интерфейсе Map<K,V>

Примечание по реализации:

Эта реализация намеренно повторно объявляет абстрактным неподходящий метод по умолчанию, предоставленный в Map.

Параметры:

key - ключ, с которым связано указанное значение

oldValue - значение, которое, как ожидается, связано с указанным ключом

newValue - значение, которое требуется связать с указанным ключом

Возвращает:

true, если значение было заменено

Вызывает:

UnsupportedOperationException - если эта карта не поддерживает операцию put

ClassCastException - если класс указанного ключа или значения не позволяет сохранить его в этой карте

NullPointerException - если указанный ключ или значение равны null, а эта карта не допускает ключи или значения null

IllegalArgumentException - если какое-либо свойство указанного ключа или значения не позволяет сохранить его в этой карте

V replace(K key, V value)

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

Определён в:

replace в интерфейсе Map<K,V>

Примечание по реализации:

Эта реализация намеренно повторно объявляет абстрактным неподходящий метод по умолчанию, предоставленный в Map.

Параметры:

key - ключ, с которым связано указанное значение

value - значение, которое требуется связать с указанным ключом

Возвращает:

предыдущее значение, связанное с указанным ключом, или null, если для ключа не было отображения. (Возвращаемое значение null также может означать, что ранее карта связывала ключ с null, если реализация поддерживает значения null.)

Вызывает:

UnsupportedOperationException - если эта карта не поддерживает операцию put

ClassCastException - если класс указанного ключа или значения не позволяет сохранить его в этой карте

NullPointerException - если указанный ключ или значение равны null, а эта карта не допускает ключи или значения null

IllegalArgumentException - если какое-либо свойство указанного ключа или значения не позволяет сохранить его в этой карте

default void replaceAll(BiFunction<? super K, ? super V, ? extends V> function)

Определён в:

replaceAll в интерфейсе Map<K,V>

Требования к реализации:

Реализация по умолчанию эквивалентна следующему коду для этого map:

for (Map.Entry<K,V> entry : map.entrySet()) {
  K k;
  V v;
  do {
    k = entry.getKey();
    v = entry.getValue();
  } while (!map.replace(k, v, function.apply(k, v)));
}

Реализация по умолчанию может повторять эти шаги, если несколько потоков пытаются выполнить обновления, в том числе потенциально вызывая функцию несколько раз для одного ключа.

В этой реализации предполагается, что ConcurrentMap не может содержать значения null и get() возврат null однозначно означает отсутствие ключа. Реализации, поддерживающие значения null, должны переопределить эту реализацию по умолчанию.

Параметры:

function - функция, применяемая к каждой записи

Вызывает:

UnsupportedOperationException - если эта карта не поддерживает операцию replaceAll (необязательно)

NullPointerException - если указанная функция равна null или если новое значение равно null, а эта карта не допускает значения null (необязательно)

ClassCastException - если класс нового значения не позволяет сохранить его в этой карте (необязательно)

IllegalArgumentException - если какое-либо свойство нового значения не позволяет сохранить его в этой карте (необязательно)

Начиная с:

1.8

default V computeIfAbsent(K key, Function<? super K, ? extends V> mappingFunction)

map.computeIfAbsent(key, k -> new Value(f(k)));

map.computeIfAbsent(key, k -> new HashSet<V>()).add(v);

Определён в:

computeIfAbsent в интерфейсе Map<K,V>

Требования к реализации:

Реализация по умолчанию эквивалентна следующим шагам для этого map:

V oldValue, newValue;
return ((oldValue = map.get(key)) == null
        && (newValue = mappingFunction.apply(key)) != null
        && (oldValue = map.putIfAbsent(key, newValue)) == null)
  ? newValue
  : oldValue;

В этой реализации предполагается, что ConcurrentMap не может содержать значения null и get() возврат null однозначно означает отсутствие ключа. Реализации, поддерживающие значения null, должны переопределить эту реализацию по умолчанию.

Параметры:

key - ключ, с которым требуется связать указанное значение

mappingFunction - функция отображения для вычисления значения

Возвращает:

текущее (существующее или вычисленное) значение, связанное с указанным ключом, или null, если вычисленное значение равно null

Вызывает:

UnsupportedOperationException - если эта карта не поддерживает операцию computeIfAbsent (необязательно)

ClassCastException - если класс указанного ключа или значения не позволяет сохранить его в этой карте (необязательно)

NullPointerException - если указанный ключ равен null, а эта карта не поддерживает ключи null, либо если mappingFunction равна null

IllegalArgumentException - если какое-либо свойство указанного ключа или значения не позволяет сохранить его в этой карте (необязательно)

Начиная с:

1.8

default V computeIfPresent(K key, BiFunction<? super K, ? super V, ? extends V> remappingFunction)

Определён в:

computeIfPresent в интерфейсе Map<K,V>

Требования к реализации:

Реализация по умолчанию эквивалентна выполнению следующих шагов для этого map:

for (V oldValue; (oldValue = map.get(key)) != null; ) {
  V newValue = remappingFunction.apply(key, oldValue);
  if ((newValue == null)
      ? map.remove(key, oldValue)
      : map.replace(key, oldValue, newValue))
    return newValue;
}
return null;

При попытках обновления из нескольких потоков операции с картой и функция переотображения могут вызываться несколько раз.

В этой реализации предполагается, что ConcurrentMap не может содержать значения null и get() возврат null однозначно означает отсутствие ключа. Реализации, поддерживающие значения null, должны переопределить эту реализацию по умолчанию.

Параметры:

key - ключ, с которым требуется связать указанное значение

remappingFunction - функция переотображения для вычисления значения

Возвращает:

новое значение, связанное с указанным ключом, или null, если значения нет

Вызывает:

UnsupportedOperationException - если эта карта не поддерживает операцию computeIfPresent (необязательно)

ClassCastException - если класс указанного ключа или значения не позволяет сохранить его в этой карте (необязательно)

NullPointerException - если указанный ключ равен null, а эта карта не поддерживает ключи null, либо если remappingFunction равна null

IllegalArgumentException - если какое-либо свойство указанного ключа или значения не позволяет сохранить его в этой карте (необязательно)

Начиная с:

1.8

default V compute(K key, BiFunction<? super K, ? super V, ? extends V> remappingFunction)

map.compute(key, (k, v) -> (v == null) ? msg : v.concat(msg))

Определён в:

compute в интерфейсе Map<K,V>

Требования к реализации:

Реализация по умолчанию эквивалентна выполнению следующих шагов для этого map:

for (;;) {
  V oldValue = map.get(key);
  V newValue = remappingFunction.apply(key, oldValue);
  if (newValue != null) {
    if ((oldValue != null)
      ? map.replace(key, oldValue, newValue)
      : map.putIfAbsent(key, newValue) == null)
      return newValue;
  } else if (oldValue == null || map.remove(key, oldValue)) {
    return null;
  }
}

При попытках обновления из нескольких потоков операции с картой и функция переотображения могут вызываться несколько раз.

В этой реализации предполагается, что ConcurrentMap не может содержать значения null и get() возврат null однозначно означает отсутствие ключа. Реализации, поддерживающие значения null, должны переопределить эту реализацию по умолчанию.

Параметры:

key - ключ, с которым требуется связать указанное значение

remappingFunction - функция переотображения для вычисления значения

Возвращает:

новое значение, связанное с указанным ключом, или null, если значения нет

Вызывает:

UnsupportedOperationException - если эта карта не поддерживает операцию compute (необязательно)

ClassCastException - если класс указанного ключа или значения не позволяет сохранить его в этой карте (необязательно)

NullPointerException - если указанный ключ равен null, а эта карта не поддерживает ключи null, либо если remappingFunction равна null

IllegalArgumentException - если какое-либо свойство указанного ключа или значения не позволяет сохранить его в этой карте (необязательно)

Начиная с:

1.8

default V merge(K key, V value, BiFunction<? super V, ? super V, ? extends V> remappingFunction)

map.merge(key, msg, String::concat)

Определён в:

merge в интерфейсе Map<K,V>

Требования к реализации:

Реализация по умолчанию эквивалентна выполнению следующих шагов для этого map:

for (;;) {
  V oldValue = map.get(key);
  if (oldValue != null) {
    V newValue = remappingFunction.apply(oldValue, value);
    if (newValue != null) {
      if (map.replace(key, oldValue, newValue))
        return newValue;
    } else if (map.remove(key, oldValue)) {
      return null;
    }
  } else if (map.putIfAbsent(key, value) == null) {
    return value;
  }
}

При попытках обновления из нескольких потоков операции с картой и функция переотображения могут вызываться несколько раз.

В этой реализации предполагается, что ConcurrentMap не может содержать значения null и get() возврат null однозначно означает отсутствие ключа. Реализации, поддерживающие значения null, должны переопределить эту реализацию по умолчанию.

Параметры:

key - ключ, с которым требуется связать результирующее значение

value - ненулевое значение, которое требуется объединить с существующим значением, связанным с ключом, или связать с ключом, если существующее значение отсутствует либо равно null

remappingFunction - функция переотображения для повторного вычисления значения, если оно имеется

Возвращает:

новое значение, связанное с указанным ключом, или null, если с ключом не связано никакого значения

Вызывает:

UnsupportedOperationException - если эта карта не поддерживает операцию merge (необязательно)

ClassCastException - если класс указанного ключа или значения не позволяет сохранить его в этой карте (необязательно)

NullPointerException - если указанный ключ равен null, а эта карта не поддерживает ключи null, либо если значение или remappingFunction равны null

IllegalArgumentException - если какое-либо свойство указанного ключа или значения не позволяет сохранить его в этой карте (необязательно)

Начиная с:

1.8