JAVA中Collection接口的方法

以下是本人从API上复制的内容，只是方便自己查找记忆。

compact1, compact2, compact3
java.util

Interface Collection<E>

public interface Collection<E> extends Iterable<E>

所有通用的Collection实现类（通常通过其子接口间接实现）应提供两个“标准”构造函数：一个void（无参数）构造函数，它创建一个空集合。另一个构造函数创建一个与其参数相同的元素的新集合。 实际上，后一个构造函数允许用户复制任何集合，生成所需实现类型的等效集合。

 

 

• • int size()
  • 返回此集合中的元素个数。 如果此集合包含超过Integer.MAX_VALUE个元素，则返回Integer.MAX_VALUE=2147483647。

 

• • boolean isEmpty()
  • 如果调用集合不包含元素，则返回 true 。

 

• • boolean contains(Object obj)
  • 如果调用集合包含指定的元素obj,则返回true 。

 

• • boolean containsAll(Collection<?> c) 
  • 如果调用集合包含指定集合c中的所有元素，则返回true。

 

• • Iterator<E> iterator()
  • 返回调用集合中的元素的迭代器。

 

• • Object[] toArray()
  • 返回一个调用集合中所有元素的Object类型数组。

 

• • <T> T[] toArray(T[] a)
  • 返回调用集合中所有元素的数组;返回的数组的类型是指定数组a的类型。如果调用集合与指定的数组大小匹配,则返回到此数组。 如果调用集合大于指定数组，将按调用集合的大小分配一个新数组。如果调用集合小于指定的数组，则数组中的多余空间将设置为null 。

 

• • boolean add(E e)
  • 调用集合添加元素e。成功添加，则返回true 。(如果调用集合不允许重复，并且已包含指定的元素，则返回false)

 

• • boolean addAll(Collection<? extends E> c)
  • 将指定集合c中的所有元素添加到调用集合（可选操作），集合发生变化则返回true。

 

• • boolean remove(Object obj)
  • 从调用集合中移除指定元素obj（如果存在）（可选操作），操作集合发生变化，返回true。

 

• • boolean removeAll(Collection<?> c)
  • 从调用集合中移除集合c的所有元素（可选操作）。操作集合发生变化，返回true。

 

• • boolean retainAll(Collection<?> c)
  • 移除调用集合中所有的c集合元素之外的所有元素，如果调用集合发生了变化（即移除了元素），则返回true。换句话说，仅保留调用集合中包含在集合c中的元素（可选操作）。

 

• • void clear()
  • 移除调用集合中的所有元素。

 

• • boolean equals(Object obj)
  • 调用集合与obj相等，返回true。

 

下面是两个默认方法：

 

 

• • default Stream<E> stream()
  • 返回一个使用调用集合作为元素来源的流。该流是顺序流。

 

• • default Stream<E> parallelStream()
  • 返回一个使用调用集合作为元素来源的流。该流能够支持并运行操作。