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() 返回一个并行流,并将此集合作为其源。允许此方法返回顺序流。 |