java collection接口源码

package java.util;
02.
03./*
04.*   1.Collection接口是集合继承关系中的根接口(root interface),有些集合允许重复元素，
05.*     有些集合有序，JDK不提供本接口的实现，只提供子接口的实现（例如Set,List）
06.*   2.所有实现Collection（或者其子接口）的类都必须包含两个构造函数：无参的构造函数，
07.*     以及参数为Collection的拷贝构造函数
08.*
09.*/
10.public interface Collection<E> extends Iterable<E> {
11.
12.    //返回集合中存在的元素。如果元素的数目超过Integer.MAX_VALUE,返回Integer.MAX_VALUE
13.    int size();
14.
15.    //当集合不包含任何元素时，返回true
16.    boolean isEmpty();
17.
18.    //如果集合中包含至少一个指定对象,返回true
19.    boolean contains(Object o);
20.
21.    //返回可以遍历集合元素的迭代器
22.    Iterator<E> iterator();
23.
24.    //返回集合中所有元素组成的数组，数组元素的返回顺序要和迭代器访问集合元素的返回顺序一样
25.    Object[] toArray();
26.
27.    //返回包含此 collection 中所有元素的数组；返回数组的运行时类型与指定数组的运行时类型相同。
28.    <T> T[] toArray(T[] a);
29.
30.    //如果集合不允许重复元素，且集合中已经含有该元素，返回false
31.    boolean add(E e);
32.
33.    //从此 collection 中移除指定元素的单个实例，如果集合中存在指定元素返回true。
34.    boolean remove(Object o);
35.
36.    //如果此 collection 包含指定 collection 中的所有元素，则返回 true。
37.    boolean containsAll(Collection<?> c);
38.
39.    //将指定 collection 中的所有元素都添加到此 collection 中
40.    boolean addAll(Collection<? extends E> c);
41.
42.    //移除此 collection 中那些也包含在指定 collection 中的所有元素（可选操作）。
43.    boolean removeAll(Collection<?> c);
44.
45.    //仅保留此 collection 中那些也包含在指定 collection 的元素（可选操作）。
46.    boolean retainAll(Collection<?> c);
47.
48.    //移除此 collection 中的所有元素（可选操作）。
49.    void clear();
50.
51.    //比较此 collection 与指定对象是否相等。通过覆盖，实现list与list相等，set与set相等
52.    boolean equals(Object o);
53.
54.    //返回此 collection 的哈希码值。
55.    int hashCode();
56.}