JavaTM Platform
Standard Ed. 6

javax.script
接口 Bindings

所有超级接口:
Map<String,Object>
所有已知实现类:
SimpleBindings

public interface Bindings
extends Map<String,Object>

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

从以下版本开始:
1.6

嵌套类摘要
 
从接口 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, containsValue, entrySet, equals, hashCode, isEmpty, keySet, size, values
 

方法详细信息

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

JavaTM Platform
Standard Ed. 6

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

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