Java集合框架学习-----Collection接口概述

写在前面
自开始在公司实习以来,经常都要用到集合框架。不仅后台要用,在前台做数据交互的时候用得也多。所以我想着是时候深入地学习一下Java的集合框架,搞搞它们的源码了。

下面先把Java集合框架的结构图放出来(摘自《Thinking in Java》):
Java集合框架类库完备图

其实呢,把上面的图提炼一下,Java集合框架的简略UML类图如下:

  • Collection接口简要类图:
Collection简要类图
  • Map接口简要类图:
Map接口简要类图

PS:上面两个UML图真的画得非常非常简略,其实Collection和Map接口下面还有很多的子接口以及实现类,具体有哪些可以参照官方文档

Collection接口介绍

Collection接口继承自超级接口Iterator,是Collection层次结构中的根接口。Collection表示一组对象,这些对象也被称为Collection的元素。一些Collection允许有重复的元素(例如List),但是另一些则不允许有重复的元素,即可为无序的(如Set)。JDK不提供此接口的任何直接实现---它会提供更为具体的子接口(如Set和List),这从上面的UML也可以看出来。此接口用来传递Collection,并在需要最大普遍性的地方操作这些Collection。

- 关于构造方法

所有通用的Collection实现类(通常通过它的一个子接口间接实现Collection)应该提供两个"标准"构造方法:一个是使用void声明的构造方法,用于创建空Collection;另一个是带有Collection类型单参数的构造方法,用于创建一个具有与其参数相同元素的新的Collection。实际上,后者允许用户复制任何Collection,以生产所需实现类型的一个等效Collection。尽管无法强制执行此约定(因为接口不能包含构造方法),但是Java平台库中所有通用的Collection实现都遵从它。

为了验证是否如上所说的,我打开了ArrayList的源码来研究一下:

首先可以看到一个使用void声明的无参构造方法:

ArrayList无参构造方法

然后我们还看到了一个参数类型为Collection的构造方法:

ArrayList参数类型为Collection的构造方法

由此可以看出上面那段话对于构造方法的描述是正确的。至于构造方法内部具体是如何实现的,等以后我再慢慢开博客来介绍。

- 关于破坏性方法

Collection接口中包含某些破坏性方法破坏性方法,是指可以修改其所操作的Collection的那些方法。比如说某个破坏性方法的参数类型为Collection,即可以往里面传一个Collection实例,如果此方法可以修改这个Collection实例,那么它就是破坏性方法。如果这个被传入的collection不支持该操作,则指定这些方法抛出UnSupportedOperationException。如果是这样,那么在调用对该collection无效的时候,这些方法可能但不一定抛出UnSupportedOperationException。例如,如果要添加的collection为空并且不可修改,则在对该collection调用addAll(Collection)方法时,可能但不一定会抛出异常。

- 关于一些限制

一些collection实现对它们可能包含的元素有所限制。例如,某些实现禁止Null元素,而某些实现则对元素的类型有所限制。试图添加不合法的元素将抛出一个未经检查的异常,一般来说是NullPointerException或者是ClassCastException。试图查询是否存在不合格的元素也可能抛出一个异常,或者只是简单地返回false;某些不适合的实现将表现出前一种行为,即抛出一个异常,而某些实现则表现出后一种行为。较为常见的是,试图对某个不合法的元素执行操作且该操作的完成不会导致将不合法的元素插入collection中,将可能抛出一个异常,也可能操作成功。这取决于实现本身。这样的异常再次接口的规范中标记为"可选"

- 关于同步策略

这主要是由每个collection来确定自身的同步策略。在没有事先的强烈保证的情况之下,调用由另一进程正在更改的collection的方法可能会出现不确定行为;这包括直接调用,将collection传递给可能执行调用的方法,以及使用现有迭代器检查collection。

- 其它

