|
JavaTM 2 Platform Std. Ed. v1.3 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 内部クラス | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
キーを値にマッピングするオブジェクトです。マップには、同一のキーを複数登録することはできません。各キーは 1 つの値にしかマッピングできません。
このインタフェースは、インタフェースというよりむしろ完全に抽象クラスであった Dictionary クラスに代わるものです。
Map インタフェースが提供する 3 つのコレクションビューにより、マップの内容を、キーのセット、値のコレクション、あるいはキーと値のマッピングのセットとして表示できるようになります。マップの「順序」は、マップのコレクションビューの反復子が要素を返すときの順序として定義されます。TreeMap クラスなど一部のマップの実装では、順序について保証しますが、HashMap クラスなどの実装では順序は保証されません。
注: 可変オブジェクトをマップキーとして使用する場合は細心の注意が必要です。オブジェクトがマップ内のキーであるときに、equals の比較に影響を与える方法でオブジェクトの値が変更された場合、マップの動作は保証されません。この禁止事項の特殊な例として、マップがそれ自身をキーとして持つことができないことが挙げられます。マップがそれ自身を値として持つことは許可されますが、その場合は細心の注意が必要です。このようなマップの場合、equals メソッドおよび hashCode メソッドの結果は、保証されません。
汎用マップの実装クラスはすべて、次の 2 つの標準的なコンストラクタを提供するようにしてください。2 つの標準的なコンストラクタとは、void (引数なし) コンストラクタと、Map 型の引数を 1 つとるコンストラクタです。前者は空のマップを作成し、後者は同じキーと値のマッピングを引数として持つ新しいマップを作成します。その結果、ユーザは、後者のコンストラクタを使って任意のマップをコピーすることにより、必要なクラスと等価なマップを作成できます。これは強制的なものではありませんが (インタフェースがコンストラクタを持つことができないため)、SDK での汎用マップの実装はすべてこれに従っています。
HashMap
,
TreeMap
,
Hashtable
,
SortedMap
,
Collection
,
Set
内部クラスの概要 | |
static interface |
Map.Entry
マップのエントリ (キーと値のペア) です。 |
メソッドの概要 | |
void |
clear()
マップからマッピングをすべて削除します (任意のオペレーション)。 |
boolean |
containsKey(Object key)
マップが指定のキーのマッピングを保持する場合に true を返します。 |
boolean |
containsValue(Object value)
マップが、指定された値に 1 つ以上のキーをマッピングしている場合に true を返します。 |
Set |
entrySet()
マップに含まれているマッピングのセットビューを返します。 |
boolean |
equals(Object o)
指定されたオブジェクトがこのマップと等しいかどうかを比較します。 |
Object |
get(Object key)
マップが指定のキーをマップする値を返します。 |
int |
hashCode()
マップのハッシュコード値を返します。 |
boolean |
isEmpty()
マップがキーと値のマッピングを保持しない場合に true を返します。 |
Set |
keySet()
マップに含まれているキーのセットビューを返します。 |
Object |
put(Object key,
Object value)
指定された値と指定されたキーをこのマップに関連付けます (任意のオペレーション)。 |
void |
putAll(Map t)
指定されたマップのすべてのマッピングをこのマップにコピーします (任意のオペレーション)。 |
Object |
remove(Object key)
このキーにマッピングがある場合に、そのマッピングをマップから削除します (任意のオペレーション)。 |
int |
size()
マップ内のキーと値のマッピングの数を返します。 |
Collection |
values()
マップに含まれている値のコレクションビューを返します。 |
メソッドの詳細 |
public int size()
public boolean isEmpty()
public boolean containsKey(Object key)
key
- マップにあるかどうかが判定されるキーClassCastException
- キーがマップに適さない型の場合NullPointerException
- キーが null のときに、マップが null キーを許可しない場合public boolean containsValue(Object value)
value
- マップにあるかどうかを判定される値public Object get(Object key)
key
- 関連付けられた値が返されるキーClassCastException
- キーがマップに適さない型の場合NullPointerException
- キーが null のときに、マップが null キーを許可しない場合containsKey(Object)
public Object put(Object key, Object value)
key
- 指定される値が関連付けられるキーvalue
- 指定されるキーに関連付けられる値UnsupportedOperationException
- put オペレーションがマップによってサポートされていない場合ClassCastException
- 指定されたキーまたは値のクラスが原因で、マップに格納できない場合IllegalArgumentException
- このキーまたは値の特性が原因で、マップに格納できない場合NullPointerException
- マップが null キーや null 値を許可しないときに、指定されたキーまたは値が null の場合public Object remove(Object key)
key
- マッピングがマップから削除されるキーUnsupportedOperationException
- マップが remove メソッドをサポートしていない場合public void putAll(Map t)
t
- マップに格納されるマッピングUnsupportedOperationException
- マップが putAll メソッドをサポートしていない場合ClassCastException
- 指定されたマップ内のキーまたは値のクラスが原因で、マップに格納できない場合IllegalArgumentException
- 指定されたマップ内のキーまたは値の特性が原因で、マップに格納できない場合NullPointerException
- マップが null キーや null 値を許可しないときに、指定されたキーまたは値が null の場合public void clear()
UnsupportedOperationException
- clear がマップによってサポートされていない場合public Set keySet()
public Collection values()
public Set entrySet()
public boolean equals(Object o)
Object
内の equals
o
- マップと等しいかどうかを比較するオブジェクトpublic int hashCode()
Object
内の hashCode
Map.Entry.hashCode()
,
Object.hashCode()
,
Object.equals(Object)
,
equals(Object)
|
JavaTM 2 Platform Std. Ed. v1.3 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 内部クラス | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
Java、Java 2D、JDBC は、米国およびその他の国における米国 Sun Microsystems, Inc. の商標もしくは登録商標です。
Copyright 1993-2000 Sun Microsystems, Inc. 901 San Antonio Road,
Palo Alto, California, 94303, U.S.A. All Rights Reserved.