Интерфейс 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}