- java.lang.Object
-
- java.util.Dictionary<K,V>
-
- 直系の既知のサブクラス:
Hashtable
public abstract class Dictionary<K,V> extends Object
Dictionary
クラスは、Hashtable
のようにキーを値にマップするクラスのabstract親です。 各キーおよび各値はオブジェクトです。 1つのDictionary
オブジェクトの中では、各キーは単一の値に関連付けられています。Dictionary
およびキーを指定して、関連する要素を参照できます。 キーや値としては、任意のnull
でないオブジェクトが使用できます。このクラスを実装している場合、2つのキーが等しいかどうかを判定するには、原則として
equals
メソッドを使用する必要があります。注: このクラスは現在使われていません。 新しい実装では、このクラスを拡張しないでMapインタフェースを実装してください。
- 導入されたバージョン:
- 1.0
- 関連項目:
Map
,Object.equals(java.lang.Object)
,Object.hashCode()
,Hashtable
-
-
コンストラクタのサマリー
コンストラクタ コンストラクタ 説明 Dictionary()
唯一のコンストラクタです。
-
メソッドのサマリー
すべてのメソッド インスタンス・メソッド 抽象メソッド 修飾子と型 メソッド 説明 abstract Enumeration<V>
elements()
ディクショナリにある値のリストを返します。abstract V
get(Object key)
ディクショナリにおいてキーにマップされている値を返します。abstract boolean
isEmpty()
値にマップされているキーが、ディクショナリにまったくないかどうかを判定します。abstract Enumeration<K>
keys()
ディクショナリにあるキーの列挙を返します。abstract V
put(K key, V value)
このディクショナリで、指定されたkey
を指定されたvalue
にマップします。abstract V
remove(Object key)
key
(およびそれに対応するvalue
)をこのディクショナリから削除します。abstract int
size()
ディクショナリにあるエントリ(個別のキー)の数を返します。
-
-
-
メソッドの詳細
-
size
public abstract int size()
ディクショナリにあるエントリ(個別のキー)の数を返します。- 戻り値:
- ディクショナリにあるキーの数。
-
isEmpty
public abstract boolean isEmpty()
値にマップされているキーが、ディクショナリにまったくないかどうかを判定します。isEmpty
メソッドの一般規約では、ディクショナリにエントリがない場合にだけ結果がtrueになります。- 戻り値:
- 値にマップされているキーがディクショナリにない場合は
true
、ある場合はfalse
。
-
keys
public abstract Enumeration<K> keys()
ディクショナリにあるキーの列挙を返します。 キー・メソッドの一般規約では、ディクショナリがエントリを格納しているすべてのキーを生成するEnumeration
オブジェクトが返されます。- 戻り値:
- ディクショナリにあるキーの列挙。
- 関連項目:
elements()
,Enumeration
-
elements
public abstract Enumeration<V> elements()
ディクショナリにある値のリストを返します。elements
メソッドの一般規約では、Enumeration
が返されて、ディクショナリのエントリに格納されているすべての要素を生成します。- 戻り値:
- ディクショナリにある値のリスト。
- 関連項目:
keys()
,Enumeration
-
get
public abstract V get(Object key)
ディクショナリにおいてキーにマップされている値を返します。isEmpty
メソッドの一般規約では、ディクショナリが指定されたキーのエントリを格納している場合は関連した値が返され、そうでない場合はnull
が返されます。- パラメータ:
key
- ディクショナリのキー。そのキーがディクショナリ内のどの値にもマップされていない場合はnull
。- 戻り値:
- ディクショナリでそのキーにマップされている値。
- 例外:
NullPointerException
-key
がnull
の場合- 関連項目:
put(java.lang.Object, java.lang.Object)
-
put
public abstract V put(K key, V value)
このディクショナリで、指定されたkey
を指定されたvalue
にマップします。 キーや値はnull
にすることはできません。ディクショナリに指定された
key
のエントリが格納されている場合、新しい要素を格納するためにエントリが変更されたあとに、そのkey
に対応するディクショナリ内にすでにある値が返されます。ディクショナリが指定された
key
に対応するエントリをまだ持たない場合、指定されたkey
およびvalue
のエントリが作成され、null
が返されます。value
を取得するには、元のkey
に等しいkey
を指定してget
メソッドを呼び出します。- パラメータ:
key
- ハッシュ表キー。value
- 値。- 戻り値:
- ディクショナリで
key
にマップされていた前の値。このキーに値がマップされていなかった場合はnull
。 - 例外:
NullPointerException
-key
またはvalue
がnull
の場合。- 関連項目:
Object.equals(java.lang.Object)
,get(java.lang.Object)
-
remove
public abstract V remove(Object key)
key
(およびそれに対応するvalue
)をこのディクショナリから削除します。 そのkey
がディクショナリになければ、メソッドは何も行いません。- パラメータ:
key
- 削除するキー。- 戻り値:
- ディクショナリで
key
がマップされていた値。そのキーがマップされていなかった場合はnull
。 - 例外:
NullPointerException
-key
がnull
である場合。
-
-