Связки интерфейса

Все суперинтерфейсы:: Map<String,Object>

Все известные реализующие классы:: SimpleBindings

public interface Bindings extends Map<String,Object>

Сопоставление пар «ключ/значение», все ключи которого являются Strings.

Начиная с:: 1.6

Краткое описание вложенных классов

Вложенные классы/интерфейсы, объявленные в интерфейсе Map

Map.Entry<K,V>

Модификатор и тип	Интерфейс	Описание
`static interface`	`Map.Entry<K,V>`	Запись карты (пара «ключ-значение»).

Краткое описание методов

Модификатор и тип	Метод	Описание
`boolean`	`containsKey(Object key)`	Возвращает `true`, если эта карта содержит сопоставление для указанного ключа.
`Object`	`get(Object key)`	Возвращает значение, которому эта карта сопоставляет указанный ключ.
`Object`	`put(String name, Object value)`	Задаёт именованное значение.
`void`	`putAll(Map<? extends String, ? extends Object> toMerge)`	Добавляет все сопоставления из заданной `Map` в эту `Bindings`.
`Object`	`remove(Object key)`	Удаляет сопоставление для этого ключа из этой карты, если оно существует (необязательная операция).

Методы, объявленные в интерфейсе Map

clear, compute, computeIfAbsent, computeIfPresent, containsValue, entrySet, equals, forEach, getOrDefault, hashCode, isEmpty, keySet, merge, putIfAbsent, remove, replace, replace, replaceAll, size, values

Модификатор и тип	Метод	Описание
`void`	`clear()`	Удаляет все сопоставления из этой карты (необязательная операция).
`default Object`	`compute(String key, BiFunction<? super String, ? super Object, ? extends Object> remappingFunction)`	Пытается вычислить сопоставление для указанного ключа и его текущего сопоставленного значения либо `null`, если текущее сопоставление отсутствует (необязательная операция).
`default Object`	`computeIfAbsent(String key, Function<? super String, ? extends Object> mappingFunction)`	Если указанному ключу ещё не сопоставлено значение (или ему сопоставлено `null`), пытается вычислить его значение с помощью заданной функции сопоставления и добавляет его в эту карту, если результат не равен `null` (необязательная операция).
`default Object`	`computeIfPresent(String key, BiFunction<? super String, ? super Object, ? extends Object> remappingFunction)`	Если значение для указанного ключа существует и не равно null, пытается вычислить новое сопоставление на основе ключа и его текущего сопоставленного значения (необязательная операция).
`boolean`	`containsValue(Object value)`	Возвращает `true`, если эта карта сопоставляет одно или несколько значений с указанным значением.
`Set<Map.Entry<String,Object>>`	`entrySet()`	Возвращает представление `Set` сопоставлений, содержащихся в этой карте.
`boolean`	`equals(Object o)`	Сравнивает указанный объект с этой картой на равенство.
`default void`	`forEach(BiConsumer<? super String, ? super Object> action)`	Выполняет заданное действие для каждой записи этой карты, пока не будут обработаны все записи или действие не вызовет исключение.
`default Object`	`getOrDefault(Object key, Object defaultValue)`	Возвращает значение, сопоставленное с указанным ключом, или `defaultValue`, если эта карта не содержит сопоставления для ключа.
`int`	`hashCode()`	Возвращает значение хеш-кода этой карты.
`boolean`	`isEmpty()`	Возвращает `true`, если эта карта не содержит сопоставлений ключ-значение.
`Set<String>`	`keySet()`	Возвращает представление `Set` ключей, содержащихся в этой карте.
`default Object`	`merge(String key, Object value, BiFunction<? super Object, ? super Object, ? extends Object> remappingFunction)`	Если указанному ключу ещё не сопоставлено значение или ему сопоставлено null, сопоставляет ему заданное ненулевое значение (необязательная операция).
`default Object`	`putIfAbsent(String key, Object value)`	Если указанному ключу ещё не сопоставлено значение (или ему сопоставлено `null`), сопоставляет ему заданное значение и возвращает `null`; в противном случае возвращает текущее значение (необязательная операция).
`default boolean`	`remove(Object key, Object value)`	Удаляет запись для указанного ключа, только если в данный момент ему сопоставлено указанное значение (необязательная операция).
`default Object`	`replace(String key, Object value)`	Заменяет запись для указанного ключа, только если в данный момент ему сопоставлено какое-либо значение (необязательная операция).
`default boolean`	`replace(String key, Object oldValue, Object newValue)`	Заменяет запись для указанного ключа, только если в данный момент ему сопоставлено указанное значение (необязательная операция).
`default void`	`replaceAll(BiFunction<? super String, ? super Object, ? extends Object> function)`	Заменяет значение каждой записи результатом вызова заданной функции для этой записи, пока не будут обработаны все записи или функция не вызовет исключение (необязательная операция).
`int`	`size()`	Возвращает количество сопоставлений ключ-значение в этой карте.
`Collection<Object>`	`values()`	Возвращает представление `Collection` значений, содержащихся в этой карте.

Подробное описание методов

put

Object put(String name, Object value)

Задаёт именованное значение.

Указано в:: put в интерфейсе Map<String,Object>
Параметры:: name — имя, связанное со значением.; value — значение, связанное с именем.
Возвращает:: Значение, ранее связанное с заданным именем. Возвращает null, если ранее с этим именем не было связано значение.
Вызывает:: NullPointerException — если имя равно null.; IllegalArgumentException — если имя представляет собой пустую строку.

putAll

void putAll(Map<? extends String, ? extends Object> toMerge)

Добавляет все сопоставления из заданной Map в эту Bindings.

Указано в:: putAll в интерфейсе Map<String,Object>
Параметры:: toMerge — Map, с которым выполняется объединение.
Вызывает:: NullPointerException — если карта toMerge равна null или если какой-либо ключ в карте равен null.; IllegalArgumentException — если какой-либо ключ в карте является пустой строкой.

containsKey

boolean containsKey(Object key)

Возвращает true, если эта карта содержит сопоставление для указанного ключа. Точнее, возвращает true тогда и только тогда, когда эта карта содержит сопоставление для ключа k, такого что (key==null ? k==null : key.equals(k)). (Такое сопоставление может быть не более чем одно.)

Указано в:: containsKey в интерфейсе Map<String,Object>
Параметры:: key — ключ, наличие которого в этой карте проверяется.
Возвращает:: true, если эта карта содержит сопоставление для указанного ключа.
Вызывает:: NullPointerException — если ключ равен null; ClassCastException — если ключ не является String; IllegalArgumentException — если ключ является пустой строкой

get

Object get(Object key)

Возвращает значение, которому эта карта сопоставляет указанный ключ. Возвращает null, если карта не содержит сопоставления для этого ключа. Возвращаемое значение null не обязательно означает, что карта не содержит сопоставления для ключа; возможно также, что карта явно сопоставляет ключ с null. Чтобы различить эти два случая, можно использовать операцию containsKey.

Точнее, если эта карта содержит сопоставление ключа k со значением v, такое что (key==null ? k==null : key.equals(k)), этот метод возвращает v; в противном случае он возвращает null. (Такое сопоставление может быть не более чем одно.)

Указано в:: get в интерфейсе Map<String,Object>
Параметры:: key — ключ, значение которого требуется вернуть.
Возвращает:: значение, которому эта карта сопоставляет указанный ключ, или null, если карта не содержит сопоставления для этого ключа.
Вызывает:: NullPointerException — если ключ равен null; ClassCastException — если ключ не является String; IllegalArgumentException — если ключ является пустой строкой

remove

Object remove(Object key)

Удаляет сопоставление для этого ключа из этой карты, если оно существует (необязательная операция). Точнее, если эта карта содержит сопоставление ключа k со значением v, такое что (key==null ? k==null : key.equals(k)), это сопоставление удаляется. (Карта может содержать не более одного такого сопоставления.)

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

Указано в:: remove в интерфейсе Map<String,Object>
Параметры:: key — ключ, сопоставление для которого требуется удалить из карты.
Возвращает:: предыдущее значение, связанное с указанным ключом, или null, если сопоставления для ключа не было.
Вызывает:: NullPointerException — если ключ равен null; ClassCastException — если ключ не является String; IllegalArgumentException — если ключ является пустой строкой

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.