Map 源码阅读(未完善)

Map 源码注释

开始的第一行就直接说明了 Map 每一个 Key 对应一个 Value 然后 Key 是不允许重复的。他是一个完全抽象的类而不是一个接口,它代替类 Dictionary 类。Map 接口提供了三个集合视图,允许 map 的内容被视为一组键、值的集合,或一组键值的映射。Map 的顺序被定义为 Map 集合视图上的迭代器返回其元素的顺序。一些 Map 的实现,比如 TreeMap 类,对它们的顺序做了特定的保证;而例如 HashMap 类,则没有。

Note:如果可变对象被用作 Map 的键,则必须非常小心。如果对象的值以影响 equals 比较的方式改变,而对象是映射中的键,则不会指定映射的行为。这种禁令的一个特例就是地图不能包含自己作为关键字。但是允许映射包含自己的值,但是要特别小心:在此类映射上, equals 和 hashCode 方法不再被很好地定义。

所有实现了 Map 接口的具有一般用途的类都应该提供两种“标准”的构造函数:(1)一个用来创造一个空的 Map 的无参构造函数(void constructor);(2)一个带有 Map 类型的单个参数的构造函数,它创建一个具有与其参数相投的 键-值 映射的新映射。实际上,后者的构造函数允许用户复制任何 Map,生成所需类的等价 Map。虽然 Map 没有办法执行这个建议(因为接口不能包含构造函数),但是 JDK 中的所有通用映射实现都符合。

如果 Map 不支持这个操作,即包含在这个接口中“破坏性”的方法,也就是修改它们所在的 Map 的方法,那么就会指定抛出一个 UnSupportedOperationException异常。如果是这种情况,调用这些方法(但不是必须的)对 Map 没有影响可能抛出一个 UnSupportedOperationException异常。例如,在不可修改的映射上调用 putAll(Map),如果映射的“叠加”映射是空的,可能(但不是必须)抛出异常。

实现 Map 接口的一些类对它们可能包含的键和值有限制。例如,一些可能会禁止空的 Key 和 values,一些会限制它们 keys 的类型。试图插入一个不合格的 key 或 value 会抛出一个未经检查的异常,一般是
NullPointerException 或 ClassCastException。试图查询一个不合格的 key 和 value 的存在可能会抛出一个异常,或是简单的返回 false。一些实现将展现前者的行为,一些将展现后者的行为。一般来说,尝试对不合格的键值来进行操作,其操作的完成不会导致将不合格的元素插入到映射中可能会引发异常,或者可能会成功执行。这个例外在这个接口的规范中被标记为“可选的”。

集合框架接口中的许多方法是根据等效方法定义的,例如,{@link #containsKey(Object)containsKey(Object key)}方法的规范说:“返回true”当且仅当这个映射包含一个关键字的映射 (key == null?k == null:key.equals(k))。这个规范不应该被解释为暗示用一个非空参数<key>调用 Map.containsKey 会导致key.equals( k)被调用的任何键 k 。实现可以自由地实现优化,从而避免了 equals 调用,例如通过首先比较两个键的哈希码。({@link Object#hashCode()}规范保证了哈希码不相等的两个对象不能相等。)更一般地说,各种集合框架接口的实现可以自由地利用实现者认为适当的任何底层方法的指定行为。

执行映射递归遍历的某些映射操作可能会失败,并且映射直接或间接包含自身的自我引用实例。这包括clone(),equals(),hashCode()和toString()方法。实现可以选择处理自引用场景,然而大多数当前的实现不这样做。

  • @author Josh Bloch
  • @see HashMap
  • @see TreeMap
  • @see Hashtable
  • @see SortedMap
  • @see Collection
  • @see Set

Map 的函数(public interface Map<K,V>)

查询操作

int size():返回此映射中键值的映射数量,如果超过 Integer.MAX_VALUE 则返回 Integer.MAX_VALUE

boolean isEmpty():如果此映射不包含键值映射,则返回 true

boolean containsKey(Object key):如果这个映射包含指定键的映射,则返回 true

boolean containsValue(Object value):如果此映射将一个或多个键映射到指定的值,则返回 true。

V get(Object key):返回指定的键映射到的值;如果此映射不包含键的映射,则返回 null

修改操作

V put(K key,V value):将指定的值与此 Map 中指定的键相关联(可选操作)。如果 Map 以前包含一个映射键,则旧值被指定的值替换.

V remove(Object key):如果存在,则从该映射中除去该映射

批量操作

void putAll(Map<?extends K,? extends V> m):将指定映射的所有映射复制到此映射。 m 映射被存储在这个映射中。

void clear():从该映射中删除所有映射,执行该方法后,Map 将为空。

查看(Views)

Set<K> keySet():返回一个包含在此映射中的键的集合视图.

Collection<V> values():返回该 Map 中包含的值的集合视图

Set<Map.Entry<K,V>> entrySet():返回此映射中包含的映射的 Set视图

interface Entry<K,V>

Map.entrySet 方法返回地图的集合视图,其元素是这个类的。获取对 Map 条目的引用的唯一方法是从这个集合视图的迭代器中获取。

每个 Map.Entry 其实就是一个 key-value 对.

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

推荐阅读更多精彩内容

  • 一、基本数据类型 注释 单行注释:// 区域注释:/* */ 文档注释:/** */ 数值 对于byte类型而言...
    龙猫小爷阅读 4,257评论 0 16
  • Spring Cloud为开发人员提供了快速构建分布式系统中一些常见模式的工具(例如配置管理,服务发现,断路器,智...
    卡卡罗2017阅读 134,633评论 18 139
  • 1. Java基础部分 基础部分的顺序:基本语法,类相关的语法,内部类的语法,继承相关的语法,异常的语法,线程的语...
    子非鱼_t_阅读 31,598评论 18 399
  • java笔记第一天 == 和 equals ==比较的比较的是两个变量的值是否相等,对于引用型变量表示的是两个变量...
    jmychou阅读 1,488评论 0 3
  • 感恩天地滋养,宇宙永恒;感恩大自然无私的爱;感恩祖先传承,历代宗亲护佑;感恩国泰民安,繁荣昌盛;感恩父母生养大恩,...
    天门金珠瑜伽阅读 390评论 0 1