以下是本人从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()
  • 返回一个使用调用集合作为元素来源的流。该流能够支持并运行操作。