first commit

LICENSE

@@ -0,0 +1 @@
+欢迎转载，注明出处就行，谢谢～～

README.md

@@ -0,0 +1,21 @@
+# Java Collections Framework Internals
+## Authors
+| Weibo Id | Name |
+|:-----------|:-------------|
+|[@计算所的小鼠标](http://weibo.com/icttinymouse) | Hao Li |
+
+## Introduction
+
+关于*C++ Standard Template Library(STL)*的书籍和资料有很多，关于*Java Collections Framework(JCF)*的资料却很少，甚至很难找到一本专门介绍它的书籍，这给Java学习者们带来不小的麻烦。我深深的不解其中的原因。虽然JCF设计参考了STL，但其定位不是Java版的STL，而是要实现一个精简紧凑的容器框架，对STL的介绍自然不能替代对JCF的介绍。
+
+## Contents
+
+本系列文章主要从**数据结构和算法**层面分析JCF中List, Set, Map等典型容器，并不特意介绍Java的语言特性。具体内容如下：
+
+1. Overview
+2. ArrayList
+3. LinkedList
+4. Stack and Queue
+5. TreeSet and TreeMap
+6. HashSet and HashMap
+7. LinkedHashSet and LinkedHashMap

markdown/0-Introduction.md

@@ -0,0 +1,21 @@
+# Java Collections Framework Internals
+## Authors
+| Weibo Id | Name |
+|:-----------|:-------------|
+|[@计算所的小鼠标](http://weibo.com/icttinymouse) | Hao Li |
+
+## Introduction
+
+关于*C++ Standard Template Library(STL)*的书籍和资料有很多，关于*Java Collections Framework(JCF)*的资料却很少，甚至很难找到一本专门介绍它的书籍，这给Java学习者们带来不小的麻烦。我深深的不解其中的原因。虽然JCF设计参考了STL，但其定位不是Java版的STL，而是要实现一个精简紧凑的容器框架，对STL的介绍自然不能替代对JCF的介绍。
+
+## Contents
+
+本系列文章主要从**数据结构和算法**层面分析JCF中List, Set, Map等典型容器，并不特意介绍Java的语言特性。具体内容如下：
+
+1. Overview
+2. ArrayList
+3. LinkedList
+4. Stack and Queue
+5. TreeSet and TreeMap
+6. HashSet and HashMap
+7. LinkedHashSet and LinkedHashMap

markdown/1-Overview.md

@@ -0,0 +1,96 @@
+# 概览
+
+容器，就是可以容纳其他Java对象的对象。*Java Collections Frameword（JCF）*为Java开发者提供了通用的容器，其始于JDK 1.2，优点是：
+
+- 降低编程难度
+- 提高程序性能
+- 提高API间的互操作性
+- 降低学习难度
+- 降低设计和实现相关API的难度
+- 增加程序的重用性
+
+Java容器里只能放对象，对于基本类型（int, long, float, double等），需要将其包装成对象类型后（Integer, Long, Float, Double等）才能放到容器里。很多时候拆包装和解包装能够自动完成。这虽然会导致额外的性能和空间开销，但简化了设计和编程。
+
+## 泛型（Generics）
+
+Java容器能够容纳任何类型的对象，这一点表面上是通过泛型机制完成，Java泛型不是什么神奇的东西，只是编译器为我们提供的一个“语法糖”，泛型本身并不需要Java虚拟机的支持，只需要在编译阶段做一下简单的字符串替换即可。实质上Java的单继承机制才是保证这一特性的根本，因为所有的对象都是Object的子类，容器里只要能够存放Object对象就行了。
+事实上，所有容器的内部存放的都是Object对象，泛型机制只是简化了编程，由编译器自动帮我们完成了强制类型转换而已。JDK 1.4以及之前版本不支持泛型，类型转换需要程序员显式完成。
+```java
+//JDK 1.4 or before
+ArrayList list = new ArrayList();
+list.add(new String("Monday"));
+list.add(new String("Tuesday"));
+list.add(new String("Wensday"));
+for(int i = 0; i < list.size(); i++){
+    String weekday = (String)list.get(i);//显式类型转换
+    System.out.println(weekday.toUpperCase());
+}
+```
+```java
+//JDK 1.5 or latter
+ArrayList<String> list = new ArrayList<String>();//参数化类型
+list.add(new String("Monday"));
+list.add(new String("Tuesday"));
+list.add(new String("Wensday"));
+for(int i = 0; i < list.size(); i++){
+    String weekday = list.get(i);//隐式类型转换，编译器自动完成
+    System.out.println(weekday.toUpperCase());
+}
+```
+
+## 内存管理
+
+跟C\++复杂的内存管理机制不同，Java GC自动包揽了一切，Java程序并不需要处理令人头疼的内存问题，因此JCF并不像C\++ STL那样需要专门的空间适配器（alloctor）。
+另外，由于Java里对象都在堆上，且对象只能通过引用（reference，跟C\++中的引用不是同一个概念，可以理解成经过包装后的指针）访问，容器里放的其实是对象的引用而不是对象本身，也就不存在C\++容器的复制拷贝问题。
+
+## 接口和实现（Interfaces and Implementations）
+### 接口
+为了规范容器的行为，统一设计，JCF定义了14种容器接口（collection interfaces），它们的关系如下图所示：
+![pic](../PNGFigures/JCF_Collection_Interfaces.png)
+*Map*接口没有继承自*Collection*接口，因为*Map*表示的是关联式容器而不是集合。但Java为我们提供了从*Map*转换到*Collection*的方法，可以方便的将*Map*切换到集合视图。
+上图中提供了*Queue*接口，却没有*Stack*，这是因为*Stack*的功能已被JDK 1.6引入的*Deque*取代。事实上*Stack*是*Vector*的子类，这两个类始于JDK 1.0，不属于JCF成员，所以不建议使用（用惯C++ vector的同学是不是有点不舍）。
+
+### 实现
+
+上述接口的通用实现见下表：
+<table align="center"><tr><td colspan="2" rowspan="2" align="center" border="0"></td><th colspan="5" align="center">Implementations</th></tr><tr><th>Hash Table</th><th>Resizable Array</th><th>Balanced Tree</th><th>Linked List</th><th>Hash Table + Linked List</th></tr><tr><th rowspan="4">Interfaces</th><th>Set</th><td><tt>HashSet</tt></td><td></td><td><tt>TreeSet</tt></td><td></td><td><tt>LinkedHashSet</tt></td></tr><tr><th>List</th><td></td><td><tt>ArrayList</tt></td><td></td><td><tt>LinkedList</tt></td><td></td></tr><tr><th>Deque</th><td></td><td><tt>ArrayDeque</tt></td><td></td><td><tt>LinkedList</tt></td><td></td></tr><tr><th>Map</th><td><tt>HashMap</tt></td><td></td><td><tt>TreeMap</tt></td><td></td><td><tt>LinkedHashMap</tt></td></tr></table>
+
+接下来的篇幅，会逐个介绍上表中容器的数据结构以及用到的算法。
+
+## 迭代器（Iterator）
+
+跟C++ STL一样，JCF的迭代器（Iterator）为我们提供了遍历容器中元素的方法。只有容器本身清楚容器里元素的组织方式，因此迭代器只能通过容器本身得到。每个容器都会通过内部类的形式实现自己的迭代器。相比STL的迭代器，JCF的迭代器更容易使用。
+
+```Java
+//visit a list with iterator
+ArrayList<String> list = new ArrayList<String>();
+list.add(new String("Monday"));
+list.add(new String("Tuesday"));
+list.add(new String("Wensday"));
+Iterator<String> it = list.iterator();//得到迭代器
+while(it.hasNext()){
+    String weekday = it.next();//访问元素
+    System.out.println(weekday.toUpperCase());
+}
+```
+JDK 1.5 引入了增强的for循环，简化了迭代容器时的写法。
+```Java
+//使用增强for迭代
+ArrayList<String> list = new ArrayList<String>();
+list.add(new String("Monday"));
+list.add(new String("Tuesday"));
+list.add(new String("Wensday"));
+for(String weekday : list){//enhanced for statement
+	System.out.println(weekday.toUpperCase());
+}
+```
+
+# 参考文献
+- [Collections Framework Overview](http://docs.oracle.com/javase/6/docs/technotes/guides/collections/overview.html)
+- [The For-Each Loop](http://docs.oracle.com/javase/1.5.0/docs/guide/language/foreach.html)
+
+
+
+
+
+