Collections Frameword接口中的很多方法是根据equals方法定义的。例如,contain(Object o )方法的闺房声明:“当且仅当此collection包含至少一个满足(o == null ? e == null : o.equals(e))的元素e时,返回true。”应将此规范理解为它暗指调用具有非空参数o的Collection.contains方法会导致任意的e元素调用o.equals(e)方法。可随意对各种实现执行优化,只要避免调用equals即可。例如,通过首先比较两个元素的哈希码(Object.hashCode()规范保证哈希码不相等的两个对象不会相等)。较为常见的是,各种Collections FrameWord接口的实现课随意利用底层Object方法的指定

Collection接口方法摘要:

偷个懒,直接把JDK文档里面的搬过来

Collection接口方法摘要

方法详细信息:
size

int size()

返回此collection中的元素的数量。如果此collection包含的元素数量大于 Integer.MAX_VALUE,则返回Integer.MAX_VALUE。
返回:此collection中元素的数量

isEmpty

boolean isEmpty()

如果此collection不包含元素,则返回true。
返回:如果此collection不包含元素,则返回true

contains

boolean contains(Object o)

如果此collection包含指定的元素,则返回true。更确切地说,当且仅当此collection至少包含一个满足(o == null ? e == null :o. equals(e))的元素e时,返回true。
参数: o - 测试在此collection中是否存在的元素。

返回: 如果此collection包含指定的元素,则返回true。

抛出:
ClassCastException:如果指定元素的类型与此collection不兼容(可选)
NullPointerException:如果指定的元素为null,并且此collection不允许null元素(可选)

iterator

Iterator<E> iterator()

返回在此collection的元素上进行迭代的迭代器。关于元素返回的顺序没有任何保证,除非此collection是某个能提供保证顺序的类的实例。
制定者:接口Iterator<E>中的iterator

返回:在此collection的元素上进行迭代的Iterator

toArray

Object[] toArray()

返回包含此collection中所有元素的数组。如果collection对其迭代器返回的元素顺序做出了某些保证,那么此方法必须以相同的顺序返回这些元素。

返回的数组将是“安全地”,因此此collection并不维护对返回数组的任何引用。换句话说,即使collection受到数组的支持,此方法也必须分配一个新的数组,因此,调用者可以随意修改返回的数组。

此方法充当了基于数组的API与基于collection的API之间的桥梁。

返回:包含此collection中所有元素的数组

toArray

<T> T[] toArray(T[] a)

返回包含此 collection 中所有元素的数组;返回数组的运行时类型与指定数组的运行时类型相同。如果指定的数组能容纳该 collection,则返回包含此 collection 元素的数组。否则,将分配一个具有指定数组的运行时类型和此 collection 大小的新数组。

如果指定的数组能容纳 collection,并有剩余空间(即数组的元素比 collection 的元素多),那么会将数组中紧接 collection 尾部的元素设置为 null。(只有 在调用者知道此 collection 没有包含任何 null
元素时才能用此方法确定 collection 的长度。)

如果此 collection 对其迭代器返回的元素顺序做出了某些保证,那么此方法必须以相同的顺序返回这些元素。

像 toArray() 方法一样,此方法充当基于数组的 API 与基于 collection 的 API 之间的桥梁。更进一步说,此方法允许对输出数组的运行时类型进行精确控制,并且在某些情况下,可以用来节省分配开销。

假定 x是只包含字符串的一个已知 collection。以下代码用来将 collection 转储到一个新分配的 String数组:
String[] y = x.toArray(new String[0]);
注意,toArray(new Object[0])
和 toArray()
在功能上是相同的。

参数:
a

  • 存储此 collection 元素的数组(如果其足够大);否则,将为此分配一个具有相同运行时类型的新数组。
    返回:
    包含此 collection 中所有元素的数组
    抛出:
    ArrayStoreException-
  • 如果指定数组的运行时类型不是此 collection 每个元素运行时类型的超类型
    NullPointerException
  • 如果指定的数组为 null
add

boolean add(E e)

