重构目录结构，增加源码目录

Author: diguage

.gitignore

@@ -1,2 +1,9 @@
 *.html
 *.pdf
+.classpath
+.project
+.settings/
+.vscode/
+target
+*.iml
+

README.adoc

@@ -1,50 +1,132 @@
-= JDK 源码分析
-
-为了督促小组成员学习，也为了他们更好地成长，“强制”安排给他们阅读 JDK 常用类的源代码。
-
-也欢迎感兴趣的小伙伴加入。或者提交PR。
-
-WARNING: 本文档基于 *JDK 1.8.0_112* 的代码开展分析，请 PR 的小伙伴使用相同的 JDK。谢谢！
-
-== 学习计划
-
-大概列了一下，该计划后续还会慢慢更新。
-
-===  集合类
-
-. `Collection`
-. `AbstractCollection`
-. `AbstractList`
-. `ArrayList`
-. `LinkedList`
-. `Map`
-. `AbstractMap`
-. `HashMap`
-. `LinkedHashMap`
-. `TreeMap`
-. `Queue`
-. `AbstractQueue`
-. `BlockingQueue`
-. `LinkedTransferQueue`
-. `SynchronousQueue`
-. `PriorityQueue`
-. `LinkedBlockingQueue`
-. `ArrayBlockingQueue`
-. `ConcurrentLinkedQueue`
-. `DelayQueue`
-. `Deque`
-. `BlockingDeque`
-. `LinkedBlockingDeque`
-. `ArrayDeque`
-. `ConcurrentLinkedDeque`
-
-=== 并发类
-
-. `AbstractQueuedSynchronizer`
-. `AbstractQueuedLongSynchronizer`
-
-== 参考书籍
-
-. https://book.douban.com/subject/26745780/[数据结构与算法分析]
-. https://book.douban.com/subject/10432347/[算法]
-. https://book.douban.com/subject/10484692/[Java并发编程实战]
+= JDK & STL 源码分析计划
+
+为了学好数据结构以及相关算法，同时也为了更好地理解 JDK 的底层实现，计划对 JDK 集合类的源码做一个系统的阅读分析。
+
+欢迎感兴趣的小伙伴提交 PR 或 Issue。
+
+WARNING: 本文档基于 *JDK 1.8.0_201* 的代码开展分析，请 PR 的小伙伴使用相同的 JDK。谢谢！
+
+== 总体思路
+
+. 学习基本的数据结构认识。兵马未动粮草先行。先把基础理论搞清楚。
+.. 学Java的，可以从下面两本书中选一本：
+... https://book.douban.com/subject/26745780/[数据结构与算法分析] -- 这本书的优点在于和 Java JDK 的集合类很贴近。
+... https://book.douban.com/subject/19952400/[算法（第4版）] -- 这本书胜在图很多。
+.. 学 C/C++ 的，可以看下面这套书：
+... https://book.douban.com/subject/4065258/[算法：C语言实现 (第1～4部分)]
+... https://book.douban.com/subject/4191525/[算法：C语言实现 （第5部分）]
+. 自己实现一遍基本的数据结构；
+. 阅读 JDK 或 STL 源码，做学习笔记。
++
+TIP: 对比一下自己的实现和这些经典代码的实现，总结自己差距，提高自己的编码能力。
++
+.. https://book.douban.com/subject/1110934/[STL源码剖析 ] -- 阅读源码时，建议参考一下本书的内容。
+.. 建议把网上的源码分析笔记都看一看，取长补短，补充自己的分析。
+.. 建议把网上相关面试题也看一看，检验自己的学习成果。
+. 相关联的 LeetCode 上的题都刷掉。
+
+[NOTE]
+====
+还有两个想法：
+
+. 可以把 Redis 的实现也过一下，Redis 实现也有很多不错的思路。毕竟 Redis 是目前最常用的缓存解决方案。
+. Java 中有很多针对集合类做扩展的库，可以一并学了，这样就能更清楚了解 Java JDK 实现的不足，开阔自己的眼界：
+.. https://github.com/google/guava[google/guava: Google core libraries for Java]
+.. https://commons.apache.org/proper/commons-collections/[Apache Commons Collections]
+.. https://www.eclipse.org/collections/[Eclipse Collections - Features you want with the collections you need.]
+====
+
+== JDK 集合类
+
+*Base*::
+代码总行数： 103 + 604 + 469 = 1176 行，预计 2 个小时。
+. `java.lang.Iterable`
+. `java.util.Collection`
+. `java.util.AbstractCollection`
+
+*List*::
+代码总行数： 734 + 781 + 253 + 1262 + 1456 + 141 + 1468 = 6095 行，预计 12 个小时。
+. `java.util.List`
+. `java.util.AbstractList`
+. `java.util.AbstractSequentialList`
+. `java.util.LinkedList`
+. `java.util.Vector`
+. `java.util.Stack`
+. `java.util.ArrayList`
+
+*Queue*::
+代码总行数： 218 + 584 + 192 + 992 + 907 = 2893 行，预计 6 个小时。
+. `java.util.Queue`
+. `java.util.Deque`
+. `java.util.AbstractQueue`
+. `java.util.ArrayDeque`
+. `java.util.PriorityQueue`
+
+*Set*::
+代码总行数： 413 + 186 + 264 + 464 + 319 + 361 + 560 + 195 + 1248 = 4010 行，预计 8 个小时。
+. `java.util.Set`
+. `java.util.AbstractSet`
+. `java.util.SortedSet`
+. `java.util.EnumSet`
+. `java.util.NavigableSet`
+. `java.util.HashSet`
+. `java.util.TreeSet`
+. `java.util.LinkedHashSet`
+. `java.util.BitSet`
+
+
+image::docs/java.util.Collection.png[]
+
+*Map*::
+代码总行数： 1183 + 284 + 424 + 860 + 3019 + 1339 + 812 + 1600 + 756 + 2397 + 155 + 1422 = 14251 行，预计 28 个小时。
+. `java.util.Map`
+. `java.util.SortedMap`
+. `java.util.NavigableMap`
+. `java.util.AbstractMap`
+. `java.util.TreeMap`
+. `java.util.WeakHashMap`
+. `java.util.EnumMap`
+. `java.util.IdentityHashMap`
+. `java.util.LinkedHashMap`
+. `java.util.HashMap`
+. `java.util.Dictionary`
+. `java.util.Hashtable`
+
+image::docs/java.util.Map.png[]
+
+*Iterator*::
+代码总行数： 118 + 302 + 195 = 615 行，预计 2 个小时。
+. `java.util.Iterator`
+. `java.util.PrimitiveIterator`
+. `java.util.ListIterator`
+
+来张总体结构图：
+
+image::docs/jdk-collection-classes.png[]
+
+TIP: 这里没有包含并发相关的集合类。这块内容放到并发中一起搞。
+
+== 目录结构介绍
+
+[source]
+----
+.
+├── LICENSE
+├── README.adoc
+├── pom.xml
+├── docs -- 这里存放阅读源码的文档。
+│   └── images -- 这里存放相关图片
+└── src
+    ├── main
+    │   └── java
+    │       └── com
+    │           └── diguage
+    │               └── truman
+    │                   └── App.java
+    └── test
+        └── java
+            └── com
+                └── diguage
+                    └── truman  -- 这个目录存放相关测试代码。
+                        └── AppTest.java
+----

