java.util
類別 Dictionary<K,V>

java.lang.Object
  java.util.Dictionary<K,V>

直接已知子類別：

Hashtable

public abstract class Dictionary<K,V>
extends Object

Dictionary 類別是任何可將鍵映射到相應值的類別（如 Hashtable）的抽象父類別。每個鍵和每個值都是一個物件。在任何一個 Dictionary 物件中，每個鍵至多與一個值相關聯。給定一個 Dictionary 和一個鍵，就可以尋找所關聯的元素。任何非 null 物件都可以用作鍵或值。

通常，應該在此類別的實作中使用 equals 方法，以決定兩個鍵是否相同。

註：此類別已過時。新的實作應該實作 Map 介面，而不是擴展此類別。

從以下版本開始：

JDK1.0

另請參見：

Map, Object.equals(java.lang.Object), Object.hashCode(), Hashtable

建構子摘要

Dictionary()
單獨的建構子。

方法摘要

abstract Enumeration<V>	elements() 返回此 dictionary 中值的列舉。
abstract V	get(Object key) 返回此 dictionary 中該鍵所映射到的值。
abstract boolean	isEmpty() 測試此 dictionary 是否不存在從鍵到值的映射。
abstract Enumeration<K>	keys() 返回此 dictionary 中的鍵的列舉。
abstract V	put(K key, V value) 將指定 key 映射到此 dictionary 中指定 value。
abstract V	remove(Object key) 從此 dictionary 中移除 key （及其相應的 value）。
abstract int	size() 返回此 dictionary 中條目（不同鍵）的數量。

從類別 java.lang.Object 繼承的方法

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

建構子詳細資訊

Dictionary

public Dictionary()

單獨的建構子。（由子類別建構子調用，通常是隱式的。）

方法詳細資訊

size

public abstract int size()

返回此 dictionary 中條目（不同鍵）的數量。

返回：

此 dictionary 中的鍵數。

isEmpty

public abstract boolean isEmpty()

測試此 dictionary 是否不存在從鍵到值的映射。isEmpty 方法的常規協定是，當且僅當此 dictionary 不包含條目時，結果為 true。

返回：

如果此 dictionary 不存在從鍵到值的映射，則返回 true；否則返回 false。

keys

public abstract Enumeration<K> keys()

返回此 dictionary 中的鍵的列舉。鍵方法的常規協定是返回 Enumeration 物件，該物件將產生此 dictionary 套件含條目的所有鍵。

返回：

此 dictionary 中鍵的列舉。

另請參見：

elements(), Enumeration

elements

public abstract Enumeration<V> elements()

返回此 dictionary 中值的列舉。elements 方法的常規協定是返回 Enumeration 物件，該物件將產生此 dictionary 中包含條目的所有元素。

返回：

此 dictionary 中值的列舉。

另請參見：

keys(), Enumeration

get

public abstract V get(Object key)

返回此 dictionary 中該鍵所映射到的值。isEmpty 方法的常規協定是，如果此 dictionary 套件含所指定鍵的條目，則返回該鍵所關聯的值；否則，返回 null。

參數：

key - 此 dictionary 中的一個鍵。如果該鍵沒有映射到此 dictionary 中任何值，則返回 null。

返回：

此 dictionary 中該鍵所映射到的值；

拋出：

NullPointerException - 如果該 key 為 null。

另請參見：

put(java.lang.Object, java.lang.Object)

put

public abstract V put(K key,
                      V value)

將指定 key 映射到此 dictionary 中指定 value。鍵和值均不能為 null。

如果此 dictionary 已經包含指定 key 的條目，則在修改條目以包含新元素之後，返回該 key 在此 dictionary 中已有的值。

如果此 dictionary 還沒有指定 key 的條目，則為指定 key 和 value 創建條目，並返回 null。

可以通過調用 get 方法來獲取 value，使用的 key 與原來的 key 相等。

參數：

key - 雜湊表鍵。

value - 值。

返回：

以前該 key 在此 dictionary 中被映射到的值，如果該鍵沒有以前的映射關係，則返回 null。

拋出：

NullPointerException - 如果 key 或 value 為 null。

另請參見：

Object.equals(java.lang.Object), get(java.lang.Object)

remove

public abstract V remove(Object key)

從此 dictionary 中移除 key （及其相應的 value）。如果該 key 不在此 dictionary 中，則該方法不執行任何操作。

參數：

key - 需要移除的鍵。

返回：

該 key 在此 dictionary 中被映射到的值，如果該鍵沒有以前的映射關係，則返回 null。

拋出：

NullPointerException - 如果 key 為 null。