Интерфейс 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