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

• Object.hashCode()
• HashMap

• Map.Entry.hashCode()
• Object.equals(Object)
• equals(Object)

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

Базовая реализация эквивалентна для этого map:

 
 for (Map.Entry<K, V> entry : map.entrySet())
     entry.setValue(function.apply(entry.getKey(), entry.getValue()));
 

Базовая реализация не дает никаких гарантий о синхронизации или атомарности этого метода. Любая реализация, предоставляющая гарантии атомарности, должна переопределить этот метод и задокументировать свои свойства параллельности.

 
 V v = map.get(key);
 if (v == null)
     v = map.put(key, value);

 return v;
 

Базовая реализация не дает никаких гарантий о синхронизации или атомарности этого метода. Любая реализация, предоставляющая гарантии атомарности, должна переопределить этот метод и задокументировать свои свойства параллельности.

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

Базовая реализация не дает никаких гарантий о синхронизации или атомарности этого метода. Любая реализация, предоставляющая гарантии атомарности, должна переопределить этот метод и задокументировать свои свойства параллельности.

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

Стандартная реализация не гарантирует синхронизацию или атомарность этого метода. Любая реализация, обеспечивающая гарантии атомарности, должна переопределить этот метод и задокументировать свои свойства конкурентности.

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

Стандартная реализация не гарантирует синхронизацию или атомарность этого метода. Любая реализация, обеспечивающая гарантии атомарности, должна переопределить этот метод и задокументировать свои свойства конкурентности.

 
 if (map.get(key) == null) {
     V newValue = mappingFunction.apply(key);
     if (newValue != null)
         map.put(key, newValue);
 }
 

Стандартная реализация не гарантирует обнаружение, если функция сопоставления изменяет эту карту во время вычисления и, при необходимости, сообщает об ошибке. Неконкурентные реализации должны переопределить этот метод и по возможности выбросить ConcurrentModificationException если обнаружено, что функция сопоставления изменяет эту карту во время вычисления. Конкурентные реализации должны переопределить этот метод и по возможности выбросить IllegalStateException если обнаружено, что функция сопоставления изменяет эту карту во время вычисления, и в результате вычисление никогда не завершится.

Стандартная реализация не гарантирует синхронизацию или атомарность этого метода. Любая реализация, обеспечивающая гарантии атомарности, должна переопределить этот метод и задокументировать свои свойства конкурентности. В частности, все реализации подинтерфейса ConcurrentMap должны задокументировать, применяется ли функция сопоставления один раз атомарно только в том случае, если значение отсутствует.

 
 if (map.get(key) != null) {
     V oldValue = map.get(key);
     V newValue = remappingFunction.apply(key, oldValue);
     if (newValue != null)
         map.put(key, newValue);
     else
         map.remove(key);
 }
 

Стандартная реализация не гарантирует обнаружение, если функция переназначения изменяет эту карту во время вычисления и, при необходимости, сообщает об ошибке. Неконкурентные реализации должны переопределить этот метод и по возможности выбросить ConcurrentModificationException если обнаружено, что функция переназначения изменяет эту карту во время вычисления. Конкурентные реализации должны переопределить этот метод и по возможности выбросить IllegalStateException если обнаружено, что функция переназначения изменяет эту карту во время вычисления, и в результате вычисление никогда не завершится.

Стандартная реализация не гарантирует синхронизацию или атомарность этого метода. Любая реализация, обеспечивающая гарантии атомарности, должна переопределить этот метод и задокументировать свои свойства конкурентности. В частности, все реализации подинтерфейса ConcurrentMap должны задокументировать, применяется ли функция переназначения один раз атомарно только в том случае, если значение отсутствует.

 
 V oldValue = map.get(key);
 V newValue = remappingFunction.apply(key, oldValue);
 if (newValue != null) {
     map.put(key, newValue);
 } else if (oldValue != null || map.containsKey(key)) {
     map.remove(key);
 }
 return newValue;
 

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

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

 
 V oldValue = map.get(key);
 V newValue = (oldValue == null) ? value :
              remappingFunction.apply(oldValue, value);
 if (newValue == null)
     map.remove(key);
 else
     map.put(key, newValue);
 

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

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

     import static java.util.Map.entry;

     Map<Integer,String> map = Map.ofEntries(
         entry(1, "a"),
         entry(2, "b"),
         entry(3, "c"),
         ...
         entry(26, "z"));
 

• Map.entry()

• Map.ofEntries()