首页 > 代码库 > 源码(03) -- java.util.Collection<E>

源码(03) -- java.util.Collection<E>

2024-09-02 03:02:53   220人阅读

 java.util.Collection<E> 源码分析

---------------------------------------------------------------------------------

java.util.Collection<E>是一个接口，它的定义如下:

1 public interface Collection<E> extends Iterable<E> {
2    // Query Operations
3    // Modification Operations
4    // Bulk Operations
5    // Comparison and hashing
6 }

(1)从定义中可以看出Collection接口中定义了:查询方法、修改方法、批量操作方法、哈希和比较方法。

(2)Collection是是一个根接口，表示一组对象，这些对象也称为collection的元素。

(3)Collection的实现类中有这样的特征: 有些collection是允许重复元素的;有些collection是不允许重复元素的;有些collection是有序的;有些collection是无序的。

(4)JDK不提供对Collection接口的直接实现，而且提供了两个更为具体的接口去实现（如:java.util.List和java.util.Set)

----------------------------------------------------------------------------------

下面来看看java.util.Collection<E>中具体有哪些方法：

从下面的表格中可以看出java.util.Collection<E>接口中一共有15个方法，其中查询操作6个;修改操作2个;批量操作5个;比较和哈希操作2个。

查询操作 int size() 返回此 collection 中的元素数。如果此 collection 包含的元素大于 Integer.MAX_VALUE，则返回 Integer.MAX_VALUE。
boolean isEmpty() 如果此 collection 不包含元素，则返回 true,否则返回false
boolean contains(Object o) 如果此 collection 包含指定的元素，则返回 true。更确切地讲，当且仅当此 collection 至少包含一个满足 (o==null ? e==null : o.equals(e)) 的元素 e 时，返回 true。
Iterator<E> iterator() 返回在此 collection 的元素上进行迭代的迭代器。关于元素返回的顺序没有任何保证（除非此 collection 是某个能提供保证顺序的类实例）。
Object[] toArray() 返回包含此 collection 中所有元素的数组。如果 collection 对其迭代器返回的元素顺序做出了某些保证，那么此方法必须以相同的顺序返回这些元素。
<T> T[] toArray(T[] a) 返回包含此 collection 中所有元素的数组；返回数组的运行时类型与指定数组的运行时类型相同。如果指定的数组能容纳该 collection，则返回包含此 collection 元素的数组。否则，将分配一个具有指定数组的运行时类型和此 collection 大小的新数组。
修改操作 boolean add(E e) 将元素e添加到此集合中，如果添加成功则返回true,添加失败则返回false
boolean remove(Object o) 从此 collection 中移除指定元素o的单个实例,如果操作成功则返回true,操作失败则返回false
批量操作 boolean containsAll(Collection<?> c ) 如果此 collection 包含指定 collection 中的所有元素，则返回 true。
addAll(Collection<? extends E> c) 将指定 collection 中的所有元素都添加到此 collection 中.
boolean removeAll(Collection<?> c) 移除此 collection 中那些也包含在指定 collection 中的所有元素。
boolean retainAll(Collection<?> c) 仅保留此 collection 中那些也包含在指定 collection 的元素。
void  clear() 移除此 collection 中的所有元素。
比较和哈希操作 boolean equals(Object o) 比较此 collection 与指定对象是否相等
int hashCode() 返回此 collection 的哈希码值

----------------------------------------------------------------------------------

java.util.Collection<E>源码如下：(看看下面的源码，定义的很规范，各种操作都有-----> 此时应该想到它的实现类该有多可怜,要实现多少方法呀。~_~)

 1 package java.util;
 2 
 3 
 4 public interface Collection<E> extends Iterable<E> {
 5     // Query Operations
 6 
 7     int size();
 8 
 9     boolean isEmpty();
10 
11     boolean contains(Object o);
12 
13     Iterator<E> iterator();
14 
15     Object[] toArray();
16 
17     <T> T[] toArray(T[] a);
18 
19     // Modification Operations
20 
21     boolean add(E e);
22 
23     boolean remove(Object o);
24 
25 
26     // Bulk Operations
27 
28     boolean containsAll(Collection<?> c);
29 
30     boolean addAll(Collection<? extends E> c);
31 
32     boolean removeAll(Collection<?> c);
33 
34     boolean retainAll(Collection<?> c);
35 
36     void clear();
37 
38 
39     // Comparison and hashing
40 
41     boolean equals(Object o);
42 
43     int hashCode();
44 }

----------------------------------------------------------------------------------

----------------------------------------------------------------------------------

 

源码(03) -- java.util.Collection<E>


联系
我们