JavaTM 2 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 2 Platform
Standard Ed. 6

提交錯誤或意見

版權所有 2008 Sun Microsystems, Inc. 保留所有權利。請遵守GNU General Public License, version 2 only