Интерфейс MapV>

int size()

Возвращает:

количество пар «ключ-значение» в этом отображении

boolean isEmpty()

Возвращает:

true, если это отображение не содержит пар «ключ-значение»

boolean containsKey(Object key)

Параметры:

key - ключ, присутствие которого в этом отображении необходимо проверить

Возвращает:

true, если это отображение содержит отображение для указанного ключа

Исключения:

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

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

boolean containsValue(Object value)

Параметры:

value - значение, присутствие которого в этом отображении необходимо проверить

Возвращает:

true, если это отображение отображает один или несколько ключей на указанное значение

Исключения:

ClassCastException - если значение неподходящего типа для этого отображения (необязательно)

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

V get(Object key)

Параметры:

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

Возвращает:

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

Исключения:

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

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

V put(K key, V value)

Параметры:

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

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

Возвращает:

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

Исключения:

UnsupportedOperationException - если операция put не поддерживается этим отображением

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

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

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

V remove(Object key)

Параметры:

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

Возвращает:

предыдущее значение, связанное с key, или null, если для key не было отображения.

Исключения:

UnsupportedOperationException - если операция remove не поддерживается этим отображением

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

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

void putAll(Map<? extends K, ? extends V> m)

Параметры:

m - отображения, которые нужно сохранить в этом отображении

Исключения:

UnsupportedOperationException - если операция putAll не поддерживается этим отображением

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

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

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

void clear()

Исключения:

UnsupportedOperationException - если операция clear не поддерживается этим отображением

Set<K> keySet()

Возвращает:

вид множества ключей, содержащихся в этом отображении

Collection<V> values()

Возвращает:

представление коллекции значений, содержащихся в этой карте

Set<Map.Entry<K,V>> entrySet()

Возвращает:

представление множества отображений, содержащихся в этой карте

boolean equals(Object o)

Overrides:

equals в классе Object

Параметры:

o - объект для сравнения на равенство с этой картой

Возвращает:

true, если указанный объект равен этой карте

См. также:

• Object.hashCode()
• HashMap

int hashCode()

Overrides:

hashCode в классе Object

Возвращает:

значение хэш-кода для этой карты

См. также:

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

default V getOrDefault(Object key, V defaultValue)

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

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

Параметры:

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

defaultValue - значение по умолчанию для ключа

Возвращает:

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

Исключения:

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

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

С момента:

1.8

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

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

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

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

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

Параметры:

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

Исключения:

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

ConcurrentModificationException - если запись найдена для удаления во время итерации

С момента:

1.8

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

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

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

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

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

Параметры:

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

Исключения:

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

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

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

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

ConcurrentModificationException - если запись найдена для удаления во время итерации

С момента:

1.8

default V putIfAbsent(K key, V value)

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

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

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

 return v;
 

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

Параметры:

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

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

Возвращает:

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

Исключения:

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

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

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

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

С момента:

1.8

default boolean remove(Object key, Object value)

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

Базовая реализация эквивалентна следующему для этой map:

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

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

Параметры:

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

value - значение, ожидаемое для указанного ключа

Возвращает:

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

Выбрасывает:

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

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

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

С момента:

1.8

default boolean replace(K key, V oldValue, V newValue)

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

Базовая реализация эквивалентна следующему для этой map:

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

Базовая реализация не выбрасывает NullPointerException для карт, не поддерживающих null-значения, если oldValue равно null, если newValue также не равно null.

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

Параметры:

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

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

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

Возвращает:

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

Выбрасывает:

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

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

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

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

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

С момента:

1.8

default V replace(K key, V value)

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

Базовая реализация эквивалентна следующему для этой map:

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

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

Параметры:

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

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

Возвращает:

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

Выбрасывает:

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

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

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

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);
 

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

Базовая реализация эквивалентна следующим шагам для этой map, затем возвращает текущее значение или null, если сейчас отсутствует:

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

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

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

Параметры:

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

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

Возвращает:

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

Выбрасывает:

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

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

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

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

С момента:

1.8

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

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

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

 
 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 должны указать, применяется ли функция переназначения один раз атомарно только в том случае, если значение отсутствует.

Параметры:

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

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

Возвращает:

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

Исключения:

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

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

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

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))

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

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

 
 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 должны указать, применяется ли функция переназначения один раз атомарно только в том случае, если значение отсутствует.

Параметры:

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

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

Возвращает:

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

Исключения:

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

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

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

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

С:

1.8

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

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

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

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

 
 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 должны указать, применяется ли функция переназначения один раз атомарно только в том случае, если значение отсутствует.

Параметры:

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

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

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

Возвращает:

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

Исключения:

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

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

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

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

С:

1.8

static <K,V> Map<K,V> of()

Тип параметров:

K - тип ключа Map

V - тип значения Map

Возвращает:

пустой Map

С:

9

static <K,V> Map<K,V> of(K k1, V v1)

Тип параметров:

K - тип ключа Map

V - тип значения Map

Параметры:

k1 - ключ отображения

v1 - значение отображения

Возвращает:

Map, содержащий указанное отображение

Исключения:

NullPointerException - если ключ или значение null

С:

9

static <K,V> Map<K,V> of(K k1, V v1, K k2, V v2)

Параметры типа:

K - тип ключа Map

V - тип значения Map

Параметры:

k1 - ключ первого отображения

v1 - значение первого отображения

k2 - ключ второго отображения

v2 - значение второго отображения

Возвращает:

a Map containing the specified mappings

Исключения:

IllegalArgumentException - если ключи являются дубликатами

NullPointerException - если любой ключ или значение является null

С версии:

9

static <K,V> Map<K,V> of(K k1, V v1, K k2, V v2, K k3, V v3)

Параметры типа:

K - тип ключа Map

V - тип значения Map

Параметры:

k1 - ключ первого отображения

v1 - значение первого отображения

k2 - ключ второго отображения

v2 - значение второго отображения

k3 - ключ третьего отображения

v3 - значение третьего отображения

Возвращает:

a Map containing the specified mappings

Исключения:

IllegalArgumentException - если есть какие-либо дубликаты ключей

NullPointerException - если любой ключ или значение является null

С версии:

9

static <K,V> Map<K,V> of(K k1, V v1, K k2, V v2, K k3, V v3, K k4, V v4)

Параметры типа:

K - тип ключа Map

V - тип значения Map

Параметры:

k1 - ключ первого отображения

v1 - значение первого отображения

k2 - ключ второго отображения

v2 - значение второго отображения

k3 - ключ третьего отображения

v3 - значение третьего отображения

k4 - ключ четвёртого отображения

v4 - значение четвёртого отображения

Возвращает:

a Map containing the specified mappings

Исключения:

IllegalArgumentException - если есть какие-либо дубликаты ключей

NullPointerException - если любой ключ или значение является null

С версии:

9

static <K,V> Map<K,V> of(K k1, V v1, K k2, V v2, K k3, V v3, K k4, V v4, K k5, V v5)

Параметры типа:

K - тип ключа Map

V - тип значения Map

Параметры:

k1 - ключ первого отображения

v1 - значение первого отображения

k2 - ключ второго отображения

v2 - значение второго отображения

k3 - ключ третьего отображения

v3 - значение третьего отображения

k4 - ключ четвёртого отображения

v4 - значение четвёртого отображения

k5 - ключ пятого отображения

v5 - значение пятого отображения

Возвращает:

a Map containing the specified mappings

Исключения:

IllegalArgumentException - если есть какие-либо дубликаты ключей

NullPointerException - если любой ключ или значение является null

С версии:

9

static <K,V> Map<K,V> of(K k1, V v1, K k2, V v2, K k3, V v3, K k4, V v4, K k5, V v5, K k6, V v6)

Параметры типа:

K - тип ключа Map

V - тип значения Map

Параметры:

k1 - ключ первого отображения

v1 - значение первого отображения

k2 - ключ второго отображения

v2 - значение второго отображения

k3 - ключ третьего отображения

v3 - значение третьего отображения

k4 - ключ четвёртого отображения

v4 - значение четвёртого отображения

k5 - ключ пятого отображения

v5 - значение пятого отображения

k6 - ключ шестого отображения

v6 - значение шестого отображения

Возвращает:

a Map containing the specified mappings

Исключения:

IllegalArgumentException - если есть какие-либо дубликаты ключей

NullPointerException - если любой ключ или значение является null

С версии:

9

static <K,V> Map<K,V> of(K k1, V v1, K k2, V v2, K k3, V v3, K k4, V v4, K k5, V v5, K k6, V v6, K k7, V v7)

Параметры типа:

K - тип ключа Map

V - тип значения Map

Параметры:

k1 - ключ первого отображения

v1 - значение первого отображения

k2 - ключ второго отображения

v2 - значение второго отображения

k3 - ключ третьего отображения

v3 - значение третьего отображения

k4 - ключ четвёртого отображения

v4 - значение четвёртого отображения

k5 - ключ пятого отображения

v5 - значение пятого отображения

k6 - ключ шестого отображения

v6 - значение шестого отображения

k7 - ключ седьмого отображения

v7 - значение седьмого отображения

Возвращает:

a Map containing the specified mappings

Исключения:

IllegalArgumentException - если есть какие-либо дубликаты ключей

NullPointerException - если любой ключ или значение является null

С версии:

9

static <K,V> Map<K,V> of(K k1, V v1, K k2, V v2, K k3, V v3, K k4, V v4, K k5, V v5, K k6, V v6, K k7, V v7, K k8, V v8)

Параметры типа:

K - тип ключа Map

V - тип значения Map

Параметры:

k1 - ключ первого сопоставления

v1 - значение первого сопоставления

k2 - ключ второго сопоставления

v2 - значение второго сопоставления

k3 - ключ третьего сопоставления

v3 - значение третьего сопоставления

k4 - ключ четвертого сопоставления

v4 - значение четвертого сопоставления

k5 - ключ пятого сопоставления

v5 - значение пятого сопоставления

k6 - ключ шестого сопоставления

v6 - значение шестого сопоставления

k7 - ключ седьмого сопоставления

v7 - значение седьмого сопоставления

k8 - ключ восьмого сопоставления

v8 - значение восьмого сопоставления

Возвращает:

a Map, содержащую указанные сопоставления

Исключения:

IllegalArgumentException - если имеются дубликаты ключей

NullPointerException - если любой ключ или значение является null

С тех пор как:

9

static <K,V> Map<K,V> of(K k1, V v1, K k2, V v2, K k3, V v3, K k4, V v4, K k5, V v5, K k6, V v6, K k7, V v7, K k8, V v8, K k9, V v9)

Параметры типа:

K - тип ключа Map

V - тип значения Map

Параметры:

k1 - ключ первого сопоставления

v1 - значение первого сопоставления

...

Возвращает:

a Map, содержащую указанные сопоставления

Исключения:

...

С тех пор как:

9

static <K,V> Map<K,V> of(K k1, V v1, K k2, V v2, K k3, V v3, K k4, V v4, K k5, V v5, K k6, V v6, K k7, V v7, K k8, V v8, K k9, V v9, K k10, V v10)

Параметры типа:

K - тип ключа Map

V - тип значения Map

Параметры:

...

Возвращает:

a Map, содержащую указанные сопоставления

Исключения:

...

С тех пор как:

9

@SafeVarargs static <K,V> Map<K,V> ofEntries(Map.Entry<? extends K, ? extends V>... entries)

Примечание API:

Удобно создавать записи карты с помощью метода Map.entry(). Например,

     import static java.util.Map.entry;

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

Параметры типа:

K - тип ключа Map

V - тип значения Map

Параметры:

entries - Map.Entry, содержащие ключи и значения, из которых заполняется карта

Возвращает:

a Map, содержащую указанные сопоставления

Исключения:

...

С тех пор как:

9

См. также:

• Map.entry()

static <K,V> Map.Entry<K,V> entry(K k, V v)

Примечание API:

Для сериализуемой Entry, см. AbstractMap.SimpleEntry или AbstractMap.SimpleImmutableEntry.

Параметры типа:

K - тип ключа

V - тип значения

Параметры:

k - ключ

v - значение

Возвращает:

a Entry, содержащую указанный ключ и значение

Исключения:

NullPointerException - если ключ или значение являются null

С тех пор как:

9

См. также:

• Map.ofEntries()

static <K,V> Map<K,V> copyOf(Map<? extends K, ? extends V> map)

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

Если заданная карта является неизменяемой картой, вызов copyOf обычно не создаст копию.

Параметры типа:

K - тип ключа карты

V - тип значения карты

Параметры:

map - карта, из которой берутся элементы, не должна быть null

Возвращает:

неизменяемую карту, содержащую элементы заданной карты

Исключения:

NullPointerException - если карта равна null или содержит null-ключи или значения

С момента:

10