javax.script
接口 Bindings

所有超级接口：

Map<String,Object>

所有已知实现类：

SimpleBindings

public interface Bindings
extends Map<String,Object>

所有键均为 String 的键/值对映射关系。

从以下版本开始：

1.6

put

Object put(String name,
           Object value)

设置指定的值。

指定者：

接口 Map<String,Object> 中的 put

参数：

name - 与值关联的名称。

value - 与名称关联的值。

返回：

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

抛出：

NullPointerException - 如果 name 为 null。

IllegalArgumentException - 如果 name 为空 String。

putAll

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

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

指定者：

接口 Map<String,Object> 中的 putAll

参数：

toMerge - 与此 Map 合并的 Map。

抛出：

NullPointerException - 如果 toMerge 映射为 null，或者该映射中的某些键为 null。

IllegalArgumentException - 如果该映射中的某些键为空 String。

containsKey

boolean containsKey(Object key)

如果此映射包含指定键的映射关系，则返回 true。更正式地说，当且仅当此映射包含针对满足 (key==null ? k==null :key.equals(k)) 的键 k 的映射关系时，返回 true。（最多只能有一个这样的映射关系。）

指定者：

接口 Map<String,Object> 中的 containsKey

参数：

key - 要测试是否存在于此映射中的键。

返回：

如果此映射包含指定键的映射关系，则返回 true。

抛出：

NullPointerException - 如果 key 为 null

ClassCastException - 如果 key 不是 String

IllegalArgumentException - 如果 key 为空 String

get

Object get(Object key)

返回此映射将指定键所映射的值。如果此映射中不包含此键的映射关系，则返回 null。返回 null 值不一定 表示此映射不包含该键的映射关系；也可能此映射将该键显式地映射为 null。可使用 containsKey 操作来区分这两种情况。

更正式地说，如果此映射包含满足 (key==null ? k==null :key.equals(k)) 的键 k 到值 v 的映射关系，那么此方法返回 v；否则返回 null。（最多只能有一个这样的映射关系。）

指定者：

接口 Map<String,Object> 中的 get

参数：

key - 要返回关联值的键。

返回：

此映射中指定键所映射的值；如果映射不包含此键的映射关系，则返回 null。

抛出：

NullPointerException - 如果 key 为 null

ClassCastException - 如果 key 不是 String

IllegalArgumentException - 如果 key 为空 String

remove

Object remove(Object key)

如果存在此键的映射关系，则将其从此映射中移除（可选操作）。更正式地说，如果此映射包含满足 (key==null ? k==null :key.equals(k)) 的键 k 到值 v 的映射关系，则移除该映射关系。（该映射最多只能包含一个这样的映射关系。）

返回映射中以前关联该键的值；如果映射不包含此键的映射关系，则返回 null。（如果该实现支持 null 值，则返回 null 也可能表示映射以前将 null 与指定的键关联。）调用返回后，映射将不包含指定键的映射关系。

指定者：

接口 Map<String,Object> 中的 remove

参数：

key - 其映射关系要从映射中移除的键。

返回：

以前与指定键关联的值；如果没有该键的映射关系，则返回 null。

抛出：

NullPointerException - 如果 key 为 null

ClassCastException - 如果 key 不是 String

IllegalArgumentException - 如果 key 为空 String

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。