Class Dictionary<K,V>

java.lang.Object

java.util.Dictionary<K,V>

Параметры типа:: K - тип ключей; V - тип отображаемых значений

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

public abstract class Dictionary<K,V> extends Object

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

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

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

С версии:

1.0

См. также:

Краткое описание конструкторов

Конструктор	Описание
`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()`	Возвращает количество записей (уникальных ключей) в этом словаре.

Методы, объявленные в классе Object

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

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создает и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Указывает, является ли другой объект «равным» этому объекту.
`protected void`	`finalize()`	Устарело и подлежит удалению: этот элемент API может быть удален в будущей версии. Финализация устарела и подлежит удалению в одном из будущих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`int`	`hashCode()`	Возвращает хеш-код этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`String`	`toString()`	Возвращает строковое представление объекта.
`final void`	`wait()`	Заставляет текущий поток ожидать, пока он не будет пробужден, обычно путем вызова notify или interrupt.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать, пока он не будет пробужден, обычно путем вызова notify или interrupt, либо пока не истечет определенный промежуток реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать, пока он не будет пробужден, обычно путем вызова notify или interrupt, либо пока не истечет определенный промежуток реального времени.

Подробное описание конструкторов

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

public abstract Enumeration<V> elements()

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

Возвращает:

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

См. также:

get

public abstract V get(Object key)

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

Параметры:

key - ключ в этом словаре. null, если ключу в этом словаре не сопоставлено никакое значение.

Возвращает:

значение, сопоставленное ключу в этом словаре;

Исключения:

NullPointerException - если key равно null.

См. также:

put

public abstract V put(K key, V value)

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

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

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

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

Параметры:

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

value - значение.

Возвращает:

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

Исключения:

NullPointerException - если key или value равно null.

См. также:

remove

public abstract V remove(Object key)

Удаляет key (и соответствующий ему value) из этого словаря. Если key отсутствует в этом словаре, метод ничего не делает.

Параметры:: key - ключ, который необходимо удалить.
Возвращает:: значение, которое было сопоставлено key в этом словаре, или null, если ключу не было сопоставлено значение.
Исключения:: NullPointerException - если key равно null.

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.