モジュール java.scripting

パッケージ 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で宣言されたメソッド

compute, computeIfAbsent, computeIfPresent, equals, forEach, getOrDefault, hashCode, merge, putIfAbsent, remove, replace, replace, replaceAll

コンストラクタの詳細

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、インタフェースBindings

定義:

インタフェースMap<String,Object>内のput

パラメータ:

name - 値の名前

value - 設定する値。

戻り値:

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

例外:

NullPointerException - 名前がnullの場合。

IllegalArgumentException - 名前が空の場合。

putAll

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

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

定義:

putAll、インタフェースBindings

定義:

インタフェースMap<String,Object>内の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を返します。 (このようなマッピングは1つのみ存在できます。)

定義:

containsKey、インタフェースBindings

定義:

インタフェースMap<String,Object>内のcontainsKey

パラメータ:

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

戻り値:

指定されたキーのマッピングがこのマップに含まれている場合はtrue

例外:

NullPointerException - キーがnullの場合

ClassCastException - keyがStringでない場合

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

containsValue

public boolean containsValue(Object value)

このマップが1つまたは複数のキーと指定された値をマッピングしている場合にtrueを返します。 より正式には、このマップに値vへのマッピングがObjects.equals(value, v)のように少なくとも1つ含まれている場合にのみ、trueを返します。 この操作では、Mapインタフェースのほとんどの実装で、マップ・サイズに時間線形が必要になる場合があります。

定義:

インタフェースMap<String,Object>内のcontainsValue

パラメータ:

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

戻り値:

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

entrySet

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

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

定義:

インタフェースMap<String,Object>内のentrySet

戻り値:

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

get

public Object get(Object key)

マップが指定されたキーをマップする値を返します。 マップにこのキーのマッピングが含まれていない場合は、nullを返します。 戻り値nullは、マップがキーのマッピングを保持していないことを示すとはかぎりません。つまり、マップが明示的にキーをnullにマップすることもあります。 containsKey操作を使用して、これら2つのケースを区別できます。

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

定義:

get、インタフェースBindings

定義:

インタフェースMap<String,Object>内のget

パラメータ:

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

戻り値:

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

例外:

NullPointerException - キーがnullの場合

ClassCastException - keyがStringでない場合

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

isEmpty

public boolean isEmpty()

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

定義:

インタフェースMap<String,Object>内のisEmpty

戻り値:

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

keySet

public Set<String> keySet()

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

定義:

インタフェースMap<String,Object>内のkeySet

戻り値:

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

remove

public Object remove(Object key)

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

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

定義:

remove、インタフェースBindings

定義:

インタフェースMap<String,Object>内のremove

パラメータ:

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

戻り値:

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

例外:

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

定義:

インタフェースMap<String,Object>内のvalues

戻り値:

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