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) マップが 1 つまたは複数のキーを指定された値にマッピングしている場合に 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 フィールドに、指定されたキーと値を設定します。

定義:

put、インタフェース: Map<String,Object>

定義:

put、インタフェース: Bindings

パラメータ:

name - 値の名前

value - 設定する値。

戻り値:

指定されたキーの以前の値。キーの設定が解除されていた場合は null。

例外:

NullPointerException - 名前が null の場合。

IllegalArgumentException - 名前が空の場合。

putAll

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

putAll は Map.putAll を使って実装されています。

定義:

putAll、インタフェース: Map<String,Object>

定義:

putAll、インタフェース: Bindings

パラメータ:

toMerge - 追加される値の Map。

例外:

NullPointerException - toMerge マップが null の場合、またはマップ内のいずれかのキーが null の場合。

IllegalArgumentException - マップ内のいずれかのキーが空の String である場合。

clear

public void clear()

マップからマッピングをすべて削除します (オプションの操作)。この呼び出しが戻ると、マップは空になります。

定義:

clear、インタフェース: Map<String,Object>

containsKey

public boolean containsKey(Object key)

指定のキーのマッピングがマップに含まれている場合に true を返します。つまり、このマップに、(key==null ? k==null : key.equals(k)) となるキー k が含まれている場合にのみ true を返します。このようなマッピングは 1 つのみ存在できます。

定義:

containsKey、インタフェース: Map<String,Object>

定義:

containsKey、インタフェース: Bindings

パラメータ:

key - このマップにあるかどうかが判定されるキー。

戻り値:

このマップが指定のキーのマッピングを保持する場合は true。

例外:

NullPointerException - キーが null の場合

ClassCastException - key が String でない場合

IllegalArgumentException - key が空の String である場合

containsValue

public boolean containsValue(Object value)

マップが 1 つまたは複数のキーを指定された値にマッピングしている場合に true を返します。つまり、このマップに、(value==null ? v==null : value.equals(v)) となる値 v へのマッピングが 1 つ以上ある場合にのみ true を返します。Map インタフェースのほとんどの実装で、このオペレーションにかかる時間はマップのサイズに正比例します。

定義:

containsValue、インタフェース: Map<String,Object>

パラメータ:

value - このマップにあるかどうかが判定される値

戻り値:

このマップが 1 つまたは複数のキーを指定された値にマッピングしている場合は true

entrySet

public Set<Map.Entry<String,Object>> entrySet()

このマップに含まれるマッピングの Set ビューを返します。セットはマップと連動しているので、マップに対する変更はセットに反映され、また、セットに対する変更はマップに反映されます。セットの反復処理中にマップが変更された場合、反復処理の結果は定義されていません (イテレータ自身の remove オペレーション、またはイテレータにより返されるマップエントリに対する setValue オペレーションを除く)。セットは要素の削除をサポートします。Iterator.remove、Set.remove、removeAll、retainAll、および clear オペレーションで対応するマッピングをマップから削除します。add または addAll オペレーションはサポートしていません。

定義:

entrySet、インタフェース: Map<String,Object>

戻り値:

マップ内に保持されているマッピングのセットビュー

get

public Object get(Object key)

マップが指定されたキーをマップする値を返します。マップがこのキーのマッピングを保持していない場合は null を返します。戻り値の null は、マップがキーのマッピングを保持していないことを示すとはかぎりません。つまり、マップが明示的にキーを null にマップすることもあります。containsKey オペレーションを使うと、こうした 2 つの場合を見分けることができます。

つまり、このメソッドは、(key==null ? k==null : key.equals(k)) となるキー k から値 v へのマッピングがこのマップに含まれている場合は v を返し、それ以外の場合は null を返します。このようなマッピングは 1 つのみ存在できます。

定義:

get、インタフェース: Map<String,Object>

定義:

get、インタフェース: Bindings

パラメータ:

key - 関連付けられている値が返されるキー。

戻り値:

マップが、指定されたキーにマッピングしている値。このキーに対するマッピングがマップにない場合は null。

例外:

NullPointerException - キーが null の場合

ClassCastException - key が String でない場合

IllegalArgumentException - key が空の String である場合

isEmpty

public boolean isEmpty()

このマップがキーと値のマッピングを保持しない場合に true を返します。

定義:

isEmpty、インタフェース: Map<String,Object>

戻り値:

このマップがキーと値のマッピングを保持しない場合は true

keySet

public Set<String> keySet()

このマップに含まれるキーの Set ビューを返します。セットはマップと連動しているので、マップに対する変更はセットに反映され、また、セットに対する変更はマップに反映されます。セットの反復処理中にマップが変更された場合、反復処理の結果は定義されていません (イテレータ自身の remove オペレーションを除く)。セットは要素の削除をサポートします。Iterator.remove、Set.remove、removeAll、retainAll、および clear オペレーションで対応するマッピングをマップから削除します。add または addAll オペレーションはサポートしていません。

定義:

keySet、インタフェース: Map<String,Object>

戻り値:

マップに含まれているキーのセットビュー

remove

public Object remove(Object key)

このキーにマッピングがある場合に、そのマッピングをマップから削除します (オプションの操作)。つまり、(key==null ? k==null : key.equals(k)) となるキー k から値 v へのマッピングがこのマップに含まれる場合、このマッピングは削除されます。マップはこのようなマッピングを 1 つだけ含めることができます。

このマップが以前にこのキーを関連付けていた値を返します。キーに対するマッピングがマップになかった場合は null を返します。null の戻り値は、実装が null 値をサポートしている場合、指定されたキーと null を以前関連付けていたマップを示す場合もあります。呼び出しが戻ると、マップは指定されたキーのマッピングを含まなくなります。

定義:

remove、インタフェース: Map<String,Object>

定義:

remove、インタフェース: Bindings

パラメータ:

key - マッピングがマップから削除されるキー。

戻り値:

指定されたキーと関連付けられていた以前の値。キーのマッピングがなかった場合は null。

例外:

NullPointerException - キーが null の場合

ClassCastException - key が String でない場合

IllegalArgumentException - key が空の String である場合

size

public int size()

このマップ内のキー値マッピングの数を返します。マップ内に Integer.MAX_VALUE より多くの要素がある場合は、Integer.MAX_VALUE を返します。

定義:

size、インタフェース: Map<String,Object>

戻り値:

このマップ内のキーと値のマッピングの数

values

public Collection<Object> values()

このマップに含まれる値の Collection ビューを返します。コレクションはマップと連動しているので、マップに対する変更はコレクションに反映され、またコレクションに対する変更はマップに反映されます。コレクションの反復処理中にマップが変更された場合、反復処理の結果は定義されていません (イテレータ自身の remove オペレーションを除く)。コレクションは要素の削除をサポートします。Iterator.remove、Collection.remove、removeAll、retainAll、および clear オペレーションで対応するマッピングをマップから削除します。add または addAll オペレーションはサポートしていません。

定義:

values、インタフェース: Map<String,Object>

戻り値:

マップ内に含まれている値のコレクションビュー