4.3. Ієрархія колекцій. Інтерфейс Collections

Ієрархія класів-колекцій

Класи-колекції, що реалізують описані вище інтерфейси, є спадкоємцями абстрактного класу AbstractCollection. Ієрархія цих класів наведена на малюнку (синім кольором показані інтерфейси).

 

Інтерфейс Collections

Варто зауважити, що в Java немає жодного класу, який би безпосередньо реалізував інтерфейс Collection. Це відбувається через проміжні інтерфейси List, Set і Queue.

Методи інтерфейсу Collection<E>:

методи	опис
boolean add (E e);	Додає елемент в колекцію
boolean addAll (Collection <? extends E> c);	Додає елементи в колекцію
void clear ();	Видаляє всі елементи з колекції
boolean contains (Object o);	Перевіряє - чи є в колекції елемент?
boolean containsAll (Collection <?> c);	Перевіряє - чи є в колекції елементи?
boolean equals (Object o);	порівнює колекції
int hashCode ();	Повертає хеш-код
boolean isEmpty ();	Перевіряє - порожня чи колекція?
Iterator <E> iterator ();	Повертає об'єкт-ітератор
boolean remove (Object o);	Видаляє елемент з колекції
boolean removeAll (Collection <?> c);	Видаляє елементи з колекції
boolean retainAll (Collection <?> c);	Видаляє всі елементи, яких немає «з»
int size ();	Повертає розмір колекції
Object [ ] toArray ();	Перетворює колекцію до масиву
<T> T [ ] toArray (T [ ] a);	Перетворює колекцію до масиву

Методи List і Set:

• boolean add(Object obj) - додає елемент obj в кінець колекції; повертає false, якщо такий елемент в колекції уже є, а колекція не допускає повторних елементів; повертає true, якщо додавання пройшло успішно;
• boolean addAll(Collection coll) - додає всі елементи колекції coll в кінець даної колекції;
• void clear() - видаляє всі елементи колекції;
• boolean contains(Object obj) - перевіряє наявність елементу obj в колекції;
• boolean containsAll(Collection coll) - перевіряє наявність всіх елементів колекції coll в даній колекції;
• boolean isEmpty() - перевіряє, чи колекція порожня;
• iterator iterator() - повертає ітератор даної колекції;
• boolean remove(object obj) — видаляє указаний елемент із колекції; повертає false, якщо елемент не знайдено, true, якщо видалення пройшло успішно;
• boolean removeAll (Collection coll) — видаляє елементи указаної колекції, що належать даній колекції;
• boolean retainAll(Collection coll) - видаляє всі елементи даної колекції, крім елементів колекції coll;
• int size() - повертає кількість елементів в колекції;
• Оbject [] toArray () - повертає всі елементи колекції у вигляді масиву;
• Object[] toArray<object[] a - записує всі елементи колекції в масив а, якщо в ньому достатньо місця.