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

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

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.
https://docs.oracle.com/en/java/javase/25/docs/api/java.base/java/util/Dictionary.html