20220210 java.util.Collection

java.util.Collection

基本信息

• public interface Collection<E> extends Iterable<E>
• rt.jar
• 引入版本：1.2

使用说明

• Collection 层次结构 中的根接口。
• Collection 表示一组对象，这些对象也称为 collection 的元素。一些 collection 允许有重复的元素，而另一些则不允许。一些 collection 是有序的，而另一些则是无序的。
• JDK 不提供此接口的任何 直接 实现：它提供更具体的子接口（ 如 Set 和 List ）实现。
• 此接口通常用来传递 collection，并在需要最大普遍性的地方操作这些 collection。
• 所有通用的 Collection 实现类（通常通过它的一个子接口间接实现 Collection）应该提供两个“标准”构造方法：一个是 void（无参数）构造方法，用于创建空 collection；另一个是带有 Collection 类型单参数的构造方法，用于创建一个具有与其参数相同元素新的 collection。
• 此接口中包含的“破坏性”方法，是指可修改其所操作的 collection 的那些方法，如果此 collection 不支持该操作，则指定这些方法抛出 UnsupportedOperationException。
• Collections Framework 接口中的很多方法是根据 equals 方法定义的。

接口定义方法

接口定义方法

int size();
返回此 collection 中的元素数。

boolean isEmpty();
如果此 collection 不包含元素，则返回 true。

boolean contains(Object o);
如果此 collection 包含指定的元素，则返回 true。

boolean containsAll(Collection<?> c);
如果此 collection 包含指定 collection 中的所有元素，则返回 true。

Iterator<E> iterator();
返回在此 collection 的元素上进行迭代的迭代器。

Object[] toArray();
<T> T[] toArray(T[] a);
返回包含此 collection 中所有元素的数组。
返回数组的运行时类型与指定数组的运行时类型相同。

boolean add(E e);
确保此 collection 包含指定的元素（可选操作）。

boolean addAll(Collection<? extends E> c);
将指定 collection 中的所有元素都添加到此 collection 中（可选操作）。

boolean remove(Object o);
从此 collection 中移除指定元素的单个实例，如果存在的话（可选操作）。
如果此调用将移除一个元素，则返回 true

boolean removeAll(Collection<?> c);
移除此 collection 中那些也包含在指定 collection 中的所有元素（可选操作）。
如果此 collection 由于调用而发生更改，则返回 true

boolean retainAll(Collection<?> c);
仅保留此 collection 中那些也包含在指定 collection 的元素（可选操作）。
如果此 collection 由于调用而发生更改，则返回 true

void clear();
移除此 collection 中的所有元素（可选操作）。

boolean equals(Object o);

int hashCode();

默认实现方法

默认实现方法

boolean removeIf(Predicate<? super E> filter)
删除此集合中满足断言的所有元素。迭代过程中的异常将转发给调用方。

Spliterator<T> spliterator()
在集合元素上创建 Spliterator

Stream<E> stream()
返回以此集合为源的顺序流。

Stream<E> parallelStream()
返回一个并行流，并将此集合作为其源。允许此方法返回顺序流。