Класс Dictionary<K,V>

public abstract class Dictionary<K,V>
extends Object

Класс Dictionary — это абстрактный родительский класс для любого класса, такого как Hashtable, который сопоставляет ключи значениям. Каждый ключ и каждое значение — это объект. В любом объекте Dictionary, каждый ключ связан с не более чем одним значением. Учитывая Dictionary и ключ, соответствующий элемент можно найти. Любой объект, не являющийся null , может использоваться в качестве ключа и значения.

Как правило, метод equals должен использоваться реализациями этого класса для определения того, являются ли два ключа одинаковыми.

ПРИМЕЧАНИЕ: Этот класс устарел. Новые реализации должны реализовывать интерфейс Map, а не расширять этот класс.

Конструкторы

Dictionary

public Dictionary()

Единственный конструктор. (Для вызова подклассами конструкторов, как правило, неявный).

Методы

size

public abstract int size()

Возвращает количество записей (различных ключей) в этом словаре.

Возвращает:

количество ключей в этом словаре.

isEmpty

public abstract boolean isEmpty()

Проверяет, отображает ли этот словарь ни один ключ на значение. Общий контракт для метода isEmpty состоит в том, что результат равен true тогда и только тогда, когда этот словарь не содержит записей.

Возвращает:

true если этот словарь не отображает ни один ключ на значения; false в противном случае.

keys

public abstract Enumeration<K> keys()

Возвращает перечисление ключей в этом словаре. Общий контракт для метода 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 - значение.

Возвращает:

предыдущее значение, которому 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.