AbstractQueuedSynchronizer.adoc renamed to docs/AbstractQueuedSynchronizer.adoc

@@ -0,0 +1,51 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0"
+         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0
+                      http://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <modelVersion>4.0.0</modelVersion>
+
+    <groupId>com.diguage</groupId>
+    <artifactId>truman</artifactId>
+    <version>0.0.1-SNAPSHOT</version>
+
+    <name>JDK Source Analysis</name>
+    <!--    <url>http://www.example.com</url>-->
+
+    <properties>
+        <jmh.version>1.21</jmh.version>
+        <junit.version>4.12</junit.version>
+        <assertj.version>3.13.2</assertj.version>
+
+        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
+        <maven.compiler.source>1.8</maven.compiler.source>
+        <maven.compiler.target>1.8</maven.compiler.target>
+    </properties>
+
+    <dependencies>
+        <dependency>
+            <groupId>org.openjdk.jmh</groupId>
+            <artifactId>jmh-core</artifactId>
+            <version>${jmh.version}</version>
+        </dependency>
+        <dependency>
+            <groupId>org.openjdk.jmh</groupId>
+            <artifactId>jmh-generator-annprocess</artifactId>
+            <version>${jmh.version}</version>
+        </dependency>
+
+        <dependency>
+            <groupId>junit</groupId>
+            <artifactId>junit</artifactId>
+            <version>${junit.version}</version>
+            <scope>test</scope>
+        </dependency>
+        <!-- https://mvnrepository.com/artifact/org.assertj/assertj-core -->
+        <dependency>
+            <groupId>org.assertj</groupId>
+            <artifactId>assertj-core</artifactId>
+            <version>${assertj.version}</version>
+            <scope>test</scope>
+        </dependency>
+    </dependencies>
+</project>

ArrayList.adoc renamed to docs/ArrayList.adoc

@@ -0,0 +1,13 @@
+package com.diguage.truman;
+
+/**
+ * Hello world!
+ *
+ */
+public class App 
+{
+    public static void main( String[] args )
+    {
+        System.out.println( "Hello World!" );
+    }
+}

ConcurrentHashMap.adoc renamed to docs/ConcurrentHashMap.adoc

@@ -0,0 +1,20 @@
+package com.diguage.truman;
+
+import static org.junit.Assert.assertTrue;
+
+import org.junit.Test;
+
+/**
+ * Unit test for simple App.
+ */
+public class AppTest 
+{
+    /**
+     * Rigorous Test :-)
+     */
+    @Test
+    public void shouldAnswerWithTrue()
+    {
+        assertTrue( true );
+    }
+}