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 - 支持此 SimpleBindings 的 Map。

拋出：

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.remove、Set.remove、removeAll、retainAll 和 clear 操作可從映射中移除相應的映射關係。它不支持 add 或 addAll 操作。

指定者：

介面 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.remove、Set.remove、removeAll、retainAll 和 clear 操作可從映射中移除相應的映射關係。它不支持 add 或 addAll 操作。

指定者：

介面 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.remove、Collection.remove、removeAll、retainAll 和 clear 操作可從映射中移除相應的映射關係。它不支持 add 或 addAll 操作。

指定者：

介面 Map<String,Object> 中的 values

返回：

此映射中包含的值的 collection 視圖