|
Foundation 1.1.2 | |||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
java.lang.Object java.util.AbstractMap
public abstract class AbstractMap
このクラスは、Map インタフェースのスケルトン実装を提供し、このインタフェースを実装するのに必要な作業量を最小限に抑えます。
変更不可能なマップを実装するには、このクラスを拡張して、マップのマッピングのセットビューを返す entrySet メソッドを実装する必要があります。通常、返されたセットは AbstractSet の上に実装されます。このセットでは add メソッドと remove メソッドをサポートするべきではありません。また、セットの反復子では remove メソッドをサポートするべきではありません。
変更可能なマップを実装するには、上記に加えて、このクラスの put メソッドをオーバーライドします (オーバーライドしなかった場合は、UnsupportedOperationException がスローされます)。また、上記に加えて、entrySet().iterator() で返される反復子に remove メソッドを実装する必要があります。
Map インタフェースの仕様で推奨されているように、通常は、引数なしの void コンストラクタ、および引数にマップをとるコンストラクタを提供してください。
実装の詳細については、このクラスの abstract メソッド以外の各メソッドのドキュメントを参照してください。より効率的な実装ができるマップの場合は、これらのメソッドをオーバーライドしてもかまいません。
このクラスは、Java Collections Framework のメンバーです。
Map
,
Collection
入れ子のクラスの概要 |
---|
インタフェース java.util.Map から継承された入れ子のクラス/インタフェース |
---|
Map.Entry |
コンストラクタの概要 | |
---|---|
protected |
AbstractMap()
唯一のコンストラクタです。 |
メソッドの概要 | |
---|---|
void |
clear()
マップからマッピングをすべて削除します (任意のオペレーション)。 |
protected Object |
clone()
AbstractMap のインスタンスのシャローコピーを返します。 |
boolean |
containsKey(Object key)
マップが指定のキーのマッピングを保持する場合に true を返します。 |
boolean |
containsValue(Object value)
このマップが 1 つ以上のキーにこの値をマップする場合は true を返します。 |
abstract Set |
entrySet()
マップ内に保持されているマッピングのセットビューを返します。 |
boolean |
equals(Object o)
指定されたオブジェクトがこのマップと等しいかどうかを比較します。 |
Object |
get(Object key)
マップが指定されたキーをマップする値を返します。 |
int |
hashCode()
マップのハッシュコード値を返します。 |
boolean |
isEmpty()
マップがキーと値のマッピングを保持しない場合に true を返します。 |
Set |
keySet()
マップに含まれているキーの Set ビューを返します。 |
Object |
put(Object key,
Object value)
指定された値と指定されたキーをこのマップに関連付けます (任意のオペレーション)。 |
void |
putAll(Map t)
指定されたマップのすべてのマッピングをこのマップにコピーします (任意のオペレーション)。 |
Object |
remove(Object key)
このキーにマッピングがある場合に、そのマッピングをマップから削除します (任意のオペレーション)。 |
int |
size()
マップ内のキー値マッピングの数を返します。 |
String |
toString()
このマップの文字列表現を返します。 |
Collection |
values()
マップ内に保持されている値のコレクションビューを返します。 |
クラス java.lang.Object から継承されたメソッド |
---|
finalize, getClass, notify, notifyAll, wait, wait, wait |
コンストラクタの詳細 |
---|
protected AbstractMap()
メソッドの詳細 |
---|
public int size()
この実装は entrySet().size() を返します。
Map
内の size
public boolean isEmpty()
この実装は size() == 0 の結果を返します。
Map
内の isEmpty
public boolean containsValue(Object value)
この実装は entrySet() の内容を次々調べ、指定された値を持つエントリを検索します。そのようなエントリが見つかった場合は、true を返します。目的のエントリが見つからずに反復が終了した場合は、false を返します。この実装では、マップのサイズに正比例した時間が必要なことに注意してください。
Map
内の containsValue
value
- マップにあるかどうかを判定される値
public boolean containsKey(Object key)
この実装は entrySet() の内容を次々調べ、指定されたキーを持つエントリを検索します。そのようなエントリが見つかった場合は、true を返します。目的のエントリが見つからずに反復が終了した場合は、false を返します。この実装では、マップのサイズに正比例した時間が必要なことに注意してください。多くの実装は、このメソッドをオーバーライドします。
Map
内の containsKey
key
- マップにあるかどうかが判定されるキー
NullPointerException
- キーが null のときに、マップが null キーを許可しない場合public Object get(Object key)
この実装は entrySet() の内容を次々調べ、指定されたキーを持つエントリを検索します。そのようなエントリが見つかった場合は、エントリの値を返します。目的のエントリが見つからずに反復が終了した場合は、null を返します。この実装では、マップのサイズに正比例した時間が必要なことに注意してください。多くの実装は、このメソッドをオーバーライドします。
Map
内の get
key
- 関連付けられている値が返されるキー
NullPointerException
- キーが null のときに、マップが null キーを許可しない場合containsKey(Object)
public Object put(Object key, Object value)
この実装は、常に UnsupportedOperationException をスローします。
Map
内の put
key
- 指定の値が関連付けられるキーvalue
- 指定のキーに関連付けられる値
UnsupportedOperationException
- put オペレーションがマップによってサポートされていない場合
ClassCastException
- 指定されたキーまたは値のクラスが原因で、マップに格納できない場合
IllegalArgumentException
- このキーまたは値 * の特性が原因で、マップに格納できない場合
NullPointerException
- マップが null キーや null 値を許可しないときに、指定されたキーまたは値が null の場合public Object remove(Object key)
この実装は entrySet() の内容を次々調べ、指定されたキーを持つエントリを検索します。そのようなエントリが見つかった場合は、エントリの値を実装の getValue オペレーションで取得し、エントリを Collection とその基になるマップから削除します。削除は反復子の remove オペレーションを使い、保存された値が返されます。目的のエントリが見つからずに反復が終了した場合は、null を返します。この実装では、マップのサイズに正比例した時間が必要なことに注意してください。多くの実装は、このメソッドをオーバーライドします。
entrySet 反復子が remove メソッドをサポートしないで、このマップが指定されたキーのマッピングを保持する場合は、この実装は UnsupportedOperationException をスローします。
Map
内の remove
key
- マッピングがマップから削除されるキー
UnsupportedOperationException
- このマップが remove オペレーションをサポートしない場合public void putAll(Map t)
この実装は、指定されたマップの entrySet() コレクションの内容を次々調べ、反復によって各エントリが返されるごとに、このマップの put オペレーションを 1 回呼び出します。
このマップが put オペレーションをサポートせず、指定マップが空でない場合、この実装は UnsupportedOperationException をスローします。
Map
内の putAll
t
- マップに格納されるマッピング
UnsupportedOperationException
- このマップが putAll オペレーションをサポートしていない場合
ClassCastException
- 指定されたマップ内のキーまたは値のクラスが原因で、マップに格納できない場合
IllegalArgumentException
- 指定されたマップ内のキーまたは値の特性が原因で、マップに格納できない場合
NullPointerException
- 指定されたマップが null である場合、またはこのマップが null のキーまたは値を許可せず、指定されたマップに null のキーまたは値が含まれている場合public void clear()
この実装は、entrySet().clear() を呼び出します。 entrySet が clear オペレーションをサポートしない場合、この実装は UnsupportedOperationException をスローします。
Map
内の clear
UnsupportedOperationException
- clear がマップによってサポートされていない場合public Set keySet()
この実装は、AbstractSet をサブクラス化する Set を返します。このサブクラスの iterator メソッドは、このマップの entrySet() 反復子の「ラッパーオブジェクト」を返します。size メソッドはこのマップの size メソッドに委譲し、contains メソッドは、このマップの containsKey メソッドに委譲します。
Set は、このメソッドが最初に呼び出されたときに作成され、それに続くすべての呼び出しに応じて返されます。同期は一切行われません。このため、わずかながら、このメソッドへの複数の呼び出しに対して、同じ Set が返されない可能性があります。
Map
内の keySet
public Collection values()
この実装は、abstract コレクションをサブクラス化するコレクションを返します。このサブクラスの iterator メソッドは、このマップの entrySet() 反復子の「ラッパーオブジェクト」を返します。size メソッドはこのマップの size メソッドに委譲し、contains メソッドは、このマップの containsValue メソッドに委譲します。
コレクションは、このメソッドが最初に呼び出されたときに作成され、それに続くすべての呼び出しに応じて返されます。同期は一切行われません。このため、わずかながら、このメソッドへの複数の呼び出しに対して、同じ Collection が返されない可能性があります。
Map
内の values
public abstract Set entrySet()
Map
内の entrySet
public boolean equals(Object o)
この実装は、指定されたオブジェクトがこのマップ自身であるかどうかを最初に調べます。このマップである場合、実装は true を返し指定されたオブジェクトについて、このセットと同じサイズのマップであるかどうかを調べます。同じサイズのマップでない場合は false を返します。同じサイズのマップである場合は、このマップの entrySet コレクションの内容を次々調べて、指定されたマップに、このマップが格納している各マッピングが含まれているかどうかを調べます。指定されたマップにそのようなマッピングがない場合は、false が返されます。反復が完了した場合に true が返されます。
Map
内の equals
Object
内の equals
o
- マップと等しいかどうかを比較するオブジェクト
Object.hashCode()
,
Hashtable
public int hashCode()
この実装は、Collection の各要素 (エントリ) の hashCode を呼び出して、entrySet() の内容を次々調べ、結果を加算していきます。
Map
内の hashCode
Object
内の hashCode
Map.Entry.hashCode()
,
Object.hashCode()
,
Object.equals(Object)
,
Set.equals(Object)
public String toString()
この実装は、空の文字列バッファーを作成し、左中括弧を付加してから、マップの entrySet ビューを繰り返して調べて、各 map.entry の文字列表現を順に付加していきます。各要素の後ろには、文字列 ", " が付加されます。ただし、最後の要素の後ろには、", " ではなく右中括弧が付加されます。最後に、文字列バッファーから文字列を取得し、返します。
Object
内の toString
protected Object clone() throws CloneNotSupportedException
Object
内の clone
CloneNotSupportedException
- オブジェクトのクラスが Cloneable
インタフェースをサポートしていない場合。clone
メソッドをオーバーライドしたサブクラスも、インスタンスを複製できないことを示すためにこの例外をスローすることがあるCloneable
|
Foundation 1.1.2 | |||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。