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