JavaTM Platform
Standard Ed. 6

javax.script
类 SimpleBindings

java.lang.Object
  继承者 javax.script.SimpleBindings
所有已实现的接口:
Map< String, Object>, Bindings

public class SimpleBindings
     
extends Object
implements Bindings

一个受 HashMap 或其他某些指定 Map 支持的 Bindings 的简单实现。

从以下版本开始:
1.6

嵌套类摘要
 
从接口 java.util.Map 继承的嵌套类/接口
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 视图。
 
从类 java.lang.Object 继承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 
从接口 java.util.Map 继承的方法
equals, hashCode
 

构造方法详细信息

SimpleBindings

public SimpleBindings(Map<String,Object> m)
构造方法使用现有 Map 来存储值。

参数:
m - 支持此 SimpleBindingsMap
抛出:
NullPointerException - 如果 m 为 null

SimpleBindings

public SimpleBindings()
默认构造方法使用 HashMap

方法详细信息

put

public Object put(String name,
                  Object value)
设置底层 map 字段中的指定键/值。

指定者:
接口 Map<String,Object> 中的 put
指定者:
接口 Bindings 中的 put
参数:
name - 值的名称
value - 要设置的值。
返回:
指定键以前的值。如果以前没有设置键,则返回 null。
抛出:
NullPointerException - 如果 name 为 null。
IllegalArgumentException - 如果 name 为空。

putAll

public void putAll(Map<? extends String,? extends Object> toMerge)
putAll 是使用 Map.putAll 实现的。

指定者:
接口 Map<String,Object> 中的 putAll
指定者:
接口 Bindings 中的 putAll
参数:
toMerge - 要添加的值的 Map
抛出:
NullPointerException - 如果 toMerge 映射为 null,或者该映射中的某些键为 null。
IllegalArgumentException - 如果该映射中的某些键为空 String。

clear

public void clear()
从此映射中移除所有映射关系(可选操作)。此调用返回后,该映射将为空。

指定者:
接口 Map<String,Object> 中的 clear

containsKey

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

指定者:
接口 Map<String,Object> 中的 containsKey
指定者:
接口 Bindings 中的 containsKey
参数:
key - 要测试是否存在于此映射中的键。
返回:
如果此映射包含指定键的映射关系,则返回 true
抛出:
NullPointerException - 如果 key 为 null
ClassCastException - 如果 key 不是 String
IllegalArgumentException - 如果 key 为空 String

containsValue

public boolean containsValue(Object value)
如果此映射将一个或多个键映射到指定值,则返回 true。更确切地讲,当且仅当此映射至少包含一个对满足 (value==null ? v==null : value.equals(v)) 的值 v 的映射关系时,返回 true。对于大多数 Map 接口的实现而言,此操作需要的时间可能与映射大小呈线性关系。

指定者:
接口 Map<String,Object> 中的 containsValue
参数:
value - 测试是否存在于此映射中的值
返回:
如果此映射将一个或多个键映射到指定值,则返回 true

entrySet

public Set<Map.Entry<String,Object>> entrySet()
返回此映射中包含的映射关系的 Set 视图。该 set 受映射支持,所以对映射的更改可在此 set 中反映出来,反之亦然。如果对该 set 进行迭代的同时修改了映射(通过迭代器自己的 remove 操作,或者通过对迭代器返回的映射项执行 setValue 操作除外),则迭代结果是不确定的。set 支持元素移除,通过 Iterator.removeSet.removeremoveAllretainAllclear 操作可从映射中移除相应的映射关系。它不支持 addaddAll 操作。

指定者:
接口 Map<String,Object> 中的 entrySet
返回:
此映射中包含的映射关系的 set 视图

get

public Object get(Object key)
返回此映射将指定键所映射到的值。如果此映射中没有此键的映射关系,则返回 null。返回 null 值不 一定 表示此映射不包含该键的映射关系;也可能此映射将该键显式地映射为 null。可使用 containsKey 操作来区分这两种情况。

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

指定者:
接口 Map<String,Object> 中的 get
指定者:
接口 Bindings 中的 get
参数:
key - 要返回关联值的键。
返回:
此映射中指定键所映射的值;如果映射不包含此键的映射关系,则返回 null
抛出:
NullPointerException - 如果 key 为 null
ClassCastException - 如果 key 不是 String
IllegalArgumentException - 如果 key 为空 String

isEmpty

public boolean isEmpty()
如果此映射未包含键-值映射关系,则返回 true

指定者:
接口 Map<String,Object> 中的 isEmpty
返回:
如果此映射未包含键-值映射关系,则返回 true

keySet

public Set<String> keySet()
返回此映射中包含的键的 Set 视图。该 set 受映射支持,所以对映射的更改可在此 set 中反映出来,反之亦然。如果对该 set 进行迭代的同时修改了映射(通过迭代器自己的 remove 操作除外),则迭代结果是不确定的。set 支持元素移除,通过 Iterator.removeSet.removeremoveAllretainAllclear 操作可从映射中移除相应的映射关系。它不支持 addaddAll 操作。

指定者:
接口 Map<String,Object> 中的 keySet
返回:
此映射中包含的键的 set 视图

remove

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

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

指定者:
接口 Map<String,Object> 中的 remove
指定者:
接口 Bindings 中的 remove
参数:
key - 其映射关系要从映射中移除的键。
返回:
以前与指定键关联的值;如果没有该键的映射关系,则返回 null
抛出:
NullPointerException - 如果 key 为 null
ClassCastException - 如果 key 不是 String
IllegalArgumentException - 如果 key 为空 String

size

public int size()
返回此映射中的键-值映射关系数。如果该映射包含的元素大于 Integer.MAX_VALUE,则返回 Integer.MAX_VALUE

指定者:
接口 Map<String,Object> 中的 size
返回:
此映射中的键-值映射关系数

values

public Collection<Object> values()
返回此映射中包含的值的 Collection 视图。该 collection 受映射支持,所以对映射的更改可在此 collection 中反映出来,反之亦然。如果对该 collection 进行迭代的同时修改了映射(通过迭代器自己的 remove 操作除外),则迭代结果是不确定的。collection 支持元素移除,通过 Iterator.removeCollection.removeremoveAllretainAllclear 操作可从映射中移除相应的映射关系。它不支持 addaddAll 操作。

指定者:
接口 Map<String,Object> 中的 values
返回:
此映射中包含的值的 collection 视图

JavaTM Platform
Standard Ed. 6

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

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