参考jdk 7源码
简介:
Collection层次结构中的根接口。Collection表示一组对象,这些对象也称为collection的都元素。
子类接口:
List、Queue、Set、SortedSet
public interface Collection<E> extends Iterable<E>{
int size();//返回集合中元素的大小
boolean isEmpty();//如果集合中没有元素,返回为true
/**
*如果集合中包含指定元素o,返回true
*/
boolean contains(Object o);
/**
*返回该集合中元素的迭代器,没有保证元素的返回顺序
*/
Iterator<E> iterator();
/**
*返回包含此集合中所有元素的数组。如果此集合对其迭代器返回的元素的顺序作
*出任何保证,则该方法必须以相同的顺序返回元素。
*该方法充当数组的api和集合的api的桥梁
*/
Object[] toArray();
/**
*确保该集合包含指定元素(可选操作)
*返回true:
*返回false:该集合已包含指定的元素,并且不允许重复
*
*支持此操作的集合可能会限制添加到该集合中的元素,特别是一些集合禁止
*添加null元素,和一些集合则会对可能添加的元素的类型施加限制。
*集合应该在文档中明确的说明限制添加的元素
*
*/
boolean add(E e);
/**
*从该集合中移除指定元素的单个实例
*/
boolean remove(Object o);
/**
*返回true:该集合包含指定集合的所有元素
*/
boolean containsAll(Collection<?> c);
/**
*将指定集合中的所有元素添加到该集合中
*/
boolean addAll(Collection<? extends E> c);
/**
*移除包含指定集合的所有元素,调用此方法后,该集合中将不会在包含指定集合中的任何元素
*/
boolean removeAll(Collection<?> c);
/**
*在该集合中仅仅保留包含指定集合中的元素,移除该集合中不包含在指定 集合中的元素
*/
boolean retainAll(Collection<?> c);
/**
*移除该集合的所有元素,调用此方法后,该集合将为空
*/
void clear();
/**
*比较指定对象和该集合是否相等
*/
boolean equals(Object o);
/**
* 返回该集合对象的hash code值
*/
int hashCode();
}