Класс Dictionary<K,​V>

Прямые известные подклассы:
Hashtable
public abstract class Dictionary<K,V>
extends Object

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

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

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

С тех пор:
1.0
См. также:
Map, Object.equals(java.lang.Object), Object.hashCode(), Hashtable

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

КонструкторОписание
Dictionary()

Единственный конструктор.

Методы

Модификатор и типМетодОписание
abstract Enumeration<V>elements()

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

abstract Vget​(Object key)

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

abstract booleanisEmpty()

Проверяет, отображает ли этот словарь ни один ключ к значению.

abstract Enumeration<K>keys()

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

abstract Vput​(K key, V value)

Сопоставляет указанный key указанному value в этом словаре.

abstract Vremove​(Object key)

Удаляет key (и его соответствующее value) из этого словаря.

abstract intsize()

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

Методы, объявленные в классе 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 если этот словарь не отображает ни один ключ к значениям; 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 в этом словаре. Ни ключ, ни значение не могут быть null.

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

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

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

Параметры:
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.

© 1993, 2020, 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/11/docs/api/java.base/java/util/Dictionary.html

Spec-Zone .ru
спецификации, руководства, описания, API