java.util

Словарь класса <K, V>

java.lang. Объект

java.util. Словарь <K, V>

Прямые Известные Подклассы:

Хеш-таблица

public abstract class Dictionary<K,V>
extends Object

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

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

ОТМЕТЬТЕ: Этот класс является устаревшим. Новые реализации должны реализовать интерфейс Карты, вместо того, чтобы расширить этот класс.

С тех пор:

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 унаследованный от класса. Объект

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

Деталь конструктора

Словарь

public Dictionary()

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

Деталь метода

размер

public abstract int size()

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

Возвраты:

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

isEmpty

public abstract boolean isEmpty()

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

Возвраты:

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

ключи

public abstract Enumeration<K> keys()

Возвращает перечисление ключей в этом словаре. Общий контракт для ключевого метода - то, что объект Enumeration возвращается, который генерирует все ключи, для которых этот словарь содержит записи.

Возвраты:

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

См. Также:

elements(), Enumeration

элементы

public abstract Enumeration<V> elements()

Возвращает перечисление значений в этом словаре. Общий контракт для метода elements - то, что Enumeration возвращается, который генерирует все элементы, содержавшиеся в записях в этом словаре.

Возвраты:

перечисление значений в этом словаре.

См. Также:

keys(), Enumeration

добраться

public abstract V get(Object key)

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

Параметры:

key - ключ в этом словаре. null если ключ не отображается ни на какое значение в этом словаре.

Возвраты:

значение, на которое ключ отображается в этом словаре;

Броски:

NullPointerException - если key является null.

См. Также:

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

поместить

public abstract V put(K key,
    V value)

Отображает указанное key к указанному value в этом словаре. Ни ключ, ни значение не могут быть null.

Если этот словарь уже содержит запись для указанного key, значение уже в этом словаре для того, что key возвращается после изменения записи, чтобы содержать новый элемент.

Если у этого словаря уже нет записи для указанного key, запись создается для указанного key и value, и null возвращается.

value может быть получен, вызывая get метод с a key это равно оригиналу key.

Параметры:

key - ключ хеш-таблицы.

value - значение.

Возвраты:

предыдущее значение то, к который key был отображен в этом словаре, или null если у ключа не было предыдущего отображения.

Броски:

NullPointerException - если key или value null.

См. Также:

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

удалить

public abstract V remove(Object key)

Удаляет key (и его соответствие value) из этого словаря. Этот метод ничего не делает если key не находится в этом словаре.

Параметры:

key - ключ, который должен быть удален.

Возвраты:

значение то, к который key был отображен в этом словаре, или null если у ключа не было отображения.

Броски:

NullPointerException - если key является null.