确保此 collection 包含指定的元素(可选操作)。如果此 collection 由于调用而发生更改,则返回 true
。(如果此 collection 不允许有重复元素,并且已经包含了指定的元素,则返回 false
。)支持此操作的 collection 可以限制哪些元素能添加到此 collection 中来。需要特别指出的是,一些 collection 拒绝添加 null
元素,其他一些 collection 将对可以添加的元素类型强加限制。Collection 类应该在其文档中清楚地指定能添加哪些元素方面的所有限制。
如果 collection 由于某些原因(已经包含该元素的原因除外)拒绝添加特定的元素,那么它必须 抛出一个异常(而不是返回 false
)。这确保了在此调用返回后,collection 总是包含指定的元素。

参数:
e

  • 确定此 collection 中是否存在的元素。
    返回:
    如果此 collection 由于调用而发生更改,则返回true

抛出:
UnsupportedOperationException

  • 如果此 collection 不支持 add
    操作
    ClassCastException
  • 如果指定元素的类不允许它添加到此 collection 中
    NullPointerException
  • 如果指定的元素为 null,并且此 collection 不允许 null 元素
    IllegalArgumentException
  • 如果元素的某属性不允许它添加到此 collection 中
    IllegalStateException
  • 如果由于插入限制,元素不能在此时间添加
remove

boolean remove(Object o )

从此 collection 中移除指定元素的单个实例,如果存在的话(可选操作)。更确切地讲,如果此 collection 包含一个或多个满足 (o==null ? e==null : o.equals(e))
的元素 e
,则移除这样的元素。如果此 collection 包含指定的元素(或者此 collection 由于调用而发生更改),则返回 true

参数:
o

  • 要从此 collection 中移除的元素(如果存在)。
    返回:
    如果此调用将移除一个元素,则返回 true

抛出:
ClassCastException

  • 如果指定元素的类型与此 collection 不兼容(可选)
    NullPointerException
  • 如果指定的元素为 null,并且此 collection 不允许 null 元素(可选)。
    UnsupportedOperationException
  • 如果此 collection 不支持 remove
    操作
containsAll

boolean containsAll(Collection<?> c)

如果此 collection 包含指定 collection 中的所有元素,则返回 true

参数:
c

  • 将检查是否包含在此 collection 中的 collection
    返回:
    如果此 collection 包含指定 collection 中的所有元素,则返回 true

抛出:
ClassCastException

  • 如果指定 collection 中有一个或多个元素的类型与此 collection 不兼容(可选)
    NullPointerException
  • 如果指定 collection 包含一个或多个 null 元素,并且此 collection 不允许 null 元素(可选),或者指定的 collection 为 null
addAll

boolean addAll(Collection<? extends E> c)

将指定 collection 中的所有元素都添加到此 collection 中(可选操作)。如果在进行此操作的同时修改指定的 collection,那么此操作行为是不确定的。(这意味着如果指定的 collection 是此 collection,并且此 collection 为非空,那么此调用的行为是不确定的。)

参数:
c

  • 包含要添加到此 collection 的元素的 collection
    返回:
    如果此 collection 由于调用而发生更改,则返回true

抛出:
UnsupportedOperationException

  • 如果此 collection 不支持 addAll
    方法
    ClassCastException
  • 如果指定 collection 中某个元素的类不允许它添加到此 collection 中
    NullPointerException
  • 如果指定 collection 包含 null 元素,并且此 collection 不支持 null 元素,或者指定的 collection 为 null

IllegalArgumentException

  • 如果指定 collection 的元素的某属性不允许它添加到此 collection 中
    IllegalStateException
  • 如果由于插入限制,不是所有的元素都能在此时间添加
removeAll

boolean removeAll(Collection<?> c)

移除此 collection 中那些也包含在指定 collection 中的所有元素(可选操作)。此调用返回后,collection 中将不包含任何与指定 collection 相同的元素。

参数:
c

  • 办好要从此 collection 移除的元素的 collection
    返回:
    如果此 collection 由于调用而发生更改,则返回true

抛出:
UnsupportedOperationException

  • 如果此 collection 不支持 removeAll
    方法
    ClassCastException
  • 如果此 collection 中一个或多个元素的类型与指定 collection 不兼容(可选)
    NullPointerException
  • 如果此 collection 包含一个或多个 null 元素,并且指定的 collection 不支持 null 元素(可选),或者指定的 collection 为 null
retainAll

boolean retainAll(Collection<?> c)

仅保留此 collection 中那些也包含在指定 collection 的元素(可选操作)。换句话说,移除此 collection 中未包含在指定 collection 中的所有元素。

参数:
c

  • 包含保留在此 collection 中的元素的 collection
    返回:
    如果此 collection 由于调用而发生更改,则返回true

抛出:
UnsupportedOperationException

  • 如果此 collection 不支持 retainAll
    操作
    ClassCastException
  • 如果此 collection 中一个或多个元素的类型与指定 collection 不兼容(可选)
    NullPointerException
  • 如果此 collection 包含一个或多个 null 元素,并且指定的 collection 不允许 null 元素(可选),或者指定的 collection 为null
clear

void clear()

移除此 collection 中的所有元素(可选操作)。此方法返回后,除非抛出一个异常。

抛出:
UnsupportedOperationException

  • 如果此 collection 不支持 clear
    操作
equals

boolean equals(Object o )

比较此 collection 与指定对象是否相等。当 Collection
接口没有对 Object.equals
的常规协定添加任何约定时,“直接”实现该 Collection
接口(换句话说,创建一个 Collection
,但它不是 Set

或 List
的类)的程序员选择重写 Object.equals
方法时必须小心。没必要这样做,最简单的方案是依靠 Object
的实现,然而实现者可能希望实现“值比较”,而不是默认的“引用比较”。(List
和 Set
接口要求进行这样的值比较。)
Object.equals
方法的常规协定声称相等必须是对称的(换句话说,当且仅当存在 b.equals(a)
时,才存在a.equals(b)
)。List.equals
和 Set.equals
的协定声称列表只能与列表相等,set 只能与 set 相等。因此,对于一个既不实现 List
又不实现 Set
接口的 collection 类,当将此 collection 与任何列表或 set 进行比较时,常规的equals
方法必须返回 false
。(按照相同的逻辑,不可能编写一个同时正确实现 Set
和 List
接口的类。)

覆盖:
类 Object
中的 equals

参数:
o

  • 要与此 collection 进行相等性比较的对象。
    返回:
    如果指定对象与此 collection 相等,则返回 true
hashCode

int hashCode()

返回此 collection 的哈希码值。当 Collection
接口没有为 Object.hashCode
方法的常规协定添加任何约束时,为了满足 Object.hashCode
方法的常规协定,程序员应该注意任何重写 Object.equals
方法的类必须重写 Object.hashCode
方法。需要特别指出的是,c1.equals(c2)
暗示着c1.hashCode()==c2.hashCode()

覆盖:
类 Object
中的 hashCode

返回:
此 collection 的哈希码值

以上是Collection接口的概述,以后再慢慢用代码对其中的方法进行验证。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 203,547评论 6 477
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,399评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 150,428评论 0 337
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,599评论 1 274
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,612评论 5 365
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,577评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,941评论 3 395
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,603评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,852评论 1 297
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,605评论 2 321
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,693评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,375评论 4 318
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,955评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,936评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,172评论 1 259
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 43,970评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,414评论 2 342

推荐阅读更多精彩内容

  • 1. Java基础部分 基础部分的顺序:基本语法,类相关的语法,内部类的语法,继承相关的语法,异常的语法,线程的语...
    子非鱼_t_阅读 31,560评论 18 399
  • Collection ├List │├LinkedList │├ArrayList │└Vector │└Stac...
    AndyZX阅读 869评论 0 1
  • 一、基本数据类型 注释 单行注释:// 区域注释:/* */ 文档注释:/** */ 数值 对于byte类型而言...
    龙猫小爷阅读 4,253评论 0 16
  • java笔记第一天 == 和 equals ==比较的比较的是两个变量的值是否相等,对于引用型变量表示的是两个变量...
    jmychou阅读 1,483评论 0 3
  • 文 | 私塾先生 前情回顾第一章:窥 | 第二章:探 | 第三章:梦 |第四章:离 “我想好了。”我从没想过我会如...
    私塾先生lilz阅读 370评论 0 2