Класс SimpleBindings

java.lang.Object

javax.script.SimpleBindings

Все реализуемые интерфейсы:: Map<String,Object>, Bindings

public class SimpleBindings extends Object implements Bindings

Простая реализация Bindings, основанная на HashMap или другом указанном Map.

Начиная с:: 1.6

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

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

Map.Entry<K,V>

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

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

Конструктор	Описание
`SimpleBindings()`	Конструктор по умолчанию использует `HashMap`.
`SimpleBindings(Map<String,Object> m)`	Конструктор использует существующий `Map` для хранения значений.

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

Модификатор и тип	Метод	Описание
`void`	`clear()`	Удаляет все отображения из этой карты (необязательная операция).
`boolean`	`containsKey(Object key)`	Возвращает `true`, если эта карта содержит отображение для указанного ключа.
`boolean`	`containsValue(Object value)`	Возвращает `true`, если эта карта связывает один или несколько ключей с указанным значением.
`Set<Map.Entry<String,Object>>`	`entrySet()`	Возвращает представление отображений, содержащихся в этой карте, в виде `Set`.
`Object`	`get(Object key)`	Возвращает значение, с которым эта карта связывает указанный ключ.
`boolean`	`isEmpty()`	Возвращает `true`, если эта карта не содержит отображений ключ-значение.
`Set<String>`	`keySet()`	Возвращает представление ключей, содержащихся в этой карте, в виде `Set`.
`Object`	`put(String name, Object value)`	Задает указанные ключ и значение в нижележащем поле `map`.
`void`	`putAll(Map<? extends String, ? extends Object> toMerge)`	`putAll` реализован с использованием `Map.putAll`.
`Object`	`remove(Object key)`	Удаляет отображение для этого ключа из карты, если оно имеется (необязательная операция).
`int`	`size()`	Возвращает количество отображений ключ-значение в этой карте.
`Collection<Object>`	`values()`	Возвращает представление значений, содержащихся в этой карте, в виде `Collection`.

Методы, объявленные в классе Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создает и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Указывает, является ли другой объект «равным» этому объекту.
`protected void`	`finalize()`	Устарело, будет удалено: этот элемент API может быть удален в будущей версии. Финализация устарела и может быть удалена в одном из следующих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`int`	`hashCode()`	Возвращает значение хеш-кода этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`String`	`toString()`	Возвращает строковое представление объекта.
`final void`	`wait()`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного интервала реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного интервала реального времени.

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

compute, computeIfAbsent, computeIfPresent, equals, forEach, getOrDefault, hashCode, merge, putIfAbsent, remove, replace, replace, replaceAll

Модификатор и тип	Метод	Описание
`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)`	Если для указанного ключа существует ненулевое значение, пытается вычислить новое отображение с учетом ключа и текущего связанного с ним значения (необязательная операция).
`boolean`	`equals(Object o)`	Сравнивает указанный объект с этой картой на предмет равенства.
`default void`	`forEach(BiConsumer<? super String, ? super Object> action)`	Выполняет заданное действие для каждой записи этой карты, пока не будут обработаны все записи или действие не вызовет исключение.
`default Object`	`getOrDefault(Object key, Object defaultValue)`	Возвращает значение, сопоставленное с указанным ключом, или `defaultValue`, если эта карта не содержит отображения для данного ключа.
`int`	`hashCode()`	Возвращает значение хеш-кода этой карты.
`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)`	Заменяет значение каждой записи результатом вызова заданной функции для этой записи, пока не будут обработаны все записи или функция не вызовет исключение (необязательная операция).

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

SimpleBindings

public SimpleBindings(Map<String,Object> m)

Конструктор использует существующий Map для хранения значений.

Параметры:: m — Map, используемый в качестве основы этой SimpleBindings.
Исключения:: NullPointerException — если m равен null

SimpleBindings

public SimpleBindings()

Конструктор по умолчанию использует HashMap.

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

put

public Object put(String name, Object value)

Задает указанные ключ и значение в нижележащем поле map.

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

putAll

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

putAll реализован с использованием Map.putAll.

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

clear

public void clear()

Удаляет все отображения из этой карты (необязательная операция). После возврата из этого вызова карта будет пустой.

Указано в:: clear в интерфейсе Map<String,Object>

containsKey

public boolean containsKey(Object key)

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

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

containsValue

public boolean containsValue(Object value)

Возвращает true, если эта карта связывает один или несколько ключей с указанным значением. Формально возвращает true тогда и только тогда, когда эта карта содержит хотя бы одно отображение со значением v, таким что Objects.equals(value, v). Для большинства реализаций интерфейса Map эта операция, вероятно, потребует времени, линейно зависящего от размера карты.

Указано в:: containsValue в интерфейсе Map<String,Object>
Параметры:: value — значение, наличие которого в этой карте необходимо проверить
Возвращает:: true, если эта карта связывает один или несколько ключей с указанным значением

entrySet

public Set<Map.Entry<String,Object>> entrySet()

Возвращает представление отображений, содержащихся в этой карте, в виде Set. Множество поддерживается картой, поэтому изменения карты отражаются в множестве, и наоборот. Если карта изменяется во время обхода множества (за исключением изменений посредством операции remove самого итератора или операции setValue для записи карты, возвращенной итератором), результаты обхода не определены. Множество поддерживает удаление элементов, удаляющее соответствующее отображение из карты, посредством операций Iterator.remove, Set.remove, removeAll, retainAll и clear. Оно не поддерживает операции add или addAll.

Указано в:: entrySet в интерфейсе Map<String,Object>
Возвращает:: представление содержащихся в этой карте отображений в виде множества

get

public Object get(Object key)

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

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

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

isEmpty

public boolean isEmpty()

Возвращает true, если эта карта не содержит отображений ключ-значение.

Указано в:: isEmpty в интерфейсе Map<String,Object>
Возвращает:: true, если эта карта не содержит отображений ключ-значение

keySet

public Set<String> keySet()

Возвращает представление ключей, содержащихся в этой карте, в виде Set. Множество поддерживается картой, поэтому изменения карты отражаются в множестве, и наоборот. Если карта изменяется во время обхода множества (за исключением изменений посредством операции remove самого итератора), результаты обхода не определены. Множество поддерживает удаление элементов, удаляющее соответствующее отображение из карты, посредством операций Iterator.remove, Set.remove, removeAll, retainAll и clear. Оно не поддерживает операции add или addAll.

Указано в:: keySet в интерфейсе Map<String,Object>
Возвращает:: представление содержащихся в этой карте ключей в виде множества

remove

public Object remove(Object key)

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

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

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

size

public int size()

Возвращает количество отображений ключ-значение в этой карте. Если карта содержит более Integer.MAX_VALUE элементов, возвращает Integer.MAX_VALUE.

Указано в:: size в интерфейсе Map<String,Object>
Возвращает:: количество отображений ключ-значение в этой карте

values

public Collection<Object> values()

Возвращает представление значений, содержащихся в этой карте, в виде Collection. Коллекция поддерживается картой, поэтому изменения карты отражаются в коллекции, и наоборот. Если карта изменяется во время обхода коллекции (за исключением изменений посредством операции remove самого итератора), результаты обхода не определены. Коллекция поддерживает удаление элементов, удаляющее соответствующее отображение из карты, посредством операций Iterator.remove, Collection.remove, removeAll, retainAll и clear. Она не поддерживает операции add или addAll.

Указано в:: values в интерфейсе Map<String,Object>
Возвращает:: представление содержащихся в этой карте значений в виде коллекции

© 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.