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)
          マップが 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)
          Map.putAll を使用して、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 - 名前が null の場合
IllegalArgumentException - 名前が空の場合。

putAll

public void putAll(Map<? extends String,? extends Object> toMerge)
Map.putAll を使用して、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 を返します。このようなマッピングが 1 つだけあります。

定義:
インタフェース Map<String,Object> 内の containsKey
定義:
インタフェース Bindings 内の containsKey
パラメータ:
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 インタフェースのほとんどの実装で、このオペレーションにかかる時間はマップのサイズに正比例します。

定義:
インタフェース Map<String,Object> 内の containsValue
パラメータ:
value - マップにあるかどうかを判定される値
戻り値:
マップが 1 つまたは複数のキーと指定された値をマッピングしている場合は true

entrySet

public Set<Map.Entry<String,Object>> entrySet()
このマップに含まれるマップの Set ビューを返します。セットはマップと連動しているので、マップに対する変更はセットに反映され、また、セットに対する変更はマップに反映されます。セットに対する反復の処理中にマップが変更された場合は、反復処理の結果は定義されません (反復子自身の remove オペレーション、または反復子により返されるマップエントリに対する setValue オペレーションを除く)。 セットは、要素の削除をサポートしており、対応するマッピングをマップから削除できます。セットは要素の削除をサポートしており、対応するマッピングをマップから削除できます。削除は、Iterator.removeSet.removeremoveAllretainAll、および clear の各オペレーションを通して行います。Set は、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 つだけあります。

定義:
インタフェース Map<String,Object> 内の get
定義:
インタフェース Bindings 内の 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.removeSet.removeremoveAllretainAll、および retainAll オペレーションを通して行います。Set は、add オペレーションや addAll オペレーションはサポートしていません。

定義:
インタフェース Map<String,Object> 内の keySet
戻り値:
マップに含まれているキーのセットビュー

remove

public Object remove(Object key)
このキーにマッピングがある場合に、そのマッピングをマップから削除します (任意のオペレーション)。 つまり、(key==null ?つまり、マップに k==null ? k==null :key.equals(k)) という条件で、キー k から値 v までマッピングがマップに含まれる場合、このマッピングは削除されます。マップはこのようなマッピングを 1 つだけ含みます。  

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

定義:
インタフェース Map<String,Object> 内の remove
定義:
インタフェース Bindings 内の 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.removeCollection.removeremoveAllretainAll、および clear オペレーションを通して行います。コレクションは、add オペレーションや addAll オペレーションはサポートしていません。

定義:
インタフェース Map<String,Object> 内の values
戻り値:
マップ内に含まれている値のコレクションビュー

JavaTM Platform
Standard Ed. 6

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2009 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。