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

Методы, объявленные в классе java.lang.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://download.java.net/java/early_access/jdk24/docs/api/java.base/java/util/Dictionary.html