java.util

クラス Dictionary<K,V>

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 インタフェースを実装してください。

導入されたバージョン:

JDK1.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() ディクショナリにあるエントリ (個別のキー) の数を返します。

クラス java.lang.Object から継承されたメソッド

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

コンストラクタの詳細

Dictionary

public Dictionary()

唯一のコンストラクタです。サブクラスのコンストラクタによる呼び出し用で、通常は暗黙的に呼び出されます。

メソッドの詳細

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 の場合。