模块 java.scripting

软件包 javax.script

Interface Bindings

All Superinterfaces:

Map<String,Object>

所有已知实现类：

ScriptObjectMirror ， SimpleBindings

public interface Bindings
extends Map<String,Object>

键/值对的映射，其所有键都是 Strings 。

从以下版本开始：

1.6

嵌套类汇总

Nested classes/interfaces declared in interface java.util.Map

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)	如果存在此键，则从此映射中移除此键的映射（可选操作）。

声明方法的接口 java.util.Map

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

方法详细信息

put

Object put(String name,
           Object value)

设置命名值。

Specified by:

put接口 Map<String,Object>

参数

name - 与值关联的名称。

value - 与名称关联的值。

结果

以前与给定名称关联的值。 如果之前没有与名称关联的值，则返回null。

异常

NullPointerException - 如果名称为null。

IllegalArgumentException - 如果名称为空String。

putAll

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

将给定的 Map中的所有映射添加到此 Bindings 。

Specified by:

putAll在界面 Map<String,Object>

参数

toMerge - 与此合并的 Map 。

异常

NullPointerException - 如果toMerge map为null或者映射中的某个键为null。

IllegalArgumentException - 如果映射中的某个键是空字符串。

containsKey

boolean containsKey(Object key)

如果此映射包含指定键的映射，则返回true 。 更正式地，当且仅当此映射包含密钥k的映射时才返回true ，如(key==null ? k==null : key.equals(k)) 。 （最多可以有一个这样的映射。）

Specified by:

containsKey在界面 Map<String,Object>

参数

key - 要测试其在此地图中的存在的密钥。

结果

true如果此映射包含指定键的映射。

异常

NullPointerException - 如果key为null

ClassCastException - 如果key不是String

IllegalArgumentException - 如果key为空String

get

Object get(Object key)

返回此映射将指定键映射到的值。 如果地图不包含此键的映射，则返回null 。 返回值null 不一定表示映射不包含键的映射; 地图也可能将密钥明确映射到null 。 可以使用containsKey操作来区分这两种情况。

更正式地说，如果此映射包含从密钥k到值v的映射，使得(key==null ? k==null : key.equals(k)) ，则此方法返回v ; 否则返回null 。 （最多可以有一个这样的映射。）

Specified by:

get在界面 Map<String,Object>

参数

key - 要返回其关联值的键。

结果

此映射映射指定键的值，如果映射不包含此键的映射， null 。

异常

NullPointerException - 如果key为null

ClassCastException - 如果key不是String

IllegalArgumentException - 如果key为空String

remove

Object remove(Object key)

如果存在此键，则从此映射中移除此键的映射（可选操作）。 更正式地说，如果此映射包含从密钥k到值v的映射，例如(key==null ? k==null : key.equals(k)) ，则删除该映射。 （地图最多可以包含一个这样的映射。）

返回映射先前与关键字关联的值，如果映射不包含此键的映射，则返回null 。 （如果实现支持null值，则返回null也可以指示映射先前与指定键关联null ）一旦调用返回，映射将不包含指定键的映射。

Specified by:

remove在界面 Map<String,Object>

参数

key - 要从地图中删除其映射的键。

结果

与指定键关联的上一个值，如果没有键映射， null 。

异常

NullPointerException - 如果key为null

ClassCastException - 如果key不是String

IllegalArgumentException - 如果key为空String