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

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)

Переопределяет:

equals в классе Object

Параметры:

o — объект, который нужно сравнить на равенство с этой картой

Возвращает:

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

См. также:

• Object.hashCode()
• HashMap

int hashCode()

Переопределяет:

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-ключи или 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-ключи или 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-ключи или 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, или если remappingFunction равна 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, или если remappingFunction равна 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, либо если значение или remappingFunction равны 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 - значение второго соответствия

Возвращает:

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 - тип ключа карты Map

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

Параметры:

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

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

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

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

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

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

Возвращает:

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 - тип ключа карты Map

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

Параметры:

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

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

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

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

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

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

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

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

Возвращает:

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 - тип ключа карты Map

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

Параметры:

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

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

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

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

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

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

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

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

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

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

Возвращает:

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 - тип ключа карты Map

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

Параметры:

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

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

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

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

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

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

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

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

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

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

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

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

Возвращает:

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 - тип ключа карты Map

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

Параметры:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Возвращает:

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 - тип ключа карты Map

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

Параметры:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Возвращает:

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 - значение первого соответствия

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

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

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

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

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

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

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

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

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

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

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

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

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

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

k9 - ключ девятого соответствия

v9 - значение девятого соответствия

Возвращает:

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 k10, V v10)

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

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

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

Параметры:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

k9 - ключ девятого соответствия

v9 - значение девятого соответствия

k10 - ключ десятого соответствия

v10 - значение десятого соответствия

Возвращает:

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

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

IllegalArgumentException - если имеются повторяющиеся ключи

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

С версии:

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и, содержащие ключи и значения, из которых формируется карта

Возвращает:

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

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

IllegalArgumentException - если имеются повторяющиеся ключи

NullPointerException - если любая запись, ключ или значение равны null либо если массив entries равен null

См. также:

• Map.entry()

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

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

Сериализуемый Entry см. в AbstractMap.SimpleEntry или AbstractMap.SimpleImmutableEntry.

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

K — тип ключа

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

Параметры:

k — ключ

v — значение

Возвращает:

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

Исключения:

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

Начиная с версии:

9

См. также:

• Map.ofEntries()

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

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

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

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

K — тип ключей Map

V — тип значений Map

Параметры:

map — Map, из которой берутся записи; не должна быть null

Возвращает:

Map, содержащую записи заданной Map

Исключения:

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

Начиная с версии:

10

static <K,V> Map<K,V> ofLazy(Set<? extends K> keys, Function<? super K, ? extends V> computingFunction)

class Application {

    private static final Map<Integer, Double> CACHE
        = Map.ofLazy(Set.of(0, 1, 3, 42, 97), param -> expensiveOperation(param));

    public static Optional<Double> cachedExpensiveOperation(int param) {
        return Optional.ofNullable(CACHE.get(param));
    }

    private static double expensiveOperation(int param) {
      // Calculate the value ...
    }

     // Eligible for constant folding
     double val = cachedExpensiveOperation(42).orElseThrow();

}

 class LazyMap<K, V> extends AbstractMap<K, V> {

     private final Map<K, LazyConstant<V>> backingMap;

     public LazyMap(Set<K> keys, Function<K, V> computingFunction) {
         this.backingMap = keys.stream()
                 .collect(Collectors.toUnmodifiableMap(
                         Function.identity(),
                         k -> LazyConstant.of(() -> computingFunction.apply(k))));
     }

     @Override
     public V get(Object key) {
         var lazyConstant = backingMap.get(key);
         return lazyConstant == null
                 ? null
                 : lazyConstant.get();
     }
 }

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

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

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

K — тип ключей, хранящихся в возвращённой карте

V — тип отображаемых значений в возвращённой карте

Параметры:

keys — ключи (не равные null) возвращённой вычисляемой карты

computingFunction — вызывается при первом обращении к соответствующему значению

Возвращает:

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

Исключения:

NullPointerException — если предоставленный набор keys равен null, если набор keys содержит элемент null или если предоставленный computingFunction равен null

Начиная с версии:

26

См. также:

• LazyConstant^{ПРЕДВАРИТЕЛЬНАЯ ВЕРСИЯ}