31.1. Java – Интерфейс Collection

Интерфейс Collection – это основа, на которой построена структура коллекций в Java. Он объявляет основные методы, которые будут иметь все коллекции. Эти методы приведены в следующей таблице.

Так как все коллекции реализуют Collection, знакомство с его методами необходима для понимания фреймворка. Некоторые из этих методов могут вызывать исключение UnsupportedOperationException.

Методы

№	Метод и описание
1	boolean add(Object obj) Добавляет obj к вызывающей коллекции. Возвращает true, если объект был добавлен в коллекцию. Возвращает false, если obj уже является членом коллекции, или если коллекция не позволяет иметь дубликаты.
2	boolean addAll(Collection c) Добавляет все элементы c в вызывающую коллекцию. Возвращает true, если операция прошла успешно (т.е. элементы были добавлены). В противном случае возвращает false.
3	void clear( ) Удаляет все элементы из вызывающей коллекции.
4	boolean contains(Object obj) Возвращает true, если obj является элементом вызывающей коллекции. В противном случае возвращает false.
5	boolean containsAll(Collection c) Возвращает true, если вызывающая коллекция содержит все элементы c. В противном случае возвращает false.
6	boolean equals(Object obj) Возвращает true, если вызывающая коллекция and obj are equal. В противном случае возвращает false.
7	int hashCode( ) Возвращает хэш-код для вызывающей коллекции.
8	boolean isEmpty( ) Возвращает true, если вызывающая коллекция пустая. В противном случае возвращает false.
9	Iterator iterator( ) Возвращает итератор для вызывающей коллекции.
10	boolean remove(Object obj) Удаляет один экземпляр obj из вызывающей коллекции. Возвращает true, если элемент был удалён. В противном случае возвращает false.
11	boolean removeAll(Collection c) Удаляет все элементы c из вызывающей коллекции. Возвращает true, если коллекция изменилась (т.е. элементы были удалены). В противном случае возвращает false.
12	boolean retainAll(Collection c Удаляет все элементы из вызывающей коллекции, кроме тех, что содержатся в c. Возвращает true, если коллекция изменилась (т.е. элементы были удалены. В противном случае возвращает false.
13	int size( Возвращает количество элементов, хранящихся в вызывающей коллекции.
14	Object[ ] toArray( ) Возвращает массив, которые содержит все элементы, хранящиеся в вызывающей коллекции. Элементы массива являются копиями элементов коллекции.
15	Object[ ] toArray(Object array[ ] Возвращает массив, содержащий только те элементы коллекции, тип которых соответствует массиву.

Пример

Ниже приведён пример, объясняющий несколько методов из различных реализаций классов из вышеупомянутых методов коллекций:

import java.util.*;

public class CollectionsDemo {

   public static void main(String[] args) {

      // ArrayList

      List a1 = new ArrayList();

      a1.add("Заря");

      a1.add("Марк");

      a1.add("Айан");

      System.out.println(" ArrayList Элементы");

      System.out.print("\t" + a1);

      // LinkedList

      List l1 = new LinkedList();

      l1.add("Заря");

      l1.add("Марк");

      l1.add("Айан");

      System.out.println();

      System.out.println(" LinkedList Элементы");

      System.out.print("\t" + l1);

      // HashSet

      Set s1 = new HashSet();

      s1.add("Заря");

      s1.add("Марк");

      s1.add("Айан");

      System.out.println();

      System.out.println(" Set Элементы");

      System.out.print("\t" + s1);

      // HashMap

      Map m1 = new HashMap();

      m1.put("Заря", "8");

      m1.put("Марк", "31");

      m1.put("Айан", "12");

      m1.put("Дэйзи", "14");

      System.out.println();

      System.out.println(" Map Элементы");

      System.out.print("\t" + m1);

   }

}

Получим следующий результат:

ArrayList Элементы

[Заря, Марк, Айан]

LinkedList Элементы

[Заря, Марк, Айан]

Set Элементы

[Айан, Заря, Марк]

Map Элементы

{Дэйзи = 14, Айан = 12, Заря = 8, Марк = 31}