31.5. Java – Интерфейс Map

Интерфейс Map в Java отображает уникальные ключи для значений. Ключ – это объект, который вы используете, чтобы позже получить значение.

• Имея ключ и значение, вы можете поместить значение в объект Map. После помещения значения, вы можете его получить, используя его ключ.
• Некоторые методы генерируют исключение NoSuchElementException, когда в вызываемой карте нет элементов.
• Исключение ClassCastException генерируется, когда объект несовместим с элементами на карте.
• Исключение NullPointerException генерируется, когда совершается попытка использовать нулевой объект, а ноль не допустим на карте.
• Исключение UnsupportedOperationException генерируется, когда совершается попытка изменить неизменяемую карту.

Методы

№	Метод и описание
1	void clear() Удаляет все пары ключей/значений в вызываемой карте.
2	boolean containsKey(Object k) Возвращает true, если вызываемая карта содержит k как ключ. В противном случае, возвращает false.
3	boolean containsValue(Object v) Возвращает true, если карта содержит v как значение. В противном случае, возвращает false.
4	Set entrySet() Возвращает набор, содержащий записи на карте. Набор содержит объекты типа Map.Entry. Этот метод обеспечивает просмотр набора вызывающей карты.
5	boolean equals(Object obj) Возвращает true, если obj является Map и содержит одинаковые записи. В противном случае, возвращает false.
6	Object get(Object k) Возвращает значение, связанное с ключом k.
7	int hashCode() Возвращает хэш-код для вызываемой карты.
8	boolean isEmpty() Возвращает true, если вызываемая карта пустая. В противном случае, возвращает false.
9	Set keySet() Возвращает набор, который содержит ключи в вызываемой карте. Этот метод предоставляет набор ключей на вызывающей карте.
10	Object put(Object k, Object v) Вставляет запись в вызываемую карту, перезаписывая любое предыдущее значение, связанное с ключом. Ключ и значения соответствуют k и v. Возвращает ноль, если ключ ещё не существует. В противном случае возвращается предыдущее значение, связанное с ключом.
11	void putAll(Map m) Вставляет все записи из m в эту карту.
12	Object remove(Object k) Удаляет запись, чей ключ равен k.
13	int size() Возвращает количество пар ключей/значений в карте.
14	Collection values() Возвращает коллекцию значений в карте. Этот метод предоставляет просмотр значений в карте.

Пример

В Java Map имеет своё реализацию в различных классах, таких как HashMap. Следующее – пример, объясняющий функционал карты.

import java.util.*;
public class CollectionsDemo {

   public static void main(String[] args) {
      Map m1 = new HashMap(); 
      m1.put("Маша", "8");
      m1.put("Михаил", "31");
      m1.put("Олег", "12");
      m1.put("Денис", "14");

      System.out.println();
      System.out.println("Элементы карты");
      System.out.print("\t" + m1);
   }
}

Получим следующее:

Элементы карты
	{Денис = 14, Олег = 12, Маша = 8, Михаил = 31}