From 1393330fbd028e867f3cfdbc58ffd20e577ff862 Mon Sep 17 00:00:00 2001
From: Tao <1042911716@qq.com>
Date: Sat, 30 Nov 2019 11:42:05 +0800
Subject: [PATCH 001/122] =?UTF-8?q?=E5=A4=84=E7=90=86group=E5=B5=8C?=
 =?UTF-8?q?=E5=A5=97=E9=97=AE=E9=A2=98?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

r1 := r.Group("/v1")
_  = r1.Group("/v2")
---
 day4-group/gee/gee.go | 10 +++++++++-
 1 file changed, 9 insertions(+), 1 deletion(-)

diff --git a/day4-group/gee/gee.go b/day4-group/gee/gee.go
index 8c5d374..0d7a5ba 100644
--- a/day4-group/gee/gee.go
+++ b/day4-group/gee/gee.go
@@ -45,7 +45,7 @@ func (group *RouterGroup) Group(prefix string) *RouterGroup {
 }
 
 func (group *RouterGroup) addRoute(method string, comp string, handler HandlerFunc) {
-	pattern := group.prefix + comp
+	pattern := getNestPrefix(group.parent, group.prefix) + comp
 	group.engine.router.addRoute(method, pattern, handler)
 }
 
@@ -68,3 +68,11 @@ func (engine *Engine) ServeHTTP(w http.ResponseWriter, req *http.Request) {
 	c := newContext(w, req)
 	engine.router.handle(c)
 }
+
+func getNestPrefix(group *RouterGroup, p string) string {
+	p = strings.Join([]string{group.prefix, p}, "")
+	if group.parent == nil {
+		return p
+	}
+	return getNestPrefix(group.parent, p)
+}

From 04012562ce4a8be9157fa0e0b73fb56169df87fa Mon Sep 17 00:00:00 2001
From: Tao <1042911716@qq.com>
Date: Sat, 30 Nov 2019 11:51:05 +0800
Subject: [PATCH 002/122] add test func

---
 day4-group/gee/router_test.go | 38 ++++++++++++++++++++++++++++++-----
 1 file changed, 33 insertions(+), 5 deletions(-)

diff --git a/day4-group/gee/router_test.go b/day4-group/gee/router_test.go
index f5d6da3..a4a6611 100644
--- a/day4-group/gee/router_test.go
+++ b/day4-group/gee/router_test.go
@@ -17,11 +17,20 @@ func newTestRouter() *router {
 }
 
 func TestParsePattern(t *testing.T) {
-	ok := reflect.DeepEqual(parsePattern("/p/:name"), []string{"p", ":name"})
-	ok = ok && reflect.DeepEqual(parsePattern("/p/*"), []string{"p", "*"})
-	ok = ok && reflect.DeepEqual(parsePattern("/p/*name/*"), []string{"p", "*name"})
-	if !ok {
-		t.Fatal("test parsePattern failed")
+	testCases := [][]string{
+		parsePattern("/p/:name"),
+		parsePattern("/p/*"),
+		parsePattern("/p/*name/*"),
+	}
+	wants := [][]string{
+		[]string{"p", ":name"},
+		[]string{"p", "*"},
+		[]string{"p", "*name"},
+	}
+	for index, result := range testCases {
+		if reflect.DeepEqual(result, wants[index]) {
+			t.Fatal("test parsePattern failed")
+		}
 	}
 }
 
@@ -72,3 +81,22 @@ func TestGetRoutes(t *testing.T) {
 		t.Fatal("the number of routes shoule be 4")
 	}
 }
+
+func TestNestingGroup(t *testing.T) {
+	r := &RouterGroup{
+		prefix:      "/v1",
+		middleWares: nil,
+		engine:      nil,
+		parent:      nil,
+	}
+	r2 := &RouterGroup{
+		prefix:      "/v2",
+		middleWares: nil,
+		engine:      nil,
+		parent:      r,
+	}
+	res := getNestPrefix(r2, "/hello")
+	if res != "/v1/v2/hello" {
+		t.Fatal("match failed")
+	}
+}

From 4db622e2355e36814e963777da2e90a272e9ae85 Mon Sep 17 00:00:00 2001
From: gzdaijie <gzdaijie@163.com>
Date: Thu, 9 Jan 2020 00:27:57 +0800
Subject: [PATCH 003/122] support group prefix nesting and add Group unit tests

---
 day1-http-base/base3/gee/gee.go    |  2 ++
 day2-context/gee/gee.go            |  2 ++
 day3-router/gee/gee.go             |  2 ++
 day4-group/gee/gee.go              | 23 ++++++++++--------
 day4-group/gee/gee_test.go         | 32 +++++++++++++++++++++++++
 day4-group/gee/router_test.go      | 38 ++++--------------------------
 day5-middleware/gee/gee.go         | 16 ++++++++++---
 day5-middleware/gee/gee_test.go    | 32 +++++++++++++++++++++++++
 day6-template/gee/gee.go           | 16 ++++++++++---
 day6-template/gee/gee_test.go      | 32 +++++++++++++++++++++++++
 day7-panic-recover/gee/gee.go      | 16 ++++++++++---
 day7-panic-recover/gee/gee_test.go | 32 +++++++++++++++++++++++++
 12 files changed, 191 insertions(+), 52 deletions(-)
 create mode 100644 day4-group/gee/gee_test.go
 create mode 100644 day5-middleware/gee/gee_test.go
 create mode 100644 day6-template/gee/gee_test.go
 create mode 100644 day7-panic-recover/gee/gee_test.go

diff --git a/day1-http-base/base3/gee/gee.go b/day1-http-base/base3/gee/gee.go
index 8c38b4c..3aefd75 100644
--- a/day1-http-base/base3/gee/gee.go
+++ b/day1-http-base/base3/gee/gee.go
@@ -2,6 +2,7 @@ package gee
 
 import (
 	"fmt"
+	"log"
 	"net/http"
 )
 
@@ -20,6 +21,7 @@ func New() *Engine {
 
 func (engine *Engine) addRoute(method string, pattern string, handler HandlerFunc) {
 	key := method + "-" + pattern
+	log.Printf("Route %4s - %s", method, pattern)
 	engine.router[key] = handler
 }
 
diff --git a/day2-context/gee/gee.go b/day2-context/gee/gee.go
index ce0d4da..802bb5e 100644
--- a/day2-context/gee/gee.go
+++ b/day2-context/gee/gee.go
@@ -1,6 +1,7 @@
 package gee
 
 import (
+	"log"
 	"net/http"
 )
 
@@ -18,6 +19,7 @@ func New() *Engine {
 }
 
 func (engine *Engine) addRoute(method string, pattern string, handler HandlerFunc) {
+	log.Printf("Route %4s - %s", method, pattern)
 	engine.router.addRoute(method, pattern, handler)
 }
 
diff --git a/day3-router/gee/gee.go b/day3-router/gee/gee.go
index ce0d4da..802bb5e 100644
--- a/day3-router/gee/gee.go
+++ b/day3-router/gee/gee.go
@@ -1,6 +1,7 @@
 package gee
 
 import (
+	"log"
 	"net/http"
 )
 
@@ -18,6 +19,7 @@ func New() *Engine {
 }
 
 func (engine *Engine) addRoute(method string, pattern string, handler HandlerFunc) {
+	log.Printf("Route %4s - %s", method, pattern)
 	engine.router.addRoute(method, pattern, handler)
 }
 
diff --git a/day4-group/gee/gee.go b/day4-group/gee/gee.go
index 0d7a5ba..604e5be 100644
--- a/day4-group/gee/gee.go
+++ b/day4-group/gee/gee.go
@@ -1,6 +1,7 @@
 package gee
 
 import (
+	"log"
 	"net/http"
 )
 
@@ -36,7 +37,7 @@ func New() *Engine {
 func (group *RouterGroup) Group(prefix string) *RouterGroup {
 	engine := group.engine
 	newGroup := &RouterGroup{
-		prefix: group.prefix + prefix,
+		prefix: prefix,
 		parent: group,
 		engine: engine,
 	}
@@ -45,10 +46,20 @@ func (group *RouterGroup) Group(prefix string) *RouterGroup {
 }
 
 func (group *RouterGroup) addRoute(method string, comp string, handler HandlerFunc) {
-	pattern := getNestPrefix(group.parent, group.prefix) + comp
+	pattern := group.getNestPrefix() + comp
+	log.Printf("Route %4s - %s", method, pattern)
 	group.engine.router.addRoute(method, pattern, handler)
 }
 
+// Support group nesting
+func (group *RouterGroup) getNestPrefix() string {
+	p := group.prefix
+	if group.parent == nil {
+		return p
+	}
+	return group.parent.getNestPrefix() + p
+}
+
 // GET defines the method to add GET request
 func (group *RouterGroup) GET(pattern string, handler HandlerFunc) {
 	group.addRoute("GET", pattern, handler)
@@ -68,11 +79,3 @@ func (engine *Engine) ServeHTTP(w http.ResponseWriter, req *http.Request) {
 	c := newContext(w, req)
 	engine.router.handle(c)
 }
-
-func getNestPrefix(group *RouterGroup, p string) string {
-	p = strings.Join([]string{group.prefix, p}, "")
-	if group.parent == nil {
-		return p
-	}
-	return getNestPrefix(group.parent, p)
-}
diff --git a/day4-group/gee/gee_test.go b/day4-group/gee/gee_test.go
new file mode 100644
index 0000000..8c03dc1
--- /dev/null
+++ b/day4-group/gee/gee_test.go
@@ -0,0 +1,32 @@
+package gee
+
+import "testing"
+
+func TestNestingGroup(t *testing.T) {
+	v1 := &RouterGroup{
+		prefix: "/v1",
+	}
+	v2 := &RouterGroup{
+		prefix: "/v2",
+		parent: v1,
+	}
+	v3 := &RouterGroup{
+		prefix: "/v3",
+		parent: v2,
+	}
+	if v2.getNestPrefix() != "/v1/v2" {
+		t.Fatal("v2 prefix should be /v1/v2")
+	}
+	if v3.getNestPrefix() != "/v1/v2/v3" {
+		t.Fatal("v3 prefix should be /v1/v2/v3")
+	}
+}
+
+func TestGroup(t *testing.T) {
+	r := New()
+	v1 := r.Group("/v1")
+	v2 := v1.Group("/v2")
+	if v2.getNestPrefix() != "/v1/v2" {
+		t.Fatal("v2 prefix should be /v1/v2")
+	}
+}
diff --git a/day4-group/gee/router_test.go b/day4-group/gee/router_test.go
index a4a6611..f5d6da3 100644
--- a/day4-group/gee/router_test.go
+++ b/day4-group/gee/router_test.go
@@ -17,20 +17,11 @@ func newTestRouter() *router {
 }
 
 func TestParsePattern(t *testing.T) {
-	testCases := [][]string{
-		parsePattern("/p/:name"),
-		parsePattern("/p/*"),
-		parsePattern("/p/*name/*"),
-	}
-	wants := [][]string{
-		[]string{"p", ":name"},
-		[]string{"p", "*"},
-		[]string{"p", "*name"},
-	}
-	for index, result := range testCases {
-		if reflect.DeepEqual(result, wants[index]) {
-			t.Fatal("test parsePattern failed")
-		}
+	ok := reflect.DeepEqual(parsePattern("/p/:name"), []string{"p", ":name"})
+	ok = ok && reflect.DeepEqual(parsePattern("/p/*"), []string{"p", "*"})
+	ok = ok && reflect.DeepEqual(parsePattern("/p/*name/*"), []string{"p", "*name"})
+	if !ok {
+		t.Fatal("test parsePattern failed")
 	}
 }
 
@@ -81,22 +72,3 @@ func TestGetRoutes(t *testing.T) {
 		t.Fatal("the number of routes shoule be 4")
 	}
 }
-
-func TestNestingGroup(t *testing.T) {
-	r := &RouterGroup{
-		prefix:      "/v1",
-		middleWares: nil,
-		engine:      nil,
-		parent:      nil,
-	}
-	r2 := &RouterGroup{
-		prefix:      "/v2",
-		middleWares: nil,
-		engine:      nil,
-		parent:      r,
-	}
-	res := getNestPrefix(r2, "/hello")
-	if res != "/v1/v2/hello" {
-		t.Fatal("match failed")
-	}
-}
diff --git a/day5-middleware/gee/gee.go b/day5-middleware/gee/gee.go
index e880d19..7ea237b 100644
--- a/day5-middleware/gee/gee.go
+++ b/day5-middleware/gee/gee.go
@@ -1,6 +1,7 @@
 package gee
 
 import (
+	"log"
 	"net/http"
 	"strings"
 )
@@ -37,7 +38,7 @@ func New() *Engine {
 func (group *RouterGroup) Group(prefix string) *RouterGroup {
 	engine := group.engine
 	newGroup := &RouterGroup{
-		prefix: group.prefix + prefix,
+		prefix: prefix,
 		parent: group,
 		engine: engine,
 	}
@@ -51,11 +52,20 @@ func (group *RouterGroup) Use(middlewares ...HandlerFunc) {
 }
 
 func (group *RouterGroup) addRoute(method string, comp string, handler HandlerFunc) {
-	pattern := group.prefix + comp
-
+	pattern := group.getNestPrefix() + comp
+	log.Printf("Route %4s - %s", method, pattern)
 	group.engine.router.addRoute(method, pattern, handler)
 }
 
+// Support group nesting
+func (group *RouterGroup) getNestPrefix() string {
+	p := group.prefix
+	if group.parent == nil {
+		return p
+	}
+	return group.parent.getNestPrefix() + p
+}
+
 // GET defines the method to add GET request
 func (group *RouterGroup) GET(pattern string, handler HandlerFunc) {
 	group.addRoute("GET", pattern, handler)
diff --git a/day5-middleware/gee/gee_test.go b/day5-middleware/gee/gee_test.go
new file mode 100644
index 0000000..8c03dc1
--- /dev/null
+++ b/day5-middleware/gee/gee_test.go
@@ -0,0 +1,32 @@
+package gee
+
+import "testing"
+
+func TestNestingGroup(t *testing.T) {
+	v1 := &RouterGroup{
+		prefix: "/v1",
+	}
+	v2 := &RouterGroup{
+		prefix: "/v2",
+		parent: v1,
+	}
+	v3 := &RouterGroup{
+		prefix: "/v3",
+		parent: v2,
+	}
+	if v2.getNestPrefix() != "/v1/v2" {
+		t.Fatal("v2 prefix should be /v1/v2")
+	}
+	if v3.getNestPrefix() != "/v1/v2/v3" {
+		t.Fatal("v3 prefix should be /v1/v2/v3")
+	}
+}
+
+func TestGroup(t *testing.T) {
+	r := New()
+	v1 := r.Group("/v1")
+	v2 := v1.Group("/v2")
+	if v2.getNestPrefix() != "/v1/v2" {
+		t.Fatal("v2 prefix should be /v1/v2")
+	}
+}
diff --git a/day6-template/gee/gee.go b/day6-template/gee/gee.go
index 357f6e9..6a56722 100644
--- a/day6-template/gee/gee.go
+++ b/day6-template/gee/gee.go
@@ -2,6 +2,7 @@ package gee
 
 import (
 	"html/template"
+	"log"
 	"net/http"
 	"path"
 	"strings"
@@ -41,7 +42,7 @@ func New() *Engine {
 func (group *RouterGroup) Group(prefix string) *RouterGroup {
 	engine := group.engine
 	newGroup := &RouterGroup{
-		prefix: group.prefix + prefix,
+		prefix: prefix,
 		parent: group,
 		engine: engine,
 	}
@@ -55,11 +56,20 @@ func (group *RouterGroup) Use(middlewares ...HandlerFunc) {
 }
 
 func (group *RouterGroup) addRoute(method string, comp string, handler HandlerFunc) {
-	pattern := group.prefix + comp
-
+	pattern := group.getNestPrefix() + comp
+	log.Printf("Route %4s - %s", method, pattern)
 	group.engine.router.addRoute(method, pattern, handler)
 }
 
+// Support group nesting
+func (group *RouterGroup) getNestPrefix() string {
+	p := group.prefix
+	if group.parent == nil {
+		return p
+	}
+	return group.parent.getNestPrefix() + p
+}
+
 // GET defines the method to add GET request
 func (group *RouterGroup) GET(pattern string, handler HandlerFunc) {
 	group.addRoute("GET", pattern, handler)
diff --git a/day6-template/gee/gee_test.go b/day6-template/gee/gee_test.go
new file mode 100644
index 0000000..8c03dc1
--- /dev/null
+++ b/day6-template/gee/gee_test.go
@@ -0,0 +1,32 @@
+package gee
+
+import "testing"
+
+func TestNestingGroup(t *testing.T) {
+	v1 := &RouterGroup{
+		prefix: "/v1",
+	}
+	v2 := &RouterGroup{
+		prefix: "/v2",
+		parent: v1,
+	}
+	v3 := &RouterGroup{
+		prefix: "/v3",
+		parent: v2,
+	}
+	if v2.getNestPrefix() != "/v1/v2" {
+		t.Fatal("v2 prefix should be /v1/v2")
+	}
+	if v3.getNestPrefix() != "/v1/v2/v3" {
+		t.Fatal("v3 prefix should be /v1/v2/v3")
+	}
+}
+
+func TestGroup(t *testing.T) {
+	r := New()
+	v1 := r.Group("/v1")
+	v2 := v1.Group("/v2")
+	if v2.getNestPrefix() != "/v1/v2" {
+		t.Fatal("v2 prefix should be /v1/v2")
+	}
+}
diff --git a/day7-panic-recover/gee/gee.go b/day7-panic-recover/gee/gee.go
index 9eeb356..4dde8de 100644
--- a/day7-panic-recover/gee/gee.go
+++ b/day7-panic-recover/gee/gee.go
@@ -2,6 +2,7 @@ package gee
 
 import (
 	"html/template"
+	"log"
 	"net/http"
 	"path"
 	"strings"
@@ -48,7 +49,7 @@ func Default() *Engine {
 func (group *RouterGroup) Group(prefix string) *RouterGroup {
 	engine := group.engine
 	newGroup := &RouterGroup{
-		prefix: group.prefix + prefix,
+		prefix: prefix,
 		parent: group,
 		engine: engine,
 	}
@@ -62,11 +63,20 @@ func (group *RouterGroup) Use(middlewares ...HandlerFunc) {
 }
 
 func (group *RouterGroup) addRoute(method string, comp string, handler HandlerFunc) {
-	pattern := group.prefix + comp
-
+	pattern := group.getNestPrefix() + comp
+	log.Printf("Route %4s - %s", method, pattern)
 	group.engine.router.addRoute(method, pattern, handler)
 }
 
+// Support group nesting
+func (group *RouterGroup) getNestPrefix() string {
+	p := group.prefix
+	if group.parent == nil {
+		return p
+	}
+	return group.parent.getNestPrefix() + p
+}
+
 // GET defines the method to add GET request
 func (group *RouterGroup) GET(pattern string, handler HandlerFunc) {
 	group.addRoute("GET", pattern, handler)
diff --git a/day7-panic-recover/gee/gee_test.go b/day7-panic-recover/gee/gee_test.go
new file mode 100644
index 0000000..8c03dc1
--- /dev/null
+++ b/day7-panic-recover/gee/gee_test.go
@@ -0,0 +1,32 @@
+package gee
+
+import "testing"
+
+func TestNestingGroup(t *testing.T) {
+	v1 := &RouterGroup{
+		prefix: "/v1",
+	}
+	v2 := &RouterGroup{
+		prefix: "/v2",
+		parent: v1,
+	}
+	v3 := &RouterGroup{
+		prefix: "/v3",
+		parent: v2,
+	}
+	if v2.getNestPrefix() != "/v1/v2" {
+		t.Fatal("v2 prefix should be /v1/v2")
+	}
+	if v3.getNestPrefix() != "/v1/v2/v3" {
+		t.Fatal("v3 prefix should be /v1/v2/v3")
+	}
+}
+
+func TestGroup(t *testing.T) {
+	r := New()
+	v1 := r.Group("/v1")
+	v2 := v1.Group("/v2")
+	if v2.getNestPrefix() != "/v1/v2" {
+		t.Fatal("v2 prefix should be /v1/v2")
+	}
+}

From 64703edcc1e2af90693001fa69dcb33e8eb1ba4f Mon Sep 17 00:00:00 2001
From: gzdaijie <gzdaijie@163.com>
Date: Thu, 9 Jan 2020 00:38:50 +0800
Subject: [PATCH 004/122] support group nesting

---
 day4-group/gee/gee.go              | 13 ++-----------
 day4-group/gee/gee_test.go         | 28 ++++++----------------------
 day5-middleware/gee/gee.go         | 13 ++-----------
 day5-middleware/gee/gee_test.go    | 28 ++++++----------------------
 day6-template/gee/gee.go           | 13 ++-----------
 day6-template/gee/gee_test.go      | 28 ++++++----------------------
 day7-panic-recover/gee/gee.go      | 13 ++-----------
 day7-panic-recover/gee/gee_test.go | 28 ++++++----------------------
 8 files changed, 32 insertions(+), 132 deletions(-)

diff --git a/day4-group/gee/gee.go b/day4-group/gee/gee.go
index 604e5be..1e5cda3 100644
--- a/day4-group/gee/gee.go
+++ b/day4-group/gee/gee.go
@@ -37,7 +37,7 @@ func New() *Engine {
 func (group *RouterGroup) Group(prefix string) *RouterGroup {
 	engine := group.engine
 	newGroup := &RouterGroup{
-		prefix: prefix,
+		prefix: group.prefix + prefix,
 		parent: group,
 		engine: engine,
 	}
@@ -46,20 +46,11 @@ func (group *RouterGroup) Group(prefix string) *RouterGroup {
 }
 
 func (group *RouterGroup) addRoute(method string, comp string, handler HandlerFunc) {
-	pattern := group.getNestPrefix() + comp
+	pattern := group.prefix + comp
 	log.Printf("Route %4s - %s", method, pattern)
 	group.engine.router.addRoute(method, pattern, handler)
 }
 
-// Support group nesting
-func (group *RouterGroup) getNestPrefix() string {
-	p := group.prefix
-	if group.parent == nil {
-		return p
-	}
-	return group.parent.getNestPrefix() + p
-}
-
 // GET defines the method to add GET request
 func (group *RouterGroup) GET(pattern string, handler HandlerFunc) {
 	group.addRoute("GET", pattern, handler)
diff --git a/day4-group/gee/gee_test.go b/day4-group/gee/gee_test.go
index 8c03dc1..f0c9577 100644
--- a/day4-group/gee/gee_test.go
+++ b/day4-group/gee/gee_test.go
@@ -2,31 +2,15 @@ package gee
 
 import "testing"
 
-func TestNestingGroup(t *testing.T) {
-	v1 := &RouterGroup{
-		prefix: "/v1",
-	}
-	v2 := &RouterGroup{
-		prefix: "/v2",
-		parent: v1,
-	}
-	v3 := &RouterGroup{
-		prefix: "/v3",
-		parent: v2,
-	}
-	if v2.getNestPrefix() != "/v1/v2" {
-		t.Fatal("v2 prefix should be /v1/v2")
-	}
-	if v3.getNestPrefix() != "/v1/v2/v3" {
-		t.Fatal("v3 prefix should be /v1/v2/v3")
-	}
-}
-
-func TestGroup(t *testing.T) {
+func TestNestedGroup(t *testing.T) {
 	r := New()
 	v1 := r.Group("/v1")
 	v2 := v1.Group("/v2")
-	if v2.getNestPrefix() != "/v1/v2" {
+	v3 := v2.Group("/v3")
+	if v2.prefix != "/v1/v2" {
+		t.Fatal("v2 prefix should be /v1/v2")
+	}
+	if v3.prefix != "/v1/v2/v3" {
 		t.Fatal("v2 prefix should be /v1/v2")
 	}
 }
diff --git a/day5-middleware/gee/gee.go b/day5-middleware/gee/gee.go
index 7ea237b..5c237c1 100644
--- a/day5-middleware/gee/gee.go
+++ b/day5-middleware/gee/gee.go
@@ -38,7 +38,7 @@ func New() *Engine {
 func (group *RouterGroup) Group(prefix string) *RouterGroup {
 	engine := group.engine
 	newGroup := &RouterGroup{
-		prefix: prefix,
+		prefix: group.prefix + prefix,
 		parent: group,
 		engine: engine,
 	}
@@ -52,20 +52,11 @@ func (group *RouterGroup) Use(middlewares ...HandlerFunc) {
 }
 
 func (group *RouterGroup) addRoute(method string, comp string, handler HandlerFunc) {
-	pattern := group.getNestPrefix() + comp
+	pattern := group.prefix + comp
 	log.Printf("Route %4s - %s", method, pattern)
 	group.engine.router.addRoute(method, pattern, handler)
 }
 
-// Support group nesting
-func (group *RouterGroup) getNestPrefix() string {
-	p := group.prefix
-	if group.parent == nil {
-		return p
-	}
-	return group.parent.getNestPrefix() + p
-}
-
 // GET defines the method to add GET request
 func (group *RouterGroup) GET(pattern string, handler HandlerFunc) {
 	group.addRoute("GET", pattern, handler)
diff --git a/day5-middleware/gee/gee_test.go b/day5-middleware/gee/gee_test.go
index 8c03dc1..f0c9577 100644
--- a/day5-middleware/gee/gee_test.go
+++ b/day5-middleware/gee/gee_test.go
@@ -2,31 +2,15 @@ package gee
 
 import "testing"
 
-func TestNestingGroup(t *testing.T) {
-	v1 := &RouterGroup{
-		prefix: "/v1",
-	}
-	v2 := &RouterGroup{
-		prefix: "/v2",
-		parent: v1,
-	}
-	v3 := &RouterGroup{
-		prefix: "/v3",
-		parent: v2,
-	}
-	if v2.getNestPrefix() != "/v1/v2" {
-		t.Fatal("v2 prefix should be /v1/v2")
-	}
-	if v3.getNestPrefix() != "/v1/v2/v3" {
-		t.Fatal("v3 prefix should be /v1/v2/v3")
-	}
-}
-
-func TestGroup(t *testing.T) {
+func TestNestedGroup(t *testing.T) {
 	r := New()
 	v1 := r.Group("/v1")
 	v2 := v1.Group("/v2")
-	if v2.getNestPrefix() != "/v1/v2" {
+	v3 := v2.Group("/v3")
+	if v2.prefix != "/v1/v2" {
+		t.Fatal("v2 prefix should be /v1/v2")
+	}
+	if v3.prefix != "/v1/v2/v3" {
 		t.Fatal("v2 prefix should be /v1/v2")
 	}
 }
diff --git a/day6-template/gee/gee.go b/day6-template/gee/gee.go
index 6a56722..d09404c 100644
--- a/day6-template/gee/gee.go
+++ b/day6-template/gee/gee.go
@@ -42,7 +42,7 @@ func New() *Engine {
 func (group *RouterGroup) Group(prefix string) *RouterGroup {
 	engine := group.engine
 	newGroup := &RouterGroup{
-		prefix: prefix,
+		prefix: group.prefix + prefix,
 		parent: group,
 		engine: engine,
 	}
@@ -56,20 +56,11 @@ func (group *RouterGroup) Use(middlewares ...HandlerFunc) {
 }
 
 func (group *RouterGroup) addRoute(method string, comp string, handler HandlerFunc) {
-	pattern := group.getNestPrefix() + comp
+	pattern := group.prefix + comp
 	log.Printf("Route %4s - %s", method, pattern)
 	group.engine.router.addRoute(method, pattern, handler)
 }
 
-// Support group nesting
-func (group *RouterGroup) getNestPrefix() string {
-	p := group.prefix
-	if group.parent == nil {
-		return p
-	}
-	return group.parent.getNestPrefix() + p
-}
-
 // GET defines the method to add GET request
 func (group *RouterGroup) GET(pattern string, handler HandlerFunc) {
 	group.addRoute("GET", pattern, handler)
diff --git a/day6-template/gee/gee_test.go b/day6-template/gee/gee_test.go
index 8c03dc1..f0c9577 100644
--- a/day6-template/gee/gee_test.go
+++ b/day6-template/gee/gee_test.go
@@ -2,31 +2,15 @@ package gee
 
 import "testing"
 
-func TestNestingGroup(t *testing.T) {
-	v1 := &RouterGroup{
-		prefix: "/v1",
-	}
-	v2 := &RouterGroup{
-		prefix: "/v2",
-		parent: v1,
-	}
-	v3 := &RouterGroup{
-		prefix: "/v3",
-		parent: v2,
-	}
-	if v2.getNestPrefix() != "/v1/v2" {
-		t.Fatal("v2 prefix should be /v1/v2")
-	}
-	if v3.getNestPrefix() != "/v1/v2/v3" {
-		t.Fatal("v3 prefix should be /v1/v2/v3")
-	}
-}
-
-func TestGroup(t *testing.T) {
+func TestNestedGroup(t *testing.T) {
 	r := New()
 	v1 := r.Group("/v1")
 	v2 := v1.Group("/v2")
-	if v2.getNestPrefix() != "/v1/v2" {
+	v3 := v2.Group("/v3")
+	if v2.prefix != "/v1/v2" {
+		t.Fatal("v2 prefix should be /v1/v2")
+	}
+	if v3.prefix != "/v1/v2/v3" {
 		t.Fatal("v2 prefix should be /v1/v2")
 	}
 }
diff --git a/day7-panic-recover/gee/gee.go b/day7-panic-recover/gee/gee.go
index 4dde8de..f0dd8fd 100644
--- a/day7-panic-recover/gee/gee.go
+++ b/day7-panic-recover/gee/gee.go
@@ -49,7 +49,7 @@ func Default() *Engine {
 func (group *RouterGroup) Group(prefix string) *RouterGroup {
 	engine := group.engine
 	newGroup := &RouterGroup{
-		prefix: prefix,
+		prefix: group.prefix + prefix,
 		parent: group,
 		engine: engine,
 	}
@@ -63,20 +63,11 @@ func (group *RouterGroup) Use(middlewares ...HandlerFunc) {
 }
 
 func (group *RouterGroup) addRoute(method string, comp string, handler HandlerFunc) {
-	pattern := group.getNestPrefix() + comp
+	pattern := group.prefix + comp
 	log.Printf("Route %4s - %s", method, pattern)
 	group.engine.router.addRoute(method, pattern, handler)
 }
 
-// Support group nesting
-func (group *RouterGroup) getNestPrefix() string {
-	p := group.prefix
-	if group.parent == nil {
-		return p
-	}
-	return group.parent.getNestPrefix() + p
-}
-
 // GET defines the method to add GET request
 func (group *RouterGroup) GET(pattern string, handler HandlerFunc) {
 	group.addRoute("GET", pattern, handler)
diff --git a/day7-panic-recover/gee/gee_test.go b/day7-panic-recover/gee/gee_test.go
index 8c03dc1..f0c9577 100644
--- a/day7-panic-recover/gee/gee_test.go
+++ b/day7-panic-recover/gee/gee_test.go
@@ -2,31 +2,15 @@ package gee
 
 import "testing"
 
-func TestNestingGroup(t *testing.T) {
-	v1 := &RouterGroup{
-		prefix: "/v1",
-	}
-	v2 := &RouterGroup{
-		prefix: "/v2",
-		parent: v1,
-	}
-	v3 := &RouterGroup{
-		prefix: "/v3",
-		parent: v2,
-	}
-	if v2.getNestPrefix() != "/v1/v2" {
-		t.Fatal("v2 prefix should be /v1/v2")
-	}
-	if v3.getNestPrefix() != "/v1/v2/v3" {
-		t.Fatal("v3 prefix should be /v1/v2/v3")
-	}
-}
-
-func TestGroup(t *testing.T) {
+func TestNestedGroup(t *testing.T) {
 	r := New()
 	v1 := r.Group("/v1")
 	v2 := v1.Group("/v2")
-	if v2.getNestPrefix() != "/v1/v2" {
+	v3 := v2.Group("/v3")
+	if v2.prefix != "/v1/v2" {
+		t.Fatal("v2 prefix should be /v1/v2")
+	}
+	if v3.prefix != "/v1/v2/v3" {
 		t.Fatal("v2 prefix should be /v1/v2")
 	}
 }

From 0c492207eb6e7382e30890e96e076abd49532615 Mon Sep 17 00:00:00 2001
From: gzdaijie <gzdaijie@163.com>
Date: Thu, 9 Jan 2020 01:04:24 +0800
Subject: [PATCH 005/122] add day7 doc

---
 README.md                  |   2 +-
 day7-panic-recover/main.go |  37 +++--
 doc/gee-day2.md            |   1 +
 doc/gee-day4.md            |   1 +
 doc/gee-day7.md            | 289 +++++++++++++++++++++++++++++++++++++
 doc/gee-day7/go-panic.png  | Bin 0 -> 3861 bytes
 doc/gee.md                 |   2 +-
 7 files changed, 314 insertions(+), 18 deletions(-)
 create mode 100644 doc/gee-day7.md
 create mode 100644 doc/gee-day7/go-panic.png

diff --git a/README.md b/README.md
index 5dee09d..93e00b2 100644
--- a/README.md
+++ b/README.md
@@ -12,7 +12,7 @@ Gee 的设计与实现参考了Gin，这个教程可以快速入门：[Go Gin简
 - [第四天：分组控制(Group)](https://geektutu.com/post/gee-day4.html)，[Code - Github](day4-group)
 - [第五天：中间件(Middleware)](https://geektutu.com/post/gee-day5.html)，[Code - Github](day5-middleware)
 - [第六天：HTML模板(Template)](https://geektutu.com/post/gee-day6.html)，[Code - Github](day6-template)
-- 第七天：错误恢复(Panic Recover)，[Code - Github](day7-panic-recover)
+- [第七天：错误恢复(Panic Recover)](https://geektutu.com/post/gee-day7.html)，[Code - Github](day7-panic-recover)
 
 
 ## Day 1 - Static Route
diff --git a/day7-panic-recover/main.go b/day7-panic-recover/main.go
index 5021aa6..0444ea8 100644
--- a/day7-panic-recover/main.go
+++ b/day7-panic-recover/main.go
@@ -5,26 +5,31 @@ $ curl "http://localhost:9999"
 Hello Geektutu
 $ curl "http://localhost:9999/panic"
 {"message":"Internal Server Error"}
+$ curl "http://localhost:9999"
+Hello Geektutu
 
 >>> log
-2019/08/18 17:55:57 [200] / in 4.533µs
-2019/08/18 17:55:58 runtime error: index out of range
+2020/01/09 01:00:10 Route  GET - /
+2020/01/09 01:00:10 Route  GET - /panic
+2020/01/09 01:00:22 [200] / in 25.364µs
+2020/01/09 01:00:32 runtime error: index out of range
 Traceback:
-	/usr/local/Cellar/go/1.12.5/libexec/src/runtime/panic.go:523
-	/usr/local/Cellar/go/1.12.5/libexec/src/runtime/panic.go:44
-	/Users/geektutu/7days-golang/day7-panic-recover/main.go:20
-	/Users/geektutu/7days-golang/day7-panic-recover/gee/context.go:41
-	/Users/geektutu/7days-golang/day7-panic-recover/gee/recovery.go:37
-	/Users/geektutu/7days-golang/day7-panic-recover/gee/context.go:41
-	/Users/geektutu/7days-golang/day7-panic-recover/gee/logger.go:15
-	/Users/geektutu/7days-golang/day7-panic-recover/gee/context.go:41
-	/Users/geektutu/7days-golang/day7-panic-recover/gee/router.go:99
-	/Users/geektutu/7days-golang/day7-panic-recover/gee/gee.go:129
-	/usr/local/Cellar/go/1.12.5/libexec/src/net/http/server.go:2775
-	/usr/local/Cellar/go/1.12.5/libexec/src/net/http/server.go:1879
-	/usr/local/Cellar/go/1.12.5/libexec/src/runtime/asm_amd64.s:1338
+        /usr/local/Cellar/go/1.12.5/libexec/src/runtime/panic.go:523
+        /usr/local/Cellar/go/1.12.5/libexec/src/runtime/panic.go:44
+        /Users/gzdaijie/Github/blog/geektutu-blog/posts/7days-golang/day7-panic-recover/main.go:47
+        /Users/gzdaijie/Github/blog/geektutu-blog/posts/7days-golang/day7-panic-recover/gee/context.go:41
+        /Users/gzdaijie/Github/blog/geektutu-blog/posts/7days-golang/day7-panic-recover/gee/recovery.go:37
+        /Users/gzdaijie/Github/blog/geektutu-blog/posts/7days-golang/day7-panic-recover/gee/context.go:41
+        /Users/gzdaijie/Github/blog/geektutu-blog/posts/7days-golang/day7-panic-recover/gee/logger.go:15
+        /Users/gzdaijie/Github/blog/geektutu-blog/posts/7days-golang/day7-panic-recover/gee/context.go:41
+        /Users/gzdaijie/Github/blog/geektutu-blog/posts/7days-golang/day7-panic-recover/gee/router.go:99
+        /Users/gzdaijie/Github/blog/geektutu-blog/posts/7days-golang/day7-panic-recover/gee/gee.go:130
+        /usr/local/Cellar/go/1.12.5/libexec/src/net/http/server.go:2775
+        /usr/local/Cellar/go/1.12.5/libexec/src/net/http/server.go:1879
+        /usr/local/Cellar/go/1.12.5/libexec/src/runtime/asm_amd64.s:1338
 
-2019/08/18 17:55:58 [500] /panic in 143.086µs
+2020/01/09 01:00:32 [500] /panic in 395.846µs
+2020/01/09 01:00:38 [200] / in 6.985µs
 */
 
 import (
diff --git a/doc/gee-day2.md b/doc/gee-day2.md
index e4b5f89..b7cf9d2 100644
--- a/doc/gee-day2.md
+++ b/doc/gee-day2.md
@@ -180,6 +180,7 @@ func newRouter() *router {
 }
 
 func (r *router) addRoute(method string, pattern string, handler HandlerFunc) {
+	log.Printf("Route %4s - %s", method, pattern)
 	key := method + "-" + pattern
 	r.handlers[key] = handler
 }
diff --git a/doc/gee-day4.md b/doc/gee-day4.md
index c6263f0..f6fb64a 100644
--- a/doc/gee-day4.md
+++ b/doc/gee-day4.md
@@ -96,6 +96,7 @@ func (group *RouterGroup) Group(prefix string) *RouterGroup {
 
 func (group *RouterGroup) addRoute(method string, comp string, handler HandlerFunc) {
 	pattern := group.prefix + comp
+	log.Printf("Route %4s - %s", method, pattern)
 	group.engine.router.addRoute(method, pattern, handler)
 }
 
diff --git a/doc/gee-day7.md b/doc/gee-day7.md
new file mode 100644
index 0000000..a9efa78
--- /dev/null
+++ b/doc/gee-day7.md
@@ -0,0 +1,289 @@
+---
+title: Go语言动手写Web框架 - Gee第六天 错误恢复(Panic Recover)
+date: 2020-01-09 01:00:00
+description: 7天用 Go语言 从零实现Web框架教程(7 days implement golang web framework from scratch tutorial)，用 Go语言/golang 动手写Web框架，从零实现一个Web框架，以 Gin 为原型从零设计一个Web框架。本文介绍了如何为Web框架增加错误处理机制。
+tags:
+- Go
+categories:
+- 从零实现
+keywords:
+- Go语言
+- 从零实现Web框架
+- 动手写Web框架
+- Panic
+- Recover
+image: post/gee-day7/go-panic.png
+github: https://github.com/geektutu/7days-golang
+---
+
+本文是[7天用Go从零实现Web框架Gee教程系列](https://geektutu.com/post/gee.html)的第七篇。
+
+- 实现错误处理机制。
+
+## panic
+
+Go 语言中，比较常见的错误处理方法是返回 error，由调用者决定后续如何处理。但是如果是无法恢复的错误，可以手动触发 panic，当然如果在程序运行过程中出现了类似于数组越界的错误，panic 也会被触发。panic 会中止当前执行的程序，退出。
+
+下面是主动触发的例子：
+
+```go
+// hello.go
+func main() {
+	fmt.Println("before panic")
+	panic("crash")
+	fmt.Println("after panic")
+}
+```
+
+```bash
+$ go run hello.go
+
+before panic
+panic: crash
+
+goroutine 1 [running]:
+main.main()
+        ~/go_demo/hello/hello.go:7 +0x95
+exit status 2
+```
+
+下面是数组越界触发的 panic
+
+```go
+// hello.go
+func main() {
+	arr := []int{1, 2, 3}
+	fmt.Println(arr[4])
+}
+```
+
+```bash
+$ go run hello.go
+panic: runtime error: index out of range [4] with length 3
+```
+
+## defer
+
+panic 会导致程序被中止，但是在退出前，会先处理完当前协程上已经defer 的任务，执行完成后再退出。效果类似于 java 语言的 `try...catch`。
+
+```go
+// hello.go
+func main() {
+	defer func() {
+		fmt.Println("defer func")
+	}()
+
+	arr := []int{1, 2, 3}
+	fmt.Println(arr[4])
+}
+```
+
+```go
+$ go run hello.go 
+defer func
+panic: runtime error: index out of range [4] with length 3
+```
+
+可以 defer 多个任务，在同一个函数中 defer 多个任务，会逆序执行。即先执行最后 defer 的任务。
+
+在这里，defer 的任务执行完成之后，panic 还会继续被抛出，导致程序非正常结束。
+
+## recover
+
+Go 语言还提供了 recover 函数，可以避免因为 panic 发生而导致整个程序终止，recover 函数只在 defer 中生效。
+
+```go
+// hello.go
+func test_recover() {
+	defer func() {
+		fmt.Println("defer func")
+		if err := recover(); err != nil {
+			fmt.Println("recover success")
+		}
+	}()
+
+	arr := []int{1, 2, 3}
+	fmt.Println(arr[4])
+	fmt.Println("after panic")
+}
+
+func main() {
+	test_recover()
+	fmt.Println("after recover")
+}
+```
+
+```go
+$ go run hello.go 
+defer func
+recover success
+after recover
+```
+
+我们可以看到，recover 捕获了 panic，程序正常结束。*test_recover()* 中的 *after panic* 没有打印，这是正确的，当 panic 被触发时，控制权就被交给了 defer 。就像在 java 中，`try`代码块中发生了异常，控制权交给了 `catch`，接下来执行 catch 代码块中的代码。而在 *main()* 中打印了 *after recover*，说明程序已经恢复正常，继续往下执行直到结束。
+
+## Gee 的错误处理机制
+
+对一个 Web 框架而言，错误处理机制是非常必要的。可能是框架本身没有完备的测试，导致在某些情况下出现空指针异常等情况。也有可能用户不正确的参数，触发了某些异常，例如数组越界，空指针等。如果因为这些原因导致系统宕机，必然是不可接受的。
+
+我们在[第六天](https://geektutu.com/post/gee-day6.html)实现的框架并没有加入异常处理机制，如果代码中存在会触发 panic 的 BUG，很容易宕掉。
+
+例如下面的代码：
+
+```go
+func main() {
+	r := gee.New()
+	r.GET("/panic", func(c *gee.Context) {
+		names := []string{"geektutu"}
+		c.String(http.StatusOK, names[100])
+	})
+	r.Run(":9999")
+}
+```
+在上面的代码中，我们为 gee 注册了路由 `/panic`，而这个路由的处理函数内部存在数组越界 `names[100]`，如果访问 *localhost:9999/panic*，Web 服务就会宕掉。
+
+今天，我们将在 gee 中添加一个非常简单的错误处理机制，即在此类错误发生时，向用户返回 *Internal Server Error*，并且在日志中打印必要的错误信息，方便进行错误定位。
+
+我们之前实现了中间件机制，错误处理也可以作为一个中间件，增强 gee 框架的能力。
+
+新增文件 **gee/recovery.go**，在这个文件中实现中间件 `Recovery`。
+
+```go
+func Recovery() HandlerFunc {
+	return func(c *Context) {
+		defer func() {
+			if err := recover(); err != nil {
+				message := fmt.Sprintf("%s", err)
+				log.Printf("%s\n\n", trace(message))
+				c.Fail(http.StatusInternalServerError, "Internal Server Error")
+			}
+		}()
+
+		c.Next()
+	}
+}
+```
+
+`Recovery` 的实现非常简单，使用 defer 挂载上错误恢复的函数，在这个函数中调用 *recover()*，捕获 panic，并且将堆栈信息打印在日志中，向用户返回 *Internal Server Error*。
+
+你可能注意到，这里有一个 *trace()* 函数，这个函数是用来获取触发 panic 的堆栈信息，完整代码如下：
+
+[day7-panic-recover/gee/recovery.go](https://github.com/geektutu/7days-golang/tree/master/day7-panic-recover)
+
+```go
+package gee
+
+import (
+	"fmt"
+	"log"
+	"net/http"
+	"runtime"
+	"strings"
+)
+
+// print stack trace for debug
+func trace(message string) string {
+	var pcs [32]uintptr
+	n := runtime.Callers(3, pcs[:]) // skip first 3 caller
+
+	var str strings.Builder
+	str.WriteString(message + "\nTraceback:")
+	for _, pc := range pcs[:n] {
+		fn := runtime.FuncForPC(pc)
+		file, line := fn.FileLine(pc)
+		str.WriteString(fmt.Sprintf("\n\t%s:%d", file, line))
+	}
+	return str.String()
+}
+
+func Recovery() HandlerFunc {
+	return func(c *Context) {
+		defer func() {
+			if err := recover(); err != nil {
+				message := fmt.Sprintf("%s", err)
+				log.Printf("%s\n\n", trace(message))
+				c.Fail(http.StatusInternalServerError, "Internal Server Error")
+			}
+		}()
+
+		c.Next()
+	}
+}
+```
+
+在 *trace()* 中，调用了 `runtime.Callers(3, pcs[:])`，Callers 用来返回调用栈的程序计数器, 第 0 个 Caller 是 Callers 本身，第 1 个是上一层 trace，第 2 个是再上一层的 `defer func`。因此，为了日志简洁一点，我们跳过了前 3 个 Caller。
+
+接下来，通过 `runtime.FuncForPC(pc)` 获取对应的函数，在通过 `fn.FileLine(pc)` 获取到调用该函数的文件名和行号，打印在日志中。
+
+至此，gee 框架的错误处理机制就完成了。
+
+## 使用 Demo
+
+[day7-panic-recover/main.go](https://github.com/geektutu/7days-golang/tree/master/day7-panic-recover)
+
+```go
+package main
+
+import (
+	"net/http"
+
+	"./gee"
+)
+
+func main() {
+	r := gee.Default()
+	r.GET("/", func(c *gee.Context) {
+		c.String(http.StatusOK, "Hello Geektutu\n")
+	})
+	// index out of range for testing Recovery()
+	r.GET("/panic", func(c *gee.Context) {
+		names := []string{"geektutu"}
+		c.String(http.StatusOK, names[100])
+	})
+
+	r.Run(":9999")
+}
+```
+
+接下来进行测试，先访问主页，访问一个有BUG的 `/panic`，服务正常返回。接下来我们再一次成功访问了主页，说明服务完全运转正常。
+
+```bash
+$ curl "http://localhost:9999"
+Hello Geektutu
+$ curl "http://localhost:9999/panic"
+{"message":"Internal Server Error"}
+$ curl "http://localhost:9999"
+Hello Geektutu
+```
+
+我们可以在后台日志中看到如下内容，引发错误的原因和堆栈信息都被打印了出来，通过日志，我们可以很容易地知道，在*day7-panic-recover/main.go:20* 的地方出现了 `index out of range` 错误。
+
+```bash
+2020/01/09 01:00:10 Route  GET - /
+2020/01/09 01:00:10 Route  GET - /panic
+2020/01/09 01:00:22 [200] / in 25.364µs
+2020/01/09 01:00:32 runtime error: index out of range
+Traceback:
+        /usr/local/Cellar/go/1.12.5/libexec/src/runtime/panic.go:523
+        /usr/local/Cellar/go/1.12.5/libexec/src/runtime/panic.go:44
+        /Users/gzdaijie/Github/blog/geektutu-blog/posts/7days-golang/day7-panic-recover/main.go:47
+        /Users/gzdaijie/Github/blog/geektutu-blog/posts/7days-golang/day7-panic-recover/gee/context.go:41
+        /Users/gzdaijie/Github/blog/geektutu-blog/posts/7days-golang/day7-panic-recover/gee/recovery.go:37
+        /Users/gzdaijie/Github/blog/geektutu-blog/posts/7days-golang/day7-panic-recover/gee/context.go:41
+        /Users/gzdaijie/Github/blog/geektutu-blog/posts/7days-golang/day7-panic-recover/gee/logger.go:15
+        /Users/gzdaijie/Github/blog/geektutu-blog/posts/7days-golang/day7-panic-recover/gee/context.go:41
+        /Users/gzdaijie/Github/blog/geektutu-blog/posts/7days-golang/day7-panic-recover/gee/router.go:99
+        /Users/gzdaijie/Github/blog/geektutu-blog/posts/7days-golang/day7-panic-recover/gee/gee.go:130
+        /usr/local/Cellar/go/1.12.5/libexec/src/net/http/server.go:2775
+        /usr/local/Cellar/go/1.12.5/libexec/src/net/http/server.go:1879
+        /usr/local/Cellar/go/1.12.5/libexec/src/runtime/asm_amd64.s:1338
+
+2020/01/09 01:00:32 [500] /panic in 395.846µs
+2020/01/09 01:00:38 [200] / in 6.985µs
+```
+
+## 参考
+
+- [Package runtime - golang.org](https://golang.org/pkg/runtime/)
+- [Is it possible get information about caller function in Golang? - StackOverflow](https://stackoverflow.com/questions/35212985/is-it-possible-get-information-about-caller-function-in-golang)
+
diff --git a/doc/gee-day7/go-panic.png b/doc/gee-day7/go-panic.png
new file mode 100644
index 0000000000000000000000000000000000000000..1682e755f7a399aa51d3ecb2e5a8010a734afbac
GIT binary patch
literal 3861
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
Xn((PN)Padr00000NkvXXu0mjf*t}Jg

literal 0
HcmV?d00001

diff --git a/doc/gee.md b/doc/gee.md
index 03f2c79..6db98b0 100644
--- a/doc/gee.md
+++ b/doc/gee.md
@@ -68,4 +68,4 @@ func handler(w http.ResponseWriter, r *http.Request) {
 - [第四天：分组控制(Group)](https://geektutu.com/post/gee-day4.html)，[Code - Github](https://github.com/geektutu/7days-golang/tree/master/day4-group)
 - [第五天：中间件(Middleware)](https://geektutu.com/post/gee-day5.html)，[Code - Github](https://github.com/geektutu/7days-golang/tree/master/day5-middleware)
 - [第六天：HTML模板(Template)](https://geektutu.com/post/gee-day6.html)，[Code - Github](https://github.com/geektutu/7days-golang/tree/master/day6-template)
-- 第七天：错误恢复(Panic Recover)，[Code - Github](https://github.com/geektutu/7days-golang/tree/master/day7-panic-recover)
\ No newline at end of file
+- [第七天：错误恢复(Panic Recover)](https://geektutu.com/post/gee-day7.html)，[Code - Github](https://github.com/geektutu/7days-golang/tree/master/day7-panic-recover)
\ No newline at end of file

From 944309dffeedc11193cc64e9275d07acd2552afe Mon Sep 17 00:00:00 2001
From: gzdaijie <gzdaijie@163.com>
Date: Thu, 9 Jan 2020 01:42:26 +0800
Subject: [PATCH 006/122] modify log

---
 day7-panic-recover/main.go | 16 ++++++++--------
 doc/gee-day7.md            | 18 +++++++++---------
 2 files changed, 17 insertions(+), 17 deletions(-)

diff --git a/day7-panic-recover/main.go b/day7-panic-recover/main.go
index 0444ea8..a342f66 100644
--- a/day7-panic-recover/main.go
+++ b/day7-panic-recover/main.go
@@ -16,14 +16,14 @@ Hello Geektutu
 Traceback:
         /usr/local/Cellar/go/1.12.5/libexec/src/runtime/panic.go:523
         /usr/local/Cellar/go/1.12.5/libexec/src/runtime/panic.go:44
-        /Users/gzdaijie/Github/blog/geektutu-blog/posts/7days-golang/day7-panic-recover/main.go:47
-        /Users/gzdaijie/Github/blog/geektutu-blog/posts/7days-golang/day7-panic-recover/gee/context.go:41
-        /Users/gzdaijie/Github/blog/geektutu-blog/posts/7days-golang/day7-panic-recover/gee/recovery.go:37
-        /Users/gzdaijie/Github/blog/geektutu-blog/posts/7days-golang/day7-panic-recover/gee/context.go:41
-        /Users/gzdaijie/Github/blog/geektutu-blog/posts/7days-golang/day7-panic-recover/gee/logger.go:15
-        /Users/gzdaijie/Github/blog/geektutu-blog/posts/7days-golang/day7-panic-recover/gee/context.go:41
-        /Users/gzdaijie/Github/blog/geektutu-blog/posts/7days-golang/day7-panic-recover/gee/router.go:99
-        /Users/gzdaijie/Github/blog/geektutu-blog/posts/7days-golang/day7-panic-recover/gee/gee.go:130
+        /Users/7days-golang/day7-panic-recover/main.go:47
+        /Users/7days-golang/day7-panic-recover/gee/context.go:41
+        /Users/7days-golang/day7-panic-recover/gee/recovery.go:37
+        /Users/7days-golang/day7-panic-recover/gee/context.go:41
+        /Users/7days-golang/day7-panic-recover/gee/logger.go:15
+        /Users/7days-golang/day7-panic-recover/gee/context.go:41
+        /Users/7days-golang/day7-panic-recover/gee/router.go:99
+        /Users/7days-golang/day7-panic-recover/gee/gee.go:130
         /usr/local/Cellar/go/1.12.5/libexec/src/net/http/server.go:2775
         /usr/local/Cellar/go/1.12.5/libexec/src/net/http/server.go:1879
         /usr/local/Cellar/go/1.12.5/libexec/src/runtime/asm_amd64.s:1338
diff --git a/doc/gee-day7.md b/doc/gee-day7.md
index a9efa78..b2766aa 100644
--- a/doc/gee-day7.md
+++ b/doc/gee-day7.md
@@ -256,7 +256,7 @@ $ curl "http://localhost:9999"
 Hello Geektutu
 ```
 
-我们可以在后台日志中看到如下内容，引发错误的原因和堆栈信息都被打印了出来，通过日志，我们可以很容易地知道，在*day7-panic-recover/main.go:20* 的地方出现了 `index out of range` 错误。
+我们可以在后台日志中看到如下内容，引发错误的原因和堆栈信息都被打印了出来，通过日志，我们可以很容易地知道，在*day7-panic-recover/main.go:47* 的地方出现了 `index out of range` 错误。
 
 ```bash
 2020/01/09 01:00:10 Route  GET - /
@@ -266,14 +266,14 @@ Hello Geektutu
 Traceback:
         /usr/local/Cellar/go/1.12.5/libexec/src/runtime/panic.go:523
         /usr/local/Cellar/go/1.12.5/libexec/src/runtime/panic.go:44
-        /Users/gzdaijie/Github/blog/geektutu-blog/posts/7days-golang/day7-panic-recover/main.go:47
-        /Users/gzdaijie/Github/blog/geektutu-blog/posts/7days-golang/day7-panic-recover/gee/context.go:41
-        /Users/gzdaijie/Github/blog/geektutu-blog/posts/7days-golang/day7-panic-recover/gee/recovery.go:37
-        /Users/gzdaijie/Github/blog/geektutu-blog/posts/7days-golang/day7-panic-recover/gee/context.go:41
-        /Users/gzdaijie/Github/blog/geektutu-blog/posts/7days-golang/day7-panic-recover/gee/logger.go:15
-        /Users/gzdaijie/Github/blog/geektutu-blog/posts/7days-golang/day7-panic-recover/gee/context.go:41
-        /Users/gzdaijie/Github/blog/geektutu-blog/posts/7days-golang/day7-panic-recover/gee/router.go:99
-        /Users/gzdaijie/Github/blog/geektutu-blog/posts/7days-golang/day7-panic-recover/gee/gee.go:130
+        /tmp/7days-golang/day7-panic-recover/main.go:47
+        /tmp/7days-golang/day7-panic-recover/gee/context.go:41
+        /tmp/7days-golang/day7-panic-recover/gee/recovery.go:37
+        /tmp/7days-golang/day7-panic-recover/gee/context.go:41
+        /tmp/7days-golang/day7-panic-recover/gee/logger.go:15
+        /tmp/7days-golang/day7-panic-recover/gee/context.go:41
+        /tmp/7days-golang/day7-panic-recover/gee/router.go:99
+        /tmp/7days-golang/day7-panic-recover/gee/gee.go:130
         /usr/local/Cellar/go/1.12.5/libexec/src/net/http/server.go:2775
         /usr/local/Cellar/go/1.12.5/libexec/src/net/http/server.go:1879
         /usr/local/Cellar/go/1.12.5/libexec/src/runtime/asm_amd64.s:1338

From fcd8faebdb98aae31b2a7950f5e0508fdf0511ce Mon Sep 17 00:00:00 2001
From: gzdaijie <gzdaijie@163.com>
Date: Fri, 10 Jan 2020 00:48:08 +0800
Subject: [PATCH 007/122] fix gee-day7 title

---
 doc/gee-day7.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/doc/gee-day7.md b/doc/gee-day7.md
index b2766aa..e1b1136 100644
--- a/doc/gee-day7.md
+++ b/doc/gee-day7.md
@@ -1,5 +1,5 @@
 ---
-title: Go语言动手写Web框架 - Gee第六天 错误恢复(Panic Recover)
+title: Go语言动手写Web框架 - Gee第七天 错误恢复(Panic Recover)
 date: 2020-01-09 01:00:00
 description: 7天用 Go语言 从零实现Web框架教程(7 days implement golang web framework from scratch tutorial)，用 Go语言/golang 动手写Web框架，从零实现一个Web框架，以 Gin 为原型从零设计一个Web框架。本文介绍了如何为Web框架增加错误处理机制。
 tags:

From bb58c2b263d8ed38b3322d90d41c823fa56c1757 Mon Sep 17 00:00:00 2001
From: gzdaijie <gzdaijie@163.com>
Date: Sat, 18 Jan 2020 01:31:09 +0800
Subject: [PATCH 008/122] add go tutorial for gee

---
 README.md  | 3 +++
 doc/gee.md | 7 ++++++-
 2 files changed, 9 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 93e00b2..2da62b5 100644
--- a/README.md
+++ b/README.md
@@ -2,6 +2,9 @@
 
 ![Gee](doc/gee/gee.jpg)
 
+
+如果是 Go 语言的初学者，推荐先阅读 [Go 语言简明教程](https://geektutu.com/post/quick-golang.html)。
+
 Gee 的设计与实现参考了Gin，这个教程可以快速入门：[Go Gin简明教程](https://geektutu.com/post/quick-go-gin.html)。
 
 ## [教程目录](https://geektutu.com/post/gee.html)
diff --git a/doc/gee.md b/doc/gee.md
index 6db98b0..26bf1f2 100644
--- a/doc/gee.md
+++ b/doc/gee.md
@@ -68,4 +68,9 @@ func handler(w http.ResponseWriter, r *http.Request) {
 - [第四天：分组控制(Group)](https://geektutu.com/post/gee-day4.html)，[Code - Github](https://github.com/geektutu/7days-golang/tree/master/day4-group)
 - [第五天：中间件(Middleware)](https://geektutu.com/post/gee-day5.html)，[Code - Github](https://github.com/geektutu/7days-golang/tree/master/day5-middleware)
 - [第六天：HTML模板(Template)](https://geektutu.com/post/gee-day6.html)，[Code - Github](https://github.com/geektutu/7days-golang/tree/master/day6-template)
-- [第七天：错误恢复(Panic Recover)](https://geektutu.com/post/gee-day7.html)，[Code - Github](https://github.com/geektutu/7days-golang/tree/master/day7-panic-recover)
\ No newline at end of file
+- [第七天：错误恢复(Panic Recover)](https://geektutu.com/post/gee-day7.html)，[Code - Github](https://github.com/geektutu/7days-golang/tree/master/day7-panic-recover)
+
+## 推荐阅读
+
+- [Go 语言简明教程](https://geektutu.com/post/quick-golang.html)
+- [Go Gin 简明教程](https://geektutu.com/post/quick-go-gin.html)
\ No newline at end of file

From 179e70e8359484ff86fd10ff767b58aae967f58e Mon Sep 17 00:00:00 2001
From: gzdaijie <gzdaijie@163.com>
Date: Sat, 18 Jan 2020 15:40:29 +0800
Subject: [PATCH 009/122] move gee day1-day7 to gee-web

---
 README.md                                     | 229 ++----------------
 gee-web/README.md                             | 215 ++++++++++++++++
 .../day1-http-base}/base1/main.go             |   0
 .../day1-http-base}/base2/main.go             |   0
 .../day1-http-base}/base3/gee/gee.go          |   0
 .../day1-http-base}/base3/main.go             |   0
 .../day2-context}/gee/context.go              |   0
 .../day2-context}/gee/gee.go                  |   0
 .../day2-context}/gee/router.go               |   0
 .../day2-context}/main.go                     |   0
 .../day3-router}/gee/context.go               |   0
 .../day3-router}/gee/gee.go                   |   0
 .../day3-router}/gee/router.go                |   0
 .../day3-router}/gee/router_test.go           |   0
 .../day3-router}/gee/trie.go                  |   0
 {day3-router => gee-web/day3-router}/main.go  |   0
 .../day4-group}/gee/context.go                |   0
 {day4-group => gee-web/day4-group}/gee/gee.go |   0
 .../day4-group}/gee/gee_test.go               |   0
 .../day4-group}/gee/router.go                 |   0
 .../day4-group}/gee/router_test.go            |   0
 .../day4-group}/gee/trie.go                   |   0
 {day4-group => gee-web/day4-group}/main.go    |   0
 .../day5-middleware}/gee/context.go           |   0
 .../day5-middleware}/gee/gee.go               |   0
 .../day5-middleware}/gee/gee_test.go          |   0
 .../day5-middleware}/gee/logger.go            |   0
 .../day5-middleware}/gee/router.go            |   0
 .../day5-middleware}/gee/router_test.go       |   0
 .../day5-middleware}/gee/trie.go              |   0
 .../day5-middleware}/main.go                  |   0
 .../day6-template}/gee/context.go             |   0
 .../day6-template}/gee/gee.go                 |   0
 .../day6-template}/gee/gee_test.go            |   0
 .../day6-template}/gee/logger.go              |   0
 .../day6-template}/gee/router.go              |   0
 .../day6-template}/gee/router_test.go         |   0
 .../day6-template}/gee/trie.go                |   0
 .../day6-template}/main.go                    |   0
 .../day6-template}/static/css/geektutu.css    |   0
 .../day6-template}/static/file1.txt           |   0
 .../day6-template}/templates/arr.tmpl         |   0
 .../day6-template}/templates/css.tmpl         |   0
 .../day6-template}/templates/custom_func.tmpl |   0
 .../day7-panic-recover}/gee/context.go        |   0
 .../day7-panic-recover}/gee/gee.go            |   0
 .../day7-panic-recover}/gee/gee_test.go       |   0
 .../day7-panic-recover}/gee/logger.go         |   0
 .../day7-panic-recover}/gee/recovery.go       |   0
 .../day7-panic-recover}/gee/router.go         |   0
 .../day7-panic-recover}/gee/router_test.go    |   0
 .../day7-panic-recover}/gee/trie.go           |   0
 .../day7-panic-recover}/main.go               |   0
 {doc => gee-web/doc}/gee-day1.md              |   8 +-
 {doc => gee-web/doc}/gee-day2.md              |   8 +-
 {doc => gee-web/doc}/gee-day3.md              |   2 +-
 {doc => gee-web/doc}/gee-day3/trie_eg.jpg     | Bin
 {doc => gee-web/doc}/gee-day3/trie_router.jpg | Bin
 {doc => gee-web/doc}/gee-day4.md              |   2 +-
 {doc => gee-web/doc}/gee-day4/group.jpg       | Bin
 {doc => gee-web/doc}/gee-day5.md              |   8 +-
 {doc => gee-web/doc}/gee-day5/middleware.jpg  | Bin
 {doc => gee-web/doc}/gee-day6.md              |   6 +-
 {doc => gee-web/doc}/gee-day6/html.png        | Bin
 {doc => gee-web/doc}/gee-day6/static.jpg      | Bin
 {doc => gee-web/doc}/gee-day7.md              |   4 +-
 {doc => gee-web/doc}/gee-day7/go-panic.png    | Bin
 {doc => gee-web/doc}/gee.md                   |  14 +-
 {doc => gee-web/doc}/gee/gee.jpg              | Bin
 69 files changed, 255 insertions(+), 241 deletions(-)
 create mode 100644 gee-web/README.md
 rename {day1-http-base => gee-web/day1-http-base}/base1/main.go (100%)
 rename {day1-http-base => gee-web/day1-http-base}/base2/main.go (100%)
 rename {day1-http-base => gee-web/day1-http-base}/base3/gee/gee.go (100%)
 rename {day1-http-base => gee-web/day1-http-base}/base3/main.go (100%)
 rename {day2-context => gee-web/day2-context}/gee/context.go (100%)
 rename {day2-context => gee-web/day2-context}/gee/gee.go (100%)
 rename {day2-context => gee-web/day2-context}/gee/router.go (100%)
 rename {day2-context => gee-web/day2-context}/main.go (100%)
 rename {day3-router => gee-web/day3-router}/gee/context.go (100%)
 rename {day3-router => gee-web/day3-router}/gee/gee.go (100%)
 rename {day3-router => gee-web/day3-router}/gee/router.go (100%)
 rename {day3-router => gee-web/day3-router}/gee/router_test.go (100%)
 rename {day3-router => gee-web/day3-router}/gee/trie.go (100%)
 rename {day3-router => gee-web/day3-router}/main.go (100%)
 rename {day4-group => gee-web/day4-group}/gee/context.go (100%)
 rename {day4-group => gee-web/day4-group}/gee/gee.go (100%)
 rename {day4-group => gee-web/day4-group}/gee/gee_test.go (100%)
 rename {day4-group => gee-web/day4-group}/gee/router.go (100%)
 rename {day4-group => gee-web/day4-group}/gee/router_test.go (100%)
 rename {day4-group => gee-web/day4-group}/gee/trie.go (100%)
 rename {day4-group => gee-web/day4-group}/main.go (100%)
 rename {day5-middleware => gee-web/day5-middleware}/gee/context.go (100%)
 rename {day5-middleware => gee-web/day5-middleware}/gee/gee.go (100%)
 rename {day5-middleware => gee-web/day5-middleware}/gee/gee_test.go (100%)
 rename {day5-middleware => gee-web/day5-middleware}/gee/logger.go (100%)
 rename {day5-middleware => gee-web/day5-middleware}/gee/router.go (100%)
 rename {day5-middleware => gee-web/day5-middleware}/gee/router_test.go (100%)
 rename {day5-middleware => gee-web/day5-middleware}/gee/trie.go (100%)
 rename {day5-middleware => gee-web/day5-middleware}/main.go (100%)
 rename {day6-template => gee-web/day6-template}/gee/context.go (100%)
 rename {day6-template => gee-web/day6-template}/gee/gee.go (100%)
 rename {day6-template => gee-web/day6-template}/gee/gee_test.go (100%)
 rename {day6-template => gee-web/day6-template}/gee/logger.go (100%)
 rename {day6-template => gee-web/day6-template}/gee/router.go (100%)
 rename {day6-template => gee-web/day6-template}/gee/router_test.go (100%)
 rename {day6-template => gee-web/day6-template}/gee/trie.go (100%)
 rename {day6-template => gee-web/day6-template}/main.go (100%)
 rename {day6-template => gee-web/day6-template}/static/css/geektutu.css (100%)
 rename {day6-template => gee-web/day6-template}/static/file1.txt (100%)
 rename {day6-template => gee-web/day6-template}/templates/arr.tmpl (100%)
 rename {day6-template => gee-web/day6-template}/templates/css.tmpl (100%)
 rename {day6-template => gee-web/day6-template}/templates/custom_func.tmpl (100%)
 rename {day7-panic-recover => gee-web/day7-panic-recover}/gee/context.go (100%)
 rename {day7-panic-recover => gee-web/day7-panic-recover}/gee/gee.go (100%)
 rename {day7-panic-recover => gee-web/day7-panic-recover}/gee/gee_test.go (100%)
 rename {day7-panic-recover => gee-web/day7-panic-recover}/gee/logger.go (100%)
 rename {day7-panic-recover => gee-web/day7-panic-recover}/gee/recovery.go (100%)
 rename {day7-panic-recover => gee-web/day7-panic-recover}/gee/router.go (100%)
 rename {day7-panic-recover => gee-web/day7-panic-recover}/gee/router_test.go (100%)
 rename {day7-panic-recover => gee-web/day7-panic-recover}/gee/trie.go (100%)
 rename {day7-panic-recover => gee-web/day7-panic-recover}/main.go (100%)
 rename {doc => gee-web/doc}/gee-day1.md (97%)
 rename {doc => gee-web/doc}/gee-day2.md (98%)
 rename {doc => gee-web/doc}/gee-day3.md (99%)
 rename {doc => gee-web/doc}/gee-day3/trie_eg.jpg (100%)
 rename {doc => gee-web/doc}/gee-day3/trie_router.jpg (100%)
 rename {doc => gee-web/doc}/gee-day4.md (99%)
 rename {doc => gee-web/doc}/gee-day4/group.jpg (100%)
 rename {doc => gee-web/doc}/gee-day5.md (97%)
 rename {doc => gee-web/doc}/gee-day5/middleware.jpg (100%)
 rename {doc => gee-web/doc}/gee-day6.md (98%)
 rename {doc => gee-web/doc}/gee-day6/html.png (100%)
 rename {doc => gee-web/doc}/gee-day6/static.jpg (100%)
 rename {doc => gee-web/doc}/gee-day7.md (98%)
 rename {doc => gee-web/doc}/gee-day7/go-panic.png (100%)
 rename {doc => gee-web/doc}/gee.md (93%)
 rename {doc => gee-web/doc}/gee/gee.jpg (100%)

diff --git a/README.md b/README.md
index 2da62b5..9f13e1a 100644
--- a/README.md
+++ b/README.md
@@ -1,222 +1,21 @@
-# 7天用Go从零实现Web框架Gee
+# 7天用Go从零实现系列
 
-![Gee](doc/gee/gee.jpg)
+## 序言
 
+7天能写什么呢？类似 gin 的 web 框架？类似 groupcache 的分布式缓存？或者一个简单的 Python 解释器？希望这个仓库能给你答案。
 
-如果是 Go 语言的初学者，推荐先阅读 [Go 语言简明教程](https://geektutu.com/post/quick-golang.html)。
+推荐先阅读 **[Go 语言简明教程](https://geektutu.com/post/quick-golang.html)**，一篇文章了解Go的基本语法、并发编程，依赖管理等内容
 
-Gee 的设计与实现参考了Gin，这个教程可以快速入门：[Go Gin简明教程](https://geektutu.com/post/quick-go-gin.html)。
+## 7天用Go从零实现Web框架Gee
 
-## [教程目录](https://geektutu.com/post/gee.html)
+Gee 的设计与实现参考了Gin，[Go Gin简明教程](https://geektutu.com/post/quick-go-gin.html)可以快速入门。
 
-- [第一天：前置知识(http.Handler接口)](https://geektutu.com/post/gee-day1.html)，[Code - Github](day1-http-base)
-- [第二天：上下文设计(Context)](https://geektutu.com/post/gee-day2.html)，[Code - Github](day2-context)
-- [第三天：Tire树路由(Router)](https://geektutu.com/post/gee-day3.html)，[Code - Github](day3-router)
-- [第四天：分组控制(Group)](https://geektutu.com/post/gee-day4.html)，[Code - Github](day4-group)
-- [第五天：中间件(Middleware)](https://geektutu.com/post/gee-day5.html)，[Code - Github](day5-middleware)
-- [第六天：HTML模板(Template)](https://geektutu.com/post/gee-day6.html)，[Code - Github](day6-template)
-- [第七天：错误恢复(Panic Recover)](https://geektutu.com/post/gee-day7.html)，[Code - Github](day7-panic-recover)
+#### [教程目录](https://geektutu.com/post/gee.html)
 
-
-## Day 1 - Static Route
-
-```go
-func main() {
-	r := gee.New()
-	r.GET("/", func(w http.ResponseWriter, req *http.Request) {
-		fmt.Fprintf(w, "URL.Path = %q\n", req.URL.Path)
-	})
-
-	r.GET("/hello", func(w http.ResponseWriter, req *http.Request) {
-		for k, v := range req.Header {
-			fmt.Fprintf(w, "Header[%q] = %q\n", k, v)
-		}
-	})
-
-	r.Run(":9999")
-}
-```
-
-## Day 2 - Context Design
-
-```go
-func main() {
-	r := gee.New()
-	r.GET("/", func(c *gee.Context) {
-		c.HTML(http.StatusOK, "<h1>Hello Gee</h1>")
-	})
-	r.GET("/hello", func(c *gee.Context) {
-		// expect /hello?name=geektutu
-		c.String(http.StatusOK, "hello %s, you're at %s\n", c.Query("name"), c.Path)
-	})
-
-	r.POST("/login", func(c *gee.Context) {
-		c.JSON(http.StatusOK, &map[string]string{
-			"username": c.PostForm("username"),
-			"password": c.PostForm("password"),
-		})
-	})
-
-	r.Run(":9999")
-}
-```
-
-## Day 3 - Dynamic Route
-
-```go
-func main() {
-	r := gee.New()
-	r.GET("/", func(c *gee.Context) {
-		c.HTML(http.StatusOK, "<h1>Hello Gee</h1>")
-	})
-
-	r.GET("/hello", func(c *gee.Context) {
-		// expect /hello?name=geektutu
-		c.String(http.StatusOK, "hello %s, you're at %s\n", c.Query("name"), c.Path)
-	})
-
-	r.GET("/hello/:name", func(c *gee.Context) {
-		// expect /hello/geektutu
-		c.String(http.StatusOK, "hello %s, you're at %s\n", c.Param("name"), c.Path)
-	})
-
-	r.GET("/assets/*filepath", func(c *gee.Context) {
-		c.JSON(http.StatusOK, gee.H{"filepath": c.Param("filepath")})
-	})
-
-	r.Run(":9999")
-}
-```
-
-## Day 4 - Nesting Group Control
-
-```go
-func main() {
-	r := gee.New()
-	v1 := r.Group("/v1")
-	{
-		v1.GET("/", func(c *gee.Context) {
-			c.HTML(http.StatusOK, "<h1>Hello Gee</h1>")
-		})
-
-		v1.GET("/hello", func(c *gee.Context) {
-			// expect /hello?name=geektutu
-			c.String(http.StatusOK, "hello %s, you're at %s\n", c.Query("name"), c.Path)
-		})
-	}
-	v2 := r.Group("/v2")
-	{
-		v2.GET("/hello/:name", func(c *gee.Context) {
-			// expect /hello/geektutu
-			c.String(http.StatusOK, "hello %s, you're at %s\n", c.Param("name"), c.Path)
-		})
-		v2.POST("/login", func(c *gee.Context) {
-			c.JSON(http.StatusOK, &map[string]string{
-				"username": c.PostForm("username"),
-				"password": c.PostForm("password"),
-			})
-		})
-
-	}
-
-	r.Run(":9999")
-}
-```
-
-## Day 5 - Middleware
-
-```go
-func onlyForV2() gee.HandlerFunc {
-	return func(c *gee.Context) {
-		// Start timer
-		t := time.Now()
-		// if a server error occurred
-		c.Fail(500, "Internal Server Error")
-		// Calculate resolution time
-		log.Printf("[%d] %s in %v for group v2", c.StatusCode, c.Req.RequestURI, time.Since(t))
-	}
-}
-
-func main() {
-	r := gee.New()
-	r.Use(gee.Logger()) // global midlleware
-	r.GET("/", func(c *gee.Context) {
-		c.HTML(http.StatusOK, "<h1>Hello Gee</h1>")
-	})
-
-	v2 := r.Group("/v2")
-	v2.Use(onlyForV2()) // v2 group middleware
-	{
-		v2.GET("/hello/:name", func(c *gee.Context) {
-			// expect /hello/geektutu
-			c.String(http.StatusOK, "hello %s, you're at %s\n", c.Param("name"), c.Path)
-		})
-	}
-
-	r.Run(":9999")
-}
-```
-
-## Day 6 - HTML Template
-
-```go
-type student struct {
-	Name string
-	Age  int8
-}
-
-func formatAsDate(t time.Time) string {
-	year, month, day := t.Date()
-	return fmt.Sprintf("%d-%02d-%02d", year, month, day)
-}
-
-func main() {
-	r := gee.New()
-	r.Use(gee.Logger())
-	r.SetFuncMap(template.FuncMap{
-		"formatAsDate": formatAsDate,
-	})
-	r.LoadHTMLGlob("templates/*")
-	r.Static("/assets", "./static")
-
-	stu1 := &student{Name: "Geektutu", Age: 20}
-	stu2 := &student{Name: "Jack", Age: 22}
-	r.GET("/", func(c *gee.Context) {
-		c.HTML(http.StatusOK, "css.tmpl", nil)
-	})
-	r.GET("/students", func(c *gee.Context) {
-		c.HTML(http.StatusOK, "arr.tmpl", gee.H{
-			"title":  "gee",
-			"stuArr": [2]*student{stu1, stu2},
-		})
-	})
-
-	r.GET("/date", func(c *gee.Context) {
-		c.HTML(http.StatusOK, "custom_func.tmpl", gee.H{
-			"title": "gee",
-			"now":   time.Date(2019, 8, 17, 0, 0, 0, 0, time.UTC),
-		})
-	})
-
-	r.Run(":9999")
-}
-```
-
-## Day 7 - Panic Recover
-
-```go
-func main() {
-	r := gee.Default()
-	r.GET("/", func(c *gee.Context) {
-		c.String(http.StatusOK, "Hello Geektutu\n")
-	})
-	// index out of range for testing Recovery()
-	r.GET("/panic", func(c *gee.Context) {
-		names := []string{"geektutu"}
-		c.String(http.StatusOK, names[100])
-	})
-
-	r.Run(":9999")
-}
-
-```
\ No newline at end of file
+- [第一天：前置知识(http.Handler接口)](https://geektutu.com/post/gee-day1.html)，[Code - Github](gee-web/day1-http-base)
+- [第二天：上下文设计(Context)](https://geektutu.com/post/gee-day2.html)，[Code - Github](gee-web/day2-context)
+- [第三天：Tire树路由(Router)](https://geektutu.com/post/gee-day3.html)，[Code - Github](gee-web/day3-router)
+- [第四天：分组控制(Group)](https://geektutu.com/post/gee-day4.html)，[Code - Github](gee-web/day4-group)
+- [第五天：中间件(Middleware)](https://geektutu.com/post/gee-day5.html)，[Code - Github](gee-web/day5-middleware)
+- [第六天：HTML模板(Template)](https://geektutu.com/post/gee-day6.html)，[Code - Github](gee-web/day6-template)
+- [第七天：错误恢复(Panic Recover)](https://geektutu.com/post/gee-day7.html)，[Code - Github](gee-web/day7-panic-recover)
\ No newline at end of file
diff --git a/gee-web/README.md b/gee-web/README.md
new file mode 100644
index 0000000..3361183
--- /dev/null
+++ b/gee-web/README.md
@@ -0,0 +1,215 @@
+# 7天用Go从零实现Web框架Gee
+
+![Gee](doc/gee/gee.jpg)
+
+## 教程目录
+
+- [第一天：前置知识(http.Handler接口)](https://geektutu.com/post/gee-day1.html)
+- [第二天：上下文设计(Context)](https://geektutu.com/post/gee-day2.html)
+- [第三天：Tire树路由(Router)](https://geektutu.com/post/gee-day3.html)
+- [第四天：分组控制(Group)](https://geektutu.com/post/gee-day4.html)
+- [第五天：中间件(Middleware)](https://geektutu.com/post/gee-day5.html)
+- [第六天：HTML模板(Template)](https://geektutu.com/post/gee-day6.html)
+- [第七天：错误恢复(Panic Recover)](https://geektutu.com/post/gee-day7.html)
+
+## Day 1 - Static Route
+
+```go
+func main() {
+	r := gee.New()
+	r.GET("/", func(w http.ResponseWriter, req *http.Request) {
+		fmt.Fprintf(w, "URL.Path = %q\n", req.URL.Path)
+	})
+
+	r.GET("/hello", func(w http.ResponseWriter, req *http.Request) {
+		for k, v := range req.Header {
+			fmt.Fprintf(w, "Header[%q] = %q\n", k, v)
+		}
+	})
+
+	r.Run(":9999")
+}
+```
+
+## Day 2 - Context Design
+
+```go
+func main() {
+	r := gee.New()
+	r.GET("/", func(c *gee.Context) {
+		c.HTML(http.StatusOK, "<h1>Hello Gee</h1>")
+	})
+	r.GET("/hello", func(c *gee.Context) {
+		// expect /hello?name=geektutu
+		c.String(http.StatusOK, "hello %s, you're at %s\n", c.Query("name"), c.Path)
+	})
+
+	r.POST("/login", func(c *gee.Context) {
+		c.JSON(http.StatusOK, &map[string]string{
+			"username": c.PostForm("username"),
+			"password": c.PostForm("password"),
+		})
+	})
+
+	r.Run(":9999")
+}
+```
+
+## Day 3 - Dynamic Route
+
+```go
+func main() {
+	r := gee.New()
+	r.GET("/", func(c *gee.Context) {
+		c.HTML(http.StatusOK, "<h1>Hello Gee</h1>")
+	})
+
+	r.GET("/hello", func(c *gee.Context) {
+		// expect /hello?name=geektutu
+		c.String(http.StatusOK, "hello %s, you're at %s\n", c.Query("name"), c.Path)
+	})
+
+	r.GET("/hello/:name", func(c *gee.Context) {
+		// expect /hello/geektutu
+		c.String(http.StatusOK, "hello %s, you're at %s\n", c.Param("name"), c.Path)
+	})
+
+	r.GET("/assets/*filepath", func(c *gee.Context) {
+		c.JSON(http.StatusOK, gee.H{"filepath": c.Param("filepath")})
+	})
+
+	r.Run(":9999")
+}
+```
+
+## Day 4 - Nesting Group Control
+
+```go
+func main() {
+	r := gee.New()
+	v1 := r.Group("/v1")
+	{
+		v1.GET("/", func(c *gee.Context) {
+			c.HTML(http.StatusOK, "<h1>Hello Gee</h1>")
+		})
+
+		v1.GET("/hello", func(c *gee.Context) {
+			// expect /hello?name=geektutu
+			c.String(http.StatusOK, "hello %s, you're at %s\n", c.Query("name"), c.Path)
+		})
+	}
+	v2 := r.Group("/v2")
+	{
+		v2.GET("/hello/:name", func(c *gee.Context) {
+			// expect /hello/geektutu
+			c.String(http.StatusOK, "hello %s, you're at %s\n", c.Param("name"), c.Path)
+		})
+		v2.POST("/login", func(c *gee.Context) {
+			c.JSON(http.StatusOK, &map[string]string{
+				"username": c.PostForm("username"),
+				"password": c.PostForm("password"),
+			})
+		})
+
+	}
+
+	r.Run(":9999")
+}
+```
+
+## Day 5 - Middleware
+
+```go
+func onlyForV2() gee.HandlerFunc {
+	return func(c *gee.Context) {
+		// Start timer
+		t := time.Now()
+		// if a server error occurred
+		c.Fail(500, "Internal Server Error")
+		// Calculate resolution time
+		log.Printf("[%d] %s in %v for group v2", c.StatusCode, c.Req.RequestURI, time.Since(t))
+	}
+}
+
+func main() {
+	r := gee.New()
+	r.Use(gee.Logger()) // global midlleware
+	r.GET("/", func(c *gee.Context) {
+		c.HTML(http.StatusOK, "<h1>Hello Gee</h1>")
+	})
+
+	v2 := r.Group("/v2")
+	v2.Use(onlyForV2()) // v2 group middleware
+	{
+		v2.GET("/hello/:name", func(c *gee.Context) {
+			// expect /hello/geektutu
+			c.String(http.StatusOK, "hello %s, you're at %s\n", c.Param("name"), c.Path)
+		})
+	}
+
+	r.Run(":9999")
+}
+```
+
+## Day 6 - HTML Template
+
+```go
+type student struct {
+	Name string
+	Age  int8
+}
+
+func formatAsDate(t time.Time) string {
+	year, month, day := t.Date()
+	return fmt.Sprintf("%d-%02d-%02d", year, month, day)
+}
+
+func main() {
+	r := gee.New()
+	r.Use(gee.Logger())
+	r.SetFuncMap(template.FuncMap{
+		"formatAsDate": formatAsDate,
+	})
+	r.LoadHTMLGlob("templates/*")
+	r.Static("/assets", "./static")
+
+	stu1 := &student{Name: "Geektutu", Age: 20}
+	stu2 := &student{Name: "Jack", Age: 22}
+	r.GET("/", func(c *gee.Context) {
+		c.HTML(http.StatusOK, "css.tmpl", nil)
+	})
+	r.GET("/students", func(c *gee.Context) {
+		c.HTML(http.StatusOK, "arr.tmpl", gee.H{
+			"title":  "gee",
+			"stuArr": [2]*student{stu1, stu2},
+		})
+	})
+
+	r.GET("/date", func(c *gee.Context) {
+		c.HTML(http.StatusOK, "custom_func.tmpl", gee.H{
+			"title": "gee",
+			"now":   time.Date(2019, 8, 17, 0, 0, 0, 0, time.UTC),
+		})
+	})
+
+	r.Run(":9999")
+}
+```
+
+## Day 7 - Panic Recover
+
+```go
+func main() {
+	r := gee.Default()
+	r.GET("/", func(c *gee.Context) {
+		c.String(http.StatusOK, "Hello Geektutu\n")
+	})
+	// index out of range for testing Recovery()
+	r.GET("/panic", func(c *gee.Context) {
+		names := []string{"geektutu"}
+		c.String(http.StatusOK, names[100])
+	})
+
+	r.Run(":9999")
+}
+```
\ No newline at end of file
diff --git a/day1-http-base/base1/main.go b/gee-web/day1-http-base/base1/main.go
similarity index 100%
rename from day1-http-base/base1/main.go
rename to gee-web/day1-http-base/base1/main.go
diff --git a/day1-http-base/base2/main.go b/gee-web/day1-http-base/base2/main.go
similarity index 100%
rename from day1-http-base/base2/main.go
rename to gee-web/day1-http-base/base2/main.go
diff --git a/day1-http-base/base3/gee/gee.go b/gee-web/day1-http-base/base3/gee/gee.go
similarity index 100%
rename from day1-http-base/base3/gee/gee.go
rename to gee-web/day1-http-base/base3/gee/gee.go
diff --git a/day1-http-base/base3/main.go b/gee-web/day1-http-base/base3/main.go
similarity index 100%
rename from day1-http-base/base3/main.go
rename to gee-web/day1-http-base/base3/main.go
diff --git a/day2-context/gee/context.go b/gee-web/day2-context/gee/context.go
similarity index 100%
rename from day2-context/gee/context.go
rename to gee-web/day2-context/gee/context.go
diff --git a/day2-context/gee/gee.go b/gee-web/day2-context/gee/gee.go
similarity index 100%
rename from day2-context/gee/gee.go
rename to gee-web/day2-context/gee/gee.go
diff --git a/day2-context/gee/router.go b/gee-web/day2-context/gee/router.go
similarity index 100%
rename from day2-context/gee/router.go
rename to gee-web/day2-context/gee/router.go
diff --git a/day2-context/main.go b/gee-web/day2-context/main.go
similarity index 100%
rename from day2-context/main.go
rename to gee-web/day2-context/main.go
diff --git a/day3-router/gee/context.go b/gee-web/day3-router/gee/context.go
similarity index 100%
rename from day3-router/gee/context.go
rename to gee-web/day3-router/gee/context.go
diff --git a/day3-router/gee/gee.go b/gee-web/day3-router/gee/gee.go
similarity index 100%
rename from day3-router/gee/gee.go
rename to gee-web/day3-router/gee/gee.go
diff --git a/day3-router/gee/router.go b/gee-web/day3-router/gee/router.go
similarity index 100%
rename from day3-router/gee/router.go
rename to gee-web/day3-router/gee/router.go
diff --git a/day3-router/gee/router_test.go b/gee-web/day3-router/gee/router_test.go
similarity index 100%
rename from day3-router/gee/router_test.go
rename to gee-web/day3-router/gee/router_test.go
diff --git a/day3-router/gee/trie.go b/gee-web/day3-router/gee/trie.go
similarity index 100%
rename from day3-router/gee/trie.go
rename to gee-web/day3-router/gee/trie.go
diff --git a/day3-router/main.go b/gee-web/day3-router/main.go
similarity index 100%
rename from day3-router/main.go
rename to gee-web/day3-router/main.go
diff --git a/day4-group/gee/context.go b/gee-web/day4-group/gee/context.go
similarity index 100%
rename from day4-group/gee/context.go
rename to gee-web/day4-group/gee/context.go
diff --git a/day4-group/gee/gee.go b/gee-web/day4-group/gee/gee.go
similarity index 100%
rename from day4-group/gee/gee.go
rename to gee-web/day4-group/gee/gee.go
diff --git a/day4-group/gee/gee_test.go b/gee-web/day4-group/gee/gee_test.go
similarity index 100%
rename from day4-group/gee/gee_test.go
rename to gee-web/day4-group/gee/gee_test.go
diff --git a/day4-group/gee/router.go b/gee-web/day4-group/gee/router.go
similarity index 100%
rename from day4-group/gee/router.go
rename to gee-web/day4-group/gee/router.go
diff --git a/day4-group/gee/router_test.go b/gee-web/day4-group/gee/router_test.go
similarity index 100%
rename from day4-group/gee/router_test.go
rename to gee-web/day4-group/gee/router_test.go
diff --git a/day4-group/gee/trie.go b/gee-web/day4-group/gee/trie.go
similarity index 100%
rename from day4-group/gee/trie.go
rename to gee-web/day4-group/gee/trie.go
diff --git a/day4-group/main.go b/gee-web/day4-group/main.go
similarity index 100%
rename from day4-group/main.go
rename to gee-web/day4-group/main.go
diff --git a/day5-middleware/gee/context.go b/gee-web/day5-middleware/gee/context.go
similarity index 100%
rename from day5-middleware/gee/context.go
rename to gee-web/day5-middleware/gee/context.go
diff --git a/day5-middleware/gee/gee.go b/gee-web/day5-middleware/gee/gee.go
similarity index 100%
rename from day5-middleware/gee/gee.go
rename to gee-web/day5-middleware/gee/gee.go
diff --git a/day5-middleware/gee/gee_test.go b/gee-web/day5-middleware/gee/gee_test.go
similarity index 100%
rename from day5-middleware/gee/gee_test.go
rename to gee-web/day5-middleware/gee/gee_test.go
diff --git a/day5-middleware/gee/logger.go b/gee-web/day5-middleware/gee/logger.go
similarity index 100%
rename from day5-middleware/gee/logger.go
rename to gee-web/day5-middleware/gee/logger.go
diff --git a/day5-middleware/gee/router.go b/gee-web/day5-middleware/gee/router.go
similarity index 100%
rename from day5-middleware/gee/router.go
rename to gee-web/day5-middleware/gee/router.go
diff --git a/day5-middleware/gee/router_test.go b/gee-web/day5-middleware/gee/router_test.go
similarity index 100%
rename from day5-middleware/gee/router_test.go
rename to gee-web/day5-middleware/gee/router_test.go
diff --git a/day5-middleware/gee/trie.go b/gee-web/day5-middleware/gee/trie.go
similarity index 100%
rename from day5-middleware/gee/trie.go
rename to gee-web/day5-middleware/gee/trie.go
diff --git a/day5-middleware/main.go b/gee-web/day5-middleware/main.go
similarity index 100%
rename from day5-middleware/main.go
rename to gee-web/day5-middleware/main.go
diff --git a/day6-template/gee/context.go b/gee-web/day6-template/gee/context.go
similarity index 100%
rename from day6-template/gee/context.go
rename to gee-web/day6-template/gee/context.go
diff --git a/day6-template/gee/gee.go b/gee-web/day6-template/gee/gee.go
similarity index 100%
rename from day6-template/gee/gee.go
rename to gee-web/day6-template/gee/gee.go
diff --git a/day6-template/gee/gee_test.go b/gee-web/day6-template/gee/gee_test.go
similarity index 100%
rename from day6-template/gee/gee_test.go
rename to gee-web/day6-template/gee/gee_test.go
diff --git a/day6-template/gee/logger.go b/gee-web/day6-template/gee/logger.go
similarity index 100%
rename from day6-template/gee/logger.go
rename to gee-web/day6-template/gee/logger.go
diff --git a/day6-template/gee/router.go b/gee-web/day6-template/gee/router.go
similarity index 100%
rename from day6-template/gee/router.go
rename to gee-web/day6-template/gee/router.go
diff --git a/day6-template/gee/router_test.go b/gee-web/day6-template/gee/router_test.go
similarity index 100%
rename from day6-template/gee/router_test.go
rename to gee-web/day6-template/gee/router_test.go
diff --git a/day6-template/gee/trie.go b/gee-web/day6-template/gee/trie.go
similarity index 100%
rename from day6-template/gee/trie.go
rename to gee-web/day6-template/gee/trie.go
diff --git a/day6-template/main.go b/gee-web/day6-template/main.go
similarity index 100%
rename from day6-template/main.go
rename to gee-web/day6-template/main.go
diff --git a/day6-template/static/css/geektutu.css b/gee-web/day6-template/static/css/geektutu.css
similarity index 100%
rename from day6-template/static/css/geektutu.css
rename to gee-web/day6-template/static/css/geektutu.css
diff --git a/day6-template/static/file1.txt b/gee-web/day6-template/static/file1.txt
similarity index 100%
rename from day6-template/static/file1.txt
rename to gee-web/day6-template/static/file1.txt
diff --git a/day6-template/templates/arr.tmpl b/gee-web/day6-template/templates/arr.tmpl
similarity index 100%
rename from day6-template/templates/arr.tmpl
rename to gee-web/day6-template/templates/arr.tmpl
diff --git a/day6-template/templates/css.tmpl b/gee-web/day6-template/templates/css.tmpl
similarity index 100%
rename from day6-template/templates/css.tmpl
rename to gee-web/day6-template/templates/css.tmpl
diff --git a/day6-template/templates/custom_func.tmpl b/gee-web/day6-template/templates/custom_func.tmpl
similarity index 100%
rename from day6-template/templates/custom_func.tmpl
rename to gee-web/day6-template/templates/custom_func.tmpl
diff --git a/day7-panic-recover/gee/context.go b/gee-web/day7-panic-recover/gee/context.go
similarity index 100%
rename from day7-panic-recover/gee/context.go
rename to gee-web/day7-panic-recover/gee/context.go
diff --git a/day7-panic-recover/gee/gee.go b/gee-web/day7-panic-recover/gee/gee.go
similarity index 100%
rename from day7-panic-recover/gee/gee.go
rename to gee-web/day7-panic-recover/gee/gee.go
diff --git a/day7-panic-recover/gee/gee_test.go b/gee-web/day7-panic-recover/gee/gee_test.go
similarity index 100%
rename from day7-panic-recover/gee/gee_test.go
rename to gee-web/day7-panic-recover/gee/gee_test.go
diff --git a/day7-panic-recover/gee/logger.go b/gee-web/day7-panic-recover/gee/logger.go
similarity index 100%
rename from day7-panic-recover/gee/logger.go
rename to gee-web/day7-panic-recover/gee/logger.go
diff --git a/day7-panic-recover/gee/recovery.go b/gee-web/day7-panic-recover/gee/recovery.go
similarity index 100%
rename from day7-panic-recover/gee/recovery.go
rename to gee-web/day7-panic-recover/gee/recovery.go
diff --git a/day7-panic-recover/gee/router.go b/gee-web/day7-panic-recover/gee/router.go
similarity index 100%
rename from day7-panic-recover/gee/router.go
rename to gee-web/day7-panic-recover/gee/router.go
diff --git a/day7-panic-recover/gee/router_test.go b/gee-web/day7-panic-recover/gee/router_test.go
similarity index 100%
rename from day7-panic-recover/gee/router_test.go
rename to gee-web/day7-panic-recover/gee/router_test.go
diff --git a/day7-panic-recover/gee/trie.go b/gee-web/day7-panic-recover/gee/trie.go
similarity index 100%
rename from day7-panic-recover/gee/trie.go
rename to gee-web/day7-panic-recover/gee/trie.go
diff --git a/day7-panic-recover/main.go b/gee-web/day7-panic-recover/main.go
similarity index 100%
rename from day7-panic-recover/main.go
rename to gee-web/day7-panic-recover/main.go
diff --git a/doc/gee-day1.md b/gee-web/doc/gee-day1.md
similarity index 97%
rename from doc/gee-day1.md
rename to gee-web/doc/gee-day1.md
index 14385d2..fd94496 100644
--- a/doc/gee-day1.md
+++ b/gee-web/doc/gee-day1.md
@@ -24,7 +24,7 @@ github: https://github.com/geektutu/7days-golang
 
 Go语言内置了 `net/http`库，封装了HTTP网络编程的基础的接口，我们实现的`Gee` Web 框架便是基于`net/http`的。我们接下来通过一个例子，简单介绍下这个库的使用。
 
-**[day1-http-base/base1/main.go](https://github.com/geektutu/7days-golang/tree/master/day1-http-base/base1)**
+**[day1-http-base/base1/main.go](https://github.com/geektutu/7days-golang/tree/master/gee-web/day1-http-base/base1)**
 
 ```go
 package main
@@ -82,7 +82,7 @@ func ListenAndServe(address string, h Handler) error
 
 第二个参数的类型是什么呢？通过查看`net/http`的源码可以发现，`Handler`是一个接口，需要实现方法 _ServeHTTP_ ，也就是说，只要传入任何实现了 _ServerHTTP_ 接口的实例，所有的HTTP请求，就都交给了该实例处理了。马上来试一试吧。
 
-**[day1-http-base/base2/main.go](https://github.com/geektutu/7days-golang/tree/master/day1-http-base/base2)**
+**[day1-http-base/base2/main.go](https://github.com/geektutu/7days-golang/tree/master/gee-web/day1-http-base/base2)**
 
 ```go
 package main
@@ -135,7 +135,7 @@ main.go
 
 ### main.go
 
-**[day1-http-base/base3/main.go](https://github.com/geektutu/7days-golang/tree/master/day1-http-base/base3)**
+**[day1-http-base/base3/main.go](https://github.com/geektutu/7days-golang/tree/master/gee-web/day1-http-base/base3)**
 
 ```go
 package main
@@ -167,7 +167,7 @@ func main() {
 
 ### gee.go
 
-**[day1-http-base/base3/gee/gee.go](https://github.com/geektutu/7days-golang/tree/master/day1-http-base/base3)**
+**[day1-http-base/base3/gee/gee.go](https://github.com/geektutu/7days-golang/tree/master/gee-web/day1-http-base/base3)**
 
 ```go
 package gee
diff --git a/doc/gee-day2.md b/gee-web/doc/gee-day2.md
similarity index 98%
rename from doc/gee-day2.md
rename to gee-web/doc/gee-day2.md
index b7cf9d2..e47467f 100644
--- a/doc/gee-day2.md
+++ b/gee-web/doc/gee-day2.md
@@ -25,7 +25,7 @@ github: https://github.com/geektutu/7days-golang
 
 为了展示第二天的成果，我们看一看在使用时的效果。
 
-[day2-context/main.go](https://github.com/geektutu/7days-golang/tree/master/day2-context)
+[day2-context/main.go](https://github.com/geektutu/7days-golang/tree/master/gee-web/day2-context)
 
 
 ```go
@@ -90,7 +90,7 @@ c.JSON(http.StatusOK, gee.H{
 
 ### 具体实现
 
-[day2-context/gee/context.go](https://github.com/geektutu/7days-golang/tree/master/day2-context)
+[day2-context/gee/context.go](https://github.com/geektutu/7days-golang/tree/master/gee-web/day2-context)
 
 ```go
 type H map[string]interface{}
@@ -168,7 +168,7 @@ func (c *Context) HTML(code int, html string) {
 
 我们将和路由相关的方法和结构提取了出来，放到了一个新的文件中`router.go`，方便我们下一次对 router 的功能进行增强，例如提供动态路由的支持。 router 的 handle 方法作了一个细微的调整，即 handler 的参数，变成了 Context。
 
-[day2-context/gee/router.go](https://github.com/geektutu/7days-golang/tree/master/day2-context)
+[day2-context/gee/router.go](https://github.com/geektutu/7days-golang/tree/master/gee-web/day2-context)
 
 ```go
 type router struct {
@@ -197,7 +197,7 @@ func (r *router) handle(c *Context) {
 
 ## 框架入口
 
-[day2-context/gee/gee.go](https://github.com/geektutu/7days-golang/tree/master/day2-context)
+[day2-context/gee/gee.go](https://github.com/geektutu/7days-golang/tree/master/gee-web/day2-context)
 
 ```go
 // HandlerFunc defines the request handler used by gee
diff --git a/doc/gee-day3.md b/gee-web/doc/gee-day3.md
similarity index 99%
rename from doc/gee-day3.md
rename to gee-web/doc/gee-day3.md
index f838554..43407f9 100644
--- a/doc/gee-day3.md
+++ b/gee-web/doc/gee-day3.md
@@ -52,7 +52,7 @@ HTTP请求的路径恰好是由`/`分隔的多段构成的，因此，每一段
 
 首先我们需要设计树节点上应该存储那些信息。
 
-**[day3-router/gee/trie.go](https://github.com/geektutu/7days-golang/tree/master/day3-router/gee)**
+**[day3-router/gee/trie.go](https://github.com/geektutu/7days-golang/tree/master/gee-web/day3-router/gee)**
 
 ```go
 type node struct {
diff --git a/doc/gee-day3/trie_eg.jpg b/gee-web/doc/gee-day3/trie_eg.jpg
similarity index 100%
rename from doc/gee-day3/trie_eg.jpg
rename to gee-web/doc/gee-day3/trie_eg.jpg
diff --git a/doc/gee-day3/trie_router.jpg b/gee-web/doc/gee-day3/trie_router.jpg
similarity index 100%
rename from doc/gee-day3/trie_router.jpg
rename to gee-web/doc/gee-day3/trie_router.jpg
diff --git a/doc/gee-day4.md b/gee-web/doc/gee-day4.md
similarity index 99%
rename from doc/gee-day4.md
rename to gee-web/doc/gee-day4.md
index f6fb64a..b3f6625 100644
--- a/doc/gee-day4.md
+++ b/gee-web/doc/gee-day4.md
@@ -49,7 +49,7 @@ v1.GET("/", func(c *gee.Context) {
 
 所以，最后的 Group 的定义是这样的：
 
-**[day4-group/gee/gee.go](https://github.com/geektutu/7days-golang/tree/master/day4-group/gee)**
+**[day4-group/gee/gee.go](https://github.com/geektutu/7days-golang/tree/master/gee-web/day4-group/gee)**
 
 ```go
 RouterGroup struct {
diff --git a/doc/gee-day4/group.jpg b/gee-web/doc/gee-day4/group.jpg
similarity index 100%
rename from doc/gee-day4/group.jpg
rename to gee-web/doc/gee-day4/group.jpg
diff --git a/doc/gee-day5.md b/gee-web/doc/gee-day5.md
similarity index 97%
rename from doc/gee-day5.md
rename to gee-web/doc/gee-day5.md
index 763e8a7..4ae022e 100644
--- a/doc/gee-day5.md
+++ b/gee-web/doc/gee-day5.md
@@ -33,7 +33,7 @@ github: https://github.com/geektutu/7days-golang
 
 Gee 的中间件的定义与路由映射的 Handler 一致，处理的输入是`Context`对象。插入点是框架接收到请求初始化`Context`对象后，允许用户使用自己定义的中间件做一些额外的处理，例如记录日志等，以及对`Context`进行二次加工。另外通过调用`(*Context).Next()`函数，中间件可等待用户自己定义的 `Handler`处理结束后，再做一些额外的操作，例如计算本次处理所用时间等。即 Gee 的中间件支持用户在请求被处理的前后，做一些额外的操作。举个例子，我们希望最终能够支持如下定义的中间件，`c.Next()`表示等待执行其他的中间件或用户的`Handler`：
 
-****[day4-group/gee/logger.go](https://github.com/geektutu/7days-golang/tree/master/day5-middleware/gee)****
+****[day4-group/gee/logger.go](https://github.com/geektutu/7days-golang/tree/master/gee-web/day5-middleware/gee)****
 
 ```go
 func Logger() HandlerFunc {
@@ -56,7 +56,7 @@ func Logger() HandlerFunc {
 
 为此，我们给`Context`添加了2个参数，定义了`Next`方法：
 
-**[day4-group/gee/context.go](https://github.com/geektutu/7days-golang/tree/master/day5-middleware/gee)**
+**[day4-group/gee/context.go](https://github.com/geektutu/7days-golang/tree/master/gee-web/day5-middleware/gee)**
 
 ```go
 type Context struct {
@@ -130,7 +130,7 @@ func B(c *Context) {
 
 - 定义`Use`函数，将中间件应用到某个 Group 。
 
-**[day4-group/gee/gee.go](https://github.com/geektutu/7days-golang/tree/master/day5-middleware/gee)**
+**[day4-group/gee/gee.go](https://github.com/geektutu/7days-golang/tree/master/gee-web/day5-middleware/gee)**
 
 ```go
 // Use is defined to add middleware to the group
@@ -155,7 +155,7 @@ ServeHTTP 函数也有变化，当我们接收到一个具体请求时，要判
 
 - handle 函数中，将从路由匹配得到的 Handler 添加到 `c.handlers`列表中，执行`c.Next()`。
 
-**[day4-group/gee/router.go](https://github.com/geektutu/7days-golang/tree/master/day5-middleware/gee)**
+**[day4-group/gee/router.go](https://github.com/geektutu/7days-golang/tree/master/gee-web/day5-middleware/gee)**
 
 ```go
 func (r *router) handle(c *Context) {
diff --git a/doc/gee-day5/middleware.jpg b/gee-web/doc/gee-day5/middleware.jpg
similarity index 100%
rename from doc/gee-day5/middleware.jpg
rename to gee-web/doc/gee-day5/middleware.jpg
diff --git a/doc/gee-day6.md b/gee-web/doc/gee-day6.md
similarity index 98%
rename from doc/gee-day6.md
rename to gee-web/doc/gee-day6.md
index ad4845b..4ee21df 100644
--- a/doc/gee-day6.md
+++ b/gee-web/doc/gee-day6.md
@@ -36,7 +36,7 @@ github: https://github.com/geektutu/7days-golang
 
 找到文件后，如何返回这一步，`net/http`库已经实现了。因此，gee 框架要做的，仅仅是解析请求的地址，映射到服务器上文件的真实地址，交给`http.FileServer`处理就好了。
 
-[day6-template/gee/gee.go](https://github.com/geektutu/7days-golang/tree/master/day6-template/gee)
+[day6-template/gee/gee.go](https://github.com/geektutu/7days-golang/tree/master/gee-web/day6-template/gee)
 
 ```go
 // create static handler
@@ -103,7 +103,7 @@ func (engine *Engine) LoadHTMLGlob(pattern string) {
 
 接下来，对原来的 `(*Context).HTML()`方法做了些小修改，使之支持根据模板文件名选择模板进行渲染。
 
-[day6-template/gee/context.go](https://github.com/geektutu/7days-golang/tree/master/day6-template/gee)
+[day6-template/gee/context.go](https://github.com/geektutu/7days-golang/tree/master/gee-web/day6-template/gee)
 
 ```go
 func (c *Context) HTML(code int, name string, data interface{}) {
@@ -140,7 +140,7 @@ func (c *Context) HTML(code int, name string, data interface{}) {
 </html>
 ```
 
-[day6-template/main.go](https://github.com/geektutu/7days-golang/tree/master/day6-template/gee)
+[day6-template/main.go](https://github.com/geektutu/7days-golang/tree/master/gee-web/day6-template/gee)
 
 ```go
 type student struct {
diff --git a/doc/gee-day6/html.png b/gee-web/doc/gee-day6/html.png
similarity index 100%
rename from doc/gee-day6/html.png
rename to gee-web/doc/gee-day6/html.png
diff --git a/doc/gee-day6/static.jpg b/gee-web/doc/gee-day6/static.jpg
similarity index 100%
rename from doc/gee-day6/static.jpg
rename to gee-web/doc/gee-day6/static.jpg
diff --git a/doc/gee-day7.md b/gee-web/doc/gee-day7.md
similarity index 98%
rename from doc/gee-day7.md
rename to gee-web/doc/gee-day7.md
index e1b1136..f72a314 100644
--- a/doc/gee-day7.md
+++ b/gee-web/doc/gee-day7.md
@@ -168,7 +168,7 @@ func Recovery() HandlerFunc {
 
 你可能注意到，这里有一个 *trace()* 函数，这个函数是用来获取触发 panic 的堆栈信息，完整代码如下：
 
-[day7-panic-recover/gee/recovery.go](https://github.com/geektutu/7days-golang/tree/master/day7-panic-recover)
+[day7-panic-recover/gee/recovery.go](https://github.com/geektutu/7days-golang/tree/master/gee-web/day7-panic-recover)
 
 ```go
 package gee
@@ -219,7 +219,7 @@ func Recovery() HandlerFunc {
 
 ## 使用 Demo
 
-[day7-panic-recover/main.go](https://github.com/geektutu/7days-golang/tree/master/day7-panic-recover)
+[day7-panic-recover/main.go](https://github.com/geektutu/7days-golang/tree/master/gee-web/day7-panic-recover)
 
 ```go
 package main
diff --git a/doc/gee-day7/go-panic.png b/gee-web/doc/gee-day7/go-panic.png
similarity index 100%
rename from doc/gee-day7/go-panic.png
rename to gee-web/doc/gee-day7/go-panic.png
diff --git a/doc/gee.md b/gee-web/doc/gee.md
similarity index 93%
rename from doc/gee.md
rename to gee-web/doc/gee.md
index 26bf1f2..c215534 100644
--- a/doc/gee.md
+++ b/gee-web/doc/gee.md
@@ -62,13 +62,13 @@ func handler(w http.ResponseWriter, r *http.Request) {
 
 ## 目录
 
-- [第一天：前置知识(http.Handler接口)](https://geektutu.com/post/gee-day1.html)，[Code - Github](https://github.com/geektutu/7days-golang/tree/master/day1-http-base)
-- [第二天：上下文设计(Context)](https://geektutu.com/post/gee-day2.html)，[Code - Github](https://github.com/geektutu/7days-golang/tree/master/day2-context)
-- [第三天：Tire树路由(Router)](https://geektutu.com/post/gee-day3.html)，[Code - Github](https://github.com/geektutu/7days-golang/tree/master/day3-router)
-- [第四天：分组控制(Group)](https://geektutu.com/post/gee-day4.html)，[Code - Github](https://github.com/geektutu/7days-golang/tree/master/day4-group)
-- [第五天：中间件(Middleware)](https://geektutu.com/post/gee-day5.html)，[Code - Github](https://github.com/geektutu/7days-golang/tree/master/day5-middleware)
-- [第六天：HTML模板(Template)](https://geektutu.com/post/gee-day6.html)，[Code - Github](https://github.com/geektutu/7days-golang/tree/master/day6-template)
-- [第七天：错误恢复(Panic Recover)](https://geektutu.com/post/gee-day7.html)，[Code - Github](https://github.com/geektutu/7days-golang/tree/master/day7-panic-recover)
+- [第一天：前置知识(http.Handler接口)](https://geektutu.com/post/gee-day1.html)，[Code - Github](https://github.com/geektutu/7days-golang/tree/master/gee-web/day1-http-base)
+- [第二天：上下文设计(Context)](https://geektutu.com/post/gee-day2.html)，[Code - Github](https://github.com/geektutu/7days-golang/tree/master/gee-web/day2-context)
+- [第三天：Tire树路由(Router)](https://geektutu.com/post/gee-day3.html)，[Code - Github](https://github.com/geektutu/7days-golang/tree/master/gee-web/day3-router)
+- [第四天：分组控制(Group)](https://geektutu.com/post/gee-day4.html)，[Code - Github](https://github.com/geektutu/7days-golang/tree/master/gee-web/day4-group)
+- [第五天：中间件(Middleware)](https://geektutu.com/post/gee-day5.html)，[Code - Github](https://github.com/geektutu/7days-golang/tree/master/gee-web/day5-middleware)
+- [第六天：HTML模板(Template)](https://geektutu.com/post/gee-day6.html)，[Code - Github](https://github.com/geektutu/7days-golang/tree/master/gee-web/day6-template)
+- [第七天：错误恢复(Panic Recover)](https://geektutu.com/post/gee-day7.html)，[Code - Github](https://github.com/geektutu/7days-golang/tree/master/gee-web/day7-panic-recover)
 
 ## 推荐阅读
 
diff --git a/doc/gee/gee.jpg b/gee-web/doc/gee/gee.jpg
similarity index 100%
rename from doc/gee/gee.jpg
rename to gee-web/doc/gee/gee.jpg

From 172d0ccfc0415c6082569c431a52725916963de9 Mon Sep 17 00:00:00 2001
From: gzdaijie <gzdaijie@163.com>
Date: Sat, 18 Jan 2020 15:57:45 +0800
Subject: [PATCH 010/122] remove subdirectory gee from doc

---
 README.md               | 2 --
 gee-web/doc/gee-day3.md | 2 +-
 gee-web/doc/gee-day4.md | 2 +-
 gee-web/doc/gee-day5.md | 8 ++++----
 gee-web/doc/gee-day6.md | 6 +++---
 5 files changed, 9 insertions(+), 11 deletions(-)

diff --git a/README.md b/README.md
index 9f13e1a..7d11a7f 100644
--- a/README.md
+++ b/README.md
@@ -1,7 +1,5 @@
 # 7天用Go从零实现系列
 
-## 序言
-
 7天能写什么呢？类似 gin 的 web 框架？类似 groupcache 的分布式缓存？或者一个简单的 Python 解释器？希望这个仓库能给你答案。
 
 推荐先阅读 **[Go 语言简明教程](https://geektutu.com/post/quick-golang.html)**，一篇文章了解Go的基本语法、并发编程，依赖管理等内容
diff --git a/gee-web/doc/gee-day3.md b/gee-web/doc/gee-day3.md
index 43407f9..23a0e72 100644
--- a/gee-web/doc/gee-day3.md
+++ b/gee-web/doc/gee-day3.md
@@ -52,7 +52,7 @@ HTTP请求的路径恰好是由`/`分隔的多段构成的，因此，每一段
 
 首先我们需要设计树节点上应该存储那些信息。
 
-**[day3-router/gee/trie.go](https://github.com/geektutu/7days-golang/tree/master/gee-web/day3-router/gee)**
+**[day3-router/gee/trie.go](https://github.com/geektutu/7days-golang/tree/master/gee-web/day3-router)**
 
 ```go
 type node struct {
diff --git a/gee-web/doc/gee-day4.md b/gee-web/doc/gee-day4.md
index b3f6625..7f71370 100644
--- a/gee-web/doc/gee-day4.md
+++ b/gee-web/doc/gee-day4.md
@@ -49,7 +49,7 @@ v1.GET("/", func(c *gee.Context) {
 
 所以，最后的 Group 的定义是这样的：
 
-**[day4-group/gee/gee.go](https://github.com/geektutu/7days-golang/tree/master/gee-web/day4-group/gee)**
+**[day4-group/gee/gee.go](https://github.com/geektutu/7days-golang/tree/master/gee-web/day4-group)**
 
 ```go
 RouterGroup struct {
diff --git a/gee-web/doc/gee-day5.md b/gee-web/doc/gee-day5.md
index 4ae022e..9f5d117 100644
--- a/gee-web/doc/gee-day5.md
+++ b/gee-web/doc/gee-day5.md
@@ -33,7 +33,7 @@ github: https://github.com/geektutu/7days-golang
 
 Gee 的中间件的定义与路由映射的 Handler 一致，处理的输入是`Context`对象。插入点是框架接收到请求初始化`Context`对象后，允许用户使用自己定义的中间件做一些额外的处理，例如记录日志等，以及对`Context`进行二次加工。另外通过调用`(*Context).Next()`函数，中间件可等待用户自己定义的 `Handler`处理结束后，再做一些额外的操作，例如计算本次处理所用时间等。即 Gee 的中间件支持用户在请求被处理的前后，做一些额外的操作。举个例子，我们希望最终能够支持如下定义的中间件，`c.Next()`表示等待执行其他的中间件或用户的`Handler`：
 
-****[day4-group/gee/logger.go](https://github.com/geektutu/7days-golang/tree/master/gee-web/day5-middleware/gee)****
+****[day4-group/gee/logger.go](https://github.com/geektutu/7days-golang/tree/master/gee-web/day5-middleware)****
 
 ```go
 func Logger() HandlerFunc {
@@ -56,7 +56,7 @@ func Logger() HandlerFunc {
 
 为此，我们给`Context`添加了2个参数，定义了`Next`方法：
 
-**[day4-group/gee/context.go](https://github.com/geektutu/7days-golang/tree/master/gee-web/day5-middleware/gee)**
+**[day4-group/gee/context.go](https://github.com/geektutu/7days-golang/tree/master/gee-web/day5-middleware)**
 
 ```go
 type Context struct {
@@ -130,7 +130,7 @@ func B(c *Context) {
 
 - 定义`Use`函数，将中间件应用到某个 Group 。
 
-**[day4-group/gee/gee.go](https://github.com/geektutu/7days-golang/tree/master/gee-web/day5-middleware/gee)**
+**[day4-group/gee/gee.go](https://github.com/geektutu/7days-golang/tree/master/gee-web/day5-middleware)**
 
 ```go
 // Use is defined to add middleware to the group
@@ -155,7 +155,7 @@ ServeHTTP 函数也有变化，当我们接收到一个具体请求时，要判
 
 - handle 函数中，将从路由匹配得到的 Handler 添加到 `c.handlers`列表中，执行`c.Next()`。
 
-**[day4-group/gee/router.go](https://github.com/geektutu/7days-golang/tree/master/gee-web/day5-middleware/gee)**
+**[day4-group/gee/router.go](https://github.com/geektutu/7days-golang/tree/master/gee-web/day5-middleware)**
 
 ```go
 func (r *router) handle(c *Context) {
diff --git a/gee-web/doc/gee-day6.md b/gee-web/doc/gee-day6.md
index 4ee21df..e429faf 100644
--- a/gee-web/doc/gee-day6.md
+++ b/gee-web/doc/gee-day6.md
@@ -36,7 +36,7 @@ github: https://github.com/geektutu/7days-golang
 
 找到文件后，如何返回这一步，`net/http`库已经实现了。因此，gee 框架要做的，仅仅是解析请求的地址，映射到服务器上文件的真实地址，交给`http.FileServer`处理就好了。
 
-[day6-template/gee/gee.go](https://github.com/geektutu/7days-golang/tree/master/gee-web/day6-template/gee)
+[day6-template/gee/gee.go](https://github.com/geektutu/7days-golang/tree/master/gee-web/day6-template)
 
 ```go
 // create static handler
@@ -103,7 +103,7 @@ func (engine *Engine) LoadHTMLGlob(pattern string) {
 
 接下来，对原来的 `(*Context).HTML()`方法做了些小修改，使之支持根据模板文件名选择模板进行渲染。
 
-[day6-template/gee/context.go](https://github.com/geektutu/7days-golang/tree/master/gee-web/day6-template/gee)
+[day6-template/gee/context.go](https://github.com/geektutu/7days-golang/tree/master/gee-web/day6-template)
 
 ```go
 func (c *Context) HTML(code int, name string, data interface{}) {
@@ -140,7 +140,7 @@ func (c *Context) HTML(code int, name string, data interface{}) {
 </html>
 ```
 
-[day6-template/main.go](https://github.com/geektutu/7days-golang/tree/master/gee-web/day6-template/gee)
+[day6-template/main.go](https://github.com/geektutu/7days-golang/tree/master/gee-web/day6-template)
 
 ```go
 type student struct {

From ba48e164a52905ba3c6c871a8b362890d8f80eb0 Mon Sep 17 00:00:00 2001
From: gzdaijie <gzdaijie@163.com>
Date: Sun, 19 Jan 2020 23:49:42 +0800
Subject: [PATCH 011/122] add distributed cache day1 lru

---
 gee-cache/day1-lru/geecache/go.mod          |  3 +
 gee-cache/day1-lru/geecache/lru/lru.go      | 84 +++++++++++++++++++++
 gee-cache/day1-lru/geecache/lru/lru_test.go | 16 ++++
 3 files changed, 103 insertions(+)
 create mode 100644 gee-cache/day1-lru/geecache/go.mod
 create mode 100644 gee-cache/day1-lru/geecache/lru/lru.go
 create mode 100644 gee-cache/day1-lru/geecache/lru/lru_test.go

diff --git a/gee-cache/day1-lru/geecache/go.mod b/gee-cache/day1-lru/geecache/go.mod
new file mode 100644
index 0000000..f9d454e
--- /dev/null
+++ b/gee-cache/day1-lru/geecache/go.mod
@@ -0,0 +1,3 @@
+module geecache
+
+go 1.13
diff --git a/gee-cache/day1-lru/geecache/lru/lru.go b/gee-cache/day1-lru/geecache/lru/lru.go
new file mode 100644
index 0000000..94f7116
--- /dev/null
+++ b/gee-cache/day1-lru/geecache/lru/lru.go
@@ -0,0 +1,84 @@
+package lru
+
+import (
+	"container/list"
+	"unsafe"
+)
+
+// Cache is a LRU cache. It is not safe for concurrent access.
+type Cache struct {
+	maxBytes int
+	nbytes   int
+	ll       *list.List
+	cache    map[string]*list.Element
+	// optional and executed when an entry is purged.
+	OnEvicted func(key string, value interface{})
+}
+
+type entry struct {
+	key   string
+	value interface{}
+}
+
+// New is the Constructor of Cache
+func New(maxBytes int, onEvicted func(string, interface{})) *Cache {
+	return &Cache{
+		maxBytes: maxBytes,
+		ll:       list.New(),
+		cache:    make(map[string]*list.Element),
+	}
+}
+
+// Add adds a value to the cache.
+func (c *Cache) Add(key string, value interface{}) {
+	if ele, ok := c.cache[key]; ok {
+		c.ll.MoveToFront(ele)
+		kv := ele.Value.(*entry)
+		kv.value = value
+		return
+	}
+	ele := c.ll.PushFront(&entry{key, value})
+	c.cache[key] = ele
+	c.nbytes += len(key) + sizeof(value)
+
+	for c.maxBytes != 0 && c.maxBytes < c.nbytes {
+		c.RemoveOldest()
+	}
+}
+
+// Get look ups a key's value
+func (c *Cache) Get(key string) (value interface{}, ok bool) {
+	if ele, ok := c.cache[key]; ok {
+		c.ll.MoveToFront(ele)
+		kv := ele.Value.(*entry)
+		return kv.value, true
+	}
+	return
+}
+
+// RemoveOldest removes the oldest item
+func (c *Cache) RemoveOldest() {
+	ele := c.ll.Back()
+	if ele != nil {
+		c.ll.Remove(ele)
+		kv := ele.Value.(*entry)
+		delete(c.cache, kv.key)
+		c.nbytes -= len(kv.key) + sizeof(kv.value)
+		if c.OnEvicted != nil {
+			c.OnEvicted(kv.key, kv.value)
+		}
+	}
+}
+
+// Value is optional interface for the value
+// if it's not implemented, use unsafe.Sizeof to count
+type Value interface {
+	Len() int // count how many bytes it takes
+}
+
+func sizeof(value interface{}) int {
+	if m, ok := value.(Value); ok {
+		return m.Len()
+	}
+	return int(unsafe.Sizeof(value))
+}
diff --git a/gee-cache/day1-lru/geecache/lru/lru_test.go b/gee-cache/day1-lru/geecache/lru/lru_test.go
new file mode 100644
index 0000000..a820af9
--- /dev/null
+++ b/gee-cache/day1-lru/geecache/lru/lru_test.go
@@ -0,0 +1,16 @@
+package lru
+
+import (
+	"testing"
+)
+
+func TestGet(t *testing.T) {
+	lru := New(0, nil)
+	lru.Add("key1", 1234)
+	if v, ok := lru.Get("key1"); !ok || v != 1234 {
+		t.Fatalf("cache hit key1=1234 failed")
+	}
+	if _, ok := lru.Get("key2"); ok {
+		t.Fatalf("cache miss key2 failed")
+	}
+}

From 4378b0de1b9ecf27abfda8c03f4e0be99d32a1bc Mon Sep 17 00:00:00 2001
From: gzdaijie <gzdaijie@163.com>
Date: Mon, 20 Jan 2020 01:08:56 +0800
Subject: [PATCH 012/122] add test func for lru

---
 gee-cache/day1-lru/geecache/lru/lru.go      | 50 ++++++++++-----------
 gee-cache/day1-lru/geecache/lru/lru_test.go | 45 +++++++++++++++++--
 2 files changed, 65 insertions(+), 30 deletions(-)

diff --git a/gee-cache/day1-lru/geecache/lru/lru.go b/gee-cache/day1-lru/geecache/lru/lru.go
index 94f7116..906c9da 100644
--- a/gee-cache/day1-lru/geecache/lru/lru.go
+++ b/gee-cache/day1-lru/geecache/lru/lru.go
@@ -1,36 +1,40 @@
 package lru
 
-import (
-	"container/list"
-	"unsafe"
-)
+import "container/list"
 
 // Cache is a LRU cache. It is not safe for concurrent access.
 type Cache struct {
-	maxBytes int
-	nbytes   int
+	maxBytes int64
+	nbytes   int64
 	ll       *list.List
 	cache    map[string]*list.Element
 	// optional and executed when an entry is purged.
-	OnEvicted func(key string, value interface{})
+	OnEvicted func(key string, value Value)
 }
 
 type entry struct {
 	key   string
-	value interface{}
+	value Value
+}
+
+// Value is optional interface for the value
+// if it's not implemented, use unsafe.Sizeof to count
+type Value interface {
+	Len() int // count how many bytes it takes
 }
 
 // New is the Constructor of Cache
-func New(maxBytes int, onEvicted func(string, interface{})) *Cache {
+func New(maxBytes int64, onEvicted func(string, Value)) *Cache {
 	return &Cache{
-		maxBytes: maxBytes,
-		ll:       list.New(),
-		cache:    make(map[string]*list.Element),
+		maxBytes:  maxBytes,
+		ll:        list.New(),
+		cache:     make(map[string]*list.Element),
+		OnEvicted: onEvicted,
 	}
 }
 
 // Add adds a value to the cache.
-func (c *Cache) Add(key string, value interface{}) {
+func (c *Cache) Add(key string, value Value) {
 	if ele, ok := c.cache[key]; ok {
 		c.ll.MoveToFront(ele)
 		kv := ele.Value.(*entry)
@@ -39,7 +43,7 @@ func (c *Cache) Add(key string, value interface{}) {
 	}
 	ele := c.ll.PushFront(&entry{key, value})
 	c.cache[key] = ele
-	c.nbytes += len(key) + sizeof(value)
+	c.nbytes += int64(len(key)) + int64(value.Len())
 
 	for c.maxBytes != 0 && c.maxBytes < c.nbytes {
 		c.RemoveOldest()
@@ -47,7 +51,7 @@ func (c *Cache) Add(key string, value interface{}) {
 }
 
 // Get look ups a key's value
-func (c *Cache) Get(key string) (value interface{}, ok bool) {
+func (c *Cache) Get(key string) (value Value, ok bool) {
 	if ele, ok := c.cache[key]; ok {
 		c.ll.MoveToFront(ele)
 		kv := ele.Value.(*entry)
@@ -63,22 +67,14 @@ func (c *Cache) RemoveOldest() {
 		c.ll.Remove(ele)
 		kv := ele.Value.(*entry)
 		delete(c.cache, kv.key)
-		c.nbytes -= len(kv.key) + sizeof(kv.value)
+		c.nbytes -= int64(len(kv.key)) + int64(kv.value.Len())
 		if c.OnEvicted != nil {
 			c.OnEvicted(kv.key, kv.value)
 		}
 	}
 }
 
-// Value is optional interface for the value
-// if it's not implemented, use unsafe.Sizeof to count
-type Value interface {
-	Len() int // count how many bytes it takes
-}
-
-func sizeof(value interface{}) int {
-	if m, ok := value.(Value); ok {
-		return m.Len()
-	}
-	return int(unsafe.Sizeof(value))
+// Len the number of cache entries
+func (c *Cache) Len() int {
+	return c.ll.Len()
 }
diff --git a/gee-cache/day1-lru/geecache/lru/lru_test.go b/gee-cache/day1-lru/geecache/lru/lru_test.go
index a820af9..7308322 100644
--- a/gee-cache/day1-lru/geecache/lru/lru_test.go
+++ b/gee-cache/day1-lru/geecache/lru/lru_test.go
@@ -1,16 +1,55 @@
 package lru
 
 import (
+	"reflect"
 	"testing"
 )
 
+type String string
+
+func (d String) Len() int {
+	return len(d)
+}
+
 func TestGet(t *testing.T) {
-	lru := New(0, nil)
-	lru.Add("key1", 1234)
-	if v, ok := lru.Get("key1"); !ok || v != 1234 {
+	lru := New(int64(0), nil)
+	lru.Add("key1", String("1234"))
+	if v, ok := lru.Get("key1"); !ok || string(v.(String)) != "1234" {
 		t.Fatalf("cache hit key1=1234 failed")
 	}
 	if _, ok := lru.Get("key2"); ok {
 		t.Fatalf("cache miss key2 failed")
 	}
 }
+
+func TestRemoveoldest(t *testing.T) {
+	k1, k2, k3 := "key1", "key2", "k3"
+	v1, v2, v3 := "value1", "value2", "v3"
+	cap := len(k1 + k2 + v1 + v2)
+	lru := New(int64(cap), nil)
+	lru.Add(k1, String(v1))
+	lru.Add(k2, String(v2))
+	lru.Add(k3, String(v3))
+
+	if _, ok := lru.Get("key1"); ok || lru.Len() != 2 {
+		t.Fatalf("Removeoldest key1 failed")
+	}
+}
+
+func TestOnEvicted(t *testing.T) {
+	keys := make([]string, 0)
+	callback := func(key string, value Value) {
+		keys = append(keys, key)
+	}
+	lru := New(int64(10), callback)
+	lru.Add("key1", String("123456"))
+	lru.Add("k2", String("k2"))
+	lru.Add("k3", String("k3"))
+	lru.Add("k4", String("k4"))
+
+	expect := []string{"key1", "k2"}
+
+	if !reflect.DeepEqual(expect, keys) {
+		t.Fatalf("Call OnEvicted failed, expect keys equals to %s", expect)
+	}
+}

From 2b0d4527669e8aee25da538ba0e79ef4b0abd14b Mon Sep 17 00:00:00 2001
From: gzdaijie <gzdaijie@gmail.com>
Date: Thu, 23 Jan 2020 23:17:29 +0800
Subject: [PATCH 013/122] add go webassembly demo

---
 README.md                               | 11 +++++++-
 demo-wasm/.gitignore                    |  2 ++
 demo-wasm/callback/Makefile             | 11 ++++++++
 demo-wasm/callback/index.html           | 18 +++++++++++++
 demo-wasm/callback/main.go              | 32 +++++++++++++++++++++++
 demo-wasm/hello-world/Makefile          | 11 ++++++++
 demo-wasm/hello-world/index.html        | 12 +++++++++
 demo-wasm/hello-world/main.go           |  9 +++++++
 demo-wasm/manipulate-dom/Makefile       | 11 ++++++++
 demo-wasm/manipulate-dom/index.html     | 18 +++++++++++++
 demo-wasm/manipulate-dom/main.go        | 34 +++++++++++++++++++++++++
 demo-wasm/register-functions/Makefile   | 11 ++++++++
 demo-wasm/register-functions/index.html | 18 +++++++++++++
 demo-wasm/register-functions/main.go    | 21 +++++++++++++++
 14 files changed, 218 insertions(+), 1 deletion(-)
 create mode 100644 demo-wasm/.gitignore
 create mode 100644 demo-wasm/callback/Makefile
 create mode 100644 demo-wasm/callback/index.html
 create mode 100644 demo-wasm/callback/main.go
 create mode 100644 demo-wasm/hello-world/Makefile
 create mode 100644 demo-wasm/hello-world/index.html
 create mode 100644 demo-wasm/hello-world/main.go
 create mode 100644 demo-wasm/manipulate-dom/Makefile
 create mode 100644 demo-wasm/manipulate-dom/index.html
 create mode 100644 demo-wasm/manipulate-dom/main.go
 create mode 100644 demo-wasm/register-functions/Makefile
 create mode 100644 demo-wasm/register-functions/index.html
 create mode 100644 demo-wasm/register-functions/main.go

diff --git a/README.md b/README.md
index 7d11a7f..6b5b664 100644
--- a/README.md
+++ b/README.md
@@ -16,4 +16,13 @@ Gee 的设计与实现参考了Gin，[Go Gin简明教程](https://geektutu.com/p
 - [第四天：分组控制(Group)](https://geektutu.com/post/gee-day4.html)，[Code - Github](gee-web/day4-group)
 - [第五天：中间件(Middleware)](https://geektutu.com/post/gee-day5.html)，[Code - Github](gee-web/day5-middleware)
 - [第六天：HTML模板(Template)](https://geektutu.com/post/gee-day6.html)，[Code - Github](gee-web/day6-template)
-- [第七天：错误恢复(Panic Recover)](https://geektutu.com/post/gee-day7.html)，[Code - Github](gee-web/day7-panic-recover)
\ No newline at end of file
+- [第七天：错误恢复(Panic Recover)](https://geektutu.com/post/gee-day7.html)，[Code - Github](gee-web/day7-panic-recover)
+
+## WebAssembly Demo
+
+#### [教程地址](https://geektutu.com/post/quick-go-wasm.html)
+
+- [1. Hello World](demo-wasm/hello-world)
+- [2. 注册函数](demo-wasm/hello-world)
+- [3. 操作 DOM](demo-wasm/hello-world)
+- [4. 回调函数](demo-wasm/hello-world)
\ No newline at end of file
diff --git a/demo-wasm/.gitignore b/demo-wasm/.gitignore
new file mode 100644
index 0000000..b4d6ef2
--- /dev/null
+++ b/demo-wasm/.gitignore
@@ -0,0 +1,2 @@
+*.wasm
+static
\ No newline at end of file
diff --git a/demo-wasm/callback/Makefile b/demo-wasm/callback/Makefile
new file mode 100644
index 0000000..234573b
--- /dev/null
+++ b/demo-wasm/callback/Makefile
@@ -0,0 +1,11 @@
+all: static/main.wasm static/wasm_exec.js
+ifeq (, $(shell which goexec))	
+	go get -u github.com/shurcooL/goexec
+endif
+	goexec 'http.ListenAndServe(`:9999`, http.FileServer(http.Dir(`.`)))'
+
+static/wasm_exec.js:
+	cp "$(shell go env GOROOT)/misc/wasm/wasm_exec.js" static
+
+static/main.wasm: main.go
+	GO111MODULE=auto GOOS=js GOARCH=wasm go build -o static/main.wasm .
\ No newline at end of file
diff --git a/demo-wasm/callback/index.html b/demo-wasm/callback/index.html
new file mode 100644
index 0000000..da37fb4
--- /dev/null
+++ b/demo-wasm/callback/index.html
@@ -0,0 +1,18 @@
+<html>
+
+<head>
+    <script src="static/wasm_exec.js"></script>
+    <script>
+        const go = new Go();
+        WebAssembly.instantiateStreaming(fetch("static/main.wasm"), go.importObject)
+            .then((result) => go.run(result.instance));
+    </script>
+</head>
+
+<body>
+    <input id="num" type="number" />
+    <button id="btn" onclick="fibFunc(num.value * 1, (v)=> ans.innerHTML=v)">Click</button>
+    <p id="ans"></p>
+</body>
+
+</html>
\ No newline at end of file
diff --git a/demo-wasm/callback/main.go b/demo-wasm/callback/main.go
new file mode 100644
index 0000000..e9c137e
--- /dev/null
+++ b/demo-wasm/callback/main.go
@@ -0,0 +1,32 @@
+// main.go
+package main
+
+import (
+	"syscall/js"
+	"time"
+)
+
+func fib(i int) int {
+	if i == 0 || i == 1 {
+		return 1
+	}
+	return fib(i-1) + fib(i-2)
+}
+
+func fibFunc(this js.Value, args []js.Value) interface{} {
+	callback := args[len(args)-1]
+	go func() {
+		time.Sleep(3 * time.Second)
+		v := fib(args[0].Int())
+		callback.Invoke(v)
+	}()
+
+	js.Global().Get("ans").Set("innerHTML", "Waiting 3s...")
+	return nil
+}
+
+func main() {
+	done := make(chan int, 0)
+	js.Global().Set("fibFunc", js.FuncOf(fibFunc))
+	<-done
+}
diff --git a/demo-wasm/hello-world/Makefile b/demo-wasm/hello-world/Makefile
new file mode 100644
index 0000000..234573b
--- /dev/null
+++ b/demo-wasm/hello-world/Makefile
@@ -0,0 +1,11 @@
+all: static/main.wasm static/wasm_exec.js
+ifeq (, $(shell which goexec))	
+	go get -u github.com/shurcooL/goexec
+endif
+	goexec 'http.ListenAndServe(`:9999`, http.FileServer(http.Dir(`.`)))'
+
+static/wasm_exec.js:
+	cp "$(shell go env GOROOT)/misc/wasm/wasm_exec.js" static
+
+static/main.wasm: main.go
+	GO111MODULE=auto GOOS=js GOARCH=wasm go build -o static/main.wasm .
\ No newline at end of file
diff --git a/demo-wasm/hello-world/index.html b/demo-wasm/hello-world/index.html
new file mode 100644
index 0000000..c75710c
--- /dev/null
+++ b/demo-wasm/hello-world/index.html
@@ -0,0 +1,12 @@
+<html>
+
+<head>
+    <script src="static/wasm_exec.js"></script>
+    <script>
+        const go = new Go();
+        WebAssembly.instantiateStreaming(fetch("static/main.wasm"), go.importObject)
+            .then((result) => go.run(result.instance));
+    </script>
+</head>
+
+</html>
\ No newline at end of file
diff --git a/demo-wasm/hello-world/main.go b/demo-wasm/hello-world/main.go
new file mode 100644
index 0000000..8bcd95b
--- /dev/null
+++ b/demo-wasm/hello-world/main.go
@@ -0,0 +1,9 @@
+// main.go
+package main
+
+import "syscall/js"
+
+func main() {
+	alert := js.Global().Get("alert")
+	alert.Invoke("Hello World!")
+}
\ No newline at end of file
diff --git a/demo-wasm/manipulate-dom/Makefile b/demo-wasm/manipulate-dom/Makefile
new file mode 100644
index 0000000..234573b
--- /dev/null
+++ b/demo-wasm/manipulate-dom/Makefile
@@ -0,0 +1,11 @@
+all: static/main.wasm static/wasm_exec.js
+ifeq (, $(shell which goexec))	
+	go get -u github.com/shurcooL/goexec
+endif
+	goexec 'http.ListenAndServe(`:9999`, http.FileServer(http.Dir(`.`)))'
+
+static/wasm_exec.js:
+	cp "$(shell go env GOROOT)/misc/wasm/wasm_exec.js" static
+
+static/main.wasm: main.go
+	GO111MODULE=auto GOOS=js GOARCH=wasm go build -o static/main.wasm .
\ No newline at end of file
diff --git a/demo-wasm/manipulate-dom/index.html b/demo-wasm/manipulate-dom/index.html
new file mode 100644
index 0000000..60f2e5a
--- /dev/null
+++ b/demo-wasm/manipulate-dom/index.html
@@ -0,0 +1,18 @@
+<html>
+
+<head>
+    <script src="static/wasm_exec.js"></script>
+    <script>
+        const go = new Go();
+        WebAssembly.instantiateStreaming(fetch("static/main.wasm"), go.importObject)
+            .then((result) => go.run(result.instance));
+    </script>
+</head>
+
+<body>
+    <input id="num" type="number" />
+    <button id="btn">Click</button>
+    <p id="ans">1</p>
+</body>
+
+</html>
\ No newline at end of file
diff --git a/demo-wasm/manipulate-dom/main.go b/demo-wasm/manipulate-dom/main.go
new file mode 100644
index 0000000..618cd85
--- /dev/null
+++ b/demo-wasm/manipulate-dom/main.go
@@ -0,0 +1,34 @@
+package main
+
+import (
+	"strconv"
+	"syscall/js"
+)
+
+func fib(i int) int {
+	if i == 0 || i == 1 {
+		return 1
+	}
+	return fib(i-1) + fib(i-2)
+}
+
+var (
+	document = js.Global().Get("document")
+	numEle   = document.Call("getElementById", "num")
+	ansEle   = document.Call("getElementById", "ans")
+	btnEle   = js.Global().Get("btn")
+)
+
+func fibFunc(this js.Value, args []js.Value) interface{} {
+	v := numEle.Get("value")
+	if num, err := strconv.Atoi(v.String()); err == nil {
+		ansEle.Set("innerHTML", js.ValueOf(fib(num)))
+	}
+	return nil
+}
+
+func main() {
+	done := make(chan int, 0)
+	btnEle.Call("addEventListener", "click", js.FuncOf(fibFunc))
+	<-done
+}
diff --git a/demo-wasm/register-functions/Makefile b/demo-wasm/register-functions/Makefile
new file mode 100644
index 0000000..234573b
--- /dev/null
+++ b/demo-wasm/register-functions/Makefile
@@ -0,0 +1,11 @@
+all: static/main.wasm static/wasm_exec.js
+ifeq (, $(shell which goexec))	
+	go get -u github.com/shurcooL/goexec
+endif
+	goexec 'http.ListenAndServe(`:9999`, http.FileServer(http.Dir(`.`)))'
+
+static/wasm_exec.js:
+	cp "$(shell go env GOROOT)/misc/wasm/wasm_exec.js" static
+
+static/main.wasm: main.go
+	GO111MODULE=auto GOOS=js GOARCH=wasm go build -o static/main.wasm .
\ No newline at end of file
diff --git a/demo-wasm/register-functions/index.html b/demo-wasm/register-functions/index.html
new file mode 100644
index 0000000..9cc865c
--- /dev/null
+++ b/demo-wasm/register-functions/index.html
@@ -0,0 +1,18 @@
+<html>
+
+<head>
+    <script src="static/wasm_exec.js"></script>
+    <script>
+        const go = new Go();
+        WebAssembly.instantiateStreaming(fetch("static/main.wasm"), go.importObject)
+            .then((result) => go.run(result.instance));
+    </script>
+</head>
+
+<body>
+    <input id="num" type="number" />
+    <button id="btn" onclick="ans.innerHTML=fibFunc(num.value * 1)">Click</button>
+    <p id="ans">1</p>
+</body>
+
+</html>
\ No newline at end of file
diff --git a/demo-wasm/register-functions/main.go b/demo-wasm/register-functions/main.go
new file mode 100644
index 0000000..2e22e78
--- /dev/null
+++ b/demo-wasm/register-functions/main.go
@@ -0,0 +1,21 @@
+// main.go
+package main
+
+import "syscall/js"
+
+func fib(i int) int {
+	if i == 0 || i == 1 {
+		return 1
+	}
+	return fib(i-1) + fib(i-2)
+}
+
+func fibFunc(this js.Value, args []js.Value) interface{} {
+	return js.ValueOf(fib(args[0].Int()))
+}
+
+func main() {
+	done := make(chan int, 0)
+	js.Global().Set("fibFunc", js.FuncOf(fibFunc))
+	<-done
+}

From 6253d09da86f9fb7b6d8acfe0d786f8ff6ec894c Mon Sep 17 00:00:00 2001
From: gzdaijie <gzdaijie@gmail.com>
Date: Sun, 2 Feb 2020 17:17:07 +0800
Subject: [PATCH 014/122] add group & sinks feature for geecache

---
 .../day2-single-node/geecache/byteview.go     | 13 +++
 gee-cache/day2-single-node/geecache/cache.go  | 35 ++++++++
 .../day2-single-node/geecache/geecache.go     | 63 +++++++++++++++
 .../geecache/geecache_test.go                 | 37 +++++++++
 gee-cache/day2-single-node/geecache/go.mod    |  3 +
 .../day2-single-node/geecache/lru/lru.go      | 80 +++++++++++++++++++
 .../day2-single-node/geecache/lru/lru_test.go | 55 +++++++++++++
 gee-cache/day2-single-node/geecache/sinks.go  | 36 +++++++++
 8 files changed, 322 insertions(+)
 create mode 100644 gee-cache/day2-single-node/geecache/byteview.go
 create mode 100644 gee-cache/day2-single-node/geecache/cache.go
 create mode 100644 gee-cache/day2-single-node/geecache/geecache.go
 create mode 100644 gee-cache/day2-single-node/geecache/geecache_test.go
 create mode 100644 gee-cache/day2-single-node/geecache/go.mod
 create mode 100644 gee-cache/day2-single-node/geecache/lru/lru.go
 create mode 100644 gee-cache/day2-single-node/geecache/lru/lru_test.go
 create mode 100644 gee-cache/day2-single-node/geecache/sinks.go

diff --git a/gee-cache/day2-single-node/geecache/byteview.go b/gee-cache/day2-single-node/geecache/byteview.go
new file mode 100644
index 0000000..b67fe3c
--- /dev/null
+++ b/gee-cache/day2-single-node/geecache/byteview.go
@@ -0,0 +1,13 @@
+package geecache
+
+type ByteView struct {
+	b []byte
+}
+
+func (v ByteView) Len() int {
+	return len(v.b)
+}
+
+func (v ByteView) view() {
+
+}
diff --git a/gee-cache/day2-single-node/geecache/cache.go b/gee-cache/day2-single-node/geecache/cache.go
new file mode 100644
index 0000000..703d033
--- /dev/null
+++ b/gee-cache/day2-single-node/geecache/cache.go
@@ -0,0 +1,35 @@
+package geecache
+
+import (
+	"geecache/lru"
+	"sync"
+)
+
+type cache struct {
+	mu         sync.RWMutex
+	lru        *lru.Cache
+	cacheBytes int64
+}
+
+func (c *cache) add(key string, value ByteView) {
+	c.mu.RLock()
+	defer c.mu.RUnlock()
+	if c.lru == nil {
+		c.lru = lru.New(c.cacheBytes, nil)
+	}
+	c.lru.Add(key, value)
+}
+
+func (c *cache) get(key string) (value ByteView, ok bool) {
+	c.mu.RLock()
+	defer c.mu.RUnlock()
+	if c.lru == nil {
+		return
+	}
+
+	if v, ok := c.lru.Get(key); ok {
+		return v.(ByteView), ok
+	}
+
+	return
+}
diff --git a/gee-cache/day2-single-node/geecache/geecache.go b/gee-cache/day2-single-node/geecache/geecache.go
new file mode 100644
index 0000000..5a3214c
--- /dev/null
+++ b/gee-cache/day2-single-node/geecache/geecache.go
@@ -0,0 +1,63 @@
+package geecache
+
+import "errors"
+
+type Group struct {
+	name      string
+	getter    Getter
+	mainCache cache
+}
+
+type GetterFunc func(key string, dest Sink) error
+
+func (f GetterFunc) Get(key string, dest Sink) error {
+	return f(key, dest)
+}
+
+type Getter interface {
+	Get(key string, dest Sink) error
+}
+
+func NewGroup(name string, cacheBytes int64, getter Getter) *Group {
+	if getter == nil {
+		panic("nil Getter")
+	}
+	return &Group{
+		name:      name,
+		getter:    getter,
+		mainCache: cache{cacheBytes: cacheBytes},
+	}
+}
+
+func (g *Group) load(key string, dest Sink) (ByteView, error) {
+	value, err := g.getLocally(key, dest)
+	if err != nil {
+		return value, err
+	}
+
+	g.populateCache(key, value)
+	return value, nil
+}
+
+func (g *Group) getLocally(key string, dest Sink) (ByteView, error) {
+	if err := g.getter.Get(key, dest); err != nil {
+		return ByteView{}, err
+	}
+	return dest.view()
+}
+
+func (g *Group) populateCache(key string, value ByteView) {
+	g.mainCache.add(key, value)
+}
+
+func (g *Group) Get(key string, dest Sink) error {
+	if dest == nil {
+		return errors.New("groupcache: nil dest Sink")
+	}
+	if v, ok := g.mainCache.get(key); ok {
+		return dest.SetBytes(v.b)
+	}
+
+	_, err := g.load(key, dest)
+	return err
+}
diff --git a/gee-cache/day2-single-node/geecache/geecache_test.go b/gee-cache/day2-single-node/geecache/geecache_test.go
new file mode 100644
index 0000000..f4e5299
--- /dev/null
+++ b/gee-cache/day2-single-node/geecache/geecache_test.go
@@ -0,0 +1,37 @@
+package geecache
+
+import (
+	"errors"
+	"fmt"
+	"log"
+	"testing"
+)
+
+var db = map[string]string{
+	"Tom":  "123",
+	"Jack": "456",
+	"Sam":  "567",
+}
+
+func TestGet(t *testing.T) {
+	gee := NewGroup("demo", 2<<10, GetterFunc(func(key string, dest Sink) error {
+		log.Printf("search key %s", key)
+		if v, ok := db[key]; ok {
+			return dest.SetBytes([]byte(v))
+		}
+		return errors.New(fmt.Sprintf("%s not exist", key))
+	}))
+
+	var dst []byte
+	dest := AllocatingByteSliceSink(&dst)
+
+	for k, v := range db {
+		if err := gee.Get(k, dest); err != nil || string(dst) != v {
+			t.Fatal("failed to get value of Tom")
+		}
+	}
+
+	if err := gee.Get("unknown", dest); err == nil {
+		t.Fatalf("the value of unknow should be empty, but %s got", string(dst))
+	}
+}
diff --git a/gee-cache/day2-single-node/geecache/go.mod b/gee-cache/day2-single-node/geecache/go.mod
new file mode 100644
index 0000000..f9d454e
--- /dev/null
+++ b/gee-cache/day2-single-node/geecache/go.mod
@@ -0,0 +1,3 @@
+module geecache
+
+go 1.13
diff --git a/gee-cache/day2-single-node/geecache/lru/lru.go b/gee-cache/day2-single-node/geecache/lru/lru.go
new file mode 100644
index 0000000..906c9da
--- /dev/null
+++ b/gee-cache/day2-single-node/geecache/lru/lru.go
@@ -0,0 +1,80 @@
+package lru
+
+import "container/list"
+
+// Cache is a LRU cache. It is not safe for concurrent access.
+type Cache struct {
+	maxBytes int64
+	nbytes   int64
+	ll       *list.List
+	cache    map[string]*list.Element
+	// optional and executed when an entry is purged.
+	OnEvicted func(key string, value Value)
+}
+
+type entry struct {
+	key   string
+	value Value
+}
+
+// Value is optional interface for the value
+// if it's not implemented, use unsafe.Sizeof to count
+type Value interface {
+	Len() int // count how many bytes it takes
+}
+
+// New is the Constructor of Cache
+func New(maxBytes int64, onEvicted func(string, Value)) *Cache {
+	return &Cache{
+		maxBytes:  maxBytes,
+		ll:        list.New(),
+		cache:     make(map[string]*list.Element),
+		OnEvicted: onEvicted,
+	}
+}
+
+// Add adds a value to the cache.
+func (c *Cache) Add(key string, value Value) {
+	if ele, ok := c.cache[key]; ok {
+		c.ll.MoveToFront(ele)
+		kv := ele.Value.(*entry)
+		kv.value = value
+		return
+	}
+	ele := c.ll.PushFront(&entry{key, value})
+	c.cache[key] = ele
+	c.nbytes += int64(len(key)) + int64(value.Len())
+
+	for c.maxBytes != 0 && c.maxBytes < c.nbytes {
+		c.RemoveOldest()
+	}
+}
+
+// Get look ups a key's value
+func (c *Cache) Get(key string) (value Value, ok bool) {
+	if ele, ok := c.cache[key]; ok {
+		c.ll.MoveToFront(ele)
+		kv := ele.Value.(*entry)
+		return kv.value, true
+	}
+	return
+}
+
+// RemoveOldest removes the oldest item
+func (c *Cache) RemoveOldest() {
+	ele := c.ll.Back()
+	if ele != nil {
+		c.ll.Remove(ele)
+		kv := ele.Value.(*entry)
+		delete(c.cache, kv.key)
+		c.nbytes -= int64(len(kv.key)) + int64(kv.value.Len())
+		if c.OnEvicted != nil {
+			c.OnEvicted(kv.key, kv.value)
+		}
+	}
+}
+
+// Len the number of cache entries
+func (c *Cache) Len() int {
+	return c.ll.Len()
+}
diff --git a/gee-cache/day2-single-node/geecache/lru/lru_test.go b/gee-cache/day2-single-node/geecache/lru/lru_test.go
new file mode 100644
index 0000000..7308322
--- /dev/null
+++ b/gee-cache/day2-single-node/geecache/lru/lru_test.go
@@ -0,0 +1,55 @@
+package lru
+
+import (
+	"reflect"
+	"testing"
+)
+
+type String string
+
+func (d String) Len() int {
+	return len(d)
+}
+
+func TestGet(t *testing.T) {
+	lru := New(int64(0), nil)
+	lru.Add("key1", String("1234"))
+	if v, ok := lru.Get("key1"); !ok || string(v.(String)) != "1234" {
+		t.Fatalf("cache hit key1=1234 failed")
+	}
+	if _, ok := lru.Get("key2"); ok {
+		t.Fatalf("cache miss key2 failed")
+	}
+}
+
+func TestRemoveoldest(t *testing.T) {
+	k1, k2, k3 := "key1", "key2", "k3"
+	v1, v2, v3 := "value1", "value2", "v3"
+	cap := len(k1 + k2 + v1 + v2)
+	lru := New(int64(cap), nil)
+	lru.Add(k1, String(v1))
+	lru.Add(k2, String(v2))
+	lru.Add(k3, String(v3))
+
+	if _, ok := lru.Get("key1"); ok || lru.Len() != 2 {
+		t.Fatalf("Removeoldest key1 failed")
+	}
+}
+
+func TestOnEvicted(t *testing.T) {
+	keys := make([]string, 0)
+	callback := func(key string, value Value) {
+		keys = append(keys, key)
+	}
+	lru := New(int64(10), callback)
+	lru.Add("key1", String("123456"))
+	lru.Add("k2", String("k2"))
+	lru.Add("k3", String("k3"))
+	lru.Add("k4", String("k4"))
+
+	expect := []string{"key1", "k2"}
+
+	if !reflect.DeepEqual(expect, keys) {
+		t.Fatalf("Call OnEvicted failed, expect keys equals to %s", expect)
+	}
+}
diff --git a/gee-cache/day2-single-node/geecache/sinks.go b/gee-cache/day2-single-node/geecache/sinks.go
new file mode 100644
index 0000000..6e528c6
--- /dev/null
+++ b/gee-cache/day2-single-node/geecache/sinks.go
@@ -0,0 +1,36 @@
+package geecache
+
+import "errors"
+
+type Sink interface {
+	SetBytes(v []byte) error
+	view() (ByteView, error)
+}
+
+type allocBytesSink struct {
+	dst *[]byte
+	v   ByteView
+}
+
+func AllocatingByteSliceSink(dst *[]byte) Sink {
+	return &allocBytesSink{dst: dst}
+}
+
+func cloneBytes(b []byte) []byte {
+	c := make([]byte, len(b))
+	copy(c, b)
+	return c
+}
+
+func (s *allocBytesSink) SetBytes(b []byte) error {
+	*s.dst = cloneBytes(b)
+	s.v.b = b
+	return nil
+}
+
+func (s *allocBytesSink) view() (ByteView, error) {
+	if s.v.b == nil {
+		return ByteView{}, errors.New("byteview not set")
+	}
+	return s.v, nil
+}

From 3091a10a7859ec019e539474bca554b9e10ac43a Mon Sep 17 00:00:00 2001
From: gzdaijie <gzdaijie@163.com>
Date: Mon, 3 Feb 2020 00:39:21 +0800
Subject: [PATCH 015/122] remove sinks

---
 .../day2-single-node/geecache/byteview.go     | 10 +++-
 .../day2-single-node/geecache/geecache.go     | 58 +++++++++----------
 .../geecache/geecache_test.go                 | 17 +++---
 gee-cache/day2-single-node/geecache/sinks.go  | 36 ------------
 4 files changed, 44 insertions(+), 77 deletions(-)
 delete mode 100644 gee-cache/day2-single-node/geecache/sinks.go

diff --git a/gee-cache/day2-single-node/geecache/byteview.go b/gee-cache/day2-single-node/geecache/byteview.go
index b67fe3c..a51394f 100644
--- a/gee-cache/day2-single-node/geecache/byteview.go
+++ b/gee-cache/day2-single-node/geecache/byteview.go
@@ -1,13 +1,21 @@
 package geecache
 
+// A ByteView holds an immutable view of bytes.
 type ByteView struct {
 	b []byte
 }
 
+// Len returns the view's length
 func (v ByteView) Len() int {
 	return len(v.b)
 }
 
-func (v ByteView) view() {
+// ByteSlice returns a copy of the data as a byte slice.
+func (v ByteView) ByteSlice() []byte {
+	return cloneBytes(v.b)
+}
 
+// String returns the data as a string, making a copy if necessary.
+func (v ByteView) String() string {
+	return string(v.b)
 }
diff --git a/gee-cache/day2-single-node/geecache/geecache.go b/gee-cache/day2-single-node/geecache/geecache.go
index 5a3214c..2b51565 100644
--- a/gee-cache/day2-single-node/geecache/geecache.go
+++ b/gee-cache/day2-single-node/geecache/geecache.go
@@ -1,23 +1,26 @@
 package geecache
 
-import "errors"
-
+// A Group is a cache namespace and associated data loaded spread over
 type Group struct {
 	name      string
 	getter    Getter
 	mainCache cache
 }
 
-type GetterFunc func(key string, dest Sink) error
-
-func (f GetterFunc) Get(key string, dest Sink) error {
-	return f(key, dest)
+// A Getter loads data for a key.
+type Getter interface {
+	Get(key string) ([]byte, error)
 }
 
-type Getter interface {
-	Get(key string, dest Sink) error
+// A GetterFunc implements Getter with a function.
+type GetterFunc func(key string) ([]byte, error)
+
+// Get implements Getter interface function
+func (f GetterFunc) Get(key string) ([]byte, error) {
+	return f(key)
 }
 
+// NewGroup create a new instance of Group
 func NewGroup(name string, cacheBytes int64, getter Getter) *Group {
 	if getter == nil {
 		panic("nil Getter")
@@ -29,35 +32,30 @@ func NewGroup(name string, cacheBytes int64, getter Getter) *Group {
 	}
 }
 
-func (g *Group) load(key string, dest Sink) (ByteView, error) {
-	value, err := g.getLocally(key, dest)
-	if err != nil {
-		return value, err
+// Get value for a key from cache
+func (g *Group) Get(key string) (ByteView, error) {
+	if v, ok := g.mainCache.get(key); ok {
+		return v, nil
 	}
 
-	g.populateCache(key, value)
-	return value, nil
+	return g.load(key)
+}
+
+func cloneBytes(b []byte) []byte {
+	c := make([]byte, len(b))
+	copy(c, b)
+	return c
 }
 
-func (g *Group) getLocally(key string, dest Sink) (ByteView, error) {
-	if err := g.getter.Get(key, dest); err != nil {
-		return ByteView{}, err
+func (g *Group) load(key string) (value ByteView, err error) {
+	bytes, err := g.getter.Get(key)
+	if err == nil {
+		value = ByteView{cloneBytes(bytes)}
+		g.populateCache(key, value)
 	}
-	return dest.view()
+	return
 }
 
 func (g *Group) populateCache(key string, value ByteView) {
 	g.mainCache.add(key, value)
 }
-
-func (g *Group) Get(key string, dest Sink) error {
-	if dest == nil {
-		return errors.New("groupcache: nil dest Sink")
-	}
-	if v, ok := g.mainCache.get(key); ok {
-		return dest.SetBytes(v.b)
-	}
-
-	_, err := g.load(key, dest)
-	return err
-}
diff --git a/gee-cache/day2-single-node/geecache/geecache_test.go b/gee-cache/day2-single-node/geecache/geecache_test.go
index f4e5299..64feb90 100644
--- a/gee-cache/day2-single-node/geecache/geecache_test.go
+++ b/gee-cache/day2-single-node/geecache/geecache_test.go
@@ -1,7 +1,6 @@
 package geecache
 
 import (
-	"errors"
 	"fmt"
 	"log"
 	"testing"
@@ -14,24 +13,22 @@ var db = map[string]string{
 }
 
 func TestGet(t *testing.T) {
-	gee := NewGroup("demo", 2<<10, GetterFunc(func(key string, dest Sink) error {
+	gee := NewGroup("demo", 2<<10, GetterFunc(func(key string) ([]byte, error) {
 		log.Printf("search key %s", key)
 		if v, ok := db[key]; ok {
-			return dest.SetBytes([]byte(v))
+			return []byte(v), nil
 		}
-		return errors.New(fmt.Sprintf("%s not exist", key))
+		return nil, fmt.Errorf("%s not exist", key)
 	}))
 
-	var dst []byte
-	dest := AllocatingByteSliceSink(&dst)
-
 	for k, v := range db {
-		if err := gee.Get(k, dest); err != nil || string(dst) != v {
+		view, err := gee.Get(k)
+		if err != nil || view.String() != v {
 			t.Fatal("failed to get value of Tom")
 		}
 	}
 
-	if err := gee.Get("unknown", dest); err == nil {
-		t.Fatalf("the value of unknow should be empty, but %s got", string(dst))
+	if view, err := gee.Get("unknown"); err == nil {
+		t.Fatalf("the value of unknow should be empty, but %s got", view)
 	}
 }
diff --git a/gee-cache/day2-single-node/geecache/sinks.go b/gee-cache/day2-single-node/geecache/sinks.go
deleted file mode 100644
index 6e528c6..0000000
--- a/gee-cache/day2-single-node/geecache/sinks.go
+++ /dev/null
@@ -1,36 +0,0 @@
-package geecache
-
-import "errors"
-
-type Sink interface {
-	SetBytes(v []byte) error
-	view() (ByteView, error)
-}
-
-type allocBytesSink struct {
-	dst *[]byte
-	v   ByteView
-}
-
-func AllocatingByteSliceSink(dst *[]byte) Sink {
-	return &allocBytesSink{dst: dst}
-}
-
-func cloneBytes(b []byte) []byte {
-	c := make([]byte, len(b))
-	copy(c, b)
-	return c
-}
-
-func (s *allocBytesSink) SetBytes(b []byte) error {
-	*s.dst = cloneBytes(b)
-	s.v.b = b
-	return nil
-}
-
-func (s *allocBytesSink) view() (ByteView, error) {
-	if s.v.b == nil {
-		return ByteView{}, errors.New("byteview not set")
-	}
-	return s.v, nil
-}

From c822a1ab029a3ee24972f0884a6010f805b675de Mon Sep 17 00:00:00 2001
From: gzdaijie <gzdaijie@163.com>
Date: Mon, 3 Feb 2020 00:45:50 +0800
Subject: [PATCH 016/122] fix lru Value comments

---
 gee-cache/day1-lru/geecache/lru/lru.go         | 5 ++---
 gee-cache/day2-single-node/geecache/lru/lru.go | 5 ++---
 2 files changed, 4 insertions(+), 6 deletions(-)

diff --git a/gee-cache/day1-lru/geecache/lru/lru.go b/gee-cache/day1-lru/geecache/lru/lru.go
index 906c9da..81eee43 100644
--- a/gee-cache/day1-lru/geecache/lru/lru.go
+++ b/gee-cache/day1-lru/geecache/lru/lru.go
@@ -17,10 +17,9 @@ type entry struct {
 	value Value
 }
 
-// Value is optional interface for the value
-// if it's not implemented, use unsafe.Sizeof to count
+// Value use Len to count how many bytes it takes
 type Value interface {
-	Len() int // count how many bytes it takes
+	Len() int
 }
 
 // New is the Constructor of Cache
diff --git a/gee-cache/day2-single-node/geecache/lru/lru.go b/gee-cache/day2-single-node/geecache/lru/lru.go
index 906c9da..81eee43 100644
--- a/gee-cache/day2-single-node/geecache/lru/lru.go
+++ b/gee-cache/day2-single-node/geecache/lru/lru.go
@@ -17,10 +17,9 @@ type entry struct {
 	value Value
 }
 
-// Value is optional interface for the value
-// if it's not implemented, use unsafe.Sizeof to count
+// Value use Len to count how many bytes it takes
 type Value interface {
-	Len() int // count how many bytes it takes
+	Len() int
 }
 
 // New is the Constructor of Cache

From cd12513aebeead6d2b3be12ab721dd8384468b74 Mon Sep 17 00:00:00 2001
From: gzdaijie <gzdaijie@163.com>
Date: Mon, 3 Feb 2020 00:59:05 +0800
Subject: [PATCH 017/122] add geecache day1 & day2 to README

---
 README.md | 11 ++++++++---
 1 file changed, 8 insertions(+), 3 deletions(-)

diff --git a/README.md b/README.md
index 6b5b664..0aa3323 100644
--- a/README.md
+++ b/README.md
@@ -18,11 +18,16 @@ Gee 的设计与实现参考了Gin，[Go Gin简明教程](https://geektutu.com/p
 - [第六天：HTML模板(Template)](https://geektutu.com/post/gee-day6.html)，[Code - Github](gee-web/day6-template)
 - [第七天：错误恢复(Panic Recover)](https://geektutu.com/post/gee-day7.html)，[Code - Github](gee-web/day7-panic-recover)
 
+## 7天用Go从零实现分布式缓存GeeCache
+
+- 第一天：LRU 缓存策略，[Code - Github](gee-cache/day1-lru)
+- 第二天：单节点缓存，[Code - Github](gee-cache/day2-single-node)
+
 ## WebAssembly Demo
 
 #### [教程地址](https://geektutu.com/post/quick-go-wasm.html)
 
 - [1. Hello World](demo-wasm/hello-world)
-- [2. 注册函数](demo-wasm/hello-world)
-- [3. 操作 DOM](demo-wasm/hello-world)
-- [4. 回调函数](demo-wasm/hello-world)
\ No newline at end of file
+- [2. 注册函数](demo-wasm/register-functions)
+- [3. 操作 DOM](demo-wasm/manipulate-dom)
+- [4. 回调函数](demo-wasm/callback)
\ No newline at end of file

From 021ec73de6a5731db6fa5b79734e66f802a55a49 Mon Sep 17 00:00:00 2001
From: gzdaijie <gzdaijie@163.com>
Date: Mon, 3 Feb 2020 17:59:18 +0800
Subject: [PATCH 018/122] day3 add http server for geecache

---
 .../day2-single-node/geecache/geecache.go     | 22 ++++-
 .../geecache/geecache_test.go                 | 32 +++++---
 .../day3-http-server/geecache/byteview.go     | 21 +++++
 gee-cache/day3-http-server/geecache/cache.go  | 35 ++++++++
 .../day3-http-server/geecache/geecache.go     | 81 +++++++++++++++++++
 .../geecache/geecache_test.go                 | 48 +++++++++++
 gee-cache/day3-http-server/geecache/go.mod    |  3 +
 gee-cache/day3-http-server/geecache/http.go   | 56 +++++++++++++
 .../day3-http-server/geecache/lru/lru.go      | 79 ++++++++++++++++++
 .../day3-http-server/geecache/lru/lru_test.go | 55 +++++++++++++
 gee-cache/day3-http-server/go.mod             |  7 ++
 gee-cache/day3-http-server/main.go            | 30 +++++++
 12 files changed, 459 insertions(+), 10 deletions(-)
 create mode 100644 gee-cache/day3-http-server/geecache/byteview.go
 create mode 100644 gee-cache/day3-http-server/geecache/cache.go
 create mode 100644 gee-cache/day3-http-server/geecache/geecache.go
 create mode 100644 gee-cache/day3-http-server/geecache/geecache_test.go
 create mode 100644 gee-cache/day3-http-server/geecache/go.mod
 create mode 100644 gee-cache/day3-http-server/geecache/http.go
 create mode 100644 gee-cache/day3-http-server/geecache/lru/lru.go
 create mode 100644 gee-cache/day3-http-server/geecache/lru/lru_test.go
 create mode 100644 gee-cache/day3-http-server/go.mod
 create mode 100644 gee-cache/day3-http-server/main.go

diff --git a/gee-cache/day2-single-node/geecache/geecache.go b/gee-cache/day2-single-node/geecache/geecache.go
index 2b51565..4273256 100644
--- a/gee-cache/day2-single-node/geecache/geecache.go
+++ b/gee-cache/day2-single-node/geecache/geecache.go
@@ -1,5 +1,7 @@
 package geecache
 
+import "sync"
+
 // A Group is a cache namespace and associated data loaded spread over
 type Group struct {
 	name      string
@@ -20,16 +22,34 @@ func (f GetterFunc) Get(key string) ([]byte, error) {
 	return f(key)
 }
 
+var (
+	mu     sync.RWMutex
+	groups = make(map[string]*Group)
+)
+
 // NewGroup create a new instance of Group
 func NewGroup(name string, cacheBytes int64, getter Getter) *Group {
 	if getter == nil {
 		panic("nil Getter")
 	}
-	return &Group{
+	mu.Lock()
+	defer mu.Unlock()
+	g := &Group{
 		name:      name,
 		getter:    getter,
 		mainCache: cache{cacheBytes: cacheBytes},
 	}
+	groups[name] = g
+	return g
+}
+
+// GetGroup returns the named group previously created with NewGroup, or
+// nil if there's no such group.
+func GetGroup(name string) *Group {
+	mu.RLock()
+	g := groups[name]
+	mu.RUnlock()
+	return g
 }
 
 // Get value for a key from cache
diff --git a/gee-cache/day2-single-node/geecache/geecache_test.go b/gee-cache/day2-single-node/geecache/geecache_test.go
index 64feb90..2bffb3f 100644
--- a/gee-cache/day2-single-node/geecache/geecache_test.go
+++ b/gee-cache/day2-single-node/geecache/geecache_test.go
@@ -7,19 +7,20 @@ import (
 )
 
 var db = map[string]string{
-	"Tom":  "123",
-	"Jack": "456",
+	"Tom":  "630",
+	"Jack": "589",
 	"Sam":  "567",
 }
 
 func TestGet(t *testing.T) {
-	gee := NewGroup("demo", 2<<10, GetterFunc(func(key string) ([]byte, error) {
-		log.Printf("search key %s", key)
-		if v, ok := db[key]; ok {
-			return []byte(v), nil
-		}
-		return nil, fmt.Errorf("%s not exist", key)
-	}))
+	gee := NewGroup("scores", 2<<10, GetterFunc(
+		func(key string) ([]byte, error) {
+			log.Println("[group scores] search key", key)
+			if v, ok := db[key]; ok {
+				return []byte(v), nil
+			}
+			return nil, fmt.Errorf("%s not exist", key)
+		}))
 
 	for k, v := range db {
 		view, err := gee.Get(k)
@@ -32,3 +33,16 @@ func TestGet(t *testing.T) {
 		t.Fatalf("the value of unknow should be empty, but %s got", view)
 	}
 }
+
+func TestGetGroup(t *testing.T) {
+	groupName := "scores"
+	NewGroup(groupName, 2<<10, GetterFunc(
+		func(key string) (bytes []byte, err error) { return }))
+	if group := GetGroup(groupName); group == nil || group.name != groupName {
+		t.Fatalf("group %s not exist", groupName)
+	}
+
+	if group := GetGroup(groupName + "111"); group != nil {
+		t.Fatalf("expect nil, but %s got", group.name)
+	}
+}
diff --git a/gee-cache/day3-http-server/geecache/byteview.go b/gee-cache/day3-http-server/geecache/byteview.go
new file mode 100644
index 0000000..a51394f
--- /dev/null
+++ b/gee-cache/day3-http-server/geecache/byteview.go
@@ -0,0 +1,21 @@
+package geecache
+
+// A ByteView holds an immutable view of bytes.
+type ByteView struct {
+	b []byte
+}
+
+// Len returns the view's length
+func (v ByteView) Len() int {
+	return len(v.b)
+}
+
+// ByteSlice returns a copy of the data as a byte slice.
+func (v ByteView) ByteSlice() []byte {
+	return cloneBytes(v.b)
+}
+
+// String returns the data as a string, making a copy if necessary.
+func (v ByteView) String() string {
+	return string(v.b)
+}
diff --git a/gee-cache/day3-http-server/geecache/cache.go b/gee-cache/day3-http-server/geecache/cache.go
new file mode 100644
index 0000000..703d033
--- /dev/null
+++ b/gee-cache/day3-http-server/geecache/cache.go
@@ -0,0 +1,35 @@
+package geecache
+
+import (
+	"geecache/lru"
+	"sync"
+)
+
+type cache struct {
+	mu         sync.RWMutex
+	lru        *lru.Cache
+	cacheBytes int64
+}
+
+func (c *cache) add(key string, value ByteView) {
+	c.mu.RLock()
+	defer c.mu.RUnlock()
+	if c.lru == nil {
+		c.lru = lru.New(c.cacheBytes, nil)
+	}
+	c.lru.Add(key, value)
+}
+
+func (c *cache) get(key string) (value ByteView, ok bool) {
+	c.mu.RLock()
+	defer c.mu.RUnlock()
+	if c.lru == nil {
+		return
+	}
+
+	if v, ok := c.lru.Get(key); ok {
+		return v.(ByteView), ok
+	}
+
+	return
+}
diff --git a/gee-cache/day3-http-server/geecache/geecache.go b/gee-cache/day3-http-server/geecache/geecache.go
new file mode 100644
index 0000000..4273256
--- /dev/null
+++ b/gee-cache/day3-http-server/geecache/geecache.go
@@ -0,0 +1,81 @@
+package geecache
+
+import "sync"
+
+// A Group is a cache namespace and associated data loaded spread over
+type Group struct {
+	name      string
+	getter    Getter
+	mainCache cache
+}
+
+// A Getter loads data for a key.
+type Getter interface {
+	Get(key string) ([]byte, error)
+}
+
+// A GetterFunc implements Getter with a function.
+type GetterFunc func(key string) ([]byte, error)
+
+// Get implements Getter interface function
+func (f GetterFunc) Get(key string) ([]byte, error) {
+	return f(key)
+}
+
+var (
+	mu     sync.RWMutex
+	groups = make(map[string]*Group)
+)
+
+// NewGroup create a new instance of Group
+func NewGroup(name string, cacheBytes int64, getter Getter) *Group {
+	if getter == nil {
+		panic("nil Getter")
+	}
+	mu.Lock()
+	defer mu.Unlock()
+	g := &Group{
+		name:      name,
+		getter:    getter,
+		mainCache: cache{cacheBytes: cacheBytes},
+	}
+	groups[name] = g
+	return g
+}
+
+// GetGroup returns the named group previously created with NewGroup, or
+// nil if there's no such group.
+func GetGroup(name string) *Group {
+	mu.RLock()
+	g := groups[name]
+	mu.RUnlock()
+	return g
+}
+
+// Get value for a key from cache
+func (g *Group) Get(key string) (ByteView, error) {
+	if v, ok := g.mainCache.get(key); ok {
+		return v, nil
+	}
+
+	return g.load(key)
+}
+
+func cloneBytes(b []byte) []byte {
+	c := make([]byte, len(b))
+	copy(c, b)
+	return c
+}
+
+func (g *Group) load(key string) (value ByteView, err error) {
+	bytes, err := g.getter.Get(key)
+	if err == nil {
+		value = ByteView{cloneBytes(bytes)}
+		g.populateCache(key, value)
+	}
+	return
+}
+
+func (g *Group) populateCache(key string, value ByteView) {
+	g.mainCache.add(key, value)
+}
diff --git a/gee-cache/day3-http-server/geecache/geecache_test.go b/gee-cache/day3-http-server/geecache/geecache_test.go
new file mode 100644
index 0000000..2bffb3f
--- /dev/null
+++ b/gee-cache/day3-http-server/geecache/geecache_test.go
@@ -0,0 +1,48 @@
+package geecache
+
+import (
+	"fmt"
+	"log"
+	"testing"
+)
+
+var db = map[string]string{
+	"Tom":  "630",
+	"Jack": "589",
+	"Sam":  "567",
+}
+
+func TestGet(t *testing.T) {
+	gee := NewGroup("scores", 2<<10, GetterFunc(
+		func(key string) ([]byte, error) {
+			log.Println("[group scores] search key", key)
+			if v, ok := db[key]; ok {
+				return []byte(v), nil
+			}
+			return nil, fmt.Errorf("%s not exist", key)
+		}))
+
+	for k, v := range db {
+		view, err := gee.Get(k)
+		if err != nil || view.String() != v {
+			t.Fatal("failed to get value of Tom")
+		}
+	}
+
+	if view, err := gee.Get("unknown"); err == nil {
+		t.Fatalf("the value of unknow should be empty, but %s got", view)
+	}
+}
+
+func TestGetGroup(t *testing.T) {
+	groupName := "scores"
+	NewGroup(groupName, 2<<10, GetterFunc(
+		func(key string) (bytes []byte, err error) { return }))
+	if group := GetGroup(groupName); group == nil || group.name != groupName {
+		t.Fatalf("group %s not exist", groupName)
+	}
+
+	if group := GetGroup(groupName + "111"); group != nil {
+		t.Fatalf("expect nil, but %s got", group.name)
+	}
+}
diff --git a/gee-cache/day3-http-server/geecache/go.mod b/gee-cache/day3-http-server/geecache/go.mod
new file mode 100644
index 0000000..f9d454e
--- /dev/null
+++ b/gee-cache/day3-http-server/geecache/go.mod
@@ -0,0 +1,3 @@
+module geecache
+
+go 1.13
diff --git a/gee-cache/day3-http-server/geecache/http.go b/gee-cache/day3-http-server/geecache/http.go
new file mode 100644
index 0000000..4d33d5d
--- /dev/null
+++ b/gee-cache/day3-http-server/geecache/http.go
@@ -0,0 +1,56 @@
+package geecache
+
+import (
+	"log"
+	"net/http"
+	"strings"
+)
+
+const defaultBasePath = "/_geecache/"
+
+// HTTPPool implements PeerPicker for a pool of HTTP peers.
+type HTTPPool struct {
+	// this peer's base URL, e.g. "https://example.net:8000"
+	self     string
+	basePath string
+}
+
+// NewHTTPPool initializes an HTTP pool of peers, and registers itself as a PeerPicker.
+func NewHTTPPool(self string) *HTTPPool {
+	return &HTTPPool{
+		self:     self,
+		basePath: defaultBasePath,
+	}
+}
+
+// ServeHTTP handle all http requests
+func (p *HTTPPool) ServeHTTP(w http.ResponseWriter, r *http.Request) {
+	if !strings.HasPrefix(r.URL.Path, p.basePath) {
+		panic("HTTPPool serving unexpected path: " + r.URL.Path)
+	}
+	log.Println("[geecache server]", r.Method, r.URL.Path)
+	// /<basepath>/<groupname>/<key> required
+	parts := strings.SplitN(r.URL.Path[len(p.basePath):], "/", 2)
+	if len(parts) != 2 {
+		http.Error(w, "bad request", http.StatusBadRequest)
+		return
+	}
+
+	groupName := parts[0]
+	key := parts[1]
+
+	group := GetGroup(groupName)
+	if group == nil {
+		http.Error(w, "no such group: "+groupName, http.StatusNotFound)
+		return
+	}
+
+	view, err := group.Get(key)
+	if err != nil {
+		http.Error(w, err.Error(), http.StatusInternalServerError)
+		return
+	}
+
+	w.Header().Set("Content-Type", "application/octet-stream")
+	w.Write(view.ByteSlice())
+}
diff --git a/gee-cache/day3-http-server/geecache/lru/lru.go b/gee-cache/day3-http-server/geecache/lru/lru.go
new file mode 100644
index 0000000..81eee43
--- /dev/null
+++ b/gee-cache/day3-http-server/geecache/lru/lru.go
@@ -0,0 +1,79 @@
+package lru
+
+import "container/list"
+
+// Cache is a LRU cache. It is not safe for concurrent access.
+type Cache struct {
+	maxBytes int64
+	nbytes   int64
+	ll       *list.List
+	cache    map[string]*list.Element
+	// optional and executed when an entry is purged.
+	OnEvicted func(key string, value Value)
+}
+
+type entry struct {
+	key   string
+	value Value
+}
+
+// Value use Len to count how many bytes it takes
+type Value interface {
+	Len() int
+}
+
+// New is the Constructor of Cache
+func New(maxBytes int64, onEvicted func(string, Value)) *Cache {
+	return &Cache{
+		maxBytes:  maxBytes,
+		ll:        list.New(),
+		cache:     make(map[string]*list.Element),
+		OnEvicted: onEvicted,
+	}
+}
+
+// Add adds a value to the cache.
+func (c *Cache) Add(key string, value Value) {
+	if ele, ok := c.cache[key]; ok {
+		c.ll.MoveToFront(ele)
+		kv := ele.Value.(*entry)
+		kv.value = value
+		return
+	}
+	ele := c.ll.PushFront(&entry{key, value})
+	c.cache[key] = ele
+	c.nbytes += int64(len(key)) + int64(value.Len())
+
+	for c.maxBytes != 0 && c.maxBytes < c.nbytes {
+		c.RemoveOldest()
+	}
+}
+
+// Get look ups a key's value
+func (c *Cache) Get(key string) (value Value, ok bool) {
+	if ele, ok := c.cache[key]; ok {
+		c.ll.MoveToFront(ele)
+		kv := ele.Value.(*entry)
+		return kv.value, true
+	}
+	return
+}
+
+// RemoveOldest removes the oldest item
+func (c *Cache) RemoveOldest() {
+	ele := c.ll.Back()
+	if ele != nil {
+		c.ll.Remove(ele)
+		kv := ele.Value.(*entry)
+		delete(c.cache, kv.key)
+		c.nbytes -= int64(len(kv.key)) + int64(kv.value.Len())
+		if c.OnEvicted != nil {
+			c.OnEvicted(kv.key, kv.value)
+		}
+	}
+}
+
+// Len the number of cache entries
+func (c *Cache) Len() int {
+	return c.ll.Len()
+}
diff --git a/gee-cache/day3-http-server/geecache/lru/lru_test.go b/gee-cache/day3-http-server/geecache/lru/lru_test.go
new file mode 100644
index 0000000..7308322
--- /dev/null
+++ b/gee-cache/day3-http-server/geecache/lru/lru_test.go
@@ -0,0 +1,55 @@
+package lru
+
+import (
+	"reflect"
+	"testing"
+)
+
+type String string
+
+func (d String) Len() int {
+	return len(d)
+}
+
+func TestGet(t *testing.T) {
+	lru := New(int64(0), nil)
+	lru.Add("key1", String("1234"))
+	if v, ok := lru.Get("key1"); !ok || string(v.(String)) != "1234" {
+		t.Fatalf("cache hit key1=1234 failed")
+	}
+	if _, ok := lru.Get("key2"); ok {
+		t.Fatalf("cache miss key2 failed")
+	}
+}
+
+func TestRemoveoldest(t *testing.T) {
+	k1, k2, k3 := "key1", "key2", "k3"
+	v1, v2, v3 := "value1", "value2", "v3"
+	cap := len(k1 + k2 + v1 + v2)
+	lru := New(int64(cap), nil)
+	lru.Add(k1, String(v1))
+	lru.Add(k2, String(v2))
+	lru.Add(k3, String(v3))
+
+	if _, ok := lru.Get("key1"); ok || lru.Len() != 2 {
+		t.Fatalf("Removeoldest key1 failed")
+	}
+}
+
+func TestOnEvicted(t *testing.T) {
+	keys := make([]string, 0)
+	callback := func(key string, value Value) {
+		keys = append(keys, key)
+	}
+	lru := New(int64(10), callback)
+	lru.Add("key1", String("123456"))
+	lru.Add("k2", String("k2"))
+	lru.Add("k3", String("k3"))
+	lru.Add("k4", String("k4"))
+
+	expect := []string{"key1", "k2"}
+
+	if !reflect.DeepEqual(expect, keys) {
+		t.Fatalf("Call OnEvicted failed, expect keys equals to %s", expect)
+	}
+}
diff --git a/gee-cache/day3-http-server/go.mod b/gee-cache/day3-http-server/go.mod
new file mode 100644
index 0000000..d0fd3ba
--- /dev/null
+++ b/gee-cache/day3-http-server/go.mod
@@ -0,0 +1,7 @@
+module example
+
+go 1.13
+
+require geecache v0.0.0
+
+replace geecache => ./geecache
diff --git a/gee-cache/day3-http-server/main.go b/gee-cache/day3-http-server/main.go
new file mode 100644
index 0000000..570a90a
--- /dev/null
+++ b/gee-cache/day3-http-server/main.go
@@ -0,0 +1,30 @@
+package main
+
+import (
+	"fmt"
+	"geecache"
+	"log"
+	"net/http"
+)
+
+var db = map[string]string{
+	"Tom":  "630",
+	"Jack": "589",
+	"Sam":  "567",
+}
+
+func main() {
+	geecache.NewGroup("scores", 2<<10, geecache.GetterFunc(
+		func(key string) ([]byte, error) {
+			log.Println("[group scores] search key", key)
+			if v, ok := db[key]; ok {
+				return []byte(v), nil
+			}
+			return nil, fmt.Errorf("%s not exist", key)
+		}))
+
+	addr := "localhost:9999"
+	peers := geecache.NewHTTPPool(addr)
+	log.Println("geecache is running at", addr)
+	log.Fatal(http.ListenAndServe(addr, peers))
+}

From 8ac52d7f3904e909c72a3a7bb1e5130f3cdb6285 Mon Sep 17 00:00:00 2001
From: gzdaijie <gzdaijie@163.com>
Date: Mon, 3 Feb 2020 18:39:53 +0800
Subject: [PATCH 019/122] day4 add consistent hash algorithm

---
 .../day4-consistent-hash/geecache/byteview.go | 21 +++++
 .../day4-consistent-hash/geecache/cache.go    | 35 ++++++++
 .../geecache/consistenthash/consistenthash.go | 58 +++++++++++++
 .../consistenthash/consistenthash_test.go     | 43 ++++++++++
 .../day4-consistent-hash/geecache/geecache.go | 81 +++++++++++++++++++
 .../geecache/geecache_test.go                 | 48 +++++++++++
 .../day4-consistent-hash/geecache/go.mod      |  3 +
 .../day4-consistent-hash/geecache/http.go     | 56 +++++++++++++
 .../day4-consistent-hash/geecache/lru/lru.go  | 79 ++++++++++++++++++
 .../geecache/lru/lru_test.go                  | 55 +++++++++++++
 gee-cache/day4-consistent-hash/go.mod         |  7 ++
 gee-cache/day4-consistent-hash/main.go        | 30 +++++++
 12 files changed, 516 insertions(+)
 create mode 100644 gee-cache/day4-consistent-hash/geecache/byteview.go
 create mode 100644 gee-cache/day4-consistent-hash/geecache/cache.go
 create mode 100644 gee-cache/day4-consistent-hash/geecache/consistenthash/consistenthash.go
 create mode 100644 gee-cache/day4-consistent-hash/geecache/consistenthash/consistenthash_test.go
 create mode 100644 gee-cache/day4-consistent-hash/geecache/geecache.go
 create mode 100644 gee-cache/day4-consistent-hash/geecache/geecache_test.go
 create mode 100644 gee-cache/day4-consistent-hash/geecache/go.mod
 create mode 100644 gee-cache/day4-consistent-hash/geecache/http.go
 create mode 100644 gee-cache/day4-consistent-hash/geecache/lru/lru.go
 create mode 100644 gee-cache/day4-consistent-hash/geecache/lru/lru_test.go
 create mode 100644 gee-cache/day4-consistent-hash/go.mod
 create mode 100644 gee-cache/day4-consistent-hash/main.go

diff --git a/gee-cache/day4-consistent-hash/geecache/byteview.go b/gee-cache/day4-consistent-hash/geecache/byteview.go
new file mode 100644
index 0000000..a51394f
--- /dev/null
+++ b/gee-cache/day4-consistent-hash/geecache/byteview.go
@@ -0,0 +1,21 @@
+package geecache
+
+// A ByteView holds an immutable view of bytes.
+type ByteView struct {
+	b []byte
+}
+
+// Len returns the view's length
+func (v ByteView) Len() int {
+	return len(v.b)
+}
+
+// ByteSlice returns a copy of the data as a byte slice.
+func (v ByteView) ByteSlice() []byte {
+	return cloneBytes(v.b)
+}
+
+// String returns the data as a string, making a copy if necessary.
+func (v ByteView) String() string {
+	return string(v.b)
+}
diff --git a/gee-cache/day4-consistent-hash/geecache/cache.go b/gee-cache/day4-consistent-hash/geecache/cache.go
new file mode 100644
index 0000000..703d033
--- /dev/null
+++ b/gee-cache/day4-consistent-hash/geecache/cache.go
@@ -0,0 +1,35 @@
+package geecache
+
+import (
+	"geecache/lru"
+	"sync"
+)
+
+type cache struct {
+	mu         sync.RWMutex
+	lru        *lru.Cache
+	cacheBytes int64
+}
+
+func (c *cache) add(key string, value ByteView) {
+	c.mu.RLock()
+	defer c.mu.RUnlock()
+	if c.lru == nil {
+		c.lru = lru.New(c.cacheBytes, nil)
+	}
+	c.lru.Add(key, value)
+}
+
+func (c *cache) get(key string) (value ByteView, ok bool) {
+	c.mu.RLock()
+	defer c.mu.RUnlock()
+	if c.lru == nil {
+		return
+	}
+
+	if v, ok := c.lru.Get(key); ok {
+		return v.(ByteView), ok
+	}
+
+	return
+}
diff --git a/gee-cache/day4-consistent-hash/geecache/consistenthash/consistenthash.go b/gee-cache/day4-consistent-hash/geecache/consistenthash/consistenthash.go
new file mode 100644
index 0000000..c8c9082
--- /dev/null
+++ b/gee-cache/day4-consistent-hash/geecache/consistenthash/consistenthash.go
@@ -0,0 +1,58 @@
+package consistenthash
+
+import (
+	"hash/crc32"
+	"sort"
+	"strconv"
+)
+
+// Hash maps bytes to uint32
+type Hash func(data []byte) uint32
+
+// Map constains all hashed keys
+type Map struct {
+	hash     Hash
+	replicas int
+	keys     []int // Sorted
+	hashMap  map[int]string
+}
+
+// New creates a Map instance
+func New(replicas int, fn Hash) *Map {
+	m := &Map{
+		replicas: replicas,
+		hash:     fn,
+		hashMap:  make(map[int]string),
+	}
+	if m.hash == nil {
+		m.hash = crc32.ChecksumIEEE
+	}
+	return m
+}
+
+// Add adds some keys to the hash.
+func (m *Map) Add(keys ...string) {
+	for _, key := range keys {
+		for i := 0; i < m.replicas; i++ {
+			hash := int(m.hash([]byte(strconv.Itoa(i) + key)))
+			m.keys = append(m.keys, hash)
+			m.hashMap[hash] = key
+		}
+	}
+	sort.Ints(m.keys)
+}
+
+// Get gets the closest item in the hash to the provided key.
+func (m *Map) Get(key string) string {
+	if len(m.keys) == 0 {
+		return ""
+	}
+
+	hash := int(m.hash([]byte(key)))
+	// Binary search for appropriate replica.
+	idx := sort.Search(len(m.keys), func(i int) bool {
+		return m.keys[i] >= hash
+	})
+
+	return m.hashMap[m.keys[idx%len(m.keys)]]
+}
diff --git a/gee-cache/day4-consistent-hash/geecache/consistenthash/consistenthash_test.go b/gee-cache/day4-consistent-hash/geecache/consistenthash/consistenthash_test.go
new file mode 100644
index 0000000..34e1275
--- /dev/null
+++ b/gee-cache/day4-consistent-hash/geecache/consistenthash/consistenthash_test.go
@@ -0,0 +1,43 @@
+package consistenthash
+
+import (
+	"strconv"
+	"testing"
+)
+
+func TestHashing(t *testing.T) {
+	hash := New(3, func(key []byte) uint32 {
+		i, _ := strconv.Atoi(string(key))
+		return uint32(i)
+	})
+
+	// Given the above hash function, this will give replicas with "hashes":
+	// 2, 4, 6, 12, 14, 16, 22, 24, 26
+	hash.Add("6", "4", "2")
+
+	testCases := map[string]string{
+		"2":  "2",
+		"11": "2",
+		"23": "4",
+		"27": "2",
+	}
+
+	for k, v := range testCases {
+		if hash.Get(k) != v {
+			t.Errorf("Asking for %s, should have yielded %s", k, v)
+		}
+	}
+
+	// Adds 8, 18, 28
+	hash.Add("8")
+
+	// 27 should now map to 8.
+	testCases["27"] = "8"
+
+	for k, v := range testCases {
+		if hash.Get(k) != v {
+			t.Errorf("Asking for %s, should have yielded %s", k, v)
+		}
+	}
+
+}
diff --git a/gee-cache/day4-consistent-hash/geecache/geecache.go b/gee-cache/day4-consistent-hash/geecache/geecache.go
new file mode 100644
index 0000000..4273256
--- /dev/null
+++ b/gee-cache/day4-consistent-hash/geecache/geecache.go
@@ -0,0 +1,81 @@
+package geecache
+
+import "sync"
+
+// A Group is a cache namespace and associated data loaded spread over
+type Group struct {
+	name      string
+	getter    Getter
+	mainCache cache
+}
+
+// A Getter loads data for a key.
+type Getter interface {
+	Get(key string) ([]byte, error)
+}
+
+// A GetterFunc implements Getter with a function.
+type GetterFunc func(key string) ([]byte, error)
+
+// Get implements Getter interface function
+func (f GetterFunc) Get(key string) ([]byte, error) {
+	return f(key)
+}
+
+var (
+	mu     sync.RWMutex
+	groups = make(map[string]*Group)
+)
+
+// NewGroup create a new instance of Group
+func NewGroup(name string, cacheBytes int64, getter Getter) *Group {
+	if getter == nil {
+		panic("nil Getter")
+	}
+	mu.Lock()
+	defer mu.Unlock()
+	g := &Group{
+		name:      name,
+		getter:    getter,
+		mainCache: cache{cacheBytes: cacheBytes},
+	}
+	groups[name] = g
+	return g
+}
+
+// GetGroup returns the named group previously created with NewGroup, or
+// nil if there's no such group.
+func GetGroup(name string) *Group {
+	mu.RLock()
+	g := groups[name]
+	mu.RUnlock()
+	return g
+}
+
+// Get value for a key from cache
+func (g *Group) Get(key string) (ByteView, error) {
+	if v, ok := g.mainCache.get(key); ok {
+		return v, nil
+	}
+
+	return g.load(key)
+}
+
+func cloneBytes(b []byte) []byte {
+	c := make([]byte, len(b))
+	copy(c, b)
+	return c
+}
+
+func (g *Group) load(key string) (value ByteView, err error) {
+	bytes, err := g.getter.Get(key)
+	if err == nil {
+		value = ByteView{cloneBytes(bytes)}
+		g.populateCache(key, value)
+	}
+	return
+}
+
+func (g *Group) populateCache(key string, value ByteView) {
+	g.mainCache.add(key, value)
+}
diff --git a/gee-cache/day4-consistent-hash/geecache/geecache_test.go b/gee-cache/day4-consistent-hash/geecache/geecache_test.go
new file mode 100644
index 0000000..2bffb3f
--- /dev/null
+++ b/gee-cache/day4-consistent-hash/geecache/geecache_test.go
@@ -0,0 +1,48 @@
+package geecache
+
+import (
+	"fmt"
+	"log"
+	"testing"
+)
+
+var db = map[string]string{
+	"Tom":  "630",
+	"Jack": "589",
+	"Sam":  "567",
+}
+
+func TestGet(t *testing.T) {
+	gee := NewGroup("scores", 2<<10, GetterFunc(
+		func(key string) ([]byte, error) {
+			log.Println("[group scores] search key", key)
+			if v, ok := db[key]; ok {
+				return []byte(v), nil
+			}
+			return nil, fmt.Errorf("%s not exist", key)
+		}))
+
+	for k, v := range db {
+		view, err := gee.Get(k)
+		if err != nil || view.String() != v {
+			t.Fatal("failed to get value of Tom")
+		}
+	}
+
+	if view, err := gee.Get("unknown"); err == nil {
+		t.Fatalf("the value of unknow should be empty, but %s got", view)
+	}
+}
+
+func TestGetGroup(t *testing.T) {
+	groupName := "scores"
+	NewGroup(groupName, 2<<10, GetterFunc(
+		func(key string) (bytes []byte, err error) { return }))
+	if group := GetGroup(groupName); group == nil || group.name != groupName {
+		t.Fatalf("group %s not exist", groupName)
+	}
+
+	if group := GetGroup(groupName + "111"); group != nil {
+		t.Fatalf("expect nil, but %s got", group.name)
+	}
+}
diff --git a/gee-cache/day4-consistent-hash/geecache/go.mod b/gee-cache/day4-consistent-hash/geecache/go.mod
new file mode 100644
index 0000000..f9d454e
--- /dev/null
+++ b/gee-cache/day4-consistent-hash/geecache/go.mod
@@ -0,0 +1,3 @@
+module geecache
+
+go 1.13
diff --git a/gee-cache/day4-consistent-hash/geecache/http.go b/gee-cache/day4-consistent-hash/geecache/http.go
new file mode 100644
index 0000000..4d33d5d
--- /dev/null
+++ b/gee-cache/day4-consistent-hash/geecache/http.go
@@ -0,0 +1,56 @@
+package geecache
+
+import (
+	"log"
+	"net/http"
+	"strings"
+)
+
+const defaultBasePath = "/_geecache/"
+
+// HTTPPool implements PeerPicker for a pool of HTTP peers.
+type HTTPPool struct {
+	// this peer's base URL, e.g. "https://example.net:8000"
+	self     string
+	basePath string
+}
+
+// NewHTTPPool initializes an HTTP pool of peers, and registers itself as a PeerPicker.
+func NewHTTPPool(self string) *HTTPPool {
+	return &HTTPPool{
+		self:     self,
+		basePath: defaultBasePath,
+	}
+}
+
+// ServeHTTP handle all http requests
+func (p *HTTPPool) ServeHTTP(w http.ResponseWriter, r *http.Request) {
+	if !strings.HasPrefix(r.URL.Path, p.basePath) {
+		panic("HTTPPool serving unexpected path: " + r.URL.Path)
+	}
+	log.Println("[geecache server]", r.Method, r.URL.Path)
+	// /<basepath>/<groupname>/<key> required
+	parts := strings.SplitN(r.URL.Path[len(p.basePath):], "/", 2)
+	if len(parts) != 2 {
+		http.Error(w, "bad request", http.StatusBadRequest)
+		return
+	}
+
+	groupName := parts[0]
+	key := parts[1]
+
+	group := GetGroup(groupName)
+	if group == nil {
+		http.Error(w, "no such group: "+groupName, http.StatusNotFound)
+		return
+	}
+
+	view, err := group.Get(key)
+	if err != nil {
+		http.Error(w, err.Error(), http.StatusInternalServerError)
+		return
+	}
+
+	w.Header().Set("Content-Type", "application/octet-stream")
+	w.Write(view.ByteSlice())
+}
diff --git a/gee-cache/day4-consistent-hash/geecache/lru/lru.go b/gee-cache/day4-consistent-hash/geecache/lru/lru.go
new file mode 100644
index 0000000..81eee43
--- /dev/null
+++ b/gee-cache/day4-consistent-hash/geecache/lru/lru.go
@@ -0,0 +1,79 @@
+package lru
+
+import "container/list"
+
+// Cache is a LRU cache. It is not safe for concurrent access.
+type Cache struct {
+	maxBytes int64
+	nbytes   int64
+	ll       *list.List
+	cache    map[string]*list.Element
+	// optional and executed when an entry is purged.
+	OnEvicted func(key string, value Value)
+}
+
+type entry struct {
+	key   string
+	value Value
+}
+
+// Value use Len to count how many bytes it takes
+type Value interface {
+	Len() int
+}
+
+// New is the Constructor of Cache
+func New(maxBytes int64, onEvicted func(string, Value)) *Cache {
+	return &Cache{
+		maxBytes:  maxBytes,
+		ll:        list.New(),
+		cache:     make(map[string]*list.Element),
+		OnEvicted: onEvicted,
+	}
+}
+
+// Add adds a value to the cache.
+func (c *Cache) Add(key string, value Value) {
+	if ele, ok := c.cache[key]; ok {
+		c.ll.MoveToFront(ele)
+		kv := ele.Value.(*entry)
+		kv.value = value
+		return
+	}
+	ele := c.ll.PushFront(&entry{key, value})
+	c.cache[key] = ele
+	c.nbytes += int64(len(key)) + int64(value.Len())
+
+	for c.maxBytes != 0 && c.maxBytes < c.nbytes {
+		c.RemoveOldest()
+	}
+}
+
+// Get look ups a key's value
+func (c *Cache) Get(key string) (value Value, ok bool) {
+	if ele, ok := c.cache[key]; ok {
+		c.ll.MoveToFront(ele)
+		kv := ele.Value.(*entry)
+		return kv.value, true
+	}
+	return
+}
+
+// RemoveOldest removes the oldest item
+func (c *Cache) RemoveOldest() {
+	ele := c.ll.Back()
+	if ele != nil {
+		c.ll.Remove(ele)
+		kv := ele.Value.(*entry)
+		delete(c.cache, kv.key)
+		c.nbytes -= int64(len(kv.key)) + int64(kv.value.Len())
+		if c.OnEvicted != nil {
+			c.OnEvicted(kv.key, kv.value)
+		}
+	}
+}
+
+// Len the number of cache entries
+func (c *Cache) Len() int {
+	return c.ll.Len()
+}
diff --git a/gee-cache/day4-consistent-hash/geecache/lru/lru_test.go b/gee-cache/day4-consistent-hash/geecache/lru/lru_test.go
new file mode 100644
index 0000000..7308322
--- /dev/null
+++ b/gee-cache/day4-consistent-hash/geecache/lru/lru_test.go
@@ -0,0 +1,55 @@
+package lru
+
+import (
+	"reflect"
+	"testing"
+)
+
+type String string
+
+func (d String) Len() int {
+	return len(d)
+}
+
+func TestGet(t *testing.T) {
+	lru := New(int64(0), nil)
+	lru.Add("key1", String("1234"))
+	if v, ok := lru.Get("key1"); !ok || string(v.(String)) != "1234" {
+		t.Fatalf("cache hit key1=1234 failed")
+	}
+	if _, ok := lru.Get("key2"); ok {
+		t.Fatalf("cache miss key2 failed")
+	}
+}
+
+func TestRemoveoldest(t *testing.T) {
+	k1, k2, k3 := "key1", "key2", "k3"
+	v1, v2, v3 := "value1", "value2", "v3"
+	cap := len(k1 + k2 + v1 + v2)
+	lru := New(int64(cap), nil)
+	lru.Add(k1, String(v1))
+	lru.Add(k2, String(v2))
+	lru.Add(k3, String(v3))
+
+	if _, ok := lru.Get("key1"); ok || lru.Len() != 2 {
+		t.Fatalf("Removeoldest key1 failed")
+	}
+}
+
+func TestOnEvicted(t *testing.T) {
+	keys := make([]string, 0)
+	callback := func(key string, value Value) {
+		keys = append(keys, key)
+	}
+	lru := New(int64(10), callback)
+	lru.Add("key1", String("123456"))
+	lru.Add("k2", String("k2"))
+	lru.Add("k3", String("k3"))
+	lru.Add("k4", String("k4"))
+
+	expect := []string{"key1", "k2"}
+
+	if !reflect.DeepEqual(expect, keys) {
+		t.Fatalf("Call OnEvicted failed, expect keys equals to %s", expect)
+	}
+}
diff --git a/gee-cache/day4-consistent-hash/go.mod b/gee-cache/day4-consistent-hash/go.mod
new file mode 100644
index 0000000..d0fd3ba
--- /dev/null
+++ b/gee-cache/day4-consistent-hash/go.mod
@@ -0,0 +1,7 @@
+module example
+
+go 1.13
+
+require geecache v0.0.0
+
+replace geecache => ./geecache
diff --git a/gee-cache/day4-consistent-hash/main.go b/gee-cache/day4-consistent-hash/main.go
new file mode 100644
index 0000000..570a90a
--- /dev/null
+++ b/gee-cache/day4-consistent-hash/main.go
@@ -0,0 +1,30 @@
+package main
+
+import (
+	"fmt"
+	"geecache"
+	"log"
+	"net/http"
+)
+
+var db = map[string]string{
+	"Tom":  "630",
+	"Jack": "589",
+	"Sam":  "567",
+}
+
+func main() {
+	geecache.NewGroup("scores", 2<<10, geecache.GetterFunc(
+		func(key string) ([]byte, error) {
+			log.Println("[group scores] search key", key)
+			if v, ok := db[key]; ok {
+				return []byte(v), nil
+			}
+			return nil, fmt.Errorf("%s not exist", key)
+		}))
+
+	addr := "localhost:9999"
+	peers := geecache.NewHTTPPool(addr)
+	log.Println("geecache is running at", addr)
+	log.Fatal(http.ListenAndServe(addr, peers))
+}

From 3c187693f2b22eaff89c9000d04d0ac6f8e222a7 Mon Sep 17 00:00:00 2001
From: gzdaijie <gzdaijie@163.com>
Date: Tue, 4 Feb 2020 00:33:34 +0800
Subject: [PATCH 020/122] day5 multi node

---
 .../day2-single-node/geecache/geecache.go     |  14 +-
 .../day3-http-server/geecache/geecache.go     |  14 +-
 .../day4-consistent-hash/geecache/geecache.go |  14 +-
 .../day5-multi-nodes/geecache/byteview.go     |  21 +++
 gee-cache/day5-multi-nodes/geecache/cache.go  |  35 +++++
 .../geecache/consistenthash/consistenthash.go |  58 ++++++++
 .../consistenthash/consistenthash_test.go     |  43 ++++++
 .../day5-multi-nodes/geecache/geecache.go     | 109 ++++++++++++++
 .../geecache/geecache_test.go                 |  48 +++++++
 gee-cache/day5-multi-nodes/geecache/go.mod    |   3 +
 gee-cache/day5-multi-nodes/geecache/http.go   | 134 ++++++++++++++++++
 .../day5-multi-nodes/geecache/lru/lru.go      |  79 +++++++++++
 .../day5-multi-nodes/geecache/lru/lru_test.go |  55 +++++++
 gee-cache/day5-multi-nodes/geecache/peers.go  |  40 ++++++
 gee-cache/day5-multi-nodes/go.mod             |   7 +
 gee-cache/day5-multi-nodes/main.go            |  30 ++++
 16 files changed, 692 insertions(+), 12 deletions(-)
 create mode 100644 gee-cache/day5-multi-nodes/geecache/byteview.go
 create mode 100644 gee-cache/day5-multi-nodes/geecache/cache.go
 create mode 100644 gee-cache/day5-multi-nodes/geecache/consistenthash/consistenthash.go
 create mode 100644 gee-cache/day5-multi-nodes/geecache/consistenthash/consistenthash_test.go
 create mode 100644 gee-cache/day5-multi-nodes/geecache/geecache.go
 create mode 100644 gee-cache/day5-multi-nodes/geecache/geecache_test.go
 create mode 100644 gee-cache/day5-multi-nodes/geecache/go.mod
 create mode 100644 gee-cache/day5-multi-nodes/geecache/http.go
 create mode 100644 gee-cache/day5-multi-nodes/geecache/lru/lru.go
 create mode 100644 gee-cache/day5-multi-nodes/geecache/lru/lru_test.go
 create mode 100644 gee-cache/day5-multi-nodes/geecache/peers.go
 create mode 100644 gee-cache/day5-multi-nodes/go.mod
 create mode 100644 gee-cache/day5-multi-nodes/main.go

diff --git a/gee-cache/day2-single-node/geecache/geecache.go b/gee-cache/day2-single-node/geecache/geecache.go
index 4273256..c2c8333 100644
--- a/gee-cache/day2-single-node/geecache/geecache.go
+++ b/gee-cache/day2-single-node/geecache/geecache.go
@@ -68,12 +68,18 @@ func cloneBytes(b []byte) []byte {
 }
 
 func (g *Group) load(key string) (value ByteView, err error) {
+	return g.getLocally(key)
+}
+
+func (g *Group) getLocally(key string) (ByteView, error) {
 	bytes, err := g.getter.Get(key)
-	if err == nil {
-		value = ByteView{cloneBytes(bytes)}
-		g.populateCache(key, value)
+	if err != nil {
+		return ByteView{}, err
+
 	}
-	return
+	value := ByteView{b: cloneBytes(bytes)}
+	g.populateCache(key, value)
+	return value, nil
 }
 
 func (g *Group) populateCache(key string, value ByteView) {
diff --git a/gee-cache/day3-http-server/geecache/geecache.go b/gee-cache/day3-http-server/geecache/geecache.go
index 4273256..c2c8333 100644
--- a/gee-cache/day3-http-server/geecache/geecache.go
+++ b/gee-cache/day3-http-server/geecache/geecache.go
@@ -68,12 +68,18 @@ func cloneBytes(b []byte) []byte {
 }
 
 func (g *Group) load(key string) (value ByteView, err error) {
+	return g.getLocally(key)
+}
+
+func (g *Group) getLocally(key string) (ByteView, error) {
 	bytes, err := g.getter.Get(key)
-	if err == nil {
-		value = ByteView{cloneBytes(bytes)}
-		g.populateCache(key, value)
+	if err != nil {
+		return ByteView{}, err
+
 	}
-	return
+	value := ByteView{b: cloneBytes(bytes)}
+	g.populateCache(key, value)
+	return value, nil
 }
 
 func (g *Group) populateCache(key string, value ByteView) {
diff --git a/gee-cache/day4-consistent-hash/geecache/geecache.go b/gee-cache/day4-consistent-hash/geecache/geecache.go
index 4273256..c2c8333 100644
--- a/gee-cache/day4-consistent-hash/geecache/geecache.go
+++ b/gee-cache/day4-consistent-hash/geecache/geecache.go
@@ -68,12 +68,18 @@ func cloneBytes(b []byte) []byte {
 }
 
 func (g *Group) load(key string) (value ByteView, err error) {
+	return g.getLocally(key)
+}
+
+func (g *Group) getLocally(key string) (ByteView, error) {
 	bytes, err := g.getter.Get(key)
-	if err == nil {
-		value = ByteView{cloneBytes(bytes)}
-		g.populateCache(key, value)
+	if err != nil {
+		return ByteView{}, err
+
 	}
-	return
+	value := ByteView{b: cloneBytes(bytes)}
+	g.populateCache(key, value)
+	return value, nil
 }
 
 func (g *Group) populateCache(key string, value ByteView) {
diff --git a/gee-cache/day5-multi-nodes/geecache/byteview.go b/gee-cache/day5-multi-nodes/geecache/byteview.go
new file mode 100644
index 0000000..a51394f
--- /dev/null
+++ b/gee-cache/day5-multi-nodes/geecache/byteview.go
@@ -0,0 +1,21 @@
+package geecache
+
+// A ByteView holds an immutable view of bytes.
+type ByteView struct {
+	b []byte
+}
+
+// Len returns the view's length
+func (v ByteView) Len() int {
+	return len(v.b)
+}
+
+// ByteSlice returns a copy of the data as a byte slice.
+func (v ByteView) ByteSlice() []byte {
+	return cloneBytes(v.b)
+}
+
+// String returns the data as a string, making a copy if necessary.
+func (v ByteView) String() string {
+	return string(v.b)
+}
diff --git a/gee-cache/day5-multi-nodes/geecache/cache.go b/gee-cache/day5-multi-nodes/geecache/cache.go
new file mode 100644
index 0000000..703d033
--- /dev/null
+++ b/gee-cache/day5-multi-nodes/geecache/cache.go
@@ -0,0 +1,35 @@
+package geecache
+
+import (
+	"geecache/lru"
+	"sync"
+)
+
+type cache struct {
+	mu         sync.RWMutex
+	lru        *lru.Cache
+	cacheBytes int64
+}
+
+func (c *cache) add(key string, value ByteView) {
+	c.mu.RLock()
+	defer c.mu.RUnlock()
+	if c.lru == nil {
+		c.lru = lru.New(c.cacheBytes, nil)
+	}
+	c.lru.Add(key, value)
+}
+
+func (c *cache) get(key string) (value ByteView, ok bool) {
+	c.mu.RLock()
+	defer c.mu.RUnlock()
+	if c.lru == nil {
+		return
+	}
+
+	if v, ok := c.lru.Get(key); ok {
+		return v.(ByteView), ok
+	}
+
+	return
+}
diff --git a/gee-cache/day5-multi-nodes/geecache/consistenthash/consistenthash.go b/gee-cache/day5-multi-nodes/geecache/consistenthash/consistenthash.go
new file mode 100644
index 0000000..c8c9082
--- /dev/null
+++ b/gee-cache/day5-multi-nodes/geecache/consistenthash/consistenthash.go
@@ -0,0 +1,58 @@
+package consistenthash
+
+import (
+	"hash/crc32"
+	"sort"
+	"strconv"
+)
+
+// Hash maps bytes to uint32
+type Hash func(data []byte) uint32
+
+// Map constains all hashed keys
+type Map struct {
+	hash     Hash
+	replicas int
+	keys     []int // Sorted
+	hashMap  map[int]string
+}
+
+// New creates a Map instance
+func New(replicas int, fn Hash) *Map {
+	m := &Map{
+		replicas: replicas,
+		hash:     fn,
+		hashMap:  make(map[int]string),
+	}
+	if m.hash == nil {
+		m.hash = crc32.ChecksumIEEE
+	}
+	return m
+}
+
+// Add adds some keys to the hash.
+func (m *Map) Add(keys ...string) {
+	for _, key := range keys {
+		for i := 0; i < m.replicas; i++ {
+			hash := int(m.hash([]byte(strconv.Itoa(i) + key)))
+			m.keys = append(m.keys, hash)
+			m.hashMap[hash] = key
+		}
+	}
+	sort.Ints(m.keys)
+}
+
+// Get gets the closest item in the hash to the provided key.
+func (m *Map) Get(key string) string {
+	if len(m.keys) == 0 {
+		return ""
+	}
+
+	hash := int(m.hash([]byte(key)))
+	// Binary search for appropriate replica.
+	idx := sort.Search(len(m.keys), func(i int) bool {
+		return m.keys[i] >= hash
+	})
+
+	return m.hashMap[m.keys[idx%len(m.keys)]]
+}
diff --git a/gee-cache/day5-multi-nodes/geecache/consistenthash/consistenthash_test.go b/gee-cache/day5-multi-nodes/geecache/consistenthash/consistenthash_test.go
new file mode 100644
index 0000000..34e1275
--- /dev/null
+++ b/gee-cache/day5-multi-nodes/geecache/consistenthash/consistenthash_test.go
@@ -0,0 +1,43 @@
+package consistenthash
+
+import (
+	"strconv"
+	"testing"
+)
+
+func TestHashing(t *testing.T) {
+	hash := New(3, func(key []byte) uint32 {
+		i, _ := strconv.Atoi(string(key))
+		return uint32(i)
+	})
+
+	// Given the above hash function, this will give replicas with "hashes":
+	// 2, 4, 6, 12, 14, 16, 22, 24, 26
+	hash.Add("6", "4", "2")
+
+	testCases := map[string]string{
+		"2":  "2",
+		"11": "2",
+		"23": "4",
+		"27": "2",
+	}
+
+	for k, v := range testCases {
+		if hash.Get(k) != v {
+			t.Errorf("Asking for %s, should have yielded %s", k, v)
+		}
+	}
+
+	// Adds 8, 18, 28
+	hash.Add("8")
+
+	// 27 should now map to 8.
+	testCases["27"] = "8"
+
+	for k, v := range testCases {
+		if hash.Get(k) != v {
+			t.Errorf("Asking for %s, should have yielded %s", k, v)
+		}
+	}
+
+}
diff --git a/gee-cache/day5-multi-nodes/geecache/geecache.go b/gee-cache/day5-multi-nodes/geecache/geecache.go
new file mode 100644
index 0000000..db6e67a
--- /dev/null
+++ b/gee-cache/day5-multi-nodes/geecache/geecache.go
@@ -0,0 +1,109 @@
+package geecache
+
+import (
+	"sync"
+)
+
+// A Group is a cache namespace and associated data loaded spread over
+type Group struct {
+	name      string
+	getter    Getter
+	mainCache cache
+	peers     PeerPicker
+	peersOnce sync.Once
+}
+
+// A Getter loads data for a key.
+type Getter interface {
+	Get(key string) ([]byte, error)
+}
+
+// A GetterFunc implements Getter with a function.
+type GetterFunc func(key string) ([]byte, error)
+
+// Get implements Getter interface function
+func (f GetterFunc) Get(key string) ([]byte, error) {
+	return f(key)
+}
+
+var (
+	mu     sync.RWMutex
+	groups = make(map[string]*Group)
+)
+
+// NewGroup create a new instance of Group
+func NewGroup(name string, cacheBytes int64, getter Getter) *Group {
+	if getter == nil {
+		panic("nil Getter")
+	}
+	mu.Lock()
+	defer mu.Unlock()
+	g := &Group{
+		name:      name,
+		getter:    getter,
+		mainCache: cache{cacheBytes: cacheBytes},
+	}
+	groups[name] = g
+	return g
+}
+
+// GetGroup returns the named group previously created with NewGroup, or
+// nil if there's no such group.
+func GetGroup(name string) *Group {
+	mu.RLock()
+	g := groups[name]
+	mu.RUnlock()
+	return g
+}
+
+// Get value for a key from cache
+func (g *Group) Get(key string) (ByteView, error) {
+	g.peersOnce.Do(func() {
+		g.peers = getPeers()
+	})
+	if v, ok := g.mainCache.get(key); ok {
+		return v, nil
+	}
+
+	return g.load(key)
+}
+
+func cloneBytes(b []byte) []byte {
+	c := make([]byte, len(b))
+	copy(c, b)
+	return c
+}
+
+func (g *Group) load(key string) (value ByteView, err error) {
+	if peer, ok := g.peers.PickPeer(key); ok {
+		value, err = g.getFromPeer(peer, key)
+		if err == nil {
+			return value, nil
+		}
+	}
+
+	return g.getLocally(key)
+}
+
+func (g *Group) populateCache(key string, value ByteView) {
+	g.mainCache.add(key, value)
+}
+
+func (g *Group) getLocally(key string) (ByteView, error) {
+	bytes, err := g.getter.Get(key)
+	if err != nil {
+		return ByteView{}, err
+
+	}
+	value := ByteView{b: cloneBytes(bytes)}
+	g.populateCache(key, value)
+	return value, nil
+}
+
+func (g *Group) getFromPeer(peer PeerGetter, key string) (ByteView, error) {
+	bytes, err := peer.Get(g.name, key)
+	if err != nil {
+		return ByteView{}, err
+	}
+	return ByteView{b: bytes}, nil
+}
diff --git a/gee-cache/day5-multi-nodes/geecache/geecache_test.go b/gee-cache/day5-multi-nodes/geecache/geecache_test.go
new file mode 100644
index 0000000..2bffb3f
--- /dev/null
+++ b/gee-cache/day5-multi-nodes/geecache/geecache_test.go
@@ -0,0 +1,48 @@
+package geecache
+
+import (
+	"fmt"
+	"log"
+	"testing"
+)
+
+var db = map[string]string{
+	"Tom":  "630",
+	"Jack": "589",
+	"Sam":  "567",
+}
+
+func TestGet(t *testing.T) {
+	gee := NewGroup("scores", 2<<10, GetterFunc(
+		func(key string) ([]byte, error) {
+			log.Println("[group scores] search key", key)
+			if v, ok := db[key]; ok {
+				return []byte(v), nil
+			}
+			return nil, fmt.Errorf("%s not exist", key)
+		}))
+
+	for k, v := range db {
+		view, err := gee.Get(k)
+		if err != nil || view.String() != v {
+			t.Fatal("failed to get value of Tom")
+		}
+	}
+
+	if view, err := gee.Get("unknown"); err == nil {
+		t.Fatalf("the value of unknow should be empty, but %s got", view)
+	}
+}
+
+func TestGetGroup(t *testing.T) {
+	groupName := "scores"
+	NewGroup(groupName, 2<<10, GetterFunc(
+		func(key string) (bytes []byte, err error) { return }))
+	if group := GetGroup(groupName); group == nil || group.name != groupName {
+		t.Fatalf("group %s not exist", groupName)
+	}
+
+	if group := GetGroup(groupName + "111"); group != nil {
+		t.Fatalf("expect nil, but %s got", group.name)
+	}
+}
diff --git a/gee-cache/day5-multi-nodes/geecache/go.mod b/gee-cache/day5-multi-nodes/geecache/go.mod
new file mode 100644
index 0000000..f9d454e
--- /dev/null
+++ b/gee-cache/day5-multi-nodes/geecache/go.mod
@@ -0,0 +1,3 @@
+module geecache
+
+go 1.13
diff --git a/gee-cache/day5-multi-nodes/geecache/http.go b/gee-cache/day5-multi-nodes/geecache/http.go
new file mode 100644
index 0000000..c108edf
--- /dev/null
+++ b/gee-cache/day5-multi-nodes/geecache/http.go
@@ -0,0 +1,134 @@
+package geecache
+
+import (
+	"bytes"
+	"fmt"
+	"geecache/consistenthash"
+	"io"
+	"log"
+	"net/http"
+	"net/url"
+	"strings"
+	"sync"
+)
+
+const (
+	defaultBasePath = "/_geecache/"
+	defaultReplicas = 50
+)
+
+// HTTPPool implements PeerPicker for a pool of HTTP peers.
+type HTTPPool struct {
+	// this peer's base URL, e.g. "https://example.net:8000"
+	self        string
+	basePath    string
+	mu          sync.Mutex // guards peers and httpGetters
+	peers       *consistenthash.Map
+	httpGetters map[string]*httpGetter // keyed by e.g. "http://10.0.0.2:8008"
+}
+
+// NewHTTPPool initializes an HTTP pool of peers, and registers itself as a PeerPicker.
+func NewHTTPPool(self string) *HTTPPool {
+	p := &HTTPPool{
+		self:     self,
+		basePath: defaultBasePath,
+	}
+	RegisterPeerPicker(func() PeerPicker { return p })
+	return p
+}
+
+// ServeHTTP handle all http requests
+func (p *HTTPPool) ServeHTTP(w http.ResponseWriter, r *http.Request) {
+	if !strings.HasPrefix(r.URL.Path, p.basePath) {
+		panic("HTTPPool serving unexpected path: " + r.URL.Path)
+	}
+	log.Println("[geecache server]", r.Method, r.URL.Path)
+	// /<basepath>/<groupname>/<key> required
+	parts := strings.SplitN(r.URL.Path[len(p.basePath):], "/", 2)
+	if len(parts) != 2 {
+		http.Error(w, "bad request", http.StatusBadRequest)
+		return
+	}
+
+	groupName := parts[0]
+	key := parts[1]
+
+	group := GetGroup(groupName)
+	if group == nil {
+		http.Error(w, "no such group: "+groupName, http.StatusNotFound)
+		return
+	}
+
+	view, err := group.Get(key)
+	if err != nil {
+		http.Error(w, err.Error(), http.StatusInternalServerError)
+		return
+	}
+
+	w.Header().Set("Content-Type", "application/octet-stream")
+	w.Write(view.ByteSlice())
+}
+
+// Set updates the pool's list of peers.
+func (p *HTTPPool) Set(peers ...string) {
+	p.mu.Lock()
+	defer p.mu.Unlock()
+	p.peers = consistenthash.New(defaultReplicas, nil)
+	p.peers.Add(peers...)
+	p.httpGetters = make(map[string]*httpGetter, len(peers))
+	for _, peer := range peers {
+		p.httpGetters[peer] = &httpGetter{baseURL: peer + p.basePath}
+	}
+}
+
+// PickPeer picks a peer according to key
+func (p *HTTPPool) PickPeer(key string) (PeerGetter, bool) {
+	p.mu.Lock()
+	defer p.mu.Unlock()
+	if peer := p.peers.Get(key); peer != "" && peer != p.self {
+		return p.httpGetters[peer], true
+	}
+	return nil, false
+}
+
+var _ PeerPicker = (*HTTPPool)(nil)
+
+type httpGetter struct {
+	baseURL string
+}
+
+var bufferPool = sync.Pool{
+	New: func() interface{} { return new(bytes.Buffer) },
+}
+
+func (h *httpGetter) Get(group string, key string) ([]byte, error) {
+	u := fmt.Sprintf(
+		"%v%v/%v",
+		h.baseURL,
+		url.QueryEscape(group),
+		url.QueryEscape(key),
+	)
+	res, err := http.Get(u)
+	if err != nil {
+		return nil, err
+	}
+	defer res.Body.Close()
+
+	if res.StatusCode != http.StatusOK {
+		return nil, fmt.Errorf("server returned: %v", res.Status)
+	}
+
+	b := bufferPool.Get().(*bytes.Buffer)
+	b.Reset()
+	defer bufferPool.Put(b)
+
+	_, err = io.Copy(b, res.Body)
+
+	if err != nil {
+		return nil, fmt.Errorf("reading response body: %v", err)
+	}
+
+	return b.Bytes(), nil
+}
+
+var _ PeerGetter = (*httpGetter)(nil)
diff --git a/gee-cache/day5-multi-nodes/geecache/lru/lru.go b/gee-cache/day5-multi-nodes/geecache/lru/lru.go
new file mode 100644
index 0000000..81eee43
--- /dev/null
+++ b/gee-cache/day5-multi-nodes/geecache/lru/lru.go
@@ -0,0 +1,79 @@
+package lru
+
+import "container/list"
+
+// Cache is a LRU cache. It is not safe for concurrent access.
+type Cache struct {
+	maxBytes int64
+	nbytes   int64
+	ll       *list.List
+	cache    map[string]*list.Element
+	// optional and executed when an entry is purged.
+	OnEvicted func(key string, value Value)
+}
+
+type entry struct {
+	key   string
+	value Value
+}
+
+// Value use Len to count how many bytes it takes
+type Value interface {
+	Len() int
+}
+
+// New is the Constructor of Cache
+func New(maxBytes int64, onEvicted func(string, Value)) *Cache {
+	return &Cache{
+		maxBytes:  maxBytes,
+		ll:        list.New(),
+		cache:     make(map[string]*list.Element),
+		OnEvicted: onEvicted,
+	}
+}
+
+// Add adds a value to the cache.
+func (c *Cache) Add(key string, value Value) {
+	if ele, ok := c.cache[key]; ok {
+		c.ll.MoveToFront(ele)
+		kv := ele.Value.(*entry)
+		kv.value = value
+		return
+	}
+	ele := c.ll.PushFront(&entry{key, value})
+	c.cache[key] = ele
+	c.nbytes += int64(len(key)) + int64(value.Len())
+
+	for c.maxBytes != 0 && c.maxBytes < c.nbytes {
+		c.RemoveOldest()
+	}
+}
+
+// Get look ups a key's value
+func (c *Cache) Get(key string) (value Value, ok bool) {
+	if ele, ok := c.cache[key]; ok {
+		c.ll.MoveToFront(ele)
+		kv := ele.Value.(*entry)
+		return kv.value, true
+	}
+	return
+}
+
+// RemoveOldest removes the oldest item
+func (c *Cache) RemoveOldest() {
+	ele := c.ll.Back()
+	if ele != nil {
+		c.ll.Remove(ele)
+		kv := ele.Value.(*entry)
+		delete(c.cache, kv.key)
+		c.nbytes -= int64(len(kv.key)) + int64(kv.value.Len())
+		if c.OnEvicted != nil {
+			c.OnEvicted(kv.key, kv.value)
+		}
+	}
+}
+
+// Len the number of cache entries
+func (c *Cache) Len() int {
+	return c.ll.Len()
+}
diff --git a/gee-cache/day5-multi-nodes/geecache/lru/lru_test.go b/gee-cache/day5-multi-nodes/geecache/lru/lru_test.go
new file mode 100644
index 0000000..7308322
--- /dev/null
+++ b/gee-cache/day5-multi-nodes/geecache/lru/lru_test.go
@@ -0,0 +1,55 @@
+package lru
+
+import (
+	"reflect"
+	"testing"
+)
+
+type String string
+
+func (d String) Len() int {
+	return len(d)
+}
+
+func TestGet(t *testing.T) {
+	lru := New(int64(0), nil)
+	lru.Add("key1", String("1234"))
+	if v, ok := lru.Get("key1"); !ok || string(v.(String)) != "1234" {
+		t.Fatalf("cache hit key1=1234 failed")
+	}
+	if _, ok := lru.Get("key2"); ok {
+		t.Fatalf("cache miss key2 failed")
+	}
+}
+
+func TestRemoveoldest(t *testing.T) {
+	k1, k2, k3 := "key1", "key2", "k3"
+	v1, v2, v3 := "value1", "value2", "v3"
+	cap := len(k1 + k2 + v1 + v2)
+	lru := New(int64(cap), nil)
+	lru.Add(k1, String(v1))
+	lru.Add(k2, String(v2))
+	lru.Add(k3, String(v3))
+
+	if _, ok := lru.Get("key1"); ok || lru.Len() != 2 {
+		t.Fatalf("Removeoldest key1 failed")
+	}
+}
+
+func TestOnEvicted(t *testing.T) {
+	keys := make([]string, 0)
+	callback := func(key string, value Value) {
+		keys = append(keys, key)
+	}
+	lru := New(int64(10), callback)
+	lru.Add("key1", String("123456"))
+	lru.Add("k2", String("k2"))
+	lru.Add("k3", String("k3"))
+	lru.Add("k4", String("k4"))
+
+	expect := []string{"key1", "k2"}
+
+	if !reflect.DeepEqual(expect, keys) {
+		t.Fatalf("Call OnEvicted failed, expect keys equals to %s", expect)
+	}
+}
diff --git a/gee-cache/day5-multi-nodes/geecache/peers.go b/gee-cache/day5-multi-nodes/geecache/peers.go
new file mode 100644
index 0000000..cfc39f7
--- /dev/null
+++ b/gee-cache/day5-multi-nodes/geecache/peers.go
@@ -0,0 +1,40 @@
+package geecache
+
+// PeerPicker is the interface that must be implemented to locate
+// the peer that owns a specific key.
+type PeerPicker interface {
+	PickPeer(key string) (peer PeerGetter, ok bool)
+}
+
+// PeerGetter is the interface that must be implemented by a peer.
+type PeerGetter interface {
+	Get(group string, key string) ([]byte, error)
+}
+
+// NoPeers is an implementation of PeerPicker that never finds a peer.
+type NoPeers struct{}
+
+// PickPeer return nothing
+func (NoPeers) PickPeer(key string) (peer PeerGetter, ok bool) { return }
+
+var portPicker func() PeerPicker
+
+// RegisterPeerPicker registers the peer initialization function.
+// It is called once, when the first group is created.
+func RegisterPeerPicker(fn func() PeerPicker) {
+	if portPicker != nil {
+		panic("RegisterPeerPicker called more than once")
+	}
+	portPicker = fn
+}
+
+func getPeers() PeerPicker {
+	if portPicker == nil {
+		return NoPeers{}
+	}
+	pk := portPicker()
+	if pk == nil {
+		pk = NoPeers{}
+	}
+	return pk
+}
diff --git a/gee-cache/day5-multi-nodes/go.mod b/gee-cache/day5-multi-nodes/go.mod
new file mode 100644
index 0000000..d0fd3ba
--- /dev/null
+++ b/gee-cache/day5-multi-nodes/go.mod
@@ -0,0 +1,7 @@
+module example
+
+go 1.13
+
+require geecache v0.0.0
+
+replace geecache => ./geecache
diff --git a/gee-cache/day5-multi-nodes/main.go b/gee-cache/day5-multi-nodes/main.go
new file mode 100644
index 0000000..570a90a
--- /dev/null
+++ b/gee-cache/day5-multi-nodes/main.go
@@ -0,0 +1,30 @@
+package main
+
+import (
+	"fmt"
+	"geecache"
+	"log"
+	"net/http"
+)
+
+var db = map[string]string{
+	"Tom":  "630",
+	"Jack": "589",
+	"Sam":  "567",
+}
+
+func main() {
+	geecache.NewGroup("scores", 2<<10, geecache.GetterFunc(
+		func(key string) ([]byte, error) {
+			log.Println("[group scores] search key", key)
+			if v, ok := db[key]; ok {
+				return []byte(v), nil
+			}
+			return nil, fmt.Errorf("%s not exist", key)
+		}))
+
+	addr := "localhost:9999"
+	peers := geecache.NewHTTPPool(addr)
+	log.Println("geecache is running at", addr)
+	log.Fatal(http.ListenAndServe(addr, peers))
+}

From 8ac9c63d92c95fcebe047a180da9379cec3ea11a Mon Sep 17 00:00:00 2001
From: gzdaijie <gzdaijie@163.com>
Date: Wed, 5 Feb 2020 16:33:26 +0800
Subject: [PATCH 021/122] day5 multi nodes finish main func & add a auto start
 shell script

---
 .../day2-single-node/geecache/geecache.go     | 11 ++-
 .../geecache/geecache_test.go                 |  2 +-
 .../day3-http-server/geecache/geecache.go     | 11 ++-
 .../geecache/geecache_test.go                 |  2 +-
 gee-cache/day3-http-server/geecache/http.go   |  8 ++-
 gee-cache/day3-http-server/main.go            | 10 ++-
 .../day4-consistent-hash/geecache/geecache.go | 11 ++-
 .../geecache/geecache_test.go                 |  2 +-
 .../day4-consistent-hash/geecache/http.go     |  8 ++-
 gee-cache/day4-consistent-hash/main.go        | 10 ++-
 .../day5-multi-nodes/geecache/geecache.go     | 29 +++++---
 .../geecache/geecache_test.go                 |  2 +-
 gee-cache/day5-multi-nodes/geecache/http.go   | 28 +++-----
 gee-cache/day5-multi-nodes/geecache/peers.go  | 28 --------
 gee-cache/day5-multi-nodes/main.go            | 67 +++++++++++++++++--
 gee-cache/day5-multi-nodes/run.sh             |  9 +++
 16 files changed, 169 insertions(+), 69 deletions(-)
 create mode 100755 gee-cache/day5-multi-nodes/run.sh

diff --git a/gee-cache/day2-single-node/geecache/geecache.go b/gee-cache/day2-single-node/geecache/geecache.go
index c2c8333..58b98b8 100644
--- a/gee-cache/day2-single-node/geecache/geecache.go
+++ b/gee-cache/day2-single-node/geecache/geecache.go
@@ -1,6 +1,10 @@
 package geecache
 
-import "sync"
+import (
+	"fmt"
+	"log"
+	"sync"
+)
 
 // A Group is a cache namespace and associated data loaded spread over
 type Group struct {
@@ -54,7 +58,12 @@ func GetGroup(name string) *Group {
 
 // Get value for a key from cache
 func (g *Group) Get(key string) (ByteView, error) {
+	if key == "" {
+		return ByteView{}, fmt.Errorf("key is required")
+	}
+
 	if v, ok := g.mainCache.get(key); ok {
+		log.Println("[GeeCache] hit")
 		return v, nil
 	}
 
diff --git a/gee-cache/day2-single-node/geecache/geecache_test.go b/gee-cache/day2-single-node/geecache/geecache_test.go
index 2bffb3f..9cb4079 100644
--- a/gee-cache/day2-single-node/geecache/geecache_test.go
+++ b/gee-cache/day2-single-node/geecache/geecache_test.go
@@ -15,7 +15,7 @@ var db = map[string]string{
 func TestGet(t *testing.T) {
 	gee := NewGroup("scores", 2<<10, GetterFunc(
 		func(key string) ([]byte, error) {
-			log.Println("[group scores] search key", key)
+			log.Println("[SlowDB] search key", key)
 			if v, ok := db[key]; ok {
 				return []byte(v), nil
 			}
diff --git a/gee-cache/day3-http-server/geecache/geecache.go b/gee-cache/day3-http-server/geecache/geecache.go
index c2c8333..58b98b8 100644
--- a/gee-cache/day3-http-server/geecache/geecache.go
+++ b/gee-cache/day3-http-server/geecache/geecache.go
@@ -1,6 +1,10 @@
 package geecache
 
-import "sync"
+import (
+	"fmt"
+	"log"
+	"sync"
+)
 
 // A Group is a cache namespace and associated data loaded spread over
 type Group struct {
@@ -54,7 +58,12 @@ func GetGroup(name string) *Group {
 
 // Get value for a key from cache
 func (g *Group) Get(key string) (ByteView, error) {
+	if key == "" {
+		return ByteView{}, fmt.Errorf("key is required")
+	}
+
 	if v, ok := g.mainCache.get(key); ok {
+		log.Println("[GeeCache] hit")
 		return v, nil
 	}
 
diff --git a/gee-cache/day3-http-server/geecache/geecache_test.go b/gee-cache/day3-http-server/geecache/geecache_test.go
index 2bffb3f..9cb4079 100644
--- a/gee-cache/day3-http-server/geecache/geecache_test.go
+++ b/gee-cache/day3-http-server/geecache/geecache_test.go
@@ -15,7 +15,7 @@ var db = map[string]string{
 func TestGet(t *testing.T) {
 	gee := NewGroup("scores", 2<<10, GetterFunc(
 		func(key string) ([]byte, error) {
-			log.Println("[group scores] search key", key)
+			log.Println("[SlowDB] search key", key)
 			if v, ok := db[key]; ok {
 				return []byte(v), nil
 			}
diff --git a/gee-cache/day3-http-server/geecache/http.go b/gee-cache/day3-http-server/geecache/http.go
index 4d33d5d..ef5e2f1 100644
--- a/gee-cache/day3-http-server/geecache/http.go
+++ b/gee-cache/day3-http-server/geecache/http.go
@@ -1,6 +1,7 @@
 package geecache
 
 import (
+	"fmt"
 	"log"
 	"net/http"
 	"strings"
@@ -23,12 +24,17 @@ func NewHTTPPool(self string) *HTTPPool {
 	}
 }
 
+// Log info with server name
+func (p *HTTPPool) Log(format string, v ...interface{}) {
+	log.Printf("[Server %s] %s", p.self, fmt.Sprintf(format, v...))
+}
+
 // ServeHTTP handle all http requests
 func (p *HTTPPool) ServeHTTP(w http.ResponseWriter, r *http.Request) {
 	if !strings.HasPrefix(r.URL.Path, p.basePath) {
 		panic("HTTPPool serving unexpected path: " + r.URL.Path)
 	}
-	log.Println("[geecache server]", r.Method, r.URL.Path)
+	p.Log("%s %s", r.Method, r.URL.Path)
 	// /<basepath>/<groupname>/<key> required
 	parts := strings.SplitN(r.URL.Path[len(p.basePath):], "/", 2)
 	if len(parts) != 2 {
diff --git a/gee-cache/day3-http-server/main.go b/gee-cache/day3-http-server/main.go
index 570a90a..5442dd7 100644
--- a/gee-cache/day3-http-server/main.go
+++ b/gee-cache/day3-http-server/main.go
@@ -1,5 +1,13 @@
 package main
 
+/*
+$ curl http://localhost:9999/_geecache/scores/Tom
+630
+
+$ curl http://localhost:9999/_geecache/scores/kkk
+kkk not exist
+*/
+
 import (
 	"fmt"
 	"geecache"
@@ -16,7 +24,7 @@ var db = map[string]string{
 func main() {
 	geecache.NewGroup("scores", 2<<10, geecache.GetterFunc(
 		func(key string) ([]byte, error) {
-			log.Println("[group scores] search key", key)
+			log.Println("[SlowDB] search key", key)
 			if v, ok := db[key]; ok {
 				return []byte(v), nil
 			}
diff --git a/gee-cache/day4-consistent-hash/geecache/geecache.go b/gee-cache/day4-consistent-hash/geecache/geecache.go
index c2c8333..58b98b8 100644
--- a/gee-cache/day4-consistent-hash/geecache/geecache.go
+++ b/gee-cache/day4-consistent-hash/geecache/geecache.go
@@ -1,6 +1,10 @@
 package geecache
 
-import "sync"
+import (
+	"fmt"
+	"log"
+	"sync"
+)
 
 // A Group is a cache namespace and associated data loaded spread over
 type Group struct {
@@ -54,7 +58,12 @@ func GetGroup(name string) *Group {
 
 // Get value for a key from cache
 func (g *Group) Get(key string) (ByteView, error) {
+	if key == "" {
+		return ByteView{}, fmt.Errorf("key is required")
+	}
+
 	if v, ok := g.mainCache.get(key); ok {
+		log.Println("[GeeCache] hit")
 		return v, nil
 	}
 
diff --git a/gee-cache/day4-consistent-hash/geecache/geecache_test.go b/gee-cache/day4-consistent-hash/geecache/geecache_test.go
index 2bffb3f..9cb4079 100644
--- a/gee-cache/day4-consistent-hash/geecache/geecache_test.go
+++ b/gee-cache/day4-consistent-hash/geecache/geecache_test.go
@@ -15,7 +15,7 @@ var db = map[string]string{
 func TestGet(t *testing.T) {
 	gee := NewGroup("scores", 2<<10, GetterFunc(
 		func(key string) ([]byte, error) {
-			log.Println("[group scores] search key", key)
+			log.Println("[SlowDB] search key", key)
 			if v, ok := db[key]; ok {
 				return []byte(v), nil
 			}
diff --git a/gee-cache/day4-consistent-hash/geecache/http.go b/gee-cache/day4-consistent-hash/geecache/http.go
index 4d33d5d..ef5e2f1 100644
--- a/gee-cache/day4-consistent-hash/geecache/http.go
+++ b/gee-cache/day4-consistent-hash/geecache/http.go
@@ -1,6 +1,7 @@
 package geecache
 
 import (
+	"fmt"
 	"log"
 	"net/http"
 	"strings"
@@ -23,12 +24,17 @@ func NewHTTPPool(self string) *HTTPPool {
 	}
 }
 
+// Log info with server name
+func (p *HTTPPool) Log(format string, v ...interface{}) {
+	log.Printf("[Server %s] %s", p.self, fmt.Sprintf(format, v...))
+}
+
 // ServeHTTP handle all http requests
 func (p *HTTPPool) ServeHTTP(w http.ResponseWriter, r *http.Request) {
 	if !strings.HasPrefix(r.URL.Path, p.basePath) {
 		panic("HTTPPool serving unexpected path: " + r.URL.Path)
 	}
-	log.Println("[geecache server]", r.Method, r.URL.Path)
+	p.Log("%s %s", r.Method, r.URL.Path)
 	// /<basepath>/<groupname>/<key> required
 	parts := strings.SplitN(r.URL.Path[len(p.basePath):], "/", 2)
 	if len(parts) != 2 {
diff --git a/gee-cache/day4-consistent-hash/main.go b/gee-cache/day4-consistent-hash/main.go
index 570a90a..5442dd7 100644
--- a/gee-cache/day4-consistent-hash/main.go
+++ b/gee-cache/day4-consistent-hash/main.go
@@ -1,5 +1,13 @@
 package main
 
+/*
+$ curl http://localhost:9999/_geecache/scores/Tom
+630
+
+$ curl http://localhost:9999/_geecache/scores/kkk
+kkk not exist
+*/
+
 import (
 	"fmt"
 	"geecache"
@@ -16,7 +24,7 @@ var db = map[string]string{
 func main() {
 	geecache.NewGroup("scores", 2<<10, geecache.GetterFunc(
 		func(key string) ([]byte, error) {
-			log.Println("[group scores] search key", key)
+			log.Println("[SlowDB] search key", key)
 			if v, ok := db[key]; ok {
 				return []byte(v), nil
 			}
diff --git a/gee-cache/day5-multi-nodes/geecache/geecache.go b/gee-cache/day5-multi-nodes/geecache/geecache.go
index db6e67a..dbd5c3e 100644
--- a/gee-cache/day5-multi-nodes/geecache/geecache.go
+++ b/gee-cache/day5-multi-nodes/geecache/geecache.go
@@ -1,6 +1,8 @@
 package geecache
 
 import (
+	"fmt"
+	"log"
 	"sync"
 )
 
@@ -10,7 +12,6 @@ type Group struct {
 	getter    Getter
 	mainCache cache
 	peers     PeerPicker
-	peersOnce sync.Once
 }
 
 // A Getter loads data for a key.
@@ -58,16 +59,26 @@ func GetGroup(name string) *Group {
 
 // Get value for a key from cache
 func (g *Group) Get(key string) (ByteView, error) {
-	g.peersOnce.Do(func() {
-		g.peers = getPeers()
-	})
+	if key == "" {
+		return ByteView{}, fmt.Errorf("key is required")
+	}
+
 	if v, ok := g.mainCache.get(key); ok {
+		log.Println("[GeeCache] hit")
 		return v, nil
 	}
 
 	return g.load(key)
 }
 
+// RegisterPeers registers a PeerPicker for choosing remote peer
+func (g *Group) RegisterPeers(peers PeerPicker) {
+	if g.peers != nil {
+		panic("RegisterPeerPicker called more than once")
+	}
+	g.peers = peers
+}
+
 func cloneBytes(b []byte) []byte {
 	c := make([]byte, len(b))
 	copy(c, b)
@@ -75,10 +86,12 @@ func cloneBytes(b []byte) []byte {
 }
 
 func (g *Group) load(key string) (value ByteView, err error) {
-	if peer, ok := g.peers.PickPeer(key); ok {
-		value, err = g.getFromPeer(peer, key)
-		if err == nil {
-			return value, nil
+	if g.peers != nil {
+		if peer, ok := g.peers.PickPeer(key); ok {
+			if value, err = g.getFromPeer(peer, key); err == nil {
+				return value, nil
+			}
+			log.Println("[GeeCache] Failed to get from peer", err)
 		}
 	}
 
diff --git a/gee-cache/day5-multi-nodes/geecache/geecache_test.go b/gee-cache/day5-multi-nodes/geecache/geecache_test.go
index 2bffb3f..9cb4079 100644
--- a/gee-cache/day5-multi-nodes/geecache/geecache_test.go
+++ b/gee-cache/day5-multi-nodes/geecache/geecache_test.go
@@ -15,7 +15,7 @@ var db = map[string]string{
 func TestGet(t *testing.T) {
 	gee := NewGroup("scores", 2<<10, GetterFunc(
 		func(key string) ([]byte, error) {
-			log.Println("[group scores] search key", key)
+			log.Println("[SlowDB] search key", key)
 			if v, ok := db[key]; ok {
 				return []byte(v), nil
 			}
diff --git a/gee-cache/day5-multi-nodes/geecache/http.go b/gee-cache/day5-multi-nodes/geecache/http.go
index c108edf..d7da2c3 100644
--- a/gee-cache/day5-multi-nodes/geecache/http.go
+++ b/gee-cache/day5-multi-nodes/geecache/http.go
@@ -1,10 +1,9 @@
 package geecache
 
 import (
-	"bytes"
 	"fmt"
 	"geecache/consistenthash"
-	"io"
+	"io/ioutil"
 	"log"
 	"net/http"
 	"net/url"
@@ -29,12 +28,15 @@ type HTTPPool struct {
 
 // NewHTTPPool initializes an HTTP pool of peers, and registers itself as a PeerPicker.
 func NewHTTPPool(self string) *HTTPPool {
-	p := &HTTPPool{
+	return &HTTPPool{
 		self:     self,
 		basePath: defaultBasePath,
 	}
-	RegisterPeerPicker(func() PeerPicker { return p })
-	return p
+}
+
+// Log info with server name
+func (p *HTTPPool) Log(format string, v ...interface{}) {
+	log.Printf("[Server %s] %s", p.self, fmt.Sprintf(format, v...))
 }
 
 // ServeHTTP handle all http requests
@@ -42,7 +44,7 @@ func (p *HTTPPool) ServeHTTP(w http.ResponseWriter, r *http.Request) {
 	if !strings.HasPrefix(r.URL.Path, p.basePath) {
 		panic("HTTPPool serving unexpected path: " + r.URL.Path)
 	}
-	log.Println("[geecache server]", r.Method, r.URL.Path)
+	p.Log("%s %s", r.Method, r.URL.Path)
 	// /<basepath>/<groupname>/<key> required
 	parts := strings.SplitN(r.URL.Path[len(p.basePath):], "/", 2)
 	if len(parts) != 2 {
@@ -86,6 +88,7 @@ func (p *HTTPPool) PickPeer(key string) (PeerGetter, bool) {
 	p.mu.Lock()
 	defer p.mu.Unlock()
 	if peer := p.peers.Get(key); peer != "" && peer != p.self {
+		p.Log("Pick peer %s", peer)
 		return p.httpGetters[peer], true
 	}
 	return nil, false
@@ -97,10 +100,6 @@ type httpGetter struct {
 	baseURL string
 }
 
-var bufferPool = sync.Pool{
-	New: func() interface{} { return new(bytes.Buffer) },
-}
-
 func (h *httpGetter) Get(group string, key string) ([]byte, error) {
 	u := fmt.Sprintf(
 		"%v%v/%v",
@@ -118,17 +117,12 @@ func (h *httpGetter) Get(group string, key string) ([]byte, error) {
 		return nil, fmt.Errorf("server returned: %v", res.Status)
 	}
 
-	b := bufferPool.Get().(*bytes.Buffer)
-	b.Reset()
-	defer bufferPool.Put(b)
-
-	_, err = io.Copy(b, res.Body)
-
+	bytes, err := ioutil.ReadAll(res.Body)
 	if err != nil {
 		return nil, fmt.Errorf("reading response body: %v", err)
 	}
 
-	return b.Bytes(), nil
+	return bytes, nil
 }
 
 var _ PeerGetter = (*httpGetter)(nil)
diff --git a/gee-cache/day5-multi-nodes/geecache/peers.go b/gee-cache/day5-multi-nodes/geecache/peers.go
index cfc39f7..8d010e2 100644
--- a/gee-cache/day5-multi-nodes/geecache/peers.go
+++ b/gee-cache/day5-multi-nodes/geecache/peers.go
@@ -10,31 +10,3 @@ type PeerPicker interface {
 type PeerGetter interface {
 	Get(group string, key string) ([]byte, error)
 }
-
-// NoPeers is an implementation of PeerPicker that never finds a peer.
-type NoPeers struct{}
-
-// PickPeer return nothing
-func (NoPeers) PickPeer(key string) (peer PeerGetter, ok bool) { return }
-
-var portPicker func() PeerPicker
-
-// RegisterPeerPicker registers the peer initialization function.
-// It is called once, when the first group is created.
-func RegisterPeerPicker(fn func() PeerPicker) {
-	if portPicker != nil {
-		panic("RegisterPeerPicker called more than once")
-	}
-	portPicker = fn
-}
-
-func getPeers() PeerPicker {
-	if portPicker == nil {
-		return NoPeers{}
-	}
-	pk := portPicker()
-	if pk == nil {
-		pk = NoPeers{}
-	}
-	return pk
-}
diff --git a/gee-cache/day5-multi-nodes/main.go b/gee-cache/day5-multi-nodes/main.go
index 570a90a..a99940c 100644
--- a/gee-cache/day5-multi-nodes/main.go
+++ b/gee-cache/day5-multi-nodes/main.go
@@ -1,6 +1,15 @@
 package main
 
+/*
+$ curl "http://localhost:9999/api?key=Tom"
+630
+
+$ curl "http://localhost:9999/api?key=kkk"
+kkk not exist
+*/
+
 import (
+	"flag"
 	"fmt"
 	"geecache"
 	"log"
@@ -13,18 +22,66 @@ var db = map[string]string{
 	"Sam":  "567",
 }
 
-func main() {
-	geecache.NewGroup("scores", 2<<10, geecache.GetterFunc(
+func createGroup() *geecache.Group {
+	return geecache.NewGroup("scores", 2<<10, geecache.GetterFunc(
 		func(key string) ([]byte, error) {
-			log.Println("[group scores] search key", key)
+			log.Println("[SlowDB] search key", key)
 			if v, ok := db[key]; ok {
 				return []byte(v), nil
 			}
 			return nil, fmt.Errorf("%s not exist", key)
 		}))
+}
 
-	addr := "localhost:9999"
+func startCacheServer(addr string, addrs []string, gee *geecache.Group) {
 	peers := geecache.NewHTTPPool(addr)
+	peers.Set(addrs...)
+	gee.RegisterPeers(peers)
 	log.Println("geecache is running at", addr)
-	log.Fatal(http.ListenAndServe(addr, peers))
+	log.Fatal(http.ListenAndServe(addr[7:], peers))
+}
+
+func startAPIServer(apiAddr string, gee *geecache.Group) {
+	http.Handle("/api", http.HandlerFunc(
+		func(w http.ResponseWriter, r *http.Request) {
+			key := r.URL.Query().Get("key")
+			view, err := gee.Get(key)
+			if err != nil {
+				http.Error(w, err.Error(), http.StatusInternalServerError)
+				return
+			}
+			w.Header().Set("Content-Type", "application/octet-stream")
+			w.Write(view.ByteSlice())
+
+		}))
+	log.Println("fontend server is running at", apiAddr)
+	log.Fatal(http.ListenAndServe(apiAddr[7:], nil))
+
+}
+
+func main() {
+	var port int
+	var api bool
+	flag.IntVar(&port, "port", 8001, "Geecache server port")
+	flag.BoolVar(&api, "api", false, "Start a api server?")
+	flag.Parse()
+
+	apiAddr := "http://localhost:9999"
+	addrMap := map[int]string{
+		8001: "http://localhost:8001",
+		8002: "http://localhost:8002",
+		8003: "http://localhost:8003",
+	}
+
+	addrs := make([]string, 3)
+
+	for _, v := range addrMap {
+		addrs = append(addrs, v)
+	}
+
+	gee := createGroup()
+	if api {
+		go startAPIServer(apiAddr, gee)
+	}
+	startCacheServer(addrMap[port], []string(addrs), gee)
 }
diff --git a/gee-cache/day5-multi-nodes/run.sh b/gee-cache/day5-multi-nodes/run.sh
new file mode 100755
index 0000000..d19b4c8
--- /dev/null
+++ b/gee-cache/day5-multi-nodes/run.sh
@@ -0,0 +1,9 @@
+#!/bin/bash
+trap "rm server;kill 0" EXIT
+
+go build -o server
+./server -port=8001 &
+./server -port=8002 &
+./server -port=8003 -api=1 &
+
+wait
\ No newline at end of file

From b3bf9326f5d5bb283c47b943ecf9b86ae49f6103 Mon Sep 17 00:00:00 2001
From: gzdaijie <gzdaijie@163.com>
Date: Wed, 5 Feb 2020 21:17:51 +0800
Subject: [PATCH 022/122] add English version's README

---
 README.md         | 83 +++++++++++++++++++++++++++++++++++------------
 gee-web/README.md | 13 ++++++--
 2 files changed, 74 insertions(+), 22 deletions(-)

diff --git a/README.md b/README.md
index 0aa3323..9d95aff 100644
--- a/README.md
+++ b/README.md
@@ -1,33 +1,76 @@
-# 7天用Go从零实现系列
+# 7 days golang apps from scratch
+
+<details>
+<summary><strong>README 中文版本</strong></summary>
+<div>
+
+## 7天用Go从零实现系列
 
 7天能写什么呢？类似 gin 的 web 框架？类似 groupcache 的分布式缓存？或者一个简单的 Python 解释器？希望这个仓库能给你答案。
 
 推荐先阅读 **[Go 语言简明教程](https://geektutu.com/post/quick-golang.html)**，一篇文章了解Go的基本语法、并发编程，依赖管理等内容
 
-## 7天用Go从零实现Web框架Gee
+### 7天用Go从零实现Web框架 - Gee
+
+[Gee](https://geektutu.com/post/gee.html) 是一个模仿 [gin](https://github.com/gin-gonic/gin) 实现的 Web 框架，[Go Gin简明教程](https://geektutu.com/post/quick-go-gin.html)可以快速入门。
+
+- 第一天：[前置知识(http.Handler接口)](https://geektutu.com/post/gee-day1.html) | [Code](gee-web/day1-http-base)
+- 第二天：[上下文设计(Context)](https://geektutu.com/post/gee-day2.html) | [Code](gee-web/day2-context)
+- 第三天：[Tire树路由(Router)](https://geektutu.com/post/gee-day3.html) | [Code](gee-web/day3-router)
+- 第四天：[分组控制(Group)](https://geektutu.com/post/gee-day4.html) | [Code](gee-web/day4-group)
+- 第五天：[中间件(Middleware)](https://geektutu.com/post/gee-day5.html) | [Code](gee-web/day5-middleware)
+- 第六天：[HTML模板(Template)](https://geektutu.com/post/gee-day6.html) | [Code](gee-web/day6-template)
+- 第七天：[错误恢复(Panic Recover)](https://geektutu.com/post/gee-day7.html) | [Code](gee-web/day7-panic-recover)
+
+### 7天用Go从零实现分布式缓存 GeeCache
+
+GeeCache 是一个模仿 [groupcache](https://github.com/golang/groupcache) 实现的分布式缓存系统
+
+- 第一天：LRU 缓存策略 | [Code](gee-cache/day1-lru)
+- 第二天：单机并发缓存 | [Code](gee-cache/day2-single-node)
+- 第三天：HTTP 服务端 | [Code](gee-cache/day3-http-server)
+- 第四天：一致性哈希(Hash) | [Code](gee-cache/day4-consistent-hash)
+- 第五天：分布式节点 | [Code](gee-cache/day5-multi-nodes)
+
+### WebAssembly 使用示例
+
+具体的实践过程记录在 [Go WebAssembly 简明教程](https://geektutu.com/post/quick-go-wasm.html)。
+
+- 示例一：Hello World | [Code](demo-wasm/hello-world)
+- 示例二：注册函数 | [Code](demo-wasm/register-functions)
+- 示例三：操作 DOM | [Code](demo-wasm/manipulate-dom)
+- 示例四：回调函数 | [Code](demo-wasm/callback)
+
+</div>
+</details>
+
+What can I write in 7 days? A gin-like web framework? A distributed cache like groupcache? Or a simple Python interpreter? Hope this repo can give you the answer.
 
-Gee 的设计与实现参考了Gin，[Go Gin简明教程](https://geektutu.com/post/quick-go-gin.html)可以快速入门。
+## Web Framework - Gee
 
-#### [教程目录](https://geektutu.com/post/gee.html)
+[Gee](https://geektutu.com/post/gee.html) is a [gin](https://github.com/gin-gonic/gin)-like framework
 
-- [第一天：前置知识(http.Handler接口)](https://geektutu.com/post/gee-day1.html)，[Code - Github](gee-web/day1-http-base)
-- [第二天：上下文设计(Context)](https://geektutu.com/post/gee-day2.html)，[Code - Github](gee-web/day2-context)
-- [第三天：Tire树路由(Router)](https://geektutu.com/post/gee-day3.html)，[Code - Github](gee-web/day3-router)
-- [第四天：分组控制(Group)](https://geektutu.com/post/gee-day4.html)，[Code - Github](gee-web/day4-group)
-- [第五天：中间件(Middleware)](https://geektutu.com/post/gee-day5.html)，[Code - Github](gee-web/day5-middleware)
-- [第六天：HTML模板(Template)](https://geektutu.com/post/gee-day6.html)，[Code - Github](gee-web/day6-template)
-- [第七天：错误恢复(Panic Recover)](https://geektutu.com/post/gee-day7.html)，[Code - Github](gee-web/day7-panic-recover)
+- Day 1 - http.Handler Interface Basic [Code](gee-web/day1-http-base)
+- Day 2 - Design a Flexiable Context [Code](gee-web/day2-context)
+- Day 3 - Router with Tire-Tree Algorithm [Code](gee-web/day3-router)
+- Day 4 - Group Control [Code](gee-web/day4-group)
+- Day 5 - Middleware Mechanism [Code](gee-web/day5-middleware)
+- Day 6 - Embeded Template Support [Code](gee-web/day6-template)
+- Day 7 - Panic Recover & Make it Robust [Code](gee-web/day7-panic-recover)
 
-## 7天用Go从零实现分布式缓存GeeCache
+## Distributed Cache - Geecache
 
-- 第一天：LRU 缓存策略，[Code - Github](gee-cache/day1-lru)
-- 第二天：单节点缓存，[Code - Github](gee-cache/day2-single-node)
+Geecache is a [groupcache](https://github.com/golang/groupcache)-like distributed cache
 
-## WebAssembly Demo
+- Day 1 - LRU (Least Recently Used) Caching Strategy [Code](gee-cache/day1-lru)
+- Day 2 - Single Machine Concurrent Cache [Code](gee-cache/day2-single-node)
+- Day 3 - Launch a HTTP Server [Code](gee-cache/day3-http-server)
+- Day 4 - Consistent Hash Algorithm [Code](gee-cache/day4-consistent-hash)
+- Day 5 - Communication between Distributed Nodes [Code](gee-cache/day5-multi-nodes)
 
-#### [教程地址](https://geektutu.com/post/quick-go-wasm.html)
+## Golang WebAssembly Demo
 
-- [1. Hello World](demo-wasm/hello-world)
-- [2. 注册函数](demo-wasm/register-functions)
-- [3. 操作 DOM](demo-wasm/manipulate-dom)
-- [4. 回调函数](demo-wasm/callback)
\ No newline at end of file
+- Demo 1 - Hello World [Code](demo-wasm/hello-world)
+- Demo 2 - Register Functions [Code](demo-wasm/register-functions)
+- Demo 3 - Manipulate DOM [Code](demo-wasm/manipulate-dom)
+- Demo 4 - Callback [Code](demo-wasm/callback)
\ No newline at end of file
diff --git a/gee-web/README.md b/gee-web/README.md
index 3361183..67ccdf2 100644
--- a/gee-web/README.md
+++ b/gee-web/README.md
@@ -1,8 +1,14 @@
-# 7天用Go从零实现Web框架Gee
+# 7 Days Go Web Framework Gee from Scratch
+
+<details>
+<summary>README 中文版本</summary>
+<div>
+
+## 7天用Go从零实现Web框架Gee
 
 ![Gee](doc/gee/gee.jpg)
 
-## 教程目录
+### Content
 
 - [第一天：前置知识(http.Handler接口)](https://geektutu.com/post/gee-day1.html)
 - [第二天：上下文设计(Context)](https://geektutu.com/post/gee-day2.html)
@@ -12,6 +18,9 @@
 - [第六天：HTML模板(Template)](https://geektutu.com/post/gee-day6.html)
 - [第七天：错误恢复(Panic Recover)](https://geektutu.com/post/gee-day7.html)
 
+</div>
+</details>
+
 ## Day 1 - Static Route
 
 ```go

From 4b49356dd28779f8890d3da0365a327b93ab5c15 Mon Sep 17 00:00:00 2001
From: gzdaijie <gzdaijie@163.com>
Date: Thu, 6 Feb 2020 22:51:06 +0800
Subject: [PATCH 023/122] day 6, support single flight

---
 gee-cache/day5-multi-nodes/run.sh             |   6 +
 .../day6-single-flight/geecache/byteview.go   |  21 +++
 .../day6-single-flight/geecache/cache.go      |  35 +++++
 .../geecache/consistenthash/consistenthash.go |  58 ++++++++
 .../consistenthash/consistenthash_test.go     |  43 ++++++
 .../day6-single-flight/geecache/geecache.go   | 136 ++++++++++++++++++
 .../geecache/geecache_test.go                 |  48 +++++++
 gee-cache/day6-single-flight/geecache/go.mod  |   3 +
 gee-cache/day6-single-flight/geecache/http.go | 128 +++++++++++++++++
 .../day6-single-flight/geecache/lru/lru.go    |  79 ++++++++++
 .../geecache/lru/lru_test.go                  |  55 +++++++
 .../day6-single-flight/geecache/peers.go      |  12 ++
 .../geecache/singleflight/singleflight.go     |  46 ++++++
 .../singleflight/singleflight_test.go         |  16 +++
 gee-cache/day6-single-flight/go.mod           |   7 +
 gee-cache/day6-single-flight/main.go          |  87 +++++++++++
 gee-cache/day6-single-flight/run.sh           |  15 ++
 17 files changed, 795 insertions(+)
 create mode 100644 gee-cache/day6-single-flight/geecache/byteview.go
 create mode 100644 gee-cache/day6-single-flight/geecache/cache.go
 create mode 100644 gee-cache/day6-single-flight/geecache/consistenthash/consistenthash.go
 create mode 100644 gee-cache/day6-single-flight/geecache/consistenthash/consistenthash_test.go
 create mode 100644 gee-cache/day6-single-flight/geecache/geecache.go
 create mode 100644 gee-cache/day6-single-flight/geecache/geecache_test.go
 create mode 100644 gee-cache/day6-single-flight/geecache/go.mod
 create mode 100644 gee-cache/day6-single-flight/geecache/http.go
 create mode 100644 gee-cache/day6-single-flight/geecache/lru/lru.go
 create mode 100644 gee-cache/day6-single-flight/geecache/lru/lru_test.go
 create mode 100644 gee-cache/day6-single-flight/geecache/peers.go
 create mode 100644 gee-cache/day6-single-flight/geecache/singleflight/singleflight.go
 create mode 100644 gee-cache/day6-single-flight/geecache/singleflight/singleflight_test.go
 create mode 100644 gee-cache/day6-single-flight/go.mod
 create mode 100644 gee-cache/day6-single-flight/main.go
 create mode 100755 gee-cache/day6-single-flight/run.sh

diff --git a/gee-cache/day5-multi-nodes/run.sh b/gee-cache/day5-multi-nodes/run.sh
index d19b4c8..066979d 100755
--- a/gee-cache/day5-multi-nodes/run.sh
+++ b/gee-cache/day5-multi-nodes/run.sh
@@ -6,4 +6,10 @@ go build -o server
 ./server -port=8002 &
 ./server -port=8003 -api=1 &
 
+sleep 2
+echo ">>> start test"
+curl "http://localhost:9999/api?key=Tom" &
+curl "http://localhost:9999/api?key=Tom" &
+curl "http://localhost:9999/api?key=Tom" &
+
 wait
\ No newline at end of file
diff --git a/gee-cache/day6-single-flight/geecache/byteview.go b/gee-cache/day6-single-flight/geecache/byteview.go
new file mode 100644
index 0000000..a51394f
--- /dev/null
+++ b/gee-cache/day6-single-flight/geecache/byteview.go
@@ -0,0 +1,21 @@
+package geecache
+
+// A ByteView holds an immutable view of bytes.
+type ByteView struct {
+	b []byte
+}
+
+// Len returns the view's length
+func (v ByteView) Len() int {
+	return len(v.b)
+}
+
+// ByteSlice returns a copy of the data as a byte slice.
+func (v ByteView) ByteSlice() []byte {
+	return cloneBytes(v.b)
+}
+
+// String returns the data as a string, making a copy if necessary.
+func (v ByteView) String() string {
+	return string(v.b)
+}
diff --git a/gee-cache/day6-single-flight/geecache/cache.go b/gee-cache/day6-single-flight/geecache/cache.go
new file mode 100644
index 0000000..703d033
--- /dev/null
+++ b/gee-cache/day6-single-flight/geecache/cache.go
@@ -0,0 +1,35 @@
+package geecache
+
+import (
+	"geecache/lru"
+	"sync"
+)
+
+type cache struct {
+	mu         sync.RWMutex
+	lru        *lru.Cache
+	cacheBytes int64
+}
+
+func (c *cache) add(key string, value ByteView) {
+	c.mu.RLock()
+	defer c.mu.RUnlock()
+	if c.lru == nil {
+		c.lru = lru.New(c.cacheBytes, nil)
+	}
+	c.lru.Add(key, value)
+}
+
+func (c *cache) get(key string) (value ByteView, ok bool) {
+	c.mu.RLock()
+	defer c.mu.RUnlock()
+	if c.lru == nil {
+		return
+	}
+
+	if v, ok := c.lru.Get(key); ok {
+		return v.(ByteView), ok
+	}
+
+	return
+}
diff --git a/gee-cache/day6-single-flight/geecache/consistenthash/consistenthash.go b/gee-cache/day6-single-flight/geecache/consistenthash/consistenthash.go
new file mode 100644
index 0000000..c8c9082
--- /dev/null
+++ b/gee-cache/day6-single-flight/geecache/consistenthash/consistenthash.go
@@ -0,0 +1,58 @@
+package consistenthash
+
+import (
+	"hash/crc32"
+	"sort"
+	"strconv"
+)
+
+// Hash maps bytes to uint32
+type Hash func(data []byte) uint32
+
+// Map constains all hashed keys
+type Map struct {
+	hash     Hash
+	replicas int
+	keys     []int // Sorted
+	hashMap  map[int]string
+}
+
+// New creates a Map instance
+func New(replicas int, fn Hash) *Map {
+	m := &Map{
+		replicas: replicas,
+		hash:     fn,
+		hashMap:  make(map[int]string),
+	}
+	if m.hash == nil {
+		m.hash = crc32.ChecksumIEEE
+	}
+	return m
+}
+
+// Add adds some keys to the hash.
+func (m *Map) Add(keys ...string) {
+	for _, key := range keys {
+		for i := 0; i < m.replicas; i++ {
+			hash := int(m.hash([]byte(strconv.Itoa(i) + key)))
+			m.keys = append(m.keys, hash)
+			m.hashMap[hash] = key
+		}
+	}
+	sort.Ints(m.keys)
+}
+
+// Get gets the closest item in the hash to the provided key.
+func (m *Map) Get(key string) string {
+	if len(m.keys) == 0 {
+		return ""
+	}
+
+	hash := int(m.hash([]byte(key)))
+	// Binary search for appropriate replica.
+	idx := sort.Search(len(m.keys), func(i int) bool {
+		return m.keys[i] >= hash
+	})
+
+	return m.hashMap[m.keys[idx%len(m.keys)]]
+}
diff --git a/gee-cache/day6-single-flight/geecache/consistenthash/consistenthash_test.go b/gee-cache/day6-single-flight/geecache/consistenthash/consistenthash_test.go
new file mode 100644
index 0000000..34e1275
--- /dev/null
+++ b/gee-cache/day6-single-flight/geecache/consistenthash/consistenthash_test.go
@@ -0,0 +1,43 @@
+package consistenthash
+
+import (
+	"strconv"
+	"testing"
+)
+
+func TestHashing(t *testing.T) {
+	hash := New(3, func(key []byte) uint32 {
+		i, _ := strconv.Atoi(string(key))
+		return uint32(i)
+	})
+
+	// Given the above hash function, this will give replicas with "hashes":
+	// 2, 4, 6, 12, 14, 16, 22, 24, 26
+	hash.Add("6", "4", "2")
+
+	testCases := map[string]string{
+		"2":  "2",
+		"11": "2",
+		"23": "4",
+		"27": "2",
+	}
+
+	for k, v := range testCases {
+		if hash.Get(k) != v {
+			t.Errorf("Asking for %s, should have yielded %s", k, v)
+		}
+	}
+
+	// Adds 8, 18, 28
+	hash.Add("8")
+
+	// 27 should now map to 8.
+	testCases["27"] = "8"
+
+	for k, v := range testCases {
+		if hash.Get(k) != v {
+			t.Errorf("Asking for %s, should have yielded %s", k, v)
+		}
+	}
+
+}
diff --git a/gee-cache/day6-single-flight/geecache/geecache.go b/gee-cache/day6-single-flight/geecache/geecache.go
new file mode 100644
index 0000000..3965674
--- /dev/null
+++ b/gee-cache/day6-single-flight/geecache/geecache.go
@@ -0,0 +1,136 @@
+package geecache
+
+import (
+	"fmt"
+	"geecache/singleflight"
+	"log"
+	"sync"
+)
+
+// A Group is a cache namespace and associated data loaded spread over
+type Group struct {
+	name      string
+	getter    Getter
+	mainCache cache
+	peers     PeerPicker
+	// use singleflight.Group to make sure that
+	// each key is only fetched once
+	loader *singleflight.Group
+}
+
+// A Getter loads data for a key.
+type Getter interface {
+	Get(key string) ([]byte, error)
+}
+
+// A GetterFunc implements Getter with a function.
+type GetterFunc func(key string) ([]byte, error)
+
+// Get implements Getter interface function
+func (f GetterFunc) Get(key string) ([]byte, error) {
+	return f(key)
+}
+
+var (
+	mu     sync.RWMutex
+	groups = make(map[string]*Group)
+)
+
+// NewGroup create a new instance of Group
+func NewGroup(name string, cacheBytes int64, getter Getter) *Group {
+	if getter == nil {
+		panic("nil Getter")
+	}
+	mu.Lock()
+	defer mu.Unlock()
+	g := &Group{
+		name:      name,
+		getter:    getter,
+		mainCache: cache{cacheBytes: cacheBytes},
+		loader:    &singleflight.Group{},
+	}
+	groups[name] = g
+	return g
+}
+
+// GetGroup returns the named group previously created with NewGroup, or
+// nil if there's no such group.
+func GetGroup(name string) *Group {
+	mu.RLock()
+	g := groups[name]
+	mu.RUnlock()
+	return g
+}
+
+// Get value for a key from cache
+func (g *Group) Get(key string) (ByteView, error) {
+	if key == "" {
+		return ByteView{}, fmt.Errorf("key is required")
+	}
+
+	if v, ok := g.mainCache.get(key); ok {
+		log.Println("[GeeCache] hit")
+		return v, nil
+	}
+
+	return g.load(key)
+}
+
+// RegisterPeers registers a PeerPicker for choosing remote peer
+func (g *Group) RegisterPeers(peers PeerPicker) {
+	if g.peers != nil {
+		panic("RegisterPeerPicker called more than once")
+	}
+	g.peers = peers
+}
+
+func cloneBytes(b []byte) []byte {
+	c := make([]byte, len(b))
+	copy(c, b)
+	return c
+}
+
+func (g *Group) load(key string) (value ByteView, err error) {
+	// each key is only fetched once (either locally or remotely)
+	// regardless of the number of concurrent callers.
+	viewi, err := g.loader.Do(key, func() (interface{}, error) {
+		if g.peers != nil {
+			if peer, ok := g.peers.PickPeer(key); ok {
+				if value, err = g.getFromPeer(peer, key); err == nil {
+					return value, nil
+				}
+				log.Println("[GeeCache] Failed to get from peer", err)
+			}
+		}
+
+		return g.getLocally(key)
+	})
+
+	if err == nil {
+		return viewi.(ByteView), nil
+	}
+	return
+}
+
+func (g *Group) populateCache(key string, value ByteView) {
+	g.mainCache.add(key, value)
+}
+
+func (g *Group) getLocally(key string) (ByteView, error) {
+	bytes, err := g.getter.Get(key)
+	if err != nil {
+		return ByteView{}, err
+
+	}
+	value := ByteView{b: cloneBytes(bytes)}
+	g.populateCache(key, value)
+	return value, nil
+}
+
+func (g *Group) getFromPeer(peer PeerGetter, key string) (ByteView, error) {
+	bytes, err := peer.Get(g.name, key)
+	if err != nil {
+		return ByteView{}, err
+	}
+	return ByteView{b: bytes}, nil
+}
diff --git a/gee-cache/day6-single-flight/geecache/geecache_test.go b/gee-cache/day6-single-flight/geecache/geecache_test.go
new file mode 100644
index 0000000..9cb4079
--- /dev/null
+++ b/gee-cache/day6-single-flight/geecache/geecache_test.go
@@ -0,0 +1,48 @@
+package geecache
+
+import (
+	"fmt"
+	"log"
+	"testing"
+)
+
+var db = map[string]string{
+	"Tom":  "630",
+	"Jack": "589",
+	"Sam":  "567",
+}
+
+func TestGet(t *testing.T) {
+	gee := NewGroup("scores", 2<<10, GetterFunc(
+		func(key string) ([]byte, error) {
+			log.Println("[SlowDB] search key", key)
+			if v, ok := db[key]; ok {
+				return []byte(v), nil
+			}
+			return nil, fmt.Errorf("%s not exist", key)
+		}))
+
+	for k, v := range db {
+		view, err := gee.Get(k)
+		if err != nil || view.String() != v {
+			t.Fatal("failed to get value of Tom")
+		}
+	}
+
+	if view, err := gee.Get("unknown"); err == nil {
+		t.Fatalf("the value of unknow should be empty, but %s got", view)
+	}
+}
+
+func TestGetGroup(t *testing.T) {
+	groupName := "scores"
+	NewGroup(groupName, 2<<10, GetterFunc(
+		func(key string) (bytes []byte, err error) { return }))
+	if group := GetGroup(groupName); group == nil || group.name != groupName {
+		t.Fatalf("group %s not exist", groupName)
+	}
+
+	if group := GetGroup(groupName + "111"); group != nil {
+		t.Fatalf("expect nil, but %s got", group.name)
+	}
+}
diff --git a/gee-cache/day6-single-flight/geecache/go.mod b/gee-cache/day6-single-flight/geecache/go.mod
new file mode 100644
index 0000000..f9d454e
--- /dev/null
+++ b/gee-cache/day6-single-flight/geecache/go.mod
@@ -0,0 +1,3 @@
+module geecache
+
+go 1.13
diff --git a/gee-cache/day6-single-flight/geecache/http.go b/gee-cache/day6-single-flight/geecache/http.go
new file mode 100644
index 0000000..d7da2c3
--- /dev/null
+++ b/gee-cache/day6-single-flight/geecache/http.go
@@ -0,0 +1,128 @@
+package geecache
+
+import (
+	"fmt"
+	"geecache/consistenthash"
+	"io/ioutil"
+	"log"
+	"net/http"
+	"net/url"
+	"strings"
+	"sync"
+)
+
+const (
+	defaultBasePath = "/_geecache/"
+	defaultReplicas = 50
+)
+
+// HTTPPool implements PeerPicker for a pool of HTTP peers.
+type HTTPPool struct {
+	// this peer's base URL, e.g. "https://example.net:8000"
+	self        string
+	basePath    string
+	mu          sync.Mutex // guards peers and httpGetters
+	peers       *consistenthash.Map
+	httpGetters map[string]*httpGetter // keyed by e.g. "http://10.0.0.2:8008"
+}
+
+// NewHTTPPool initializes an HTTP pool of peers, and registers itself as a PeerPicker.
+func NewHTTPPool(self string) *HTTPPool {
+	return &HTTPPool{
+		self:     self,
+		basePath: defaultBasePath,
+	}
+}
+
+// Log info with server name
+func (p *HTTPPool) Log(format string, v ...interface{}) {
+	log.Printf("[Server %s] %s", p.self, fmt.Sprintf(format, v...))
+}
+
+// ServeHTTP handle all http requests
+func (p *HTTPPool) ServeHTTP(w http.ResponseWriter, r *http.Request) {
+	if !strings.HasPrefix(r.URL.Path, p.basePath) {
+		panic("HTTPPool serving unexpected path: " + r.URL.Path)
+	}
+	p.Log("%s %s", r.Method, r.URL.Path)
+	// /<basepath>/<groupname>/<key> required
+	parts := strings.SplitN(r.URL.Path[len(p.basePath):], "/", 2)
+	if len(parts) != 2 {
+		http.Error(w, "bad request", http.StatusBadRequest)
+		return
+	}
+
+	groupName := parts[0]
+	key := parts[1]
+
+	group := GetGroup(groupName)
+	if group == nil {
+		http.Error(w, "no such group: "+groupName, http.StatusNotFound)
+		return
+	}
+
+	view, err := group.Get(key)
+	if err != nil {
+		http.Error(w, err.Error(), http.StatusInternalServerError)
+		return
+	}
+
+	w.Header().Set("Content-Type", "application/octet-stream")
+	w.Write(view.ByteSlice())
+}
+
+// Set updates the pool's list of peers.
+func (p *HTTPPool) Set(peers ...string) {
+	p.mu.Lock()
+	defer p.mu.Unlock()
+	p.peers = consistenthash.New(defaultReplicas, nil)
+	p.peers.Add(peers...)
+	p.httpGetters = make(map[string]*httpGetter, len(peers))
+	for _, peer := range peers {
+		p.httpGetters[peer] = &httpGetter{baseURL: peer + p.basePath}
+	}
+}
+
+// PickPeer picks a peer according to key
+func (p *HTTPPool) PickPeer(key string) (PeerGetter, bool) {
+	p.mu.Lock()
+	defer p.mu.Unlock()
+	if peer := p.peers.Get(key); peer != "" && peer != p.self {
+		p.Log("Pick peer %s", peer)
+		return p.httpGetters[peer], true
+	}
+	return nil, false
+}
+
+var _ PeerPicker = (*HTTPPool)(nil)
+
+type httpGetter struct {
+	baseURL string
+}
+
+func (h *httpGetter) Get(group string, key string) ([]byte, error) {
+	u := fmt.Sprintf(
+		"%v%v/%v",
+		h.baseURL,
+		url.QueryEscape(group),
+		url.QueryEscape(key),
+	)
+	res, err := http.Get(u)
+	if err != nil {
+		return nil, err
+	}
+	defer res.Body.Close()
+
+	if res.StatusCode != http.StatusOK {
+		return nil, fmt.Errorf("server returned: %v", res.Status)
+	}
+
+	bytes, err := ioutil.ReadAll(res.Body)
+	if err != nil {
+		return nil, fmt.Errorf("reading response body: %v", err)
+	}
+
+	return bytes, nil
+}
+
+var _ PeerGetter = (*httpGetter)(nil)
diff --git a/gee-cache/day6-single-flight/geecache/lru/lru.go b/gee-cache/day6-single-flight/geecache/lru/lru.go
new file mode 100644
index 0000000..81eee43
--- /dev/null
+++ b/gee-cache/day6-single-flight/geecache/lru/lru.go
@@ -0,0 +1,79 @@
+package lru
+
+import "container/list"
+
+// Cache is a LRU cache. It is not safe for concurrent access.
+type Cache struct {
+	maxBytes int64
+	nbytes   int64
+	ll       *list.List
+	cache    map[string]*list.Element
+	// optional and executed when an entry is purged.
+	OnEvicted func(key string, value Value)
+}
+
+type entry struct {
+	key   string
+	value Value
+}
+
+// Value use Len to count how many bytes it takes
+type Value interface {
+	Len() int
+}
+
+// New is the Constructor of Cache
+func New(maxBytes int64, onEvicted func(string, Value)) *Cache {
+	return &Cache{
+		maxBytes:  maxBytes,
+		ll:        list.New(),
+		cache:     make(map[string]*list.Element),
+		OnEvicted: onEvicted,
+	}
+}
+
+// Add adds a value to the cache.
+func (c *Cache) Add(key string, value Value) {
+	if ele, ok := c.cache[key]; ok {
+		c.ll.MoveToFront(ele)
+		kv := ele.Value.(*entry)
+		kv.value = value
+		return
+	}
+	ele := c.ll.PushFront(&entry{key, value})
+	c.cache[key] = ele
+	c.nbytes += int64(len(key)) + int64(value.Len())
+
+	for c.maxBytes != 0 && c.maxBytes < c.nbytes {
+		c.RemoveOldest()
+	}
+}
+
+// Get look ups a key's value
+func (c *Cache) Get(key string) (value Value, ok bool) {
+	if ele, ok := c.cache[key]; ok {
+		c.ll.MoveToFront(ele)
+		kv := ele.Value.(*entry)
+		return kv.value, true
+	}
+	return
+}
+
+// RemoveOldest removes the oldest item
+func (c *Cache) RemoveOldest() {
+	ele := c.ll.Back()
+	if ele != nil {
+		c.ll.Remove(ele)
+		kv := ele.Value.(*entry)
+		delete(c.cache, kv.key)
+		c.nbytes -= int64(len(kv.key)) + int64(kv.value.Len())
+		if c.OnEvicted != nil {
+			c.OnEvicted(kv.key, kv.value)
+		}
+	}
+}
+
+// Len the number of cache entries
+func (c *Cache) Len() int {
+	return c.ll.Len()
+}
diff --git a/gee-cache/day6-single-flight/geecache/lru/lru_test.go b/gee-cache/day6-single-flight/geecache/lru/lru_test.go
new file mode 100644
index 0000000..7308322
--- /dev/null
+++ b/gee-cache/day6-single-flight/geecache/lru/lru_test.go
@@ -0,0 +1,55 @@
+package lru
+
+import (
+	"reflect"
+	"testing"
+)
+
+type String string
+
+func (d String) Len() int {
+	return len(d)
+}
+
+func TestGet(t *testing.T) {
+	lru := New(int64(0), nil)
+	lru.Add("key1", String("1234"))
+	if v, ok := lru.Get("key1"); !ok || string(v.(String)) != "1234" {
+		t.Fatalf("cache hit key1=1234 failed")
+	}
+	if _, ok := lru.Get("key2"); ok {
+		t.Fatalf("cache miss key2 failed")
+	}
+}
+
+func TestRemoveoldest(t *testing.T) {
+	k1, k2, k3 := "key1", "key2", "k3"
+	v1, v2, v3 := "value1", "value2", "v3"
+	cap := len(k1 + k2 + v1 + v2)
+	lru := New(int64(cap), nil)
+	lru.Add(k1, String(v1))
+	lru.Add(k2, String(v2))
+	lru.Add(k3, String(v3))
+
+	if _, ok := lru.Get("key1"); ok || lru.Len() != 2 {
+		t.Fatalf("Removeoldest key1 failed")
+	}
+}
+
+func TestOnEvicted(t *testing.T) {
+	keys := make([]string, 0)
+	callback := func(key string, value Value) {
+		keys = append(keys, key)
+	}
+	lru := New(int64(10), callback)
+	lru.Add("key1", String("123456"))
+	lru.Add("k2", String("k2"))
+	lru.Add("k3", String("k3"))
+	lru.Add("k4", String("k4"))
+
+	expect := []string{"key1", "k2"}
+
+	if !reflect.DeepEqual(expect, keys) {
+		t.Fatalf("Call OnEvicted failed, expect keys equals to %s", expect)
+	}
+}
diff --git a/gee-cache/day6-single-flight/geecache/peers.go b/gee-cache/day6-single-flight/geecache/peers.go
new file mode 100644
index 0000000..8d010e2
--- /dev/null
+++ b/gee-cache/day6-single-flight/geecache/peers.go
@@ -0,0 +1,12 @@
+package geecache
+
+// PeerPicker is the interface that must be implemented to locate
+// the peer that owns a specific key.
+type PeerPicker interface {
+	PickPeer(key string) (peer PeerGetter, ok bool)
+}
+
+// PeerGetter is the interface that must be implemented by a peer.
+type PeerGetter interface {
+	Get(group string, key string) ([]byte, error)
+}
diff --git a/gee-cache/day6-single-flight/geecache/singleflight/singleflight.go b/gee-cache/day6-single-flight/geecache/singleflight/singleflight.go
new file mode 100644
index 0000000..85bd0dd
--- /dev/null
+++ b/gee-cache/day6-single-flight/geecache/singleflight/singleflight.go
@@ -0,0 +1,46 @@
+package singleflight
+
+import "sync"
+
+// call is an in-flight or completed Do call
+type call struct {
+	wg  sync.WaitGroup
+	val interface{}
+	err error
+}
+
+// Group represents a class of work and forms a namespace in which
+// units of work can be executed with duplicate suppression.
+type Group struct {
+	mu sync.Mutex       // protects m
+	m  map[string]*call // lazily initialized
+}
+
+// Do executes and returns the results of the given function, making
+// sure that only one execution is in-flight for a given key at a
+// time. If a duplicate comes in, the duplicate caller waits for the
+// original to complete and receives the same results.
+func (g *Group) Do(key string, fn func() (interface{}, error)) (interface{}, error) {
+	g.mu.Lock()
+	if g.m == nil {
+		g.m = make(map[string]*call)
+	}
+	if c, ok := g.m[key]; ok {
+		g.mu.Unlock()
+		c.wg.Wait()
+		return c.val, c.err
+	}
+	c := new(call)
+	c.wg.Add(1)
+	g.m[key] = c
+	g.mu.Unlock()
+
+	c.val, c.err = fn()
+	c.wg.Done()
+
+	g.mu.Lock()
+	delete(g.m, key)
+	g.mu.Unlock()
+
+	return c.val, c.err
+}
diff --git a/gee-cache/day6-single-flight/geecache/singleflight/singleflight_test.go b/gee-cache/day6-single-flight/geecache/singleflight/singleflight_test.go
new file mode 100644
index 0000000..450951a
--- /dev/null
+++ b/gee-cache/day6-single-flight/geecache/singleflight/singleflight_test.go
@@ -0,0 +1,16 @@
+package singleflight
+
+import (
+	"testing"
+)
+
+func TestDo(t *testing.T) {
+	var g Group
+	v, err := g.Do("key", func() (interface{}, error) {
+		return "bar", nil
+	})
+
+	if v != "bar" || err != nil {
+		t.Errorf("Do v = %v, error = %v", v, err)
+	}
+}
diff --git a/gee-cache/day6-single-flight/go.mod b/gee-cache/day6-single-flight/go.mod
new file mode 100644
index 0000000..d0fd3ba
--- /dev/null
+++ b/gee-cache/day6-single-flight/go.mod
@@ -0,0 +1,7 @@
+module example
+
+go 1.13
+
+require geecache v0.0.0
+
+replace geecache => ./geecache
diff --git a/gee-cache/day6-single-flight/main.go b/gee-cache/day6-single-flight/main.go
new file mode 100644
index 0000000..a99940c
--- /dev/null
+++ b/gee-cache/day6-single-flight/main.go
@@ -0,0 +1,87 @@
+package main
+
+/*
+$ curl "http://localhost:9999/api?key=Tom"
+630
+
+$ curl "http://localhost:9999/api?key=kkk"
+kkk not exist
+*/
+
+import (
+	"flag"
+	"fmt"
+	"geecache"
+	"log"
+	"net/http"
+)
+
+var db = map[string]string{
+	"Tom":  "630",
+	"Jack": "589",
+	"Sam":  "567",
+}
+
+func createGroup() *geecache.Group {
+	return geecache.NewGroup("scores", 2<<10, geecache.GetterFunc(
+		func(key string) ([]byte, error) {
+			log.Println("[SlowDB] search key", key)
+			if v, ok := db[key]; ok {
+				return []byte(v), nil
+			}
+			return nil, fmt.Errorf("%s not exist", key)
+		}))
+}
+
+func startCacheServer(addr string, addrs []string, gee *geecache.Group) {
+	peers := geecache.NewHTTPPool(addr)
+	peers.Set(addrs...)
+	gee.RegisterPeers(peers)
+	log.Println("geecache is running at", addr)
+	log.Fatal(http.ListenAndServe(addr[7:], peers))
+}
+
+func startAPIServer(apiAddr string, gee *geecache.Group) {
+	http.Handle("/api", http.HandlerFunc(
+		func(w http.ResponseWriter, r *http.Request) {
+			key := r.URL.Query().Get("key")
+			view, err := gee.Get(key)
+			if err != nil {
+				http.Error(w, err.Error(), http.StatusInternalServerError)
+				return
+			}
+			w.Header().Set("Content-Type", "application/octet-stream")
+			w.Write(view.ByteSlice())
+
+		}))
+	log.Println("fontend server is running at", apiAddr)
+	log.Fatal(http.ListenAndServe(apiAddr[7:], nil))
+
+}
+
+func main() {
+	var port int
+	var api bool
+	flag.IntVar(&port, "port", 8001, "Geecache server port")
+	flag.BoolVar(&api, "api", false, "Start a api server?")
+	flag.Parse()
+
+	apiAddr := "http://localhost:9999"
+	addrMap := map[int]string{
+		8001: "http://localhost:8001",
+		8002: "http://localhost:8002",
+		8003: "http://localhost:8003",
+	}
+
+	addrs := make([]string, 3)
+
+	for _, v := range addrMap {
+		addrs = append(addrs, v)
+	}
+
+	gee := createGroup()
+	if api {
+		go startAPIServer(apiAddr, gee)
+	}
+	startCacheServer(addrMap[port], []string(addrs), gee)
+}
diff --git a/gee-cache/day6-single-flight/run.sh b/gee-cache/day6-single-flight/run.sh
new file mode 100755
index 0000000..066979d
--- /dev/null
+++ b/gee-cache/day6-single-flight/run.sh
@@ -0,0 +1,15 @@
+#!/bin/bash
+trap "rm server;kill 0" EXIT
+
+go build -o server
+./server -port=8001 &
+./server -port=8002 &
+./server -port=8003 -api=1 &
+
+sleep 2
+echo ">>> start test"
+curl "http://localhost:9999/api?key=Tom" &
+curl "http://localhost:9999/api?key=Tom" &
+curl "http://localhost:9999/api?key=Tom" &
+
+wait
\ No newline at end of file

From 353ffe60d5eb825f6cf843cb045e3e3a1d5cfc2f Mon Sep 17 00:00:00 2001
From: gzdaijie <gzdaijie@163.com>
Date: Thu, 6 Feb 2020 23:32:31 +0800
Subject: [PATCH 024/122] day7 support proto

---
 gee-cache/day7-proto-buf/geecache/byteview.go |  21 +++
 gee-cache/day7-proto-buf/geecache/cache.go    |  35 +++++
 .../geecache/consistenthash/consistenthash.go |  58 +++++++
 .../consistenthash/consistenthash_test.go     |  43 ++++++
 gee-cache/day7-proto-buf/geecache/geecache.go | 142 ++++++++++++++++++
 .../day7-proto-buf/geecache/geecache_test.go  |  48 ++++++
 .../geecache/geecachepb/geecachepb.pb.go      | 128 ++++++++++++++++
 .../geecache/geecachepb/geecachepb.proto      |  16 ++
 gee-cache/day7-proto-buf/geecache/go.mod      |   5 +
 gee-cache/day7-proto-buf/geecache/go.sum      |   2 +
 gee-cache/day7-proto-buf/geecache/http.go     | 135 +++++++++++++++++
 gee-cache/day7-proto-buf/geecache/lru/lru.go  |  79 ++++++++++
 .../day7-proto-buf/geecache/lru/lru_test.go   |  55 +++++++
 gee-cache/day7-proto-buf/geecache/peers.go    |  14 ++
 .../geecache/singleflight/singleflight.go     |  46 ++++++
 .../singleflight/singleflight_test.go         |  16 ++
 gee-cache/day7-proto-buf/go.mod               |   7 +
 gee-cache/day7-proto-buf/go.sum               |   2 +
 gee-cache/day7-proto-buf/main.go              |  87 +++++++++++
 gee-cache/day7-proto-buf/run.sh               |  15 ++
 20 files changed, 954 insertions(+)
 create mode 100644 gee-cache/day7-proto-buf/geecache/byteview.go
 create mode 100644 gee-cache/day7-proto-buf/geecache/cache.go
 create mode 100644 gee-cache/day7-proto-buf/geecache/consistenthash/consistenthash.go
 create mode 100644 gee-cache/day7-proto-buf/geecache/consistenthash/consistenthash_test.go
 create mode 100644 gee-cache/day7-proto-buf/geecache/geecache.go
 create mode 100644 gee-cache/day7-proto-buf/geecache/geecache_test.go
 create mode 100644 gee-cache/day7-proto-buf/geecache/geecachepb/geecachepb.pb.go
 create mode 100644 gee-cache/day7-proto-buf/geecache/geecachepb/geecachepb.proto
 create mode 100644 gee-cache/day7-proto-buf/geecache/go.mod
 create mode 100644 gee-cache/day7-proto-buf/geecache/go.sum
 create mode 100644 gee-cache/day7-proto-buf/geecache/http.go
 create mode 100644 gee-cache/day7-proto-buf/geecache/lru/lru.go
 create mode 100644 gee-cache/day7-proto-buf/geecache/lru/lru_test.go
 create mode 100644 gee-cache/day7-proto-buf/geecache/peers.go
 create mode 100644 gee-cache/day7-proto-buf/geecache/singleflight/singleflight.go
 create mode 100644 gee-cache/day7-proto-buf/geecache/singleflight/singleflight_test.go
 create mode 100644 gee-cache/day7-proto-buf/go.mod
 create mode 100644 gee-cache/day7-proto-buf/go.sum
 create mode 100644 gee-cache/day7-proto-buf/main.go
 create mode 100755 gee-cache/day7-proto-buf/run.sh

diff --git a/gee-cache/day7-proto-buf/geecache/byteview.go b/gee-cache/day7-proto-buf/geecache/byteview.go
new file mode 100644
index 0000000..a51394f
--- /dev/null
+++ b/gee-cache/day7-proto-buf/geecache/byteview.go
@@ -0,0 +1,21 @@
+package geecache
+
+// A ByteView holds an immutable view of bytes.
+type ByteView struct {
+	b []byte
+}
+
+// Len returns the view's length
+func (v ByteView) Len() int {
+	return len(v.b)
+}
+
+// ByteSlice returns a copy of the data as a byte slice.
+func (v ByteView) ByteSlice() []byte {
+	return cloneBytes(v.b)
+}
+
+// String returns the data as a string, making a copy if necessary.
+func (v ByteView) String() string {
+	return string(v.b)
+}
diff --git a/gee-cache/day7-proto-buf/geecache/cache.go b/gee-cache/day7-proto-buf/geecache/cache.go
new file mode 100644
index 0000000..703d033
--- /dev/null
+++ b/gee-cache/day7-proto-buf/geecache/cache.go
@@ -0,0 +1,35 @@
+package geecache
+
+import (
+	"geecache/lru"
+	"sync"
+)
+
+type cache struct {
+	mu         sync.RWMutex
+	lru        *lru.Cache
+	cacheBytes int64
+}
+
+func (c *cache) add(key string, value ByteView) {
+	c.mu.RLock()
+	defer c.mu.RUnlock()
+	if c.lru == nil {
+		c.lru = lru.New(c.cacheBytes, nil)
+	}
+	c.lru.Add(key, value)
+}
+
+func (c *cache) get(key string) (value ByteView, ok bool) {
+	c.mu.RLock()
+	defer c.mu.RUnlock()
+	if c.lru == nil {
+		return
+	}
+
+	if v, ok := c.lru.Get(key); ok {
+		return v.(ByteView), ok
+	}
+
+	return
+}
diff --git a/gee-cache/day7-proto-buf/geecache/consistenthash/consistenthash.go b/gee-cache/day7-proto-buf/geecache/consistenthash/consistenthash.go
new file mode 100644
index 0000000..c8c9082
--- /dev/null
+++ b/gee-cache/day7-proto-buf/geecache/consistenthash/consistenthash.go
@@ -0,0 +1,58 @@
+package consistenthash
+
+import (
+	"hash/crc32"
+	"sort"
+	"strconv"
+)
+
+// Hash maps bytes to uint32
+type Hash func(data []byte) uint32
+
+// Map constains all hashed keys
+type Map struct {
+	hash     Hash
+	replicas int
+	keys     []int // Sorted
+	hashMap  map[int]string
+}
+
+// New creates a Map instance
+func New(replicas int, fn Hash) *Map {
+	m := &Map{
+		replicas: replicas,
+		hash:     fn,
+		hashMap:  make(map[int]string),
+	}
+	if m.hash == nil {
+		m.hash = crc32.ChecksumIEEE
+	}
+	return m
+}
+
+// Add adds some keys to the hash.
+func (m *Map) Add(keys ...string) {
+	for _, key := range keys {
+		for i := 0; i < m.replicas; i++ {
+			hash := int(m.hash([]byte(strconv.Itoa(i) + key)))
+			m.keys = append(m.keys, hash)
+			m.hashMap[hash] = key
+		}
+	}
+	sort.Ints(m.keys)
+}
+
+// Get gets the closest item in the hash to the provided key.
+func (m *Map) Get(key string) string {
+	if len(m.keys) == 0 {
+		return ""
+	}
+
+	hash := int(m.hash([]byte(key)))
+	// Binary search for appropriate replica.
+	idx := sort.Search(len(m.keys), func(i int) bool {
+		return m.keys[i] >= hash
+	})
+
+	return m.hashMap[m.keys[idx%len(m.keys)]]
+}
diff --git a/gee-cache/day7-proto-buf/geecache/consistenthash/consistenthash_test.go b/gee-cache/day7-proto-buf/geecache/consistenthash/consistenthash_test.go
new file mode 100644
index 0000000..34e1275
--- /dev/null
+++ b/gee-cache/day7-proto-buf/geecache/consistenthash/consistenthash_test.go
@@ -0,0 +1,43 @@
+package consistenthash
+
+import (
+	"strconv"
+	"testing"
+)
+
+func TestHashing(t *testing.T) {
+	hash := New(3, func(key []byte) uint32 {
+		i, _ := strconv.Atoi(string(key))
+		return uint32(i)
+	})
+
+	// Given the above hash function, this will give replicas with "hashes":
+	// 2, 4, 6, 12, 14, 16, 22, 24, 26
+	hash.Add("6", "4", "2")
+
+	testCases := map[string]string{
+		"2":  "2",
+		"11": "2",
+		"23": "4",
+		"27": "2",
+	}
+
+	for k, v := range testCases {
+		if hash.Get(k) != v {
+			t.Errorf("Asking for %s, should have yielded %s", k, v)
+		}
+	}
+
+	// Adds 8, 18, 28
+	hash.Add("8")
+
+	// 27 should now map to 8.
+	testCases["27"] = "8"
+
+	for k, v := range testCases {
+		if hash.Get(k) != v {
+			t.Errorf("Asking for %s, should have yielded %s", k, v)
+		}
+	}
+
+}
diff --git a/gee-cache/day7-proto-buf/geecache/geecache.go b/gee-cache/day7-proto-buf/geecache/geecache.go
new file mode 100644
index 0000000..44161bc
--- /dev/null
+++ b/gee-cache/day7-proto-buf/geecache/geecache.go
@@ -0,0 +1,142 @@
+package geecache
+
+import (
+	"fmt"
+	pb "geecache/geecachepb"
+	"geecache/singleflight"
+	"log"
+	"sync"
+)
+
+// A Group is a cache namespace and associated data loaded spread over
+type Group struct {
+	name      string
+	getter    Getter
+	mainCache cache
+	peers     PeerPicker
+	// use singleflight.Group to make sure that
+	// each key is only fetched once
+	loader *singleflight.Group
+}
+
+// A Getter loads data for a key.
+type Getter interface {
+	Get(key string) ([]byte, error)
+}
+
+// A GetterFunc implements Getter with a function.
+type GetterFunc func(key string) ([]byte, error)
+
+// Get implements Getter interface function
+func (f GetterFunc) Get(key string) ([]byte, error) {
+	return f(key)
+}
+
+var (
+	mu     sync.RWMutex
+	groups = make(map[string]*Group)
+)
+
+// NewGroup create a new instance of Group
+func NewGroup(name string, cacheBytes int64, getter Getter) *Group {
+	if getter == nil {
+		panic("nil Getter")
+	}
+	mu.Lock()
+	defer mu.Unlock()
+	g := &Group{
+		name:      name,
+		getter:    getter,
+		mainCache: cache{cacheBytes: cacheBytes},
+		loader:    &singleflight.Group{},
+	}
+	groups[name] = g
+	return g
+}
+
+// GetGroup returns the named group previously created with NewGroup, or
+// nil if there's no such group.
+func GetGroup(name string) *Group {
+	mu.RLock()
+	g := groups[name]
+	mu.RUnlock()
+	return g
+}
+
+// Get value for a key from cache
+func (g *Group) Get(key string) (ByteView, error) {
+	if key == "" {
+		return ByteView{}, fmt.Errorf("key is required")
+	}
+
+	if v, ok := g.mainCache.get(key); ok {
+		log.Println("[GeeCache] hit")
+		return v, nil
+	}
+
+	return g.load(key)
+}
+
+// RegisterPeers registers a PeerPicker for choosing remote peer
+func (g *Group) RegisterPeers(peers PeerPicker) {
+	if g.peers != nil {
+		panic("RegisterPeerPicker called more than once")
+	}
+	g.peers = peers
+}
+
+func cloneBytes(b []byte) []byte {
+	c := make([]byte, len(b))
+	copy(c, b)
+	return c
+}
+
+func (g *Group) load(key string) (value ByteView, err error) {
+	// each key is only fetched once (either locally or remotely)
+	// regardless of the number of concurrent callers.
+	viewi, err := g.loader.Do(key, func() (interface{}, error) {
+		if g.peers != nil {
+			if peer, ok := g.peers.PickPeer(key); ok {
+				if value, err = g.getFromPeer(peer, key); err == nil {
+					return value, nil
+				}
+				log.Println("[GeeCache] Failed to get from peer", err)
+			}
+		}
+
+		return g.getLocally(key)
+	})
+
+	if err == nil {
+		return viewi.(ByteView), nil
+	}
+	return
+}
+
+func (g *Group) populateCache(key string, value ByteView) {
+	g.mainCache.add(key, value)
+}
+
+func (g *Group) getLocally(key string) (ByteView, error) {
+	bytes, err := g.getter.Get(key)
+	if err != nil {
+		return ByteView{}, err
+
+	}
+	value := ByteView{b: cloneBytes(bytes)}
+	g.populateCache(key, value)
+	return value, nil
+}
+
+func (g *Group) getFromPeer(peer PeerGetter, key string) (ByteView, error) {
+	req := &pb.Request{
+		Group: g.name,
+		Key:   key,
+	}
+	res := &pb.Response{}
+	err := peer.Get(req, res)
+	if err != nil {
+		return ByteView{}, err
+	}
+	return ByteView{b: res.Value}, nil
+}
diff --git a/gee-cache/day7-proto-buf/geecache/geecache_test.go b/gee-cache/day7-proto-buf/geecache/geecache_test.go
new file mode 100644
index 0000000..9cb4079
--- /dev/null
+++ b/gee-cache/day7-proto-buf/geecache/geecache_test.go
@@ -0,0 +1,48 @@
+package geecache
+
+import (
+	"fmt"
+	"log"
+	"testing"
+)
+
+var db = map[string]string{
+	"Tom":  "630",
+	"Jack": "589",
+	"Sam":  "567",
+}
+
+func TestGet(t *testing.T) {
+	gee := NewGroup("scores", 2<<10, GetterFunc(
+		func(key string) ([]byte, error) {
+			log.Println("[SlowDB] search key", key)
+			if v, ok := db[key]; ok {
+				return []byte(v), nil
+			}
+			return nil, fmt.Errorf("%s not exist", key)
+		}))
+
+	for k, v := range db {
+		view, err := gee.Get(k)
+		if err != nil || view.String() != v {
+			t.Fatal("failed to get value of Tom")
+		}
+	}
+
+	if view, err := gee.Get("unknown"); err == nil {
+		t.Fatalf("the value of unknow should be empty, but %s got", view)
+	}
+}
+
+func TestGetGroup(t *testing.T) {
+	groupName := "scores"
+	NewGroup(groupName, 2<<10, GetterFunc(
+		func(key string) (bytes []byte, err error) { return }))
+	if group := GetGroup(groupName); group == nil || group.name != groupName {
+		t.Fatalf("group %s not exist", groupName)
+	}
+
+	if group := GetGroup(groupName + "111"); group != nil {
+		t.Fatalf("expect nil, but %s got", group.name)
+	}
+}
diff --git a/gee-cache/day7-proto-buf/geecache/geecachepb/geecachepb.pb.go b/gee-cache/day7-proto-buf/geecache/geecachepb/geecachepb.pb.go
new file mode 100644
index 0000000..d89521d
--- /dev/null
+++ b/gee-cache/day7-proto-buf/geecache/geecachepb/geecachepb.pb.go
@@ -0,0 +1,128 @@
+// Code generated by protoc-gen-go. DO NOT EDIT.
+// source: geecachepb.proto
+
+package geecachepb
+
+import (
+	fmt "fmt"
+	proto "github.com/golang/protobuf/proto"
+	math "math"
+)
+
+// Reference imports to suppress errors if they are not otherwise used.
+var _ = proto.Marshal
+var _ = fmt.Errorf
+var _ = math.Inf
+
+// This is a compile-time assertion to ensure that this generated file
+// is compatible with the proto package it is being compiled against.
+// A compilation error at this line likely means your copy of the
+// proto package needs to be updated.
+const _ = proto.ProtoPackageIsVersion3 // please upgrade the proto package
+
+type Request struct {
+	Group                string   `protobuf:"bytes,1,opt,name=group,proto3" json:"group,omitempty"`
+	Key                  string   `protobuf:"bytes,2,opt,name=key,proto3" json:"key,omitempty"`
+	XXX_NoUnkeyedLiteral struct{} `json:"-"`
+	XXX_unrecognized     []byte   `json:"-"`
+	XXX_sizecache        int32    `json:"-"`
+}
+
+func (m *Request) Reset()         { *m = Request{} }
+func (m *Request) String() string { return proto.CompactTextString(m) }
+func (*Request) ProtoMessage()    {}
+func (*Request) Descriptor() ([]byte, []int) {
+	return fileDescriptor_889d0a4ad37a0d42, []int{0}
+}
+
+func (m *Request) XXX_Unmarshal(b []byte) error {
+	return xxx_messageInfo_Request.Unmarshal(m, b)
+}
+func (m *Request) XXX_Marshal(b []byte, deterministic bool) ([]byte, error) {
+	return xxx_messageInfo_Request.Marshal(b, m, deterministic)
+}
+func (m *Request) XXX_Merge(src proto.Message) {
+	xxx_messageInfo_Request.Merge(m, src)
+}
+func (m *Request) XXX_Size() int {
+	return xxx_messageInfo_Request.Size(m)
+}
+func (m *Request) XXX_DiscardUnknown() {
+	xxx_messageInfo_Request.DiscardUnknown(m)
+}
+
+var xxx_messageInfo_Request proto.InternalMessageInfo
+
+func (m *Request) GetGroup() string {
+	if m != nil {
+		return m.Group
+	}
+	return ""
+}
+
+func (m *Request) GetKey() string {
+	if m != nil {
+		return m.Key
+	}
+	return ""
+}
+
+type Response struct {
+	Value                []byte   `protobuf:"bytes,1,opt,name=value,proto3" json:"value,omitempty"`
+	XXX_NoUnkeyedLiteral struct{} `json:"-"`
+	XXX_unrecognized     []byte   `json:"-"`
+	XXX_sizecache        int32    `json:"-"`
+}
+
+func (m *Response) Reset()         { *m = Response{} }
+func (m *Response) String() string { return proto.CompactTextString(m) }
+func (*Response) ProtoMessage()    {}
+func (*Response) Descriptor() ([]byte, []int) {
+	return fileDescriptor_889d0a4ad37a0d42, []int{1}
+}
+
+func (m *Response) XXX_Unmarshal(b []byte) error {
+	return xxx_messageInfo_Response.Unmarshal(m, b)
+}
+func (m *Response) XXX_Marshal(b []byte, deterministic bool) ([]byte, error) {
+	return xxx_messageInfo_Response.Marshal(b, m, deterministic)
+}
+func (m *Response) XXX_Merge(src proto.Message) {
+	xxx_messageInfo_Response.Merge(m, src)
+}
+func (m *Response) XXX_Size() int {
+	return xxx_messageInfo_Response.Size(m)
+}
+func (m *Response) XXX_DiscardUnknown() {
+	xxx_messageInfo_Response.DiscardUnknown(m)
+}
+
+var xxx_messageInfo_Response proto.InternalMessageInfo
+
+func (m *Response) GetValue() []byte {
+	if m != nil {
+		return m.Value
+	}
+	return nil
+}
+
+func init() {
+	proto.RegisterType((*Request)(nil), "geecachepb.Request")
+	proto.RegisterType((*Response)(nil), "geecachepb.Response")
+}
+
+func init() { proto.RegisterFile("geecachepb.proto", fileDescriptor_889d0a4ad37a0d42) }
+
+var fileDescriptor_889d0a4ad37a0d42 = []byte{
+	// 148 bytes of a gzipped FileDescriptorProto
+	0x1f, 0x8b, 0x08, 0x00, 0x00, 0x00, 0x00, 0x00, 0x02, 0xff, 0xe2, 0x12, 0x48, 0x4f, 0x4d, 0x4d,
+	0x4e, 0x4c, 0xce, 0x48, 0x2d, 0x48, 0xd2, 0x2b, 0x28, 0xca, 0x2f, 0xc9, 0x17, 0xe2, 0x42, 0x88,
+	0x28, 0x19, 0x72, 0xb1, 0x07, 0xa5, 0x16, 0x96, 0xa6, 0x16, 0x97, 0x08, 0x89, 0x70, 0xb1, 0xa6,
+	0x17, 0xe5, 0x97, 0x16, 0x48, 0x30, 0x2a, 0x30, 0x6a, 0x70, 0x06, 0x41, 0x38, 0x42, 0x02, 0x5c,
+	0xcc, 0xd9, 0xa9, 0x95, 0x12, 0x4c, 0x60, 0x31, 0x10, 0x53, 0x49, 0x81, 0x8b, 0x23, 0x28, 0xb5,
+	0xb8, 0x20, 0x3f, 0xaf, 0x38, 0x15, 0xa4, 0xa7, 0x2c, 0x31, 0xa7, 0x34, 0x15, 0xac, 0x87, 0x27,
+	0x08, 0xc2, 0x31, 0xb2, 0xe3, 0xe2, 0x72, 0x07, 0x69, 0x76, 0x06, 0x59, 0x22, 0x64, 0xc0, 0xc5,
+	0xec, 0x9e, 0x5a, 0x22, 0x24, 0xac, 0x87, 0xe4, 0x10, 0xa8, 0x9d, 0x52, 0x22, 0xa8, 0x82, 0x10,
+	0x53, 0x93, 0xd8, 0xc0, 0xee, 0x34, 0x06, 0x04, 0x00, 0x00, 0xff, 0xff, 0x5c, 0xd5, 0xdd, 0x09,
+	0xbb, 0x00, 0x00, 0x00,
+}
diff --git a/gee-cache/day7-proto-buf/geecache/geecachepb/geecachepb.proto b/gee-cache/day7-proto-buf/geecache/geecachepb/geecachepb.proto
new file mode 100644
index 0000000..3f5b313
--- /dev/null
+++ b/gee-cache/day7-proto-buf/geecache/geecachepb/geecachepb.proto
@@ -0,0 +1,16 @@
+syntax = "proto3";
+
+package geecachepb;
+
+message Request {
+  string group = 1;
+  string key = 2;
+}
+
+message Response {
+  bytes value = 1;
+}
+
+service GroupCache {
+  rpc Get(Request) returns (Response);
+}
diff --git a/gee-cache/day7-proto-buf/geecache/go.mod b/gee-cache/day7-proto-buf/geecache/go.mod
new file mode 100644
index 0000000..2ad7119
--- /dev/null
+++ b/gee-cache/day7-proto-buf/geecache/go.mod
@@ -0,0 +1,5 @@
+module geecache
+
+go 1.13
+
+require github.com/golang/protobuf v1.3.3
diff --git a/gee-cache/day7-proto-buf/geecache/go.sum b/gee-cache/day7-proto-buf/geecache/go.sum
new file mode 100644
index 0000000..b1efb8b
--- /dev/null
+++ b/gee-cache/day7-proto-buf/geecache/go.sum
@@ -0,0 +1,2 @@
+github.com/golang/protobuf v1.3.3 h1:gyjaxf+svBWX08ZjK86iN9geUJF0H6gp2IRKX6Nf6/I=
+github.com/golang/protobuf v1.3.3/go.mod h1:vzj43D7+SQXF/4pzW/hwtAqwc6iTitCiVSaWz5lYuqw=
diff --git a/gee-cache/day7-proto-buf/geecache/http.go b/gee-cache/day7-proto-buf/geecache/http.go
new file mode 100644
index 0000000..a4d171c
--- /dev/null
+++ b/gee-cache/day7-proto-buf/geecache/http.go
@@ -0,0 +1,135 @@
+package geecache
+
+import (
+	"fmt"
+	"geecache/consistenthash"
+	pb "geecache/geecachepb"
+	"io/ioutil"
+	"log"
+	"net/http"
+	"net/url"
+	"strings"
+	"sync"
+
+	"github.com/golang/protobuf/proto"
+)
+
+const (
+	defaultBasePath = "/_geecache/"
+	defaultReplicas = 50
+)
+
+// HTTPPool implements PeerPicker for a pool of HTTP peers.
+type HTTPPool struct {
+	// this peer's base URL, e.g. "https://example.net:8000"
+	self        string
+	basePath    string
+	mu          sync.Mutex // guards peers and httpGetters
+	peers       *consistenthash.Map
+	httpGetters map[string]*httpGetter // keyed by e.g. "http://10.0.0.2:8008"
+}
+
+// NewHTTPPool initializes an HTTP pool of peers, and registers itself as a PeerPicker.
+func NewHTTPPool(self string) *HTTPPool {
+	return &HTTPPool{
+		self:     self,
+		basePath: defaultBasePath,
+	}
+}
+
+// Log info with server name
+func (p *HTTPPool) Log(format string, v ...interface{}) {
+	log.Printf("[Server %s] %s", p.self, fmt.Sprintf(format, v...))
+}
+
+// ServeHTTP handle all http requests
+func (p *HTTPPool) ServeHTTP(w http.ResponseWriter, r *http.Request) {
+	if !strings.HasPrefix(r.URL.Path, p.basePath) {
+		panic("HTTPPool serving unexpected path: " + r.URL.Path)
+	}
+	p.Log("%s %s", r.Method, r.URL.Path)
+	// /<basepath>/<groupname>/<key> required
+	parts := strings.SplitN(r.URL.Path[len(p.basePath):], "/", 2)
+	if len(parts) != 2 {
+		http.Error(w, "bad request", http.StatusBadRequest)
+		return
+	}
+
+	groupName := parts[0]
+	key := parts[1]
+
+	group := GetGroup(groupName)
+	if group == nil {
+		http.Error(w, "no such group: "+groupName, http.StatusNotFound)
+		return
+	}
+
+	view, err := group.Get(key)
+	if err != nil {
+		http.Error(w, err.Error(), http.StatusInternalServerError)
+		return
+	}
+
+	w.Header().Set("Content-Type", "application/octet-stream")
+	w.Write(view.ByteSlice())
+}
+
+// Set updates the pool's list of peers.
+func (p *HTTPPool) Set(peers ...string) {
+	p.mu.Lock()
+	defer p.mu.Unlock()
+	p.peers = consistenthash.New(defaultReplicas, nil)
+	p.peers.Add(peers...)
+	p.httpGetters = make(map[string]*httpGetter, len(peers))
+	for _, peer := range peers {
+		p.httpGetters[peer] = &httpGetter{baseURL: peer + p.basePath}
+	}
+}
+
+// PickPeer picks a peer according to key
+func (p *HTTPPool) PickPeer(key string) (PeerGetter, bool) {
+	p.mu.Lock()
+	defer p.mu.Unlock()
+	if peer := p.peers.Get(key); peer != "" && peer != p.self {
+		p.Log("Pick peer %s", peer)
+		return p.httpGetters[peer], true
+	}
+	return nil, false
+}
+
+var _ PeerPicker = (*HTTPPool)(nil)
+
+type httpGetter struct {
+	baseURL string
+}
+
+func (h *httpGetter) Get(in *pb.Request, out *pb.Response) error {
+	u := fmt.Sprintf(
+		"%v%v/%v",
+		h.baseURL,
+		url.QueryEscape(in.GetGroup()),
+		url.QueryEscape(in.GetKey()),
+	)
+	res, err := http.Get(u)
+	if err != nil {
+		return err
+	}
+	defer res.Body.Close()
+
+	if res.StatusCode != http.StatusOK {
+		return fmt.Errorf("server returned: %v", res.Status)
+	}
+
+	bytes, err := ioutil.ReadAll(res.Body)
+	if err != nil {
+		return fmt.Errorf("reading response body: %v", err)
+	}
+
+	if err = proto.Unmarshal(bytes, out); err != nil {
+		return fmt.Errorf("decoding response body: %v", err)
+	}
+
+	return nil
+}
+
+var _ PeerGetter = (*httpGetter)(nil)
diff --git a/gee-cache/day7-proto-buf/geecache/lru/lru.go b/gee-cache/day7-proto-buf/geecache/lru/lru.go
new file mode 100644
index 0000000..81eee43
--- /dev/null
+++ b/gee-cache/day7-proto-buf/geecache/lru/lru.go
@@ -0,0 +1,79 @@
+package lru
+
+import "container/list"
+
+// Cache is a LRU cache. It is not safe for concurrent access.
+type Cache struct {
+	maxBytes int64
+	nbytes   int64
+	ll       *list.List
+	cache    map[string]*list.Element
+	// optional and executed when an entry is purged.
+	OnEvicted func(key string, value Value)
+}
+
+type entry struct {
+	key   string
+	value Value
+}
+
+// Value use Len to count how many bytes it takes
+type Value interface {
+	Len() int
+}
+
+// New is the Constructor of Cache
+func New(maxBytes int64, onEvicted func(string, Value)) *Cache {
+	return &Cache{
+		maxBytes:  maxBytes,
+		ll:        list.New(),
+		cache:     make(map[string]*list.Element),
+		OnEvicted: onEvicted,
+	}
+}
+
+// Add adds a value to the cache.
+func (c *Cache) Add(key string, value Value) {
+	if ele, ok := c.cache[key]; ok {
+		c.ll.MoveToFront(ele)
+		kv := ele.Value.(*entry)
+		kv.value = value
+		return
+	}
+	ele := c.ll.PushFront(&entry{key, value})
+	c.cache[key] = ele
+	c.nbytes += int64(len(key)) + int64(value.Len())
+
+	for c.maxBytes != 0 && c.maxBytes < c.nbytes {
+		c.RemoveOldest()
+	}
+}
+
+// Get look ups a key's value
+func (c *Cache) Get(key string) (value Value, ok bool) {
+	if ele, ok := c.cache[key]; ok {
+		c.ll.MoveToFront(ele)
+		kv := ele.Value.(*entry)
+		return kv.value, true
+	}
+	return
+}
+
+// RemoveOldest removes the oldest item
+func (c *Cache) RemoveOldest() {
+	ele := c.ll.Back()
+	if ele != nil {
+		c.ll.Remove(ele)
+		kv := ele.Value.(*entry)
+		delete(c.cache, kv.key)
+		c.nbytes -= int64(len(kv.key)) + int64(kv.value.Len())
+		if c.OnEvicted != nil {
+			c.OnEvicted(kv.key, kv.value)
+		}
+	}
+}
+
+// Len the number of cache entries
+func (c *Cache) Len() int {
+	return c.ll.Len()
+}
diff --git a/gee-cache/day7-proto-buf/geecache/lru/lru_test.go b/gee-cache/day7-proto-buf/geecache/lru/lru_test.go
new file mode 100644
index 0000000..7308322
--- /dev/null
+++ b/gee-cache/day7-proto-buf/geecache/lru/lru_test.go
@@ -0,0 +1,55 @@
+package lru
+
+import (
+	"reflect"
+	"testing"
+)
+
+type String string
+
+func (d String) Len() int {
+	return len(d)
+}
+
+func TestGet(t *testing.T) {
+	lru := New(int64(0), nil)
+	lru.Add("key1", String("1234"))
+	if v, ok := lru.Get("key1"); !ok || string(v.(String)) != "1234" {
+		t.Fatalf("cache hit key1=1234 failed")
+	}
+	if _, ok := lru.Get("key2"); ok {
+		t.Fatalf("cache miss key2 failed")
+	}
+}
+
+func TestRemoveoldest(t *testing.T) {
+	k1, k2, k3 := "key1", "key2", "k3"
+	v1, v2, v3 := "value1", "value2", "v3"
+	cap := len(k1 + k2 + v1 + v2)
+	lru := New(int64(cap), nil)
+	lru.Add(k1, String(v1))
+	lru.Add(k2, String(v2))
+	lru.Add(k3, String(v3))
+
+	if _, ok := lru.Get("key1"); ok || lru.Len() != 2 {
+		t.Fatalf("Removeoldest key1 failed")
+	}
+}
+
+func TestOnEvicted(t *testing.T) {
+	keys := make([]string, 0)
+	callback := func(key string, value Value) {
+		keys = append(keys, key)
+	}
+	lru := New(int64(10), callback)
+	lru.Add("key1", String("123456"))
+	lru.Add("k2", String("k2"))
+	lru.Add("k3", String("k3"))
+	lru.Add("k4", String("k4"))
+
+	expect := []string{"key1", "k2"}
+
+	if !reflect.DeepEqual(expect, keys) {
+		t.Fatalf("Call OnEvicted failed, expect keys equals to %s", expect)
+	}
+}
diff --git a/gee-cache/day7-proto-buf/geecache/peers.go b/gee-cache/day7-proto-buf/geecache/peers.go
new file mode 100644
index 0000000..9324577
--- /dev/null
+++ b/gee-cache/day7-proto-buf/geecache/peers.go
@@ -0,0 +1,14 @@
+package geecache
+
+import pb "geecache/geecachepb"
+
+// PeerPicker is the interface that must be implemented to locate
+// the peer that owns a specific key.
+type PeerPicker interface {
+	PickPeer(key string) (peer PeerGetter, ok bool)
+}
+
+// PeerGetter is the interface that must be implemented by a peer.
+type PeerGetter interface {
+	Get(in *pb.Request, out *pb.Response) error
+}
diff --git a/gee-cache/day7-proto-buf/geecache/singleflight/singleflight.go b/gee-cache/day7-proto-buf/geecache/singleflight/singleflight.go
new file mode 100644
index 0000000..85bd0dd
--- /dev/null
+++ b/gee-cache/day7-proto-buf/geecache/singleflight/singleflight.go
@@ -0,0 +1,46 @@
+package singleflight
+
+import "sync"
+
+// call is an in-flight or completed Do call
+type call struct {
+	wg  sync.WaitGroup
+	val interface{}
+	err error
+}
+
+// Group represents a class of work and forms a namespace in which
+// units of work can be executed with duplicate suppression.
+type Group struct {
+	mu sync.Mutex       // protects m
+	m  map[string]*call // lazily initialized
+}
+
+// Do executes and returns the results of the given function, making
+// sure that only one execution is in-flight for a given key at a
+// time. If a duplicate comes in, the duplicate caller waits for the
+// original to complete and receives the same results.
+func (g *Group) Do(key string, fn func() (interface{}, error)) (interface{}, error) {
+	g.mu.Lock()
+	if g.m == nil {
+		g.m = make(map[string]*call)
+	}
+	if c, ok := g.m[key]; ok {
+		g.mu.Unlock()
+		c.wg.Wait()
+		return c.val, c.err
+	}
+	c := new(call)
+	c.wg.Add(1)
+	g.m[key] = c
+	g.mu.Unlock()
+
+	c.val, c.err = fn()
+	c.wg.Done()
+
+	g.mu.Lock()
+	delete(g.m, key)
+	g.mu.Unlock()
+
+	return c.val, c.err
+}
diff --git a/gee-cache/day7-proto-buf/geecache/singleflight/singleflight_test.go b/gee-cache/day7-proto-buf/geecache/singleflight/singleflight_test.go
new file mode 100644
index 0000000..450951a
--- /dev/null
+++ b/gee-cache/day7-proto-buf/geecache/singleflight/singleflight_test.go
@@ -0,0 +1,16 @@
+package singleflight
+
+import (
+	"testing"
+)
+
+func TestDo(t *testing.T) {
+	var g Group
+	v, err := g.Do("key", func() (interface{}, error) {
+		return "bar", nil
+	})
+
+	if v != "bar" || err != nil {
+		t.Errorf("Do v = %v, error = %v", v, err)
+	}
+}
diff --git a/gee-cache/day7-proto-buf/go.mod b/gee-cache/day7-proto-buf/go.mod
new file mode 100644
index 0000000..d0fd3ba
--- /dev/null
+++ b/gee-cache/day7-proto-buf/go.mod
@@ -0,0 +1,7 @@
+module example
+
+go 1.13
+
+require geecache v0.0.0
+
+replace geecache => ./geecache
diff --git a/gee-cache/day7-proto-buf/go.sum b/gee-cache/day7-proto-buf/go.sum
new file mode 100644
index 0000000..b1efb8b
--- /dev/null
+++ b/gee-cache/day7-proto-buf/go.sum
@@ -0,0 +1,2 @@
+github.com/golang/protobuf v1.3.3 h1:gyjaxf+svBWX08ZjK86iN9geUJF0H6gp2IRKX6Nf6/I=
+github.com/golang/protobuf v1.3.3/go.mod h1:vzj43D7+SQXF/4pzW/hwtAqwc6iTitCiVSaWz5lYuqw=
diff --git a/gee-cache/day7-proto-buf/main.go b/gee-cache/day7-proto-buf/main.go
new file mode 100644
index 0000000..a99940c
--- /dev/null
+++ b/gee-cache/day7-proto-buf/main.go
@@ -0,0 +1,87 @@
+package main
+
+/*
+$ curl "http://localhost:9999/api?key=Tom"
+630
+
+$ curl "http://localhost:9999/api?key=kkk"
+kkk not exist
+*/
+
+import (
+	"flag"
+	"fmt"
+	"geecache"
+	"log"
+	"net/http"
+)
+
+var db = map[string]string{
+	"Tom":  "630",
+	"Jack": "589",
+	"Sam":  "567",
+}
+
+func createGroup() *geecache.Group {
+	return geecache.NewGroup("scores", 2<<10, geecache.GetterFunc(
+		func(key string) ([]byte, error) {
+			log.Println("[SlowDB] search key", key)
+			if v, ok := db[key]; ok {
+				return []byte(v), nil
+			}
+			return nil, fmt.Errorf("%s not exist", key)
+		}))
+}
+
+func startCacheServer(addr string, addrs []string, gee *geecache.Group) {
+	peers := geecache.NewHTTPPool(addr)
+	peers.Set(addrs...)
+	gee.RegisterPeers(peers)
+	log.Println("geecache is running at", addr)
+	log.Fatal(http.ListenAndServe(addr[7:], peers))
+}
+
+func startAPIServer(apiAddr string, gee *geecache.Group) {
+	http.Handle("/api", http.HandlerFunc(
+		func(w http.ResponseWriter, r *http.Request) {
+			key := r.URL.Query().Get("key")
+			view, err := gee.Get(key)
+			if err != nil {
+				http.Error(w, err.Error(), http.StatusInternalServerError)
+				return
+			}
+			w.Header().Set("Content-Type", "application/octet-stream")
+			w.Write(view.ByteSlice())
+
+		}))
+	log.Println("fontend server is running at", apiAddr)
+	log.Fatal(http.ListenAndServe(apiAddr[7:], nil))
+
+}
+
+func main() {
+	var port int
+	var api bool
+	flag.IntVar(&port, "port", 8001, "Geecache server port")
+	flag.BoolVar(&api, "api", false, "Start a api server?")
+	flag.Parse()
+
+	apiAddr := "http://localhost:9999"
+	addrMap := map[int]string{
+		8001: "http://localhost:8001",
+		8002: "http://localhost:8002",
+		8003: "http://localhost:8003",
+	}
+
+	addrs := make([]string, 3)
+
+	for _, v := range addrMap {
+		addrs = append(addrs, v)
+	}
+
+	gee := createGroup()
+	if api {
+		go startAPIServer(apiAddr, gee)
+	}
+	startCacheServer(addrMap[port], []string(addrs), gee)
+}
diff --git a/gee-cache/day7-proto-buf/run.sh b/gee-cache/day7-proto-buf/run.sh
new file mode 100755
index 0000000..066979d
--- /dev/null
+++ b/gee-cache/day7-proto-buf/run.sh
@@ -0,0 +1,15 @@
+#!/bin/bash
+trap "rm server;kill 0" EXIT
+
+go build -o server
+./server -port=8001 &
+./server -port=8002 &
+./server -port=8003 -api=1 &
+
+sleep 2
+echo ">>> start test"
+curl "http://localhost:9999/api?key=Tom" &
+curl "http://localhost:9999/api?key=Tom" &
+curl "http://localhost:9999/api?key=Tom" &
+
+wait
\ No newline at end of file

From e0f405bb08b7d341caf10e5d1ee0879ab7bf202f Mon Sep 17 00:00:00 2001
From: gzdaijie <gzdaijie@163.com>
Date: Thu, 6 Feb 2020 23:50:37 +0800
Subject: [PATCH 025/122] update README.md, add day6 & day7 code link

---
 README.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/README.md b/README.md
index 9d95aff..2ce094e 100644
--- a/README.md
+++ b/README.md
@@ -31,6 +31,8 @@ GeeCache 是一个模仿 [groupcache](https://github.com/golang/groupcache) 实
 - 第三天：HTTP 服务端 | [Code](gee-cache/day3-http-server)
 - 第四天：一致性哈希(Hash) | [Code](gee-cache/day4-consistent-hash)
 - 第五天：分布式节点 | [Code](gee-cache/day5-multi-nodes)
+- 第六天：防止缓存击穿 | [Code](gee-cache/day6-single-flight)
+- 第七天：使用 Protobuf 通信 | [Code](gee-cache/day7-proto-buf)
 
 ### WebAssembly 使用示例
 
@@ -67,6 +69,8 @@ Geecache is a [groupcache](https://github.com/golang/groupcache)-like distribute
 - Day 3 - Launch a HTTP Server [Code](gee-cache/day3-http-server)
 - Day 4 - Consistent Hash Algorithm [Code](gee-cache/day4-consistent-hash)
 - Day 5 - Communication between Distributed Nodes [Code](gee-cache/day5-multi-nodes)
+- Day 6 - Cache Breakdown & Single Flight  | [Code](gee-cache/day6-single-flight)
+- Day 7 - Use Protobuf as RPC Data Exchange Type | [Code](gee-cache/day7-proto-buf)
 
 ## Golang WebAssembly Demo
 

From 15f1e5c07c4d3247b29432f6d51027fe9f11655d Mon Sep 17 00:00:00 2001
From: gzdaijie <gzdaijie@163.com>
Date: Sat, 8 Feb 2020 02:13:55 +0800
Subject: [PATCH 026/122] add gee-cache doc

---
 README.md                              |   4 +-
 gee-cache/doc/geecache.md              |  72 +++++++++++++++++++++++++
 gee-cache/doc/geecache/geecache.jpg    | Bin 0 -> 29407 bytes
 gee-cache/doc/geecache/geecache_sm.jpg | Bin 0 -> 6713 bytes
 gee-web/doc/gee-day1.md                |   3 +-
 gee-web/doc/gee-day2.md                |   3 +-
 gee-web/doc/gee-day3.md                |   3 +-
 gee-web/doc/gee-day4.md                |   3 +-
 gee-web/doc/gee-day5.md                |   3 +-
 gee-web/doc/gee-day6.md                |   3 +-
 gee-web/doc/gee-day7.md                |   3 +-
 gee-web/doc/gee.md                     |   3 +-
 12 files changed, 90 insertions(+), 10 deletions(-)
 create mode 100644 gee-cache/doc/geecache.md
 create mode 100644 gee-cache/doc/geecache/geecache.jpg
 create mode 100644 gee-cache/doc/geecache/geecache_sm.jpg

diff --git a/README.md b/README.md
index 2ce094e..cdc75ff 100644
--- a/README.md
+++ b/README.md
@@ -24,7 +24,7 @@
 
 ### 7天用Go从零实现分布式缓存 GeeCache
 
-GeeCache 是一个模仿 [groupcache](https://github.com/golang/groupcache) 实现的分布式缓存系统
+[GeeCache](https://geektutu.com/post/geecache.html) 是一个模仿 [groupcache](https://github.com/golang/groupcache) 实现的分布式缓存系统
 
 - 第一天：LRU 缓存策略 | [Code](gee-cache/day1-lru)
 - 第二天：单机并发缓存 | [Code](gee-cache/day2-single-node)
@@ -62,7 +62,7 @@ What can I write in 7 days? A gin-like web framework? A distributed cache like g
 
 ## Distributed Cache - Geecache
 
-Geecache is a [groupcache](https://github.com/golang/groupcache)-like distributed cache
+[GeeCache](https://geektutu.com/post/geecache.html) is a [groupcache](https://github.com/golang/groupcache)-like distributed cache
 
 - Day 1 - LRU (Least Recently Used) Caching Strategy [Code](gee-cache/day1-lru)
 - Day 2 - Single Machine Concurrent Cache [Code](gee-cache/day2-single-node)
diff --git a/gee-cache/doc/geecache.md b/gee-cache/doc/geecache.md
new file mode 100644
index 0000000..21b2f0d
--- /dev/null
+++ b/gee-cache/doc/geecache.md
@@ -0,0 +1,72 @@
+---
+title: 7天用Go从零实现分布式缓存GeeCache
+date: 2020-02-08 01:00:00
+description: 7天用 用 Go语言/golang 从零实现分布式缓存 GeeCache 教程(7 days implement golang distributed cache from scratch tutorial)，动手写分布式缓存，参照 groupcache 的实现。功能包括单机/分布式缓存，LRU (Least Recently Used) 缓存策略，防止缓存击穿、一致性哈希(Consistent Hash)，protobuf 通信等。
+tags:
+- Go
+nav: 从零实现
+categories:
+- 分布式缓存 - GeeCache
+keywords:
+- Go语言
+- 从零实现分布式缓存
+- 动手写分布式缓存
+image: post/geecache/geecache_sm.jpg
+github: https://github.com/geektutu/7days-golang
+---
+
+![分布式缓存geecache](geecache/geecache.jpg)
+
+## 1 谈谈分布式缓存
+
+第一次请求时将一些耗时操作的结果暂存，以后遇到相同的请求，直接返回暂存的数据。我想这是大部分童鞋对于缓存的理解。在计算机系统中，缓存无处不在，比如我们访问一个网页，网页和引用的 JS/CSS 等静态文件，根据不同的策略，会缓存在浏览器本地或是 CDN 服务器，那在第二次访问的时候，就会觉得网页加载的速度快了不少；比如微博的点赞的数量，不可能每个人每次访问，都从数据库中查找所有点赞的记录再统计，数据库的操作是很耗时的，很难支持那么大的流量，所以一般点赞这类数据是缓存在 Redis 服务集群中的。
+
+> 商业世界里，现金为王；架构世界里，缓存为王。
+
+缓存中最简单的莫过于存储在内存中的键值对缓存了。说到键值对，很容易想到的是字典(dict)类型，Go 语言中称之为 map。那直接创建一个 map，每次有新数据就往 map 中插入不就好了，这不就是键值对缓存么？这样做有什么问题呢？
+
+1）内存不够了怎么办？
+
+那就随机删掉几条数据好了。随机删掉好呢？还是按照时间顺序好呢？或者是有没有其他更好的淘汰策略呢？不同数据的访问频率是不一样的，优先删除访问频率低的数据是不是更好呢？数据的访问频率可能随着时间变化，那优先删除最近最少访问的数据可能是一个更好的选择。我们需要实现一个合理的淘汰策略。
+
+2）并发写入冲突了怎么办？
+
+对缓存的访问，一般不可能是串行的。map 是没有并发保护的，应对并发的场景，修改操作(包括新增，更新和删除)需要加锁。
+
+3）单机性能不够怎么办？
+
+单台计算机的资源是有限的，计算、存储等都是有限的。随着业务量和访问量的增加，单台机器很容易遇到瓶颈。如果利用多台计算机的资源，并行处理提高性能就要缓存应用能够支持分布式，这称为水平扩展(scale horizontally)。与水平扩展相对应的是垂直扩展(scale vertically)，即通过增加单个节点的计算、存储、带宽等，来提高系统的性能，硬件的成本和性能并非呈线性关系，大部分情况下，分布式系统是一个更优的选择。
+
+4）...
+
+## 2 关于 GeeCache
+
+设计一个分布式缓存系统，需要考虑资源控制、淘汰策略、并发、分布式节点通信等各个方面的问题。而且，针对不同的应用场景，还需要在不同的特性之间权衡，例如，是否需要支持缓存更新？还是假定缓存在淘汰之前是不允许改变的。不同的权衡对应着不同的实现。
+
+[groupcache](https://github.com/golang/groupcache) 是 Go 语言版的 memcached，目的是在某些特定场合替代 memcached。groupcache 的作者也是 memcached 的作者。无论是了解单机缓存还是分布式缓存，深入学习这个库的实现都是非常有意义的。
+
+`GeeCache` 基本上模仿了 [groupcache](https://github.com/golang/groupcache) 的实现，为了将代码量限制在 500 行左右（groupcache 约 3000 行），裁剪了部分功能。但总体实现上，还是与 groupcache 非常接近的。支持特性有：
+
+- 单机缓存和基于 HTTP 的分布式缓存
+- 最近最少访问(Least Recently Used, LRU) 缓存策略
+- 使用 Go 锁机制防止缓存击穿
+- 使用一致性哈希选择节点，实现负载均衡
+- 使用 protobuf 优化节点间二进制通信
+- ...
+
+`GeeCache` 分7天实现，每天完成的部分都是可以独立运行和测试的，就像搭积木一样，每天实现的特性组合在一起就是最终的分布式缓存系统。每天的代码在 100 行左右。
+
+## 3 目录
+
+- 第一天：LRU 缓存策略 | [Code - Github](https://github.com/geektutu/7days-golang/blob/master/gee-cache/day1-lru)
+- 第二天：单机并发缓存 | [Code - Github](https://github.com/geektutu/7days-golang/blob/master/gee-cache/day2-single-node)
+- 第三天：HTTP 服务端 | [Code - Github](https://github.com/geektutu/7days-golang/blob/master/gee-cache/day3-http-server)
+- 第四天：一致性哈希(Hash) | [Code - Github](https://github.com/geektutu/7days-golang/blob/master/gee-cache/day4-consistent-hash)
+- 第五天：分布式节点 | [Code - Github](https://github.com/geektutu/7days-golang/blob/master/gee-cache/day5-multi-nodes)
+- 第六天：防止缓存击穿 | [Code - Github](https://github.com/geektutu/7days-golang/blob/master/gee-cache/day6-single-flight)
+- 第七天：使用 Protobuf 通信 | [Code - Github](https://github.com/geektutu/7days-golang/blob/master/gee-cache/day7-proto-buf)
+
+## 附 推荐阅读
+
+- [Go 语言简明教程](https://geektutu.com/post/quick-golang.html)
+- [Go Protobuf 简明教程](https://geektutu.com/post/quick-go-protobuf.html)
\ No newline at end of file
diff --git a/gee-cache/doc/geecache/geecache.jpg b/gee-cache/doc/geecache/geecache.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..d19e7fead236e6aee190f73c7ed7e176dfa8d2c4
GIT binary patch
literal 29407
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

literal 0
HcmV?d00001

diff --git a/gee-cache/doc/geecache/geecache_sm.jpg b/gee-cache/doc/geecache/geecache_sm.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..a3832b0be4f66309561f5caabf371d4e332e7937
GIT binary patch
literal 6713
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
QoO?gd&N;?!cKq%C0W4|;x&QzG

literal 0
HcmV?d00001

diff --git a/gee-web/doc/gee-day1.md b/gee-web/doc/gee-day1.md
index fd94496..ca00e8a 100644
--- a/gee-web/doc/gee-day1.md
+++ b/gee-web/doc/gee-day1.md
@@ -4,8 +4,9 @@ date: 2019-08-12 00:10:10
 description: 7天用 Go语言 从零实现Web框架教程(7 days implement golang web framework from scratch tutorial)，用 Go语言/golang 动手写Web框架，从零实现一个Web框架，以 Gin 为原型从零设计一个Web框架。本文介绍了Go标准库 net/http 和 http.Handler 接口的使用，拦截所有的 HTTP 请求，交给Gee框架处理。
 tags:
 - Go
+nav: 从零实现
 categories:
-- 从零实现
+- Web框架 - Gee
 keywords:
 - Go语言
 - 从零实现Web框架
diff --git a/gee-web/doc/gee-day2.md b/gee-web/doc/gee-day2.md
index e47467f..281ebcc 100644
--- a/gee-web/doc/gee-day2.md
+++ b/gee-web/doc/gee-day2.md
@@ -4,8 +4,9 @@ date: 2019-08-19 00:10:10
 description: 7天用 Go语言 从零实现Web框架教程(7 days implement golang web framework from scratch tutorial)，用 Go语言/golang 动手写Web框架，从零实现一个Web框架，以 Gin 为原型从零设计一个Web框架。本文介绍了请求上下文(Context)的设计理念，封装了返回JSON/String/Data/HTML等类型响应的方法。
 tags:
 - Go
+nav: 从零实现
 categories:
-- 从零实现
+- Web框架 - Gee
 keywords:
 - Go语言
 - 从零实现Web框架
diff --git a/gee-web/doc/gee-day3.md b/gee-web/doc/gee-day3.md
index 23a0e72..4b34f6d 100644
--- a/gee-web/doc/gee-day3.md
+++ b/gee-web/doc/gee-day3.md
@@ -4,8 +4,9 @@ date: 2019-08-28 00:10:10
 description: 7天用 Go语言 从零实现Web框架教程(7 days implement golang web framework from scratch tutorial)，用 Go语言/golang 动手写Web框架，从零实现一个Web框架，以 Gin 为原型从零设计一个Web框架。本文介绍了如何用 Trie 前缀树实现路由 Route。支持简单的参数解析和通配符的场景。
 tags:
 - Go
+nav: 从零实现
 categories:
-- 从零实现
+- Web框架 - Gee
 keywords:
 - Go语言
 - 从零实现Web框架
diff --git a/gee-web/doc/gee-day4.md b/gee-web/doc/gee-day4.md
index 7f71370..3a5eb21 100644
--- a/gee-web/doc/gee-day4.md
+++ b/gee-web/doc/gee-day4.md
@@ -4,8 +4,9 @@ date: 2019-09-01 15:10:10
 description: 7天用 Go语言 从零实现Web框架教程(7 days implement golang web framework from scratch tutorial)，用 Go语言/golang 动手写Web框架，从零实现一个Web框架，以 Gin 为原型从零设计一个Web框架。本文介绍了分组控制(Group Control)的意义，以及嵌套分组路由的实现。
 tags:
 - Go
+nav: 从零实现
 categories:
-- 从零实现
+- Web框架 - Gee
 keywords:
 - Go语言
 - 从零实现Web框架
diff --git a/gee-web/doc/gee-day5.md b/gee-web/doc/gee-day5.md
index 9f5d117..e4fb039 100644
--- a/gee-web/doc/gee-day5.md
+++ b/gee-web/doc/gee-day5.md
@@ -4,8 +4,9 @@ date: 2019-09-01 20:10:10
 description: 7天用 Go语言 从零实现Web框架教程(7 days implement golang web framework from scratch tutorial)，用 Go语言/golang 动手写Web框架，从零实现一个Web框架，以 Gin 为原型从零设计一个Web框架。本文介绍了如何为Web框架添加中间件的功能(middlewares)。
 tags:
 - Go
+nav: 从零实现
 categories:
-- 从零实现
+- Web框架 - Gee
 keywords:
 - Go语言
 - 从零实现Web框架
diff --git a/gee-web/doc/gee-day6.md b/gee-web/doc/gee-day6.md
index e429faf..b77f041 100644
--- a/gee-web/doc/gee-day6.md
+++ b/gee-web/doc/gee-day6.md
@@ -4,8 +4,9 @@ date: 2019-09-08 20:10:00
 description: 7天用 Go语言 从零实现Web框架教程(7 days implement golang web framework from scratch tutorial)，用 Go语言/golang 动手写Web框架，从零实现一个Web框架，以 Gin 为原型从零设计一个Web框架。本文介绍了如何为Web框架添加HTML模板(HTML Template)以及静态文件(Serve Static Files)的功能。
 tags:
 - Go
+nav: 从零实现
 categories:
-- 从零实现
+- Web框架 - Gee
 keywords:
 - Go语言
 - 从零实现Web框架
diff --git a/gee-web/doc/gee-day7.md b/gee-web/doc/gee-day7.md
index f72a314..b3f6873 100644
--- a/gee-web/doc/gee-day7.md
+++ b/gee-web/doc/gee-day7.md
@@ -4,8 +4,9 @@ date: 2020-01-09 01:00:00
 description: 7天用 Go语言 从零实现Web框架教程(7 days implement golang web framework from scratch tutorial)，用 Go语言/golang 动手写Web框架，从零实现一个Web框架，以 Gin 为原型从零设计一个Web框架。本文介绍了如何为Web框架增加错误处理机制。
 tags:
 - Go
+nav: 从零实现
 categories:
-- 从零实现
+- Web框架 - Gee
 keywords:
 - Go语言
 - 从零实现Web框架
diff --git a/gee-web/doc/gee.md b/gee-web/doc/gee.md
index c215534..c2581cc 100644
--- a/gee-web/doc/gee.md
+++ b/gee-web/doc/gee.md
@@ -4,8 +4,9 @@ date: 2019-08-11 02:10:10
 description: 7天用 Go语言 从零实现Web框架教程(7 days implement golang web framework from scratch tutorial)，用 Go语言/golang 动手写Web框架，从零实现一个Web框架，以 Gin 为原型从零设计一个Web框架。
 tags:
 - Go
+nav: 从零实现
 categories:
-- 从零实现
+- Web框架 - Gee
 keywords:
 - Gee教程
 - 从零实现Web框架

From 1f47dbdd12c9f71ad4d2129e474a7a308d5e099a Mon Sep 17 00:00:00 2001
From: gzdaijie <gzdaijie@163.com>
Date: Sun, 9 Feb 2020 17:11:39 +0800
Subject: [PATCH 027/122] fix proto decode error

---
 gee-cache/day7-proto-buf/geecache/http.go | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/gee-cache/day7-proto-buf/geecache/http.go b/gee-cache/day7-proto-buf/geecache/http.go
index a4d171c..4a1c129 100644
--- a/gee-cache/day7-proto-buf/geecache/http.go
+++ b/gee-cache/day7-proto-buf/geecache/http.go
@@ -70,8 +70,15 @@ func (p *HTTPPool) ServeHTTP(w http.ResponseWriter, r *http.Request) {
 		return
 	}
 
+	// Write the value to the response body as a proto message.
+	body, err := proto.Marshal(&pb.Response{Value: view.ByteSlice()})
+	if err != nil {
+		http.Error(w, err.Error(), http.StatusInternalServerError)
+		return
+	}
+
 	w.Header().Set("Content-Type", "application/octet-stream")
-	w.Write(view.ByteSlice())
+	w.Write(body)
 }
 
 // Set updates the pool's list of peers.

From 3b2e7ea903f2f0bf86906543dc7b4aca2c12f03b Mon Sep 17 00:00:00 2001
From: gzdaijie <gzdaijie@gmail.com>
Date: Tue, 11 Feb 2020 22:10:37 +0800
Subject: [PATCH 028/122] add geecache-day1 doc

---
 README.md                                |   2 +-
 gee-cache/doc/geecache-day1.md           | 251 +++++++++++++++++++++++
 gee-cache/doc/geecache-day1/lru.jpg      | Bin 0 -> 12957 bytes
 gee-cache/doc/geecache-day1/lru_logo.jpg | Bin 0 -> 5272 bytes
 gee-cache/doc/geecache.md                |   5 +-
 5 files changed, 255 insertions(+), 3 deletions(-)
 create mode 100644 gee-cache/doc/geecache-day1.md
 create mode 100755 gee-cache/doc/geecache-day1/lru.jpg
 create mode 100755 gee-cache/doc/geecache-day1/lru_logo.jpg

diff --git a/README.md b/README.md
index cdc75ff..28e085d 100644
--- a/README.md
+++ b/README.md
@@ -26,7 +26,7 @@
 
 [GeeCache](https://geektutu.com/post/geecache.html) 是一个模仿 [groupcache](https://github.com/golang/groupcache) 实现的分布式缓存系统
 
-- 第一天：LRU 缓存策略 | [Code](gee-cache/day1-lru)
+- [第一天：LRU 缓存淘汰策略](https://geektutu.com/post/geecache-day1.html) | [Code](gee-cache/day1-lru)
 - 第二天：单机并发缓存 | [Code](gee-cache/day2-single-node)
 - 第三天：HTTP 服务端 | [Code](gee-cache/day3-http-server)
 - 第四天：一致性哈希(Hash) | [Code](gee-cache/day4-consistent-hash)
diff --git a/gee-cache/doc/geecache-day1.md b/gee-cache/doc/geecache-day1.md
new file mode 100644
index 0000000..f5330d8
--- /dev/null
+++ b/gee-cache/doc/geecache-day1.md
@@ -0,0 +1,251 @@
+---
+title: 动手写分布式缓存 - GeeCache第一天 LRU 缓存淘汰策略
+date: 2020-02-11 22:00:00
+description: 7天用 Go语言/golang 从零实现分布式缓存 GeeCache 教程(7 days implement golang distributed cache from scratch tutorial)，动手写分布式缓存，参照 groupcache 的实现。本文介绍常用的三种缓存淘汰(失效)算法：先进先出(FIFO)，最少使用(LFU) 和 最近最少使用(LRU)，并实现 LRU 算法和相应的测试代码。
+tags:
+- Go
+nav: 从零实现
+categories:
+- 分布式缓存 - GeeCache
+keywords:
+- Go语言
+- 从零实现分布式缓存
+- 动手写分布式缓存
+- LRU
+- 缓存失效
+image: post/geecache-day1/lru_logo.jpg
+github: https://github.com/geektutu/7days-golang
+---
+
+
+本文是[7天用Go从零实现分布式缓存GeeCache教程系列](https://geektutu.com/post/geecache.html)的第一篇。
+
+- 介绍常用的三种缓存淘汰(失效)算法：FIFO，LFU 和 LRU
+- 实现 LRU 缓存淘汰算法，**代码约80行**
+
+## 1 FIFO/LFU/LRU 算法简介
+
+GeeCache 的缓存全部存储在内存中，内存是有限的，因此不可能无限制地添加数据。假定我们设置缓存能够使用的内存大小为 N，那么在某一个时间点，添加了某一条缓存记录之后，占用内存超过了 N，这个时候就需要从缓存中移除一条或多条数据了。那移除谁呢？我们肯定希望尽可能移除“没用”的数据，那如何判定数据“有用”还是“没用”呢？
+
+### 1.1 FIFO(First In First Out)
+
+先进先出，也就是淘汰缓存中最老(最早添加)的记录。FIFO 认为，最早添加的记录，其不再被使用的可能性比刚添加的可能性大。这种算法的实现也非常简单，创建一个队列，新增记录添加到队尾，每次内存不够时，淘汰队首。但是很多场景下，部分记录虽然是最早添加但也最常被访问，而不得不因为呆的时间太长而被淘汰。这类数据会被频繁地添加进缓存，又被淘汰出去，导致缓存命中率降低。
+
+### 1.2 LFU(Least Frequently Used)
+
+最少使用，也就是淘汰缓存中访问频率最低的记录。LFU 认为，如果数据过去被访问多次，那么将来被访问的频率也更高。LFU 的实现需要维护一个按照访问次数排序的队列，每次访问，访问次数加1，队列重新排序，淘汰时选择访问次数最少的即可。LFU 算法的命中率是比较高的，但缺点也非常明显，维护每个记录的访问次数，对内存的消耗是很高的；另外，如果数据的访问模式发生变化，LFU 需要较长的时间去适应，也就是说 LFU 算法受历史数据的影响比较大。例如某个数据历史上访问次数奇高，但在某个时间点之后几乎不再被访问，但因为历史访问次数过高，而迟迟不能被淘汰。
+
+### 1.3 LRU(Least Recently Used) 
+
+最近最少使用，相对于仅考虑时间因素的 FIFO 和仅考虑访问频率的 LFU，LRU 算法可以认为是相对平衡的一种淘汰算法。LRU 认为，如果数据最近被访问过，那么将来被访问的概率也会更高。LRU 算法的实现非常简单，维护一个队列，如果某条记录被访问了，则移动到队尾，那么队首则是最近最少访问的数据，淘汰该条记录即可。
+
+## 2 LRU 算法实现
+
+### 2.1 核心数据结构
+
+![implement lru algorithm with golang](geecache-day1/lru.jpg)
+
+这张图很好地表示了 LRU 算法最核心的 2 个数据结构
+
+- 绿色的是字典(map)，存储键和值的映射关系。这样根据某个键(key)查找对应的值(value)的复杂是`O(1)`，在字典中插入一条记录的复杂度也是`O(1)`。
+- 红色的是双向链表(double linked list)实现的队列。将所有的值放到双向链表中，这样，当访问到某个值时，将其移动到队尾的复杂度是`O(1)`，在队尾新增一条记录以及删除一条记录的复杂度均为`O(1)`。
+
+接下来我们创建一个包含字典和双向链表的结构体类型 Cache，方便实现后续的增删查改操作。
+
+[day1-lru/geecache/lru/lru.go - github](https://github.com/geektutu/7days-golang/tree/master/gee-cache/day1-lru/geecache/lru)
+
+```go
+package lru
+
+import "container/list"
+
+// Cache is a LRU cache. It is not safe for concurrent access.
+type Cache struct {
+	maxBytes int64
+	nbytes   int64
+	ll       *list.List
+	cache    map[string]*list.Element
+	// optional and executed when an entry is purged.
+	OnEvicted func(key string, value Value)
+}
+
+type entry struct {
+	key   string
+	value Value
+}
+
+// Value use Len to count how many bytes it takes
+type Value interface {
+	Len() int
+}
+```
+
+- 在这里我们直接使用 Go 语言标准库实现的双向链表`list.List`。
+- 字典的定义是 `map[string]*list.Element`，键是字符串，值是双向链表中对应节点的指针。
+- `maxBytes` 是允许使用的最大内存，`nbytes` 是当前已使用的内存，`OnEvicted` 是某条记录被移除时的回调函数，可以为 nil。
+- 键值对 `entry` 是双向链表节点的数据类型，在链表中仍保存每个值对应的 key 的好处在于，淘汰队首节点时，需要用 key 从字典中删除对应的映射。
+- 为了通用性，我们允许值是实现了 `Value` 接口的任意类型，该接口只包含了一个方法 `Len() int`，用于返回值所占用的内存大小。
+
+
+方便实例化 `Cache`，实现 `New()` 函数：
+
+```go
+// New is the Constructor of Cache
+func New(maxBytes int64, onEvicted func(string, Value)) *Cache {
+	return &Cache{
+		maxBytes:  maxBytes,
+		ll:        list.New(),
+		cache:     make(map[string]*list.Element),
+		OnEvicted: onEvicted,
+	}
+}
+```
+
+### 2.2 查找功能
+
+查找主要有 2 个步骤，第一步是从字典中找到对应的双向链表的节点，第二步，将该节点移动到队尾。
+
+```go
+// Get look ups a key's value
+func (c *Cache) Get(key string) (value Value, ok bool) {
+	if ele, ok := c.cache[key]; ok {
+		c.ll.MoveToFront(ele)
+		kv := ele.Value.(*entry)
+		return kv.value, true
+	}
+	return
+}
+```
+
+- 如果键对应的链表节点存在，则将对应节点移动到队尾，并返回查找到的值。
+- `c.ll.MoveToFront(ele)`，即将链表中的节点 `ele` 移动到队尾（双向链表作为队列，队首队尾是相对的，在这里约定 front 为队尾）
+
+### 2.3 删除
+
+这里的删除，实际上是缓存淘汰。即移除最近最少访问的节点（队首）
+
+```go
+// RemoveOldest removes the oldest item
+func (c *Cache) RemoveOldest() {
+	ele := c.ll.Back()
+	if ele != nil {
+		c.ll.Remove(ele)
+		kv := ele.Value.(*entry)
+		delete(c.cache, kv.key)
+		c.nbytes -= int64(len(kv.key)) + int64(kv.value.Len())
+		if c.OnEvicted != nil {
+			c.OnEvicted(kv.key, kv.value)
+		}
+	}
+}
+```
+
+- `c.ll.Back()` 取到队首节点，从链表中删除。
+- `delete(c.cache, kv.key)`，从字典中`c.cache`删除该节点的映射关系。
+- 更新当前所用的内存 `c.nbytes`。
+- 如果回调函数 `OnEvicted` 不为 nil，则调用回调函数。
+
+### 2.4 新增/修改
+
+```go
+// Add adds a value to the cache.
+func (c *Cache) Add(key string, value Value) {
+	if ele, ok := c.cache[key]; ok {
+		c.ll.MoveToFront(ele)
+		kv := ele.Value.(*entry)
+		kv.value = value
+		return
+	}
+	ele := c.ll.PushFront(&entry{key, value})
+	c.cache[key] = ele
+	c.nbytes += int64(len(key)) + int64(value.Len())
+
+	for c.maxBytes != 0 && c.maxBytes < c.nbytes {
+		c.RemoveOldest()
+	}
+}
+```
+
+- 如果键存在，则更新对应节点的值，并将该节点移到队尾。
+- 不存在则是新增场景，首先队尾添加新节点 `&entry{key, value}`, 并字典中添加 `key` 和节点的映射关系。
+- 更新 `c.nbytes`，如果超过了设定的最大值 `c.maxBytes`，则移除最少访问的节点。
+
+最后，为了方便测试，我们实现 `Len()` 用来获取添加了多少条数据。
+
+```go
+// Len the number of cache entries
+func (c *Cache) Len() int {
+	return c.ll.Len()
+}
+```
+
+## 3 测试
+
+例如，我们可以尝试添加几条数据，测试 `Get` 方法
+
+[day1-lru/geecache/lru/lru_test.go - github](https://github.com/geektutu/7days-golang/tree/master/gee-cache/day1-lru/geecache/lru)
+
+```go
+type String string
+
+func (d String) Len() int {
+	return len(d)
+}
+
+func TestGet(t *testing.T) {
+	lru := New(int64(0), nil)
+	lru.Add("key1", String("1234"))
+	if v, ok := lru.Get("key1"); !ok || string(v.(String)) != "1234" {
+		t.Fatalf("cache hit key1=1234 failed")
+	}
+	if _, ok := lru.Get("key2"); ok {
+		t.Fatalf("cache miss key2 failed")
+	}
+}
+```
+
+测试，当使用内存超过了设定值时，是否会触发“无用”节点的移除：
+
+```go
+func TestRemoveoldest(t *testing.T) {
+	k1, k2, k3 := "key1", "key2", "k3"
+	v1, v2, v3 := "value1", "value2", "v3"
+	cap := len(k1 + k2 + v1 + v2)
+	lru := New(int64(cap), nil)
+	lru.Add(k1, String(v1))
+	lru.Add(k2, String(v2))
+	lru.Add(k3, String(v3))
+
+	if _, ok := lru.Get("key1"); ok || lru.Len() != 2 {
+		t.Fatalf("Removeoldest key1 failed")
+	}
+}
+```
+
+测试回调函数能否被调用：
+
+```go
+func TestOnEvicted(t *testing.T) {
+	keys := make([]string, 0)
+	callback := func(key string, value Value) {
+		keys = append(keys, key)
+	}
+	lru := New(int64(10), callback)
+	lru.Add("key1", String("123456"))
+	lru.Add("k2", String("k2"))
+	lru.Add("k3", String("k3"))
+	lru.Add("k4", String("k4"))
+
+	expect := []string{"key1", "k2"}
+
+	if !reflect.DeepEqual(expect, keys) {
+		t.Fatalf("Call OnEvicted failed, expect keys equals to %s", expect)
+	}
+}
+```
+
+## 附 推荐阅读
+
+- [Go 语言简明教程](https://geektutu.com/post/quick-golang.html)
+- [Go Test 单元测试简明教程](https://geektutu.com/post/quick-go-test.html)
+- [list 官方文档 - golang.org](https://golang.org/pkg/container/list/)
\ No newline at end of file
diff --git a/gee-cache/doc/geecache-day1/lru.jpg b/gee-cache/doc/geecache-day1/lru.jpg
new file mode 100755
index 0000000000000000000000000000000000000000..db90cd8386de9e36b59fa89b6328146242d08ff3
GIT binary patch
literal 12957
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
DcnX|5

literal 0
HcmV?d00001

diff --git a/gee-cache/doc/geecache-day1/lru_logo.jpg b/gee-cache/doc/geecache-day1/lru_logo.jpg
new file mode 100755
index 0000000000000000000000000000000000000000..7ab49f44e6a6e2b1483a5ef88ed3bce9b98de4bd
GIT binary patch
literal 5272
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

literal 0
HcmV?d00001

diff --git a/gee-cache/doc/geecache.md b/gee-cache/doc/geecache.md
index 21b2f0d..fc79090 100644
--- a/gee-cache/doc/geecache.md
+++ b/gee-cache/doc/geecache.md
@@ -1,7 +1,7 @@
 ---
 title: 7天用Go从零实现分布式缓存GeeCache
 date: 2020-02-08 01:00:00
-description: 7天用 用 Go语言/golang 从零实现分布式缓存 GeeCache 教程(7 days implement golang distributed cache from scratch tutorial)，动手写分布式缓存，参照 groupcache 的实现。功能包括单机/分布式缓存，LRU (Least Recently Used) 缓存策略，防止缓存击穿、一致性哈希(Consistent Hash)，protobuf 通信等。
+description: 7天用 Go语言/golang 从零实现分布式缓存 GeeCache 教程(7 days implement golang distributed cache from scratch tutorial)，动手写分布式缓存，参照 groupcache 的实现。功能包括单机/分布式缓存，LRU (Least Recently Used) 缓存策略，防止缓存击穿、一致性哈希(Consistent Hash)，protobuf 通信等。
 tags:
 - Go
 nav: 从零实现
@@ -58,7 +58,7 @@ github: https://github.com/geektutu/7days-golang
 
 ## 3 目录
 
-- 第一天：LRU 缓存策略 | [Code - Github](https://github.com/geektutu/7days-golang/blob/master/gee-cache/day1-lru)
+- [第一天：LRU 缓存淘汰策略](https://geektutu.com/post/geecache-day1.html) | [Code - Github](https://github.com/geektutu/7days-golang/blob/master/gee-cache/day1-lru)
 - 第二天：单机并发缓存 | [Code - Github](https://github.com/geektutu/7days-golang/blob/master/gee-cache/day2-single-node)
 - 第三天：HTTP 服务端 | [Code - Github](https://github.com/geektutu/7days-golang/blob/master/gee-cache/day3-http-server)
 - 第四天：一致性哈希(Hash) | [Code - Github](https://github.com/geektutu/7days-golang/blob/master/gee-cache/day4-consistent-hash)
@@ -69,4 +69,5 @@ github: https://github.com/geektutu/7days-golang
 ## 附 推荐阅读
 
 - [Go 语言简明教程](https://geektutu.com/post/quick-golang.html)
+- [Go Test 单元测试简明教程](https://geektutu.com/post/quick-go-test.html)
 - [Go Protobuf 简明教程](https://geektutu.com/post/quick-go-protobuf.html)
\ No newline at end of file

From 75a54051122fcbef6c5cbbcb2fb5d2ac4f454b65 Mon Sep 17 00:00:00 2001
From: gzdaijie <gzdaijie@163.com>
Date: Wed, 12 Feb 2020 01:57:07 +0800
Subject: [PATCH 029/122] fix cache.go sync.Mutex, use Lock instead of RLock

---
 gee-cache/day2-single-node/geecache/cache.go     | 10 +++++-----
 gee-cache/day3-http-server/geecache/cache.go     | 10 +++++-----
 gee-cache/day4-consistent-hash/geecache/cache.go | 10 +++++-----
 gee-cache/day5-multi-nodes/geecache/cache.go     | 10 +++++-----
 gee-cache/day6-single-flight/geecache/cache.go   | 10 +++++-----
 gee-cache/day7-proto-buf/geecache/cache.go       | 10 +++++-----
 6 files changed, 30 insertions(+), 30 deletions(-)

diff --git a/gee-cache/day2-single-node/geecache/cache.go b/gee-cache/day2-single-node/geecache/cache.go
index 703d033..665c3f3 100644
--- a/gee-cache/day2-single-node/geecache/cache.go
+++ b/gee-cache/day2-single-node/geecache/cache.go
@@ -6,14 +6,14 @@ import (
 )
 
 type cache struct {
-	mu         sync.RWMutex
+	mu         sync.Mutex
 	lru        *lru.Cache
 	cacheBytes int64
 }
 
 func (c *cache) add(key string, value ByteView) {
-	c.mu.RLock()
-	defer c.mu.RUnlock()
+	c.mu.Lock()
+	defer c.mu.Unlock()
 	if c.lru == nil {
 		c.lru = lru.New(c.cacheBytes, nil)
 	}
@@ -21,8 +21,8 @@ func (c *cache) add(key string, value ByteView) {
 }
 
 func (c *cache) get(key string) (value ByteView, ok bool) {
-	c.mu.RLock()
-	defer c.mu.RUnlock()
+	c.mu.Lock()
+	defer c.mu.Unlock()
 	if c.lru == nil {
 		return
 	}
diff --git a/gee-cache/day3-http-server/geecache/cache.go b/gee-cache/day3-http-server/geecache/cache.go
index 703d033..665c3f3 100644
--- a/gee-cache/day3-http-server/geecache/cache.go
+++ b/gee-cache/day3-http-server/geecache/cache.go
@@ -6,14 +6,14 @@ import (
 )
 
 type cache struct {
-	mu         sync.RWMutex
+	mu         sync.Mutex
 	lru        *lru.Cache
 	cacheBytes int64
 }
 
 func (c *cache) add(key string, value ByteView) {
-	c.mu.RLock()
-	defer c.mu.RUnlock()
+	c.mu.Lock()
+	defer c.mu.Unlock()
 	if c.lru == nil {
 		c.lru = lru.New(c.cacheBytes, nil)
 	}
@@ -21,8 +21,8 @@ func (c *cache) add(key string, value ByteView) {
 }
 
 func (c *cache) get(key string) (value ByteView, ok bool) {
-	c.mu.RLock()
-	defer c.mu.RUnlock()
+	c.mu.Lock()
+	defer c.mu.Unlock()
 	if c.lru == nil {
 		return
 	}
diff --git a/gee-cache/day4-consistent-hash/geecache/cache.go b/gee-cache/day4-consistent-hash/geecache/cache.go
index 703d033..665c3f3 100644
--- a/gee-cache/day4-consistent-hash/geecache/cache.go
+++ b/gee-cache/day4-consistent-hash/geecache/cache.go
@@ -6,14 +6,14 @@ import (
 )
 
 type cache struct {
-	mu         sync.RWMutex
+	mu         sync.Mutex
 	lru        *lru.Cache
 	cacheBytes int64
 }
 
 func (c *cache) add(key string, value ByteView) {
-	c.mu.RLock()
-	defer c.mu.RUnlock()
+	c.mu.Lock()
+	defer c.mu.Unlock()
 	if c.lru == nil {
 		c.lru = lru.New(c.cacheBytes, nil)
 	}
@@ -21,8 +21,8 @@ func (c *cache) add(key string, value ByteView) {
 }
 
 func (c *cache) get(key string) (value ByteView, ok bool) {
-	c.mu.RLock()
-	defer c.mu.RUnlock()
+	c.mu.Lock()
+	defer c.mu.Unlock()
 	if c.lru == nil {
 		return
 	}
diff --git a/gee-cache/day5-multi-nodes/geecache/cache.go b/gee-cache/day5-multi-nodes/geecache/cache.go
index 703d033..665c3f3 100644
--- a/gee-cache/day5-multi-nodes/geecache/cache.go
+++ b/gee-cache/day5-multi-nodes/geecache/cache.go
@@ -6,14 +6,14 @@ import (
 )
 
 type cache struct {
-	mu         sync.RWMutex
+	mu         sync.Mutex
 	lru        *lru.Cache
 	cacheBytes int64
 }
 
 func (c *cache) add(key string, value ByteView) {
-	c.mu.RLock()
-	defer c.mu.RUnlock()
+	c.mu.Lock()
+	defer c.mu.Unlock()
 	if c.lru == nil {
 		c.lru = lru.New(c.cacheBytes, nil)
 	}
@@ -21,8 +21,8 @@ func (c *cache) add(key string, value ByteView) {
 }
 
 func (c *cache) get(key string) (value ByteView, ok bool) {
-	c.mu.RLock()
-	defer c.mu.RUnlock()
+	c.mu.Lock()
+	defer c.mu.Unlock()
 	if c.lru == nil {
 		return
 	}
diff --git a/gee-cache/day6-single-flight/geecache/cache.go b/gee-cache/day6-single-flight/geecache/cache.go
index 703d033..665c3f3 100644
--- a/gee-cache/day6-single-flight/geecache/cache.go
+++ b/gee-cache/day6-single-flight/geecache/cache.go
@@ -6,14 +6,14 @@ import (
 )
 
 type cache struct {
-	mu         sync.RWMutex
+	mu         sync.Mutex
 	lru        *lru.Cache
 	cacheBytes int64
 }
 
 func (c *cache) add(key string, value ByteView) {
-	c.mu.RLock()
-	defer c.mu.RUnlock()
+	c.mu.Lock()
+	defer c.mu.Unlock()
 	if c.lru == nil {
 		c.lru = lru.New(c.cacheBytes, nil)
 	}
@@ -21,8 +21,8 @@ func (c *cache) add(key string, value ByteView) {
 }
 
 func (c *cache) get(key string) (value ByteView, ok bool) {
-	c.mu.RLock()
-	defer c.mu.RUnlock()
+	c.mu.Lock()
+	defer c.mu.Unlock()
 	if c.lru == nil {
 		return
 	}
diff --git a/gee-cache/day7-proto-buf/geecache/cache.go b/gee-cache/day7-proto-buf/geecache/cache.go
index 703d033..665c3f3 100644
--- a/gee-cache/day7-proto-buf/geecache/cache.go
+++ b/gee-cache/day7-proto-buf/geecache/cache.go
@@ -6,14 +6,14 @@ import (
 )
 
 type cache struct {
-	mu         sync.RWMutex
+	mu         sync.Mutex
 	lru        *lru.Cache
 	cacheBytes int64
 }
 
 func (c *cache) add(key string, value ByteView) {
-	c.mu.RLock()
-	defer c.mu.RUnlock()
+	c.mu.Lock()
+	defer c.mu.Unlock()
 	if c.lru == nil {
 		c.lru = lru.New(c.cacheBytes, nil)
 	}
@@ -21,8 +21,8 @@ func (c *cache) add(key string, value ByteView) {
 }
 
 func (c *cache) get(key string) (value ByteView, ok bool) {
-	c.mu.RLock()
-	defer c.mu.RUnlock()
+	c.mu.Lock()
+	defer c.mu.Unlock()
 	if c.lru == nil {
 		return
 	}

From 2031e28df3c731c0a3adda74d83b5d4ebbb561d6 Mon Sep 17 00:00:00 2001
From: gzdaijie <gzdaijie@gmail.com>
Date: Wed, 12 Feb 2020 15:09:03 +0800
Subject: [PATCH 030/122] 1. move cloneBytes from geecache.go to byteview.go 2.
 add more tests

---
 README.md                                     |   4 +-
 .../day2-single-node/geecache/byteview.go     |   6 +
 .../day2-single-node/geecache/geecache.go     |   6 -
 .../geecache/geecache_test.go                 |  23 +-
 .../day3-http-server/geecache/byteview.go     |   6 +
 .../day3-http-server/geecache/geecache.go     |   6 -
 .../geecache/geecache_test.go                 |  23 +-
 gee-cache/day3-http-server/geecache/http.go   |   2 +-
 .../day4-consistent-hash/geecache/byteview.go |   6 +
 .../day4-consistent-hash/geecache/geecache.go |   6 -
 .../geecache/geecache_test.go                 |  23 +-
 .../day4-consistent-hash/geecache/http.go     |   2 +-
 .../day5-multi-nodes/geecache/byteview.go     |   6 +
 .../day5-multi-nodes/geecache/geecache.go     |   6 -
 .../geecache/geecache_test.go                 |  23 +-
 gee-cache/day5-multi-nodes/geecache/http.go   |   2 +-
 .../day6-single-flight/geecache/byteview.go   |   6 +
 .../day6-single-flight/geecache/geecache.go   |   6 -
 .../geecache/geecache_test.go                 |  23 +-
 gee-cache/day6-single-flight/geecache/http.go |   2 +-
 gee-cache/day7-proto-buf/geecache/byteview.go |   6 +
 gee-cache/day7-proto-buf/geecache/geecache.go |   6 -
 .../day7-proto-buf/geecache/geecache_test.go  |  23 +-
 gee-cache/day7-proto-buf/geecache/http.go     |   2 +-
 gee-cache/doc/geecache-day1.md                |  10 +-
 gee-cache/doc/geecache-day1/lru.jpg           | Bin
 gee-cache/doc/geecache-day1/lru_logo.jpg      | Bin
 gee-cache/doc/geecache-day2.md                | 430 ++++++++++++++++++
 .../doc/geecache-day2/concurrent_cache.jpg    | Bin 0 -> 13089 bytes
 .../geecache-day2/concurrent_cache_logo.jpg   | Bin 0 -> 5339 bytes
 gee-cache/doc/geecache-day3.md                | 254 +++++++++++
 gee-cache/doc/geecache-day3/http.jpg          | Bin 0 -> 14453 bytes
 gee-cache/doc/geecache-day3/http_logo.jpg     | Bin 0 -> 6050 bytes
 gee-cache/doc/geecache.md                     |   4 +-
 34 files changed, 860 insertions(+), 62 deletions(-)
 mode change 100755 => 100644 gee-cache/doc/geecache-day1/lru.jpg
 mode change 100755 => 100644 gee-cache/doc/geecache-day1/lru_logo.jpg
 create mode 100644 gee-cache/doc/geecache-day2.md
 create mode 100644 gee-cache/doc/geecache-day2/concurrent_cache.jpg
 create mode 100644 gee-cache/doc/geecache-day2/concurrent_cache_logo.jpg
 create mode 100644 gee-cache/doc/geecache-day3.md
 create mode 100755 gee-cache/doc/geecache-day3/http.jpg
 create mode 100755 gee-cache/doc/geecache-day3/http_logo.jpg

diff --git a/README.md b/README.md
index 28e085d..89fe062 100644
--- a/README.md
+++ b/README.md
@@ -27,8 +27,8 @@
 [GeeCache](https://geektutu.com/post/geecache.html) 是一个模仿 [groupcache](https://github.com/golang/groupcache) 实现的分布式缓存系统
 
 - [第一天：LRU 缓存淘汰策略](https://geektutu.com/post/geecache-day1.html) | [Code](gee-cache/day1-lru)
-- 第二天：单机并发缓存 | [Code](gee-cache/day2-single-node)
-- 第三天：HTTP 服务端 | [Code](gee-cache/day3-http-server)
+- [第二天：单机并发缓存](https://geektutu.com/post/geecache-day2.html) | [Code](gee-cache/day2-single-node)
+- [第三天：HTTP 服务端](https://geektutu.com/post/geecache-day3.html) | [Code](gee-cache/day3-http-server)
 - 第四天：一致性哈希(Hash) | [Code](gee-cache/day4-consistent-hash)
 - 第五天：分布式节点 | [Code](gee-cache/day5-multi-nodes)
 - 第六天：防止缓存击穿 | [Code](gee-cache/day6-single-flight)
diff --git a/gee-cache/day2-single-node/geecache/byteview.go b/gee-cache/day2-single-node/geecache/byteview.go
index a51394f..3ee1022 100644
--- a/gee-cache/day2-single-node/geecache/byteview.go
+++ b/gee-cache/day2-single-node/geecache/byteview.go
@@ -19,3 +19,9 @@ func (v ByteView) ByteSlice() []byte {
 func (v ByteView) String() string {
 	return string(v.b)
 }
+
+func cloneBytes(b []byte) []byte {
+	c := make([]byte, len(b))
+	copy(c, b)
+	return c
+}
diff --git a/gee-cache/day2-single-node/geecache/geecache.go b/gee-cache/day2-single-node/geecache/geecache.go
index 58b98b8..e289018 100644
--- a/gee-cache/day2-single-node/geecache/geecache.go
+++ b/gee-cache/day2-single-node/geecache/geecache.go
@@ -70,12 +70,6 @@ func (g *Group) Get(key string) (ByteView, error) {
 	return g.load(key)
 }
 
-func cloneBytes(b []byte) []byte {
-	c := make([]byte, len(b))
-	copy(c, b)
-	return c
-}
-
 func (g *Group) load(key string) (value ByteView, err error) {
 	return g.getLocally(key)
 }
diff --git a/gee-cache/day2-single-node/geecache/geecache_test.go b/gee-cache/day2-single-node/geecache/geecache_test.go
index 9cb4079..7ef9f4f 100644
--- a/gee-cache/day2-single-node/geecache/geecache_test.go
+++ b/gee-cache/day2-single-node/geecache/geecache_test.go
@@ -3,6 +3,7 @@ package geecache
 import (
 	"fmt"
 	"log"
+	"reflect"
 	"testing"
 )
 
@@ -12,21 +13,39 @@ var db = map[string]string{
 	"Sam":  "567",
 }
 
+func TestGetter(t *testing.T) {
+	var f Getter = GetterFunc(func(key string) ([]byte, error) {
+		return []byte(key), nil
+	})
+
+	expect := []byte("key")
+	if v, _ := f.Get("key"); !reflect.DeepEqual(v, expect) {
+		t.Fatal("callback failed")
+	}
+}
+
 func TestGet(t *testing.T) {
+	loadCounts := make(map[string]int, len(db))
 	gee := NewGroup("scores", 2<<10, GetterFunc(
 		func(key string) ([]byte, error) {
 			log.Println("[SlowDB] search key", key)
 			if v, ok := db[key]; ok {
+				if _, ok := loadCounts[key]; !ok {
+					loadCounts[key] = 0
+				}
+				loadCounts[key]++
 				return []byte(v), nil
 			}
 			return nil, fmt.Errorf("%s not exist", key)
 		}))
 
 	for k, v := range db {
-		view, err := gee.Get(k)
-		if err != nil || view.String() != v {
+		if view, err := gee.Get(k); err != nil || view.String() != v {
 			t.Fatal("failed to get value of Tom")
 		}
+		if _, err := gee.Get(k); err != nil || loadCounts[k] > 1 {
+			t.Fatalf("cache %s miss", k)
+		}
 	}
 
 	if view, err := gee.Get("unknown"); err == nil {
diff --git a/gee-cache/day3-http-server/geecache/byteview.go b/gee-cache/day3-http-server/geecache/byteview.go
index a51394f..3ee1022 100644
--- a/gee-cache/day3-http-server/geecache/byteview.go
+++ b/gee-cache/day3-http-server/geecache/byteview.go
@@ -19,3 +19,9 @@ func (v ByteView) ByteSlice() []byte {
 func (v ByteView) String() string {
 	return string(v.b)
 }
+
+func cloneBytes(b []byte) []byte {
+	c := make([]byte, len(b))
+	copy(c, b)
+	return c
+}
diff --git a/gee-cache/day3-http-server/geecache/geecache.go b/gee-cache/day3-http-server/geecache/geecache.go
index 58b98b8..e289018 100644
--- a/gee-cache/day3-http-server/geecache/geecache.go
+++ b/gee-cache/day3-http-server/geecache/geecache.go
@@ -70,12 +70,6 @@ func (g *Group) Get(key string) (ByteView, error) {
 	return g.load(key)
 }
 
-func cloneBytes(b []byte) []byte {
-	c := make([]byte, len(b))
-	copy(c, b)
-	return c
-}
-
 func (g *Group) load(key string) (value ByteView, err error) {
 	return g.getLocally(key)
 }
diff --git a/gee-cache/day3-http-server/geecache/geecache_test.go b/gee-cache/day3-http-server/geecache/geecache_test.go
index 9cb4079..7ef9f4f 100644
--- a/gee-cache/day3-http-server/geecache/geecache_test.go
+++ b/gee-cache/day3-http-server/geecache/geecache_test.go
@@ -3,6 +3,7 @@ package geecache
 import (
 	"fmt"
 	"log"
+	"reflect"
 	"testing"
 )
 
@@ -12,21 +13,39 @@ var db = map[string]string{
 	"Sam":  "567",
 }
 
+func TestGetter(t *testing.T) {
+	var f Getter = GetterFunc(func(key string) ([]byte, error) {
+		return []byte(key), nil
+	})
+
+	expect := []byte("key")
+	if v, _ := f.Get("key"); !reflect.DeepEqual(v, expect) {
+		t.Fatal("callback failed")
+	}
+}
+
 func TestGet(t *testing.T) {
+	loadCounts := make(map[string]int, len(db))
 	gee := NewGroup("scores", 2<<10, GetterFunc(
 		func(key string) ([]byte, error) {
 			log.Println("[SlowDB] search key", key)
 			if v, ok := db[key]; ok {
+				if _, ok := loadCounts[key]; !ok {
+					loadCounts[key] = 0
+				}
+				loadCounts[key]++
 				return []byte(v), nil
 			}
 			return nil, fmt.Errorf("%s not exist", key)
 		}))
 
 	for k, v := range db {
-		view, err := gee.Get(k)
-		if err != nil || view.String() != v {
+		if view, err := gee.Get(k); err != nil || view.String() != v {
 			t.Fatal("failed to get value of Tom")
 		}
+		if _, err := gee.Get(k); err != nil || loadCounts[k] > 1 {
+			t.Fatalf("cache %s miss", k)
+		}
 	}
 
 	if view, err := gee.Get("unknown"); err == nil {
diff --git a/gee-cache/day3-http-server/geecache/http.go b/gee-cache/day3-http-server/geecache/http.go
index ef5e2f1..b9b994e 100644
--- a/gee-cache/day3-http-server/geecache/http.go
+++ b/gee-cache/day3-http-server/geecache/http.go
@@ -16,7 +16,7 @@ type HTTPPool struct {
 	basePath string
 }
 
-// NewHTTPPool initializes an HTTP pool of peers, and registers itself as a PeerPicker.
+// NewHTTPPool initializes an HTTP pool of peers.
 func NewHTTPPool(self string) *HTTPPool {
 	return &HTTPPool{
 		self:     self,
diff --git a/gee-cache/day4-consistent-hash/geecache/byteview.go b/gee-cache/day4-consistent-hash/geecache/byteview.go
index a51394f..3ee1022 100644
--- a/gee-cache/day4-consistent-hash/geecache/byteview.go
+++ b/gee-cache/day4-consistent-hash/geecache/byteview.go
@@ -19,3 +19,9 @@ func (v ByteView) ByteSlice() []byte {
 func (v ByteView) String() string {
 	return string(v.b)
 }
+
+func cloneBytes(b []byte) []byte {
+	c := make([]byte, len(b))
+	copy(c, b)
+	return c
+}
diff --git a/gee-cache/day4-consistent-hash/geecache/geecache.go b/gee-cache/day4-consistent-hash/geecache/geecache.go
index 58b98b8..e289018 100644
--- a/gee-cache/day4-consistent-hash/geecache/geecache.go
+++ b/gee-cache/day4-consistent-hash/geecache/geecache.go
@@ -70,12 +70,6 @@ func (g *Group) Get(key string) (ByteView, error) {
 	return g.load(key)
 }
 
-func cloneBytes(b []byte) []byte {
-	c := make([]byte, len(b))
-	copy(c, b)
-	return c
-}
-
 func (g *Group) load(key string) (value ByteView, err error) {
 	return g.getLocally(key)
 }
diff --git a/gee-cache/day4-consistent-hash/geecache/geecache_test.go b/gee-cache/day4-consistent-hash/geecache/geecache_test.go
index 9cb4079..7ef9f4f 100644
--- a/gee-cache/day4-consistent-hash/geecache/geecache_test.go
+++ b/gee-cache/day4-consistent-hash/geecache/geecache_test.go
@@ -3,6 +3,7 @@ package geecache
 import (
 	"fmt"
 	"log"
+	"reflect"
 	"testing"
 )
 
@@ -12,21 +13,39 @@ var db = map[string]string{
 	"Sam":  "567",
 }
 
+func TestGetter(t *testing.T) {
+	var f Getter = GetterFunc(func(key string) ([]byte, error) {
+		return []byte(key), nil
+	})
+
+	expect := []byte("key")
+	if v, _ := f.Get("key"); !reflect.DeepEqual(v, expect) {
+		t.Fatal("callback failed")
+	}
+}
+
 func TestGet(t *testing.T) {
+	loadCounts := make(map[string]int, len(db))
 	gee := NewGroup("scores", 2<<10, GetterFunc(
 		func(key string) ([]byte, error) {
 			log.Println("[SlowDB] search key", key)
 			if v, ok := db[key]; ok {
+				if _, ok := loadCounts[key]; !ok {
+					loadCounts[key] = 0
+				}
+				loadCounts[key]++
 				return []byte(v), nil
 			}
 			return nil, fmt.Errorf("%s not exist", key)
 		}))
 
 	for k, v := range db {
-		view, err := gee.Get(k)
-		if err != nil || view.String() != v {
+		if view, err := gee.Get(k); err != nil || view.String() != v {
 			t.Fatal("failed to get value of Tom")
 		}
+		if _, err := gee.Get(k); err != nil || loadCounts[k] > 1 {
+			t.Fatalf("cache %s miss", k)
+		}
 	}
 
 	if view, err := gee.Get("unknown"); err == nil {
diff --git a/gee-cache/day4-consistent-hash/geecache/http.go b/gee-cache/day4-consistent-hash/geecache/http.go
index ef5e2f1..b9b994e 100644
--- a/gee-cache/day4-consistent-hash/geecache/http.go
+++ b/gee-cache/day4-consistent-hash/geecache/http.go
@@ -16,7 +16,7 @@ type HTTPPool struct {
 	basePath string
 }
 
-// NewHTTPPool initializes an HTTP pool of peers, and registers itself as a PeerPicker.
+// NewHTTPPool initializes an HTTP pool of peers.
 func NewHTTPPool(self string) *HTTPPool {
 	return &HTTPPool{
 		self:     self,
diff --git a/gee-cache/day5-multi-nodes/geecache/byteview.go b/gee-cache/day5-multi-nodes/geecache/byteview.go
index a51394f..3ee1022 100644
--- a/gee-cache/day5-multi-nodes/geecache/byteview.go
+++ b/gee-cache/day5-multi-nodes/geecache/byteview.go
@@ -19,3 +19,9 @@ func (v ByteView) ByteSlice() []byte {
 func (v ByteView) String() string {
 	return string(v.b)
 }
+
+func cloneBytes(b []byte) []byte {
+	c := make([]byte, len(b))
+	copy(c, b)
+	return c
+}
diff --git a/gee-cache/day5-multi-nodes/geecache/geecache.go b/gee-cache/day5-multi-nodes/geecache/geecache.go
index dbd5c3e..5372a4a 100644
--- a/gee-cache/day5-multi-nodes/geecache/geecache.go
+++ b/gee-cache/day5-multi-nodes/geecache/geecache.go
@@ -79,12 +79,6 @@ func (g *Group) RegisterPeers(peers PeerPicker) {
 	g.peers = peers
 }
 
-func cloneBytes(b []byte) []byte {
-	c := make([]byte, len(b))
-	copy(c, b)
-	return c
-}
-
 func (g *Group) load(key string) (value ByteView, err error) {
 	if g.peers != nil {
 		if peer, ok := g.peers.PickPeer(key); ok {
diff --git a/gee-cache/day5-multi-nodes/geecache/geecache_test.go b/gee-cache/day5-multi-nodes/geecache/geecache_test.go
index 9cb4079..7ef9f4f 100644
--- a/gee-cache/day5-multi-nodes/geecache/geecache_test.go
+++ b/gee-cache/day5-multi-nodes/geecache/geecache_test.go
@@ -3,6 +3,7 @@ package geecache
 import (
 	"fmt"
 	"log"
+	"reflect"
 	"testing"
 )
 
@@ -12,21 +13,39 @@ var db = map[string]string{
 	"Sam":  "567",
 }
 
+func TestGetter(t *testing.T) {
+	var f Getter = GetterFunc(func(key string) ([]byte, error) {
+		return []byte(key), nil
+	})
+
+	expect := []byte("key")
+	if v, _ := f.Get("key"); !reflect.DeepEqual(v, expect) {
+		t.Fatal("callback failed")
+	}
+}
+
 func TestGet(t *testing.T) {
+	loadCounts := make(map[string]int, len(db))
 	gee := NewGroup("scores", 2<<10, GetterFunc(
 		func(key string) ([]byte, error) {
 			log.Println("[SlowDB] search key", key)
 			if v, ok := db[key]; ok {
+				if _, ok := loadCounts[key]; !ok {
+					loadCounts[key] = 0
+				}
+				loadCounts[key]++
 				return []byte(v), nil
 			}
 			return nil, fmt.Errorf("%s not exist", key)
 		}))
 
 	for k, v := range db {
-		view, err := gee.Get(k)
-		if err != nil || view.String() != v {
+		if view, err := gee.Get(k); err != nil || view.String() != v {
 			t.Fatal("failed to get value of Tom")
 		}
+		if _, err := gee.Get(k); err != nil || loadCounts[k] > 1 {
+			t.Fatalf("cache %s miss", k)
+		}
 	}
 
 	if view, err := gee.Get("unknown"); err == nil {
diff --git a/gee-cache/day5-multi-nodes/geecache/http.go b/gee-cache/day5-multi-nodes/geecache/http.go
index d7da2c3..815591f 100644
--- a/gee-cache/day5-multi-nodes/geecache/http.go
+++ b/gee-cache/day5-multi-nodes/geecache/http.go
@@ -26,7 +26,7 @@ type HTTPPool struct {
 	httpGetters map[string]*httpGetter // keyed by e.g. "http://10.0.0.2:8008"
 }
 
-// NewHTTPPool initializes an HTTP pool of peers, and registers itself as a PeerPicker.
+// NewHTTPPool initializes an HTTP pool of peers.
 func NewHTTPPool(self string) *HTTPPool {
 	return &HTTPPool{
 		self:     self,
diff --git a/gee-cache/day6-single-flight/geecache/byteview.go b/gee-cache/day6-single-flight/geecache/byteview.go
index a51394f..3ee1022 100644
--- a/gee-cache/day6-single-flight/geecache/byteview.go
+++ b/gee-cache/day6-single-flight/geecache/byteview.go
@@ -19,3 +19,9 @@ func (v ByteView) ByteSlice() []byte {
 func (v ByteView) String() string {
 	return string(v.b)
 }
+
+func cloneBytes(b []byte) []byte {
+	c := make([]byte, len(b))
+	copy(c, b)
+	return c
+}
diff --git a/gee-cache/day6-single-flight/geecache/geecache.go b/gee-cache/day6-single-flight/geecache/geecache.go
index 3965674..69004ac 100644
--- a/gee-cache/day6-single-flight/geecache/geecache.go
+++ b/gee-cache/day6-single-flight/geecache/geecache.go
@@ -84,12 +84,6 @@ func (g *Group) RegisterPeers(peers PeerPicker) {
 	g.peers = peers
 }
 
-func cloneBytes(b []byte) []byte {
-	c := make([]byte, len(b))
-	copy(c, b)
-	return c
-}
-
 func (g *Group) load(key string) (value ByteView, err error) {
 	// each key is only fetched once (either locally or remotely)
 	// regardless of the number of concurrent callers.
diff --git a/gee-cache/day6-single-flight/geecache/geecache_test.go b/gee-cache/day6-single-flight/geecache/geecache_test.go
index 9cb4079..7ef9f4f 100644
--- a/gee-cache/day6-single-flight/geecache/geecache_test.go
+++ b/gee-cache/day6-single-flight/geecache/geecache_test.go
@@ -3,6 +3,7 @@ package geecache
 import (
 	"fmt"
 	"log"
+	"reflect"
 	"testing"
 )
 
@@ -12,21 +13,39 @@ var db = map[string]string{
 	"Sam":  "567",
 }
 
+func TestGetter(t *testing.T) {
+	var f Getter = GetterFunc(func(key string) ([]byte, error) {
+		return []byte(key), nil
+	})
+
+	expect := []byte("key")
+	if v, _ := f.Get("key"); !reflect.DeepEqual(v, expect) {
+		t.Fatal("callback failed")
+	}
+}
+
 func TestGet(t *testing.T) {
+	loadCounts := make(map[string]int, len(db))
 	gee := NewGroup("scores", 2<<10, GetterFunc(
 		func(key string) ([]byte, error) {
 			log.Println("[SlowDB] search key", key)
 			if v, ok := db[key]; ok {
+				if _, ok := loadCounts[key]; !ok {
+					loadCounts[key] = 0
+				}
+				loadCounts[key]++
 				return []byte(v), nil
 			}
 			return nil, fmt.Errorf("%s not exist", key)
 		}))
 
 	for k, v := range db {
-		view, err := gee.Get(k)
-		if err != nil || view.String() != v {
+		if view, err := gee.Get(k); err != nil || view.String() != v {
 			t.Fatal("failed to get value of Tom")
 		}
+		if _, err := gee.Get(k); err != nil || loadCounts[k] > 1 {
+			t.Fatalf("cache %s miss", k)
+		}
 	}
 
 	if view, err := gee.Get("unknown"); err == nil {
diff --git a/gee-cache/day6-single-flight/geecache/http.go b/gee-cache/day6-single-flight/geecache/http.go
index d7da2c3..815591f 100644
--- a/gee-cache/day6-single-flight/geecache/http.go
+++ b/gee-cache/day6-single-flight/geecache/http.go
@@ -26,7 +26,7 @@ type HTTPPool struct {
 	httpGetters map[string]*httpGetter // keyed by e.g. "http://10.0.0.2:8008"
 }
 
-// NewHTTPPool initializes an HTTP pool of peers, and registers itself as a PeerPicker.
+// NewHTTPPool initializes an HTTP pool of peers.
 func NewHTTPPool(self string) *HTTPPool {
 	return &HTTPPool{
 		self:     self,
diff --git a/gee-cache/day7-proto-buf/geecache/byteview.go b/gee-cache/day7-proto-buf/geecache/byteview.go
index a51394f..3ee1022 100644
--- a/gee-cache/day7-proto-buf/geecache/byteview.go
+++ b/gee-cache/day7-proto-buf/geecache/byteview.go
@@ -19,3 +19,9 @@ func (v ByteView) ByteSlice() []byte {
 func (v ByteView) String() string {
 	return string(v.b)
 }
+
+func cloneBytes(b []byte) []byte {
+	c := make([]byte, len(b))
+	copy(c, b)
+	return c
+}
diff --git a/gee-cache/day7-proto-buf/geecache/geecache.go b/gee-cache/day7-proto-buf/geecache/geecache.go
index 44161bc..cbce7b9 100644
--- a/gee-cache/day7-proto-buf/geecache/geecache.go
+++ b/gee-cache/day7-proto-buf/geecache/geecache.go
@@ -85,12 +85,6 @@ func (g *Group) RegisterPeers(peers PeerPicker) {
 	g.peers = peers
 }
 
-func cloneBytes(b []byte) []byte {
-	c := make([]byte, len(b))
-	copy(c, b)
-	return c
-}
-
 func (g *Group) load(key string) (value ByteView, err error) {
 	// each key is only fetched once (either locally or remotely)
 	// regardless of the number of concurrent callers.
diff --git a/gee-cache/day7-proto-buf/geecache/geecache_test.go b/gee-cache/day7-proto-buf/geecache/geecache_test.go
index 9cb4079..7ef9f4f 100644
--- a/gee-cache/day7-proto-buf/geecache/geecache_test.go
+++ b/gee-cache/day7-proto-buf/geecache/geecache_test.go
@@ -3,6 +3,7 @@ package geecache
 import (
 	"fmt"
 	"log"
+	"reflect"
 	"testing"
 )
 
@@ -12,21 +13,39 @@ var db = map[string]string{
 	"Sam":  "567",
 }
 
+func TestGetter(t *testing.T) {
+	var f Getter = GetterFunc(func(key string) ([]byte, error) {
+		return []byte(key), nil
+	})
+
+	expect := []byte("key")
+	if v, _ := f.Get("key"); !reflect.DeepEqual(v, expect) {
+		t.Fatal("callback failed")
+	}
+}
+
 func TestGet(t *testing.T) {
+	loadCounts := make(map[string]int, len(db))
 	gee := NewGroup("scores", 2<<10, GetterFunc(
 		func(key string) ([]byte, error) {
 			log.Println("[SlowDB] search key", key)
 			if v, ok := db[key]; ok {
+				if _, ok := loadCounts[key]; !ok {
+					loadCounts[key] = 0
+				}
+				loadCounts[key]++
 				return []byte(v), nil
 			}
 			return nil, fmt.Errorf("%s not exist", key)
 		}))
 
 	for k, v := range db {
-		view, err := gee.Get(k)
-		if err != nil || view.String() != v {
+		if view, err := gee.Get(k); err != nil || view.String() != v {
 			t.Fatal("failed to get value of Tom")
 		}
+		if _, err := gee.Get(k); err != nil || loadCounts[k] > 1 {
+			t.Fatalf("cache %s miss", k)
+		}
 	}
 
 	if view, err := gee.Get("unknown"); err == nil {
diff --git a/gee-cache/day7-proto-buf/geecache/http.go b/gee-cache/day7-proto-buf/geecache/http.go
index 4a1c129..be8a44e 100644
--- a/gee-cache/day7-proto-buf/geecache/http.go
+++ b/gee-cache/day7-proto-buf/geecache/http.go
@@ -29,7 +29,7 @@ type HTTPPool struct {
 	httpGetters map[string]*httpGetter // keyed by e.g. "http://10.0.0.2:8008"
 }
 
-// NewHTTPPool initializes an HTTP pool of peers, and registers itself as a PeerPicker.
+// NewHTTPPool initializes an HTTP pool of peers.
 func NewHTTPPool(self string) *HTTPPool {
 	return &HTTPPool{
 		self:     self,
diff --git a/gee-cache/doc/geecache-day1.md b/gee-cache/doc/geecache-day1.md
index f5330d8..6848421 100644
--- a/gee-cache/doc/geecache-day1.md
+++ b/gee-cache/doc/geecache-day1.md
@@ -1,7 +1,7 @@
 ---
 title: 动手写分布式缓存 - GeeCache第一天 LRU 缓存淘汰策略
 date: 2020-02-11 22:00:00
-description: 7天用 Go语言/golang 从零实现分布式缓存 GeeCache 教程(7 days implement golang distributed cache from scratch tutorial)，动手写分布式缓存，参照 groupcache 的实现。本文介绍常用的三种缓存淘汰(失效)算法：先进先出(FIFO)，最少使用(LFU) 和 最近最少使用(LRU)，并实现 LRU 算法和相应的测试代码。
+description: 7天用 Go语言/golang 从零实现分布式缓存 GeeCache 教程(7 days implement golang distributed cache from scratch tutorial)，动手写分布式缓存，参照 groupcache 的实现。本文介绍了常用的三种缓存淘汰(失效)算法：先进先出(FIFO)，最少使用(LFU) 和 最近最少使用(LRU)，并实现 LRU 算法和相应的测试代码。
 tags:
 - Go
 nav: 从零实现
@@ -9,8 +9,8 @@ categories:
 - 分布式缓存 - GeeCache
 keywords:
 - Go语言
-- 从零实现分布式缓存
-- 动手写分布式缓存
+- 从零实现
+- 分布式缓存
 - LRU
 - 缓存失效
 image: post/geecache-day1/lru_logo.jpg
@@ -141,7 +141,7 @@ func (c *Cache) RemoveOldest() {
 ```
 
 - `c.ll.Back()` 取到队首节点，从链表中删除。
-- `delete(c.cache, kv.key)`，从字典中`c.cache`删除该节点的映射关系。
+- `delete(c.cache, kv.key)`，从字典中 `c.cache` 删除该节点的映射关系。
 - 更新当前所用的内存 `c.nbytes`。
 - 如果回调函数 `OnEvicted` 不为 nil，则调用回调函数。
 
@@ -167,7 +167,7 @@ func (c *Cache) Add(key string, value Value) {
 ```
 
 - 如果键存在，则更新对应节点的值，并将该节点移到队尾。
-- 不存在则是新增场景，首先队尾添加新节点 `&entry{key, value}`, 并字典中添加 `key` 和节点的映射关系。
+- 不存在则是新增场景，首先队尾添加新节点 `&entry{key, value}`, 并字典中添加 key 和节点的映射关系。
 - 更新 `c.nbytes`，如果超过了设定的最大值 `c.maxBytes`，则移除最少访问的节点。
 
 最后，为了方便测试，我们实现 `Len()` 用来获取添加了多少条数据。
diff --git a/gee-cache/doc/geecache-day1/lru.jpg b/gee-cache/doc/geecache-day1/lru.jpg
old mode 100755
new mode 100644
diff --git a/gee-cache/doc/geecache-day1/lru_logo.jpg b/gee-cache/doc/geecache-day1/lru_logo.jpg
old mode 100755
new mode 100644
diff --git a/gee-cache/doc/geecache-day2.md b/gee-cache/doc/geecache-day2.md
new file mode 100644
index 0000000..c899111
--- /dev/null
+++ b/gee-cache/doc/geecache-day2.md
@@ -0,0 +1,430 @@
+---
+title: 动手写分布式缓存 - GeeCache第二天 单机并发缓存
+date: 2020-02-12 22:00:00
+description: 7天用 Go语言/golang 从零实现分布式缓存 GeeCache 教程(7 days implement golang distributed cache from scratch tutorial)，动手写分布式缓存，参照 groupcache 的实现。本文介绍了 sync.Mutex 互斥锁的使用，并发控制 LRU 缓存。实现 GeeCache 核心数据结构 Group，缓存不存在时，调用回调函数(callback)获取源数据。
+tags:
+- Go
+nav: 从零实现
+categories:
+- 分布式缓存 - GeeCache
+keywords:
+- Go语言
+- 从零实现
+- 分布式缓存
+- 互斥锁
+- sync.Mutex
+image: post/geecache-day2/concurrent_cache_logo.jpg
+github: https://github.com/geektutu/7days-golang
+---
+
+![geecache concurrent cache](geecache-day2/concurrent_cache.jpg)
+
+本文是[7天用Go从零实现分布式缓存GeeCache](https://geektutu.com/post/geecache.html)的第二篇。
+
+- 介绍 sync.Mutex 互斥锁的使用，并实现 LRU 缓存的并发控制。
+- 实现 GeeCache 核心数据结构 Group，缓存不存在时，调用回调函数获取源数据，**代码约150行**
+
+## 1 sync.Mutex
+
+多个协程(goroutine)同时读写同一个变量，在并发度较高的情况下，会发生冲突。确保一次只有一个协程(goroutine)可以访问该变量以避免冲突，这称之为`互斥`，互斥锁可以解决这个问题。
+
+> sync.Mutex 是一个互斥锁，可以由不同的协程加锁和解锁。
+
+`sync.Mutex` 是 Go 语言标准库提供的一个互斥锁，当一个协程(goroutine)获得了这个锁的拥有权后，其它请求锁的协程(goroutine) 就会阻塞在 `Lock()` 方法的调用上，直到调用 `Unlock()` 锁被释放。
+
+接下来举一个简单的例子，假设有10个并发的协程打印了同一个数字`100`，为了避免重复打印，实现了`printOnce(num int)` 函数，使用集合 set 记录已打印过的数字，如果数字已打印过，则不再打印。
+
+```go
+var set = make(map[int]bool, 0)
+
+func printOnce(num int) {
+	if _, exist := set[num]; !exist {
+		fmt.Println(num)
+	}
+	set[num] = true
+}
+
+func main() {
+	for i := 0; i < 10; i++ {
+		go printOnce(100)
+	}
+	time.Sleep(time.Second)
+}
+```
+
+我们运行 `go run .` 会发生什么情况呢？
+
+```bash
+$ go run .
+100
+100
+```
+
+有时候打印 2 次，有时候打印 4 次，有时候还会触发 panic，因为对同一个数据结构`set`的访问冲突了。接下来用互斥锁的`Lock()`和`Unlock()` 方法将冲突的部分包裹起来：
+
+```go
+var m sync.Mutex
+var set = make(map[int]bool, 0)
+
+func printOnce(num int) {
+	m.Lock()
+	if _, exist := set[num]; !exist {
+		fmt.Println(num)
+	}
+	set[num] = true
+	m.Unlock()
+}
+
+func main() {
+	for i := 0; i < 10; i++ {
+		go printOnce(100)
+	}
+	time.Sleep(time.Second)
+}
+```
+
+```bash
+$ go run .
+100
+```
+
+相同的数字只会被打印一次。当一个协程调用了 `Lock()` 方法时，其他协程被阻塞了，直到`Unlock()`调用将锁释放。因此被包裹部分的代码就能够避免冲突，实现互斥。
+
+`Unlock()`释放锁还有另外一种写法：
+
+```go
+func printOnce(num int) {
+	m.Lock()
+	defer m.Unlock()
+	if _, exist := set[num]; !exist {
+		fmt.Println(num)
+	}
+	set[num] = true
+}
+```
+
+## 2 支持并发读写
+
+上一篇文章 [GeeCache 第一天](https://geektutu.com/post/geecache-day1.html) 实现了 LRU 缓存淘汰策略。接下来我们使用 `sync.Mutex` 封装 LRU 的几个方法，使之支持并发的读写。在这之前，我们抽象了一个只读数据结构 `ByteView` 用来表示缓存值，是 GeeCache 主要的数据结构之一。
+
+[day2-single-node/geecache/byteview.go - github](https://github.com/geektutu/7days-golang/tree/master/gee-cache/day2-single-node/geecache)
+
+```go
+package geecache
+
+// A ByteView holds an immutable view of bytes.
+type ByteView struct {
+	b []byte
+}
+
+// Len returns the view's length
+func (v ByteView) Len() int {
+	return len(v.b)
+}
+
+// ByteSlice returns a copy of the data as a byte slice.
+func (v ByteView) ByteSlice() []byte {
+	return cloneBytes(v.b)
+}
+
+// String returns the data as a string, making a copy if necessary.
+func (v ByteView) String() string {
+	return string(v.b)
+}
+
+func cloneBytes(b []byte) []byte {
+	c := make([]byte, len(b))
+	copy(c, b)
+	return c
+}
+```
+
+- ByteView 只有一个数据成员，`b []byte`，b 将会存储真实的缓存值。选择 byte 类型是为了能够支持任意的数据类型的存储，例如字符串、图片等。
+- 实现 `Len() int` 方法，我们在 lru.Cache 的实现中，要求被缓存对象必须实现 Value 接口，即 `Len() int` 方法，返回其所占的内存大小。
+- `b` 是只读的，使用 `ByteSlice()` 方法返回一个拷贝，防止缓存值被外部程序修改。
+
+接下来就可以为 lru.Cache 添加并发特性了。
+
+[day2-single-node/geecache/cache.go - github](https://github.com/geektutu/7days-golang/tree/master/gee-cache/day2-single-node/geecache)
+
+```go
+package geecache
+
+import (
+	"geecache/lru"
+	"sync"
+)
+
+type cache struct {
+	mu         sync.Mutex
+	lru        *lru.Cache
+	cacheBytes int64
+}
+
+func (c *cache) add(key string, value ByteView) {
+	c.mu.Lock()
+	defer c.mu.Unlock()
+	if c.lru == nil {
+		c.lru = lru.New(c.cacheBytes, nil)
+	}
+	c.lru.Add(key, value)
+}
+
+func (c *cache) get(key string) (value ByteView, ok bool) {
+	c.mu.Lock()
+	defer c.mu.Unlock()
+	if c.lru == nil {
+		return
+	}
+
+	if v, ok := c.lru.Get(key); ok {
+		return v.(ByteView), ok
+	}
+
+	return
+}
+```
+
+- `cache.go` 的实现非常简单，实例化 lru，封装 get 和 add 方法，并添加互斥锁 mu。
+- 在 `add` 方法中，判断了 `c.lru` 是否为 nil，如果不等于 nil 再创建实例。这种方法称之为延迟初始化(Lazy Initialization)，一个对象的延迟初始化意味着该对象的创建将会延迟至第一次使用该对象时。主要用于提高性能，并减少程序内存要求。
+
+## 3 主体结构 Group
+
+Group 是 GeeCache 最核心的数据结构，负责与用户的交互，并且控制缓存值存储和获取的流程。
+
+```bash
+                            是
+接收 key --> 检查是否被缓存 -----> 返回缓存值 ⑴
+                |  否                         是
+                |-----> 是否应当从远程节点获取 -----> 与远程节点交互 --> 返回缓存值 ⑵
+                            |  否
+                            |-----> 调用`回调函数`，获取值并添加到缓存 --> 返回缓存值 ⑶
+```
+
+我们将在 `geecache.go` 中实现主体结构 Group，那么 GeeCache 的代码结构的雏形已经形成了。
+
+```bash
+geecache/
+    |--lru/
+        |--lru.go  // lru 缓存淘汰策略
+    |--byteview.go // 缓存值的抽象与封装
+    |--cache.go    // 并发控制
+    |--geecache.go // 负责与外部交互，控制缓存存储和获取的主流程
+```
+
+接下来我们将实现流程 ⑴ 和 ⑶，远程交互的部分后续再实现。
+
+
+### 3.1 回调 Getter
+
+我们思考一下，如果缓存不存在，应从数据源（文件，数据库等）获取数据并添加到缓存中。GeeCache 是否应该支持多种数据源的配置呢？不应该，一是数据源的种类太多，没办法一一实现；而是扩展性不好。如何从源头获取数据，应该是用户决定的事情，我们就把这件事交给用户好了。因此，我们设计了一个回调函数(callback)，在缓存不存在时，调用这个函数，得到源数据。
+
+[day2-single-node/geecache/geecache.go - github](https://github.com/geektutu/7days-golang/tree/master/gee-cache/day2-single-node/geecache)
+
+```go
+// A Getter loads data for a key.
+type Getter interface {
+	Get(key string) ([]byte, error)
+}
+
+// A GetterFunc implements Getter with a function.
+type GetterFunc func(key string) ([]byte, error)
+
+// Get implements Getter interface function
+func (f GetterFunc) Get(key string) ([]byte, error) {
+	return f(key)
+}
+```
+
+- 定义接口 Getter 和 回调函数 `Get(key string)([]byte, error)`，参数是 key，返回值是 []byte。
+- 定义函数类型 GetterFunc，并实现 Getter 接口的 `Get` 方法。
+
+我们可以写一个测试用例来保证回调函数能够正常工作。
+
+```go
+func TestGetter(t *testing.T) {
+	var f Getter = GetterFunc(func(key string) ([]byte, error) {
+		return []byte(key), nil
+	})
+
+	expect := []byte("key")
+	if v, _ := f.Get("key"); !reflect.DeepEqual(v, expect) {
+		t.Errorf("callback failed")
+	}
+}
+```
+
+- 在这个测试用例中，我们借助 GetterFunc 的类型转换，将一个匿名回调函数转换成了接口 `f Getter`。
+- 调用该接口的方法 `f.Get(key string)`，实际上就是在调用匿名回调函数。
+
+> 定义一个函数类型 F，并且实现接口 A 的方法，然后在这个方法中调用自己。这是 Go 语言中将其他函数（参数返回值定义与 F 一致）转换为接口 A 的常用技巧。
+
+### 3.2 Group 的定义
+
+接下来是最核心数据结构 Group 的定义：
+
+[day2-single-node/geecache/geecache.go - github](https://github.com/geektutu/7days-golang/tree/master/gee-cache/day2-single-node/geecache)
+
+```go
+// A Group is a cache namespace and associated data loaded spread over
+type Group struct {
+	name      string
+	getter    Getter
+	mainCache cache
+}
+
+var (
+	mu     sync.RWMutex
+	groups = make(map[string]*Group)
+)
+
+// NewGroup create a new instance of Group
+func NewGroup(name string, cacheBytes int64, getter Getter) *Group {
+	if getter == nil {
+		panic("nil Getter")
+	}
+	mu.Lock()
+	defer mu.Unlock()
+	g := &Group{
+		name:      name,
+		getter:    getter,
+		mainCache: cache{cacheBytes: cacheBytes},
+	}
+	groups[name] = g
+	return g
+}
+
+// GetGroup returns the named group previously created with NewGroup, or
+// nil if there's no such group.
+func GetGroup(name string) *Group {
+	mu.RLock()
+	g := groups[name]
+	mu.RUnlock()
+	return g
+}
+```
+
+- 一个 Group 可以认为是一个缓存的命名空间，每个 Group 拥有一个唯一的名称 `name`。比如可以创建三个 Group，缓存学生的成绩命名为 scores，缓存学生信息的命名为 info，缓存学生课程的命名为 courses。
+- 第二个属性是 `getter Getter`，即缓存未命中时获取源数据的回调(callback)。
+- 第三个属性是 `mainCache cache`，即一开始实现的并发缓存。
+- 构建函数 `NewGroup` 用来实例化 Group，并且将 group 存储在全局变量 `groups` 中。
+- `GetGroup` 用来特定名称的 Group，这里使用了只读锁 `RLock()`，因为不涉及任何冲突变量的写操作。
+
+### 3.3 Group 的 Get 方法
+
+接下来是 GeeCache 最为核心的方法 `Get`：
+
+```go
+// Get value for a key from cache
+func (g *Group) Get(key string) (ByteView, error) {
+	if key == "" {
+		return ByteView{}, fmt.Errorf("key is required")
+	}
+
+	if v, ok := g.mainCache.get(key); ok {
+		log.Println("[GeeCache] hit")
+		return v, nil
+	}
+
+	return g.load(key)
+}
+
+func (g *Group) load(key string) (value ByteView, err error) {
+	return g.getLocally(key)
+}
+
+func (g *Group) getLocally(key string) (ByteView, error) {
+	bytes, err := g.getter.Get(key)
+	if err != nil {
+		return ByteView{}, err
+
+	}
+	value := ByteView{b: cloneBytes(bytes)}
+	g.populateCache(key, value)
+	return value, nil
+}
+
+func (g *Group) populateCache(key string, value ByteView) {
+	g.mainCache.add(key, value)
+}
+```
+
+- Get 方法实现了上述所说的流程 ⑴ 和 ⑶。
+- 流程 ⑴ ：从 mainCache 中查找缓存，如果存在则返回缓存值。
+- 流程 ⑶ ：缓存不存在，则调用 load 方法，load 调用 getLocally（分布式场景下会调用 getFromPeer 从其他节点获取），getLocally 调用用户回调函数 `g.getter.Get()` 获取源数据，并且将源数据添加到缓存 mainCache 中（通过 populateCache 方法）
+
+至此，这一章节的单机并发缓存就已经完成了。
+
+## 4 测试
+
+可以写测试用例，也可以写 main 函数来测试这一章节实现的功能。那我们通过测试用例来看一下，如何使用我们实现的单机并发缓存吧。
+
+首先，用一个 map 模拟耗时的数据库。
+
+```go
+var db = map[string]string{
+	"Tom":  "630",
+	"Jack": "589",
+	"Sam":  "567",
+}
+```
+
+创建 group 实例，并测试 `Get` 方法
+
+```go
+func TestGet(t *testing.T) {
+	loadCounts := make(map[string]int, len(db))
+	gee := NewGroup("scores", 2<<10, GetterFunc(
+		func(key string) ([]byte, error) {
+			log.Println("[SlowDB] search key", key)
+			if v, ok := db[key]; ok {
+				if _, ok := loadCounts[key]; !ok {
+					loadCounts[key] = 0
+				}
+				loadCounts[key] += 1
+				return []byte(v), nil
+			}
+			return nil, fmt.Errorf("%s not exist", key)
+		}))
+
+	for k, v := range db {
+		if view, err := gee.Get(k); err != nil || view.String() != v {
+			t.Fatal("failed to get value of Tom")
+		} // load from callback function
+		if _, err := gee.Get(k); err != nil || loadCounts[k] > 1 {
+			t.Fatalf("cache %s miss", k)
+		} // cache hit
+	}
+
+	if view, err := gee.Get("unknown"); err == nil {
+		t.Fatalf("the value of unknow should be empty, but %s got", view)
+	}
+}
+```
+
+- 在这个测试用例中，我们主要测试了 2 种情况
+- 1）在缓存为空的情况下，能够通过回调函数获取到源数据。
+- 2）在缓存已经存在的情况下，是否直接从缓存中获取，为了实现这一点，使用 `loadCounts` 统计某个键调用回调函数的次数，如果次数大于1，则表示调用了多次回调函数，没有缓存。
+
+测试结果如下：
+
+```bash
+$ go test -run TestGet
+2020/02/11 22:07:31 [SlowDB] search key Sam
+2020/02/11 22:07:31 [GeeCache] hit
+2020/02/11 22:07:31 [SlowDB] search key Tom
+2020/02/11 22:07:31 [GeeCache] hit
+2020/02/11 22:07:31 [SlowDB] search key Jack
+2020/02/11 22:07:31 [GeeCache] hit
+2020/02/11 22:07:31 [SlowDB] search key unknown
+PASS
+ok      geecache        0.008s
+```
+
+可以很清晰地看到，缓存为空时，调用了回调函数，第二次访问时，则直接从缓存中读取。
+
+## 附 推荐阅读
+
+- [Go 语言简明教程 - 并发编程](https://geektutu.com/post/quick-golang.html#7-并发编程-goroutine)
+- [Go Test 单元测试简明教程](https://geektutu.com/post/quick-go-test.html)
+- [sync 官方文档 - golang.org](https://golang.org/pkg/sync/)
\ No newline at end of file
diff --git a/gee-cache/doc/geecache-day2/concurrent_cache.jpg b/gee-cache/doc/geecache-day2/concurrent_cache.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..4c2f171087b1d4dfe76e69433b510feb0a6709a0
GIT binary patch
literal 13089
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
DH>MkT

literal 0
HcmV?d00001

diff --git a/gee-cache/doc/geecache-day2/concurrent_cache_logo.jpg b/gee-cache/doc/geecache-day2/concurrent_cache_logo.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..1a6317c125d145482b277f4b4eab1793a5a7edb7
GIT binary patch
literal 5339
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

literal 0
HcmV?d00001

diff --git a/gee-cache/doc/geecache-day3.md b/gee-cache/doc/geecache-day3.md
new file mode 100644
index 0000000..b113e7c
--- /dev/null
+++ b/gee-cache/doc/geecache-day3.md
@@ -0,0 +1,254 @@
+---
+title: 动手写分布式缓存 - GeeCache第三天 HTTP 服务端
+date: 2020-02-12 22:00:00
+description: 7天用 Go语言/golang 从零实现分布式缓存 GeeCache 教程(7 days implement golang distributed cache from scratch tutorial)，动手写分布式缓存，参照 groupcache 的实现。本文介绍了如何使用标准库 http 搭建 HTTP Server，为 GeeCache 单机节点搭建 HTTP 服务，并进行相关的测试。
+tags:
+- Go
+nav: 从零实现
+categories:
+- 分布式缓存 - GeeCache
+keywords:
+- Go语言
+- 从零实现
+- 分布式缓存
+- HTTP Server
+image: post/geecache-day3/http_logo.jpg
+github: https://github.com/geektutu/7days-golang
+---
+
+![geecache http server](geecache-day3/http.jpg)
+
+本文是[7天用Go从零实现分布式缓存GeeCache](https://geektutu.com/post/geecache.html)的第三篇。
+
+- 介绍如何使用 Go 语言标准库 `http` 搭建 HTTP Server
+- 并实现 main 函数启动 HTTP Server 测试 API，**代码约60行**
+
+## 1 http 标准库
+
+Go 语言提供了 `http` 标准库，可以非常方便地搭建 HTTP 服务端和客户端。比如我们可以实现一个服务端，无论接收到什么请求，都返回字符串 "Hello World!"
+
+```go
+package main
+
+import (
+	"log"
+	"net/http"
+)
+
+type server int
+
+func (h *server) ServeHTTP(w http.ResponseWriter, r *http.Request) {
+	log.Println(r.URL.Path)
+	w.Write([]byte("Hello World!"))
+}
+
+func main() {
+	var s server
+	http.ListenAndServe("localhost:9999", &s)
+}
+```
+
+- 创建任意类型 server，并实现 `ServeHTTP` 方法。
+- 调用 `http.ListenAndServe` 在 9999 端口启动 http 服务，处理请求的对象为 `s server`。
+
+接下来我们执行 `go run .` 启动服务，借助 curl 来测试效果：
+
+```bash
+$ curl http://localhost:9999  
+Hello World!
+$ curl http://localhost:9999/abc
+Hello World!
+```
+
+Go 程序日志输出
+
+```bash
+2020/02/11 22:56:32 /
+2020/02/11 22:56:34 /abc
+```
+
+> `http.ListenAndServe` 接收 2 个参数，第一个参数是服务启动的地址，第二个参数是 Handler，任何实现了 `ServeHTTP` 方法的对象都可以作为 HTTP 的 Handler。
+
+在标准库中，http.Handler 接口的定义如下：
+
+```go
+package http
+
+type Handler interface {
+    ServeHTTP(w ResponseWriter, r *Request)
+}
+```
+
+## 2 GeeCache HTTP 服务端
+
+分布式缓存需要实现节点间通信，建立基于 HTTP 的通信机制是比较常见和简单的做法。如果一个节点启动了 HTTP 服务，那么这个节点就可以被其他节点访问。今天我们就为单机节点搭建 HTTP Server。
+
+不与其他部分耦合，我们将这部分代码放在新的 `http.go` 文件中，当前的代码结构如下：
+
+```bash
+geecache/
+    |--lru/
+        |--lru.go  // lru 缓存淘汰策略
+    |--byteview.go // 缓存值的抽象与封装
+    |--cache.go    // 并发控制
+    |--geecache.go // 负责与外部交互，控制缓存存储和获取的主流程
+	|--http.go     // 提供被其他节点访问的能力(基于http)
+```
+
+首先我们创建一个结构体 `HTTPPool`，作为承载节点间 HTTP 通信的核心数据结构（包括服务端和客户端，今天只实现服务端）。
+
+[day3-http-server/geecache/http.go - github](https://github.com/geektutu/7days-golang/tree/master/gee-cache/day3-http-server/geecache)
+
+```go
+package geecache
+
+import (
+	"fmt"
+	"log"
+	"net/http"
+	"strings"
+)
+
+const defaultBasePath = "/_geecache/"
+
+// HTTPPool implements PeerPicker for a pool of HTTP peers.
+type HTTPPool struct {
+	// this peer's base URL, e.g. "https://example.net:8000"
+	self     string
+	basePath string
+}
+
+// NewHTTPPool initializes an HTTP pool of peers.
+func NewHTTPPool(self string) *HTTPPool {
+	return &HTTPPool{
+		self:     self,
+		basePath: defaultBasePath,
+	}
+}
+```
+
+- `HTTPPool` 只有 2 个参数，一个是 self，用来记录自己的地址，包括主机名/IP 和端口。
+- 另一个是 basePath，作为节点间通讯地址的前缀，默认是 `/_geecache/`，那么 http://example.com/_geecache/ 开头的请求，就用于节点间的访问。因为一个主机上还可能承载其他的服务，加一段 Path 是一个好习惯。比如，大部分网站的 API 接口，一般以 `/api` 作为前缀。
+
+接下来，实现最为核心的 `ServeHTTP` 方法。
+
+```go
+// Log info with server name
+func (p *HTTPPool) Log(format string, v ...interface{}) {
+	log.Printf("[Server %s] %s", p.self, fmt.Sprintf(format, v...))
+}
+
+// ServeHTTP handle all http requests
+func (p *HTTPPool) ServeHTTP(w http.ResponseWriter, r *http.Request) {
+	if !strings.HasPrefix(r.URL.Path, p.basePath) {
+		panic("HTTPPool serving unexpected path: " + r.URL.Path)
+	}
+	p.Log("%s %s", r.Method, r.URL.Path)
+	// /<basepath>/<groupname>/<key> required
+	parts := strings.SplitN(r.URL.Path[len(p.basePath):], "/", 2)
+	if len(parts) != 2 {
+		http.Error(w, "bad request", http.StatusBadRequest)
+		return
+	}
+
+	groupName := parts[0]
+	key := parts[1]
+
+	group := GetGroup(groupName)
+	if group == nil {
+		http.Error(w, "no such group: "+groupName, http.StatusNotFound)
+		return
+	}
+
+	view, err := group.Get(key)
+	if err != nil {
+		http.Error(w, err.Error(), http.StatusInternalServerError)
+		return
+	}
+
+	w.Header().Set("Content-Type", "application/octet-stream")
+	w.Write(view.ByteSlice())
+}
+```
+
+- ServeHTTP 的实现逻辑是比较简单的，首先判断访问路径的前缀是否是 `basePath`，不是返回错误。
+- 我们约定访问路径格式为 `/<basepath>/<groupname>/<key>`，通过 groupname 得到 group 实例，再使用 `group.Get(key)` 获取缓存数据。
+- 最终使用 `w.Write()` 将缓存值作为 httpResponse 的 body 返回。
+
+到这里，HTTP 服务端已经完整地实现了。接下来，我们将在单机上启动 HTTP 服务，使用 curl 进行测试。
+
+## 3 测试
+
+实现 main 函数，实例化 group，并启动 HTTP 服务。
+
+[day3-http-server/main.go - github](https://github.com/geektutu/7days-golang/tree/master/gee-cache/day3-http-server)
+
+```go
+package main
+
+import (
+	"fmt"
+	"geecache"
+	"log"
+	"net/http"
+)
+
+var db = map[string]string{
+	"Tom":  "630",
+	"Jack": "589",
+	"Sam":  "567",
+}
+
+func main() {
+	geecache.NewGroup("scores", 2<<10, geecache.GetterFunc(
+		func(key string) ([]byte, error) {
+			log.Println("[SlowDB] search key", key)
+			if v, ok := db[key]; ok {
+				return []byte(v), nil
+			}
+			return nil, fmt.Errorf("%s not exist", key)
+		}))
+
+	addr := "localhost:9999"
+	peers := geecache.NewHTTPPool(addr)
+	log.Println("geecache is running at", addr)
+	log.Fatal(http.ListenAndServe(addr, peers))
+}
+```
+
+- 同样地，我们使用 map 模拟了数据源 db。
+- 创建一个名为 scores 的 Group，若缓存为空，回调函数会从 db 中获取数据并返回。
+- 使用 http.ListenAndServe 在 9999 端口启动了 HTTP 服务。
+
+> 需要注意的点：
+> main.go 和 geecache/ 在同级目录，但 go modules 不再支持 import <相对路径>，相对路径需要在 go.mod 中声明：
+> require geecache v0.0.0
+> replace geecache => ./geecache
+
+接下来，运行 main 函数，使用 curl 做一些简单测试：
+
+```bash
+$ curl http://localhost:9999/_geecache/scores/Tom
+630
+$ curl http://localhost:9999/_geecache/scores/kkk
+kkk not exist
+```
+
+GeeCache 的日志输出如下：
+
+```bash
+2020/02/11 23:28:39 geecache is running at localhost:9999
+2020/02/11 23:29:08 [Server localhost:9999] GET /_geecache/scores/Tom
+2020/02/11 23:29:08 [SlowDB] search key Tom
+2020/02/11 23:29:16 [Server localhost:9999] GET /_geecache/scores/kkk
+2020/02/11 23:29:16 [SlowDB] search key kkk
+```
+
+节点间的相互通信不仅需要 HTTP 服务端，还需要 HTTP 客户端，这就是我们下一步需要做的事情。
+
+## 附 推荐阅读
+
+- [Go 语言简明教程](https://geektutu.com/post/quick-golang.html)
+- [Go Test 单元测试简明教程](https://geektutu.com/post/quick-go-test.html)
+- [Go http.Handler 基础](https://geektutu.com/post/gee-day1.html)
+- [http 官方文档 - golang.org](https://golang.org/pkg/http)
\ No newline at end of file
diff --git a/gee-cache/doc/geecache-day3/http.jpg b/gee-cache/doc/geecache-day3/http.jpg
new file mode 100755
index 0000000000000000000000000000000000000000..20bde205b4a49ae27b28362abba05d7918835004
GIT binary patch
literal 14453
zcmb`u1yo#1(<r(Jx8M*Qf(8xln&1+GySux)C&AqzL4&&mcXxM};O=sVbIy0}|G)Lt
z``=pk_6)tdtBUIGs_yFQ-8C<BFKYm*q^N`_00IF32>bzF7J*LyH0=Lbdg%br;6PfC
zB#;0p073&G(14dNfbg{iXwYj@|4A?)2q<V+NI3YH1pw}E_`L6bkl-hx;D4$7-!8t%
zEB==y?$h85Td!~2wX`=60qm3y18BVVG4%Jxd&A#k1nFF9v%OS)7Di7tkTJc!umAJ|
zw6GbKdg}hP<dSF8AUj3?DSqhoXsj^imhZiLkL)&kyxGEsr!(T-OZC;u<(#aH3uU~C
ztU~ZddL&Dz>lOVC^&uyJlT^idM3KvfgL`j5;0J;)z#p*P*itcIJkNOdX!17uG1H_@
zD)l0x=0YrUnwaj1XV7?_w*`9qHyyV}_Xe@n<JW_cPnXt>I^B;?_nE?*d@(GcoOhW8
zqQ5PPtYTsJbXdn;`zm|y!*Q^rZUIc)@beYzH`qQFa1;~gocFx|<HYn&65V;_a4j67
zOZG$uBl`d0YJ)HtTXbJX_h-pN<x*$RqvdJv)VTbOkL6t-08|4&lz7&HnX@9T19`B%
zG_&3X61_2I5Ag@z(I3o*zm!s&l9uWuO7<St$wha@=?v^>BYQbw#0`5O_E3u@oE1MS
z!N2zG|0|WW0f2_!E5(o3jHWPNNm99XrVz12-uD%NUHY2;o#^WUdIoUu&CDpGkkL%(
zytT7hOP!m6#TA|o+e~d^u?$Lh8yFA$1DsK(PdZOoa0Me9w#cPHW1WY0RVQA;+eHp<
zu7R<y37Y$O^sP#I`AlyfkuM;2X2g#dHXP4|UHjt|i>V0Y3d+?V;FSNSSR?^JyKv{?
zH&OM3f&k_(xi9Y_rrWLBAQlt)en%uQFAP|Ndqrndktp2o4}7V{7JCW0sDz;!{849V
zq@?>`Li-B<@JzcR-A47+oqjs~v>$_5H~;Pn0I(8qYuopjGyq`1uId@k_S!yTsM!}S
zQvmb&54w6m`J%g?Ij=d$dDKYDxo}cz$Vr!>8szljEj{Kdt(E&7b>BMrac?BjEDhpL
zS|$A|`|m!T7<iah>}x`B<O+47cs#fd*;pMX3N7&iVtZP64l?<@<9AF+F*`T^CIbM7
zh|#o^3*xW*owp9h&llUE4rp$aH+N$DD8a3w_p^~)7x|=9zW-1o9S`M;1U;L$4ZHx-
zF6`}2x{m28JC+8EmorX=un<vjs{dgd<9I)rZFr__aH-jB39F6ZC|w^p(kxZEY6uI$
z+WGMh8H5cV<wKBSDHU&ZR&`>Z5)to7cixsS7z_PM!A;(^I9z0(@aa-pfZ`Khql>%I
zNM$MAm@ut0KmC_iDqnC$$gZSB9^)exsPZWk_clavKU3Yxt7->#CxdXy?X(R{@tQzW
zh8xMam$Pna1Z4@4i%vQcXcgBz?TD^Qf8zlFIhW!WY?>otjxTf*jqg8DSlKv5kY7M$
zl$#jiHSQXMT1VS|Fp>#VfVdHMhf^Cw1_AFsP{0wsSrC$D6s%cS@QV67rCh%9g9(lK
zyZQqF;+#;y<s6kHFdV=F5W(2Z3Po^P{_h3!;V+P^Js5)E!1)#Y0D&zn9@xf0{x?Gl
zKtMu4gJAwLv!GX&4{P8IJi&ZX0N@g=U6Q}5e`k<wNN)E*o+CMP9C1BqF5_9HrMT8$
z)Y@JlSEg9Vhv;kVlWnP$6NJa+Qmw~9t2ob#CIHwT&pJ%07@ZsO)-iPGEf}mbyekj9
z*Gw(BaE0~#i!rz<cmPTeAmTd((1OZn1HCF&J^jHV005SYrr(e8&?)QjV>1A_g9Nwp
zUxAsTLNE#xNv8`s$yl@zeC;Lg&UhqWV~$&Jk&D_ixZ?oih&I1Vc%yXEn?>&PS5{?-
zA(+|OIeNYC_x?B@zd}YwvXg9Tu{)Ej=UcykhYYajUQlpz5%ZP7&Rp6rRxST-15>@<
zg&ld!jq^%$Ww!)?uK)rgY@A%)n&lJ#TI2f)4W6;{KLCg}Q4+KrUr@^!fC3gY0a(xw
z|6S4`7_g)vVB!7}HN>l^9}mIV|9b*0?@h_1Itf5@YjM~+^0?zaE-x5`faL@mg_7go
zTzR!hdvZg?z^iSMNFaBSneEUhAW-jcw2;Di?s0Wt3qW`Jq-QU!-;{3-hG<Z+XmCie
z@vrB%cbd;F%oJ!<J2ua>{ik8jKKVCNZ9xDK?$AwQ*`4k^a4{h_H#bOMQXfl_ro;e|
z0Ng6lX%RL)&f+s`J13ikr@jCQ1v<p~^jRGVTFEXnD%v}EUSFV6?a2e+bzPql1W1T{
zzeT!uw>sn&wRL!$*qF^;zE_odA16r;rn|XBgw8z((&3&_Dcttib$#s!M@!Jk37@?M
ztViqSDrK3-mM;Jyh+J}zZ+3;%%r{Jsuqt_i{!=RoAOZmAGM0tq-D3?q!<>Vw8rKY(
z8eK34<n0BKgiRV5SDJX+*Xr;dzLzz7Jq=d*Yb|oj5WtMU0RR*dd>^rE08MZk0DQoT
zQbYwHKoAg6Fz~3bu#nJTR|5oI5oiE9G{!q7R8nT4k8+q~@_PDq_I}YYSR{-rtO~l0
z{sA#r6;+*rpM)KLW>=DbQ8efnpNxt<jccD+Kim4pWdR9*UVuWb+=4G^1-k%ZjD8fr
zJ&HX;u)E=j+Al}ijlP^ZR0wn9U=T0HweWcjo-;&LZj#c?UsAAfkgvvIhlwdGU}V;A
zd2^Nz&$ovHBr;3W&LGRKTKNLB&}xXuh|$G8MV8>g4fu04kH3wLHyn)r-JBI1EZMs&
zuCPr00(^8}$^3|t6ghX#{|%B^IN`~#)(uf3OZzBkF)G8beFBf!d*)np^KnmyDo^|z
z<uj{qxcN3}AewV!N~2+wa7buk>iqP>MA6oTH*vM8fLH&y%cFQjeyh>FPygDO_hsxh
z%B`J##WZV+3%g=Ua?(jTJUovd5A2r~KBphIKHD-c05NQ7H8IL#LF;BWQB+Q7WlhZX
zjIu0^bA!yLWrN1|5Fh17AtmU~R>H~W8XQ=&@!m%&-c*JDsSGXB$tQ{5kNQ{plzZY!
z@(S{WgQX8CmC49MtH=ZL($7Z2u}<Ll6VGxw|Coz!nI<)l4>0w2L*WxWkDPWYe3=zV
zmuDtlp!{Yp;nhqFGnDVnS#xLhJxM*q?VW*rcxy2#LaGCL4myLSv*yX#_>@*MnK6Za
zMEB8vzT0~S`r5A8+D;R3y=Lq2I~H;|4#EA40jqUrGy37=@Ukjc3DfzY+?qNND|GK=
zA8^p^onN^<Wqze8ol^X})j?{zzxxH~eA@l74nb`~7IqRX>l=`|dvg93&p0>3y9es)
z`e2faJab6HqCNz(UzOf)%O;}imwiH#<f&t$Z}YP0is6~wZ|Eichh;edt#982fdgI*
z%Uw=kH$sDODW0^#?6gdxL1d3PP<0yRx14+-3d>o(cbQ6W`nKMTY*|$xA%-_Fff2t%
zV<I#N2Tf)=Q-7VOOYCkEByQ=AXB&&*s^Jtt4vC%CeT{O9pk@^`y_${~r?1-Yjw^iA
zkZS@<aW^q5G`VLmbA&6`?JtPyvTr=%X-TZseQu{BMM0iNwOGZ>xwK~usu@x63X&iv
z@*ueV5%@_0Vxj9t^kW0(@C(r83bIpCoOWQ%Nvq?|JvP{T+?;#?tkJUeNCxMXG`;TB
z#n)6GM|bq9W!`+;$%~~t#iM2$-&q_OQa#)qB-J;~fY-*QBg7lF%1-IB=2EllSi>jG
zy8SU;rnZQav<5T(TOO@R6nPL--cS##i|nw)%_AxZA>GOJM@BCCc~G>~1Wz=9TVjSY
zG~P5Y%^vy2PA^{UZD^I-$wsc)pIwo+CjLrttNq`--U{cd@D{O&YV&^7tlizn+D<fa
zT$N+Waa5laD+@~M!7&jd*&eb)NQF#fOSE2PM<Wtb-IO2MrTMi>)mzz_mI|=P29C4F
z?U9$H?B=lS|7;-eYgh`eedlLaM@c@;8V@%iH)zmcc|YgiM5Iu_`)CmJ7{<+N*|$lX
zjiomw7Ha%l6wrik`=9k?ms?;`aOfrMc5dNd7wx9ra+KH_sb2I9c~|}d^oL`~va#{x
z^hbvcJ?2^^lM%w47)U-m`(!=hJVp3D73~S|;CWo@<UeM-`DcA}>$DWM$O&w0ex$|>
zw-t3;PI!73!!~~rw<%p&V}`(<V^?%DclHAOoV0=QkGCI&m1VDXm8y`Ps=Hvyb@ZHO
zsOmH}62cd&kO^S=o!)hJy>xu37d`%+yOMFGG*@G+jj(Ci6ElT`)qTI$G-3Wqe?SRl
zX`(71X47326MyvwpY?b=fhsv@);rH~x2OFoO^0%>C^sfX0pn;snZVkS16bIluCI`n
zfX!I)RM=af%J*Bruj<68n31ZEgF24Q#7rR~l&=vtj-HK9DlL7Ml|9tKjKjoYt&l3H
z;<k&Zlv{*FmvZjl(p@wv84gw!HMEvz5+#(*3E1Od63RBqNZ>LjrC2$sS+-2vuqSjj
z+`Kv~SJC2<bYzeD_)ey7Ko<ROE;VR7#*(uuRgYDMf*YRJxM3If>dR7u;L@?^qS}8|
zq_t7if!^?x+viq|Z%g{`TWh+Z1|L3(kh*RmbnJUiWTJI{{+>5go*zP&o2_JdUaK+S
zHy3QrS&;I;p<g9BsURo5kDDu<UXf}&k0tvyI?;MK@p*gf81EaVcfpqE+0Kl&F>5(#
zi-kW6+`#Q8MgM2I_Qc`uGIViMXKi{W{h8ruj_IilJ1sO%f0WMMUH}w4WRgiK>N@kV
z_h$ocpG=s01~)8KOgA-11q{unG2Y8)do@$th-}+=m%e}RfvB+<_IoIm*>EtCBY3HJ
zwG+#6|6U(-n#GmzAT({fad94lR9}+EX1ni{$G~a4u{#9&DXy8W<ibuO%LCgnvr=kn
zxNCZQI2qw&CVh6e(X}UCs37=rjHJRasm}Qs{x>p-x3Q$OWh3p-63W;{6sk^)^<+KB
zBhbpuaK2Scm42gvV>RenyXkTZ!wq@%ZdZZT28;(tYnx&UV$u|<`yxUVEJ1^&H<wC_
z3^v4KcxHmd_*}MR9G*K)&+*;i6!3_NY<x`o@Qx8T%M)I=#wNxt6v^RpX_|)%&ekWI
zF_v7x`Z6J0RBqi;%nDQ7_{>7IAL3(ilh}2|b>{<+zvx=yJ&jq_9dw(%kx=mQjczG4
ze*PH_i)xk|w^$>JsZ**jfX@*Wp4c^4I^I(&?A<qANU539^kCED<EX9jc7MY^q`aoN
zez3T|ic+w_!PRPDxUM^#+0TLnWu_})g|7m9rt!o>S+(~}e*w@5RA#S{i>eQt8eRak
zqAkN0fZ_8AQ7iFjzzZPv0$gkamsRPTIk^{C;+*e}jw>vQE&mT|xho!zM1pjn+yb(;
z^0K&>-<o|{Vz{SUG$rUQJ<S2$B5quc#f1iKO=AXCVz9BZiGj1e+P7UQxB1GgQ?e%O
zO3`k@H`BpqL!P?ffrNpU960%tfokRkt#=hR7d<mX?8^7N%<{7x@QAEdebzA<*KK{9
znRYv#6xd}Fy^^kd<j9ELm26rrBO7PLyZW_B)13t~N%iZgp_z<?$nuw!b;I41-wxF#
zy!$`Ia$u+=vK!L2s=Mg0A8q0}!Q|m`OHj+QewE!WrRMu1b?z#Ff<AB|KGA1=XtS}8
zxK{QF55dMcU!YZXEykTktHqf$o(oSfOXEQzJbQomgT>;uRB}a*mYFFY>wL0u3R9gf
ztqoD1($Q*9z*p9Z0jq^<gb%aS+i%ha@jr}oJ4dipl3k0I$T0^_?=E_?JY=2Mx2j-b
z@&%O~^=KK(Br_WgrgmB@TeZ-skZ667UPZVpdtBDp-V~QS9Umn(9*tKdDn2f-Tek!2
zwDqiI(z`LeMc`NqOTBsmC)eT=eSL2%K|qdMyr!L2Lvi34OPb0TG4(>57{x7d=;M4d
z(YLsXY52>?<K^{sKlYD5Q1F#iheSp3sz-g;?bd0gX^|CJ-xOAaGq>kaqtZ-2GJ4Ru
zz7ywdGSecam!dnJPghVLkHKDJA}O$7u&8L!hi=BvLeuP7h|0i_z}6|B;F#|+9G?#G
z@feLicl2*iqqpah@_P1Ep8S5VG|jnECG3vU&GSf52HrWquE-0(j&f(GBt=11Y>!Dd
z{*5zL5IRZ2_SpHbmQ}>ONk8G!qCrdH3s4-{K!m9^+8&;k*zNpXJ%L5IgG=^3nq$<}
zRkqU{C!eYoth_9dDwZb(S!UsQ?~`h_KaCZQE_s9ag92e<R9Eq0LnW?NOJ~OI#8eF%
zEu60j!e}~6&|-JrwX>3CtxZW49!>Zkc^Rv~i7k2}-EK68trm?4x!BB9Jcm`g$8-U7
zOSysgY9ZAGN<QI@M~kh2t~<|Ssh<aEM>uM+$(@CBu9Dj_N40}#E@w)Tml4r@14H1^
zGzKjvEDF+D)-{Kyu>Wfr{mWM3b*M5=&$4Ks*tiIbV@p3@S3Z?Kc;?`9d(KV#=2uTp
zTd(5IE6FCOZ_^i&pV6E(@a#f#XZ%gt5MJ|+mokQ~RWHY;>Koa#1i5in&v9V*ta9Ct
z(|<SW|LzFeZvKz^@c!#Q%u${_-kkh-A}5(#O^vQ&PgIz9$#C1sT7UzCs7iSUvIcEA
zWFxW?-y}AiSbWMBXE}g}E4uPrXrM^19DB<N1)JtTtW<&<KL_cX<DaaIMXS#66cK!@
z(eDd(I+DNh@n=jUg>LhG0^-jOlzeV|cG|&aho-<V$0_1tatad_hAB{m=#}0mu!@;+
znR~}e9MUc(U@+B9J@>Qtrn$zd+o7sKAqlzS+n<^m*4V>p7|qQxX6LF4a(td$JZsM@
zc(`Q*t-4h;ittFbK=(#s_=^AE;$1TE?3w$2&SJFvqV=$avl&sabk%%&;%@?90Fm4A
z7r>!YOX)LnHw)A;-bl;4G=hLKN~yI!g&nokG#)>~Q;+zyT0T=275tiK9ocM{D`<I;
zV=huXwy^z_OG{FYZh>koA!<`oDU-Hj@n$YoTDfIcywy42f-Uo|5h{T^MuKuH)?QYP
z%6i4yQ%FrgrV>}OU@^*fa0eM#{_}Y)RVGSa5su}w*g7fkRa59U;{=x(=^e3UhaqlX
zfF|^Y1o5br=W)~K`=UrB6D*pU`dl$v$}~RnKtnSFJsFWlGBWujTiHa!2U4cHlp)qi
z-jo?<X5-;ZreUuHl9hwR)FMdfnLyeUb^$m8+}_X+7SGxw6Hbgxm0A>Tl_t!=ykRqg
z(b))`OC6m>SW5EB;^a{z?;z|zkZydG)(6L33Q~|J!J^^6dj-Pqiy}N2Ngu2twTqay
zk5rD&?OKbd=DQ{bzufnyH7?TkL9}W583CXT!l&C<X~jYOo_^>YQPGWlZ^pWgdv;ri
zJQ}0$O+)_)GBP{ERvZlztIPi;!)kiU5o@;KLy0_E9fus9Mxncu(Z^+fDRc?)SbK>E
zs^Zw%t&^6?b}1zaf?)9u^e_1Y==8Skbj_pMGzYmQ(+A3I)4PLFj4hsx7d$RJ^wtPk
zWPAk1oHL||iJL{S_5eFAX{eg}?=v}`si6zbFQXRQ^;+NG=1A-utX-X#t^Ik<$-J<g
zP>~WTo~E-Z?oZ`3uuLwoENvcdJ{kW0`;Uc_`*gUI+xZsKhfIdYk>!y=jZFVc$ti`8
zQCT0AKIji@*H%~^kPtj+lzbx?B<q`LiWr$$b|z1Skf<3Mj6EbND#)w%R~B@MpryaI
z8rUC93O@wMH6UeXK$hi9$KTnWhmw6l*eT13(lBETqE18*d;`2fNT8=8LeY7aP?Z%Y
zEraC?owrDs?*aniVw+07?RNet?7_zS^+^8dxh~p{Zej$iiN1$YH{TrqDEu(=13Y=i
zCb5`AqYH&h$K|Xmb-vS|Hs0SVNKccJ8U<C-<Qc26;3H}^+R&Eic2%-Y@Rkikhh~&C
zb((RBu}|t%`4dvBLHow42G~ooc$LIh?rf@Bcctjp+;EFLR1+r`3-ope#!o1v+@%|$
zFCWjRv0Jk*4Lh`2oyp~z)9ATsy+gQeP_kXbVZV-wur67>q<JP^f4}P;to>lwTQcEE
zs<)T_S@&6DG5p8e%9F6_19@Khji}&(B|~Iv&ORfnqZc*t5DYZ5K%l2pL`VKH$_(cr
zjrZD<K}380zD=>Mqod|1$)#Sk-CiH>CW;vMC5s#7ElJsXRQIoSl@Tds&V~3cGL1xa
z63cmb{?-x77whp+^Kk|HH7#T!7(??aBW}J2U9976>{i}~C)XGXy_}ntU?%}5fhwr7
z<!S8#t(|~b(h3jb21zVC<UsR|IxzVC9UN>;Wzo4WS<8oS?@7HyHu<B!nNfyXYYr}d
zfIZ{!-R)*W&nMC<8)_OnBt#cV5JaXiljb#Q6!oI@ZvC3si+TE$Y;c18!zwQdY43o*
zNyGqQ`{g>N*a=Z~yBu6PLdKUZ4!JH?z%H-KiDcOq!2Sa3>g~ryAb*Rpte+68*u7O@
z)o<0=+BWiwp%><t3*`zg`QEbb%`F_15j)8e+P96V0fp4;RoD$e(%lRJ9(PW1&#xN8
z{t_HKx4QNRJuRb~_tflAM+ddIp|!?f=P)?qqlem}Rd#@QY2Rv3E9#!tDbM~AmS*&}
zZ8x$viw@N)xD&+LGSIjE<rfi6UXPg1`@D~MVoR|%nW*btn!lc;`3TS{9cf3O=ayUb
z@O$2cay4u{-9EI6XAmqIZ97D?AUM_$9JX|?O?+?>e~9079qp3Dz4}&Ut**X&xfX*J
z+hhwsbm~6Qeo4OY%CI<<qUi`)d;un>L+lUL>c9>z8rFBz0dX=rocv-5*D}M{G5qdB
zd01}?U3piXPQtIv<DK#X!U3C|WDKWbHAg2gw$&3H@=v#z0lzs9nU)FISR(S;p`85r
z0;_uA8Z%Qz?08RjwCbz|nmRYwSk?bTyYuFqq3A(jZ}PtYjaXQUQ+COPM&bs?OB*)I
zzxi1f%=XQB8R%5Uy$c+@V`CM1^MCD$2*~zX!+hx&V%Jx#F=_J3Rjfc@BKXKO8&0*K
z5+K^AdlZjR#=z;06EIyG5#8vB#kzual$2kPU-VU0hGr1MaqLtAy^nG4OO&f)nC7<@
zgGaIP@iV;7e=5sTgHw2iQyU)6=nA0ZW!_Z^hm+mL*;S}0sqBYJihlQ+&{CrFDGKHl
z+2;|V!)sux>_5FbQ-K_tnNrx@oS5RK3-Cd^EenU&bc_hkE3k1KEK0qpIF(F}Dg_VE
zG*{+i@613}g*{^238Tlux=;T^f`LzFFR8j&^C@PyFh5NE&PV;+K*l{TSJI5e(b{#(
z53!nqt}>66KR#7NiLS5r%VBdg)}7rtxtbh#*fP1`p2u+iT7gulwbObEpW)|pb1%+^
z-Y!!G6-=|K?BHbk9^Tt4m3N^+(?(Bb{wUJ*<4zfMe-PA%8frfD9#=9~%Y4sNx~Jh}
zndF(0Ipx9=ct}2DE#sXSrEZE9KkxGya_H&(bxHj*o9Zfd=-`pl2s^%+e;j>*jR>x{
z=>6bc*x-F(QYs#XWIBdQX`f-R()85(ZS%+5vMaT09%Snt=M*=6NAWPrR70(ETlb{6
z!JqF39hD~c1wfsMEXaAhY-UBjVq4~0YFEFOQ@UmAz<I#k(QbvA6_Vw!8flSwWapW_
z0B-ojMc^a9k*-qw_sWX`eEa~>y+4=f@(LdXJm~AAde=7+GPuP_^S(OQlc`R2HL>yU
zd#;ReRj5f}8L>`HdZhKqm9!3rzY~(nHrG!1K^Rig`cd_vdQHg;_w`L%xuOWZ`p#fD
zn%Ep3cS2%5rdQQXc&EVc*3=LQDm;z@`IgA9)eu)ik{E{=F}$AwB=3`dPFR{WDkx?s
zR-iaOZMjBHF%B;tEK=Rc8FeFv=Z=q?n~_bIN!0c2cG~E19hL16jpGja-qzDz8d1iE
zD5#*?)scBuvdlydf8+ZYww%|rb*v3~z8%-j`&F$0UpmdEgYx0ijYX&}f$VYF&O^PU
z|F!S(AlTyz&4!sz?YqW2a_y~h9>`fsO}$!r5TQL|zTqEQA6`!FSTA~;pV;5}V|9Ze
zoUruMEY%WU5Nk5t((ug#_cw>Lx6VsT$Om}5VV2QFJU7uIa~oyTY>uTKxIwI1$fQjf
z&YtcUxjwy9PnHa+6a5dKtNar_>g=qPnK6}m63Q?&Cxyvk0!Y?!Wy7PZI4VdCeDT7`
z%1cL&u;p>i1-!uzEu?!Vwr71_VQhqNFF3S81Qfn2f?YLl=Mo{)>v217&lHKWGP027
zrB9{ae(j4$`jwjzedW;e<+eV2RdjvKkqup0NFh1~N42FoJY26E-jB@n(N+1)^Ag&?
zc*fb@I)&JhS724KH-9k;HhHG*QtYb2*;}!PB{#8ox`@V<xx)gUIW}}6Ti#F5p*G}q
zxA5hBhhC3Jg`2cMXM^5zLi>-O0+k9cz&ws5H|HH@^}!`|N8WJf&ALgP!)k9te`51q
zrwo~6$qGJS^zxtf6;H7Jd(U^wn|EFN7Ru>CaP=tjY3+pH=W7bj$_v2zV9@K8t+(G(
za$iA6K7rKH<^+C8xX(A<fAS{Di*SkSjIk^3yvKEhW1n-nRT-VfieK+2#O~rzWV~f#
zwds0a4fsu%w)u8G)NiNjnDE*f|HILQJ#oKH;|4<*uY_12Uy~HcpH$t(I_k)}DWY+X
zs8uvaz0IK(gcktv-pj0pwfVsZ11tdIBO-amCjs%y!|UT5xxL#^@p*IolbTl939Cx1
z^VAI*d|s1Ioyp7SqXAx&V_EQh2n{L#34kCWA)&z6SKylyZ~~#BlDuPL6w(!xv-_gw
z7yWbGH>!R8-&+pU`*><e`AhI$T<&YulJWQRuS)KRnS%cyUIB?u`ZHP&dVi5>HkaqV
zeE}>2K%#Ht3HQFI>0MuY^$_S{k`7!P-n<vf;q!oW>1!uppkm=>Fy#MTI9{KbX@7S^
z=iI$}V!y(J(jC99+#16qFMoFY#^>;`6A$m%rr!5Y=8dyEgrLdf^j}@N$|mGXl^0tQ
zVZ>kAJ4uN7Je{fCL-9)-^}{|>HAMYLU$E$-<L-uf<U=hyW2L)`*Wj52tr^js-@DdX
z8v&il3GAdJC#4WPY4OzW&ajC-bL;6VtZVr9tnMK~&Mt|QuKcS4skm>TboLge$l);V
z!>oW(mdbbc;;Rv%KZ*tX&+7PnM^X58oPXX!9wpC&%wKFc+|u;e1Z{by$Ub|dFG3}$
z5t}sb>x37V<aq1|gAetN0&BDR;bO2dvKJ=k>EW@n!UsG$`+_dNdd3kporRfg#xMD%
zLv}CmvbxH4y|gBMy#A7V?wat9mcx#sXD0#Sr(5{>qajA{T&%5JmrAr&rFXg+tke7O
zbh3H6Rzpd9tq~RDt932TO4poqv{`pGmy(LkPGP3uAzy)HQ{J0{I6l>Gh`ryO9iac?
z8N%Ab=@ZNgFl&ol5}7$AfylSxvR<Sdt?;|A&7nKee-Fgt3;!f&_o1NMc3bl~wg~Ru
zCNqeA)}MAI9xZVjNwsqQpRyjrV7fn@Vl;p|x9VyBj_N_n`b24ER~iO2@Ex42n4OAK
zn23wxhHbP>SriW0cfC5?NbTQQ^A7@7$Fhy<Q3DoLeckw_VK^#2R;F0|*J>q{q^(x2
zM=Uh$w=Y0?<sXi{;;sAw-84O!mA$hIamTl#6TPDL80*1H#(duYFp?S8jxv3Z2y#hY
z;z+1+>U``WkokV3FupqUkXd)_hLasXi4^~g??!f*Q`DTW*`B(`s;`M<4R`gZrHp8D
z^yCq1pfUjud)<1378z?dgyjRIFL`^_&F8&WkAPimxISCnte>f)1x>siJ=Xjgz!mwY
zdV)PEIv<}6VBe4EUi{`qW+L-8(e+A9p7j$E^z9AX&h6v-IUh}?o0^#8lrd)F)Ww_O
zqo>_PuN3{DUu(`!qjeD{X2*!V4MiD2Oe0Mm3BqgPZMbEkYWBYr@XUWoJ7jT4sx~-~
z&TG$93)7P&Zg%kC?{!jU;`-Y~dDk=uItIM}doO@t!zb(nu8?ONo84ohXXiO}Fzo6k
z3*3a)Lni+xZh<z=YI`uJ-}@`6_cGu~wGo#)Of8k7IdNrX=e<osLoKPOD4&&8W*?U;
z@_waIK9Mz-!Aw$fBCf?sYCqnZ9GX)xNAHNW`JD<m!I@3!HB>SC;^_4eTW{;wM!mL3
zF`x4&%oBYvo4li#CDh7v)K+9QdamR0yWCOaiQWS4T9AJ@(_z_iY`efIwrwvCgP+HU
zT`AWvn))T$`$N&+I)1C)#F@$?%|sy|kxS!R?i_K5gCE>YQu9t>cT9{Lao%3EBu#82
z;$!K@)i?aA&+W#CFW%*b@NJb2GDn}ehw5&~WdILrQ$H@Zn_5yX6(1i9Gxx(dcRXhG
zd~O^5guLvRpd$23v$?iZZ+O0m`Sy=&x%WS(xf}>HZ7x%vl+27&5QIm*d)R-RyWFPH
zFa-Tvf6~1^El;<|e&`(cU^Baba@=55TO()*3+74lkjPFWvu3qRhxQQCfl*#%s=`@!
zYmJe~KVx4(eF3aq0IWAQV^(ckJ@yXJc60qV9ljpWH~G&}XXzqR8m%zwn>+!3?1zJ~
z%F*t5bROJVkRERe$ji%O^`G@P*dGlSuH+&|M?mWwE!x4V^iv+OXCT9+)l+U{fj4C0
zSo_fP@;(ptp5g^m$w$pHo|t7>+l6~NJ?@G~Nl;3{K6IHku3~SVakEOCbo6j~kM|H}
zZkyk{UFY2P77MGEvy$#|I(RsFj9d-Z^VnvqG`Bf@y1I<GEakXHL|B>Ep2L4abE!f(
z&c2>fI!UC<zew2rRmWl!-oN|;>;x5@eu-6bV3+Ydz_^VnOT&R(x=KZLG3y~J&Tr+S
zFV%|uvUN+`e|j^2So~a_9hs4BC*b#(3B@5tk=oYJs*M@Pn4nu7Tis#S`o(8<E$@Ie
z>>MUMILI2ss-=8|`m~Sq{>K>MU-q3^C119T_%uI;ZP5n$O1lNwV71-FWw{j+AH189
zgF_4<K;Ucre`8)C(IB8e04fGFCW+t|MszIQzxFXO8Um02zZd#24$l7mQZ8E6uB2Mk
zf*=3oTetUb?Wt-ZsCk$F8GT_me2_7L-N*;K@owQHn@j`#DQd0uFrzucgEG)c@@GhD
zG=pWv&m;4ueUk#4DJQP)Fo5+%N_&@sDkq8pQS|;!L(z9s5C{#uzG$PN-4v#jfCwv?
zM60ZHWz8V`^Sc5-4Qf-pps0hj^Y-7?|1H$L0I<nx^&?AZPrY`7VSl!gGCQbQGPgvM
zx5U<QJKCkI(I4^gh}h_!<)*4X1iE(EC+<E;>PEJUMC4hEr=qWNMc?Ur8sl|&Ba(;H
zStA|0S;L!i-Li~0`T(w~r!eiK?F^2l$2gLnk3kW3<zzoh))L)9f<gNnpQZ#RDV|fU
z_1Arw!Xek+4i+dL@gPs;DWCQPoQCecv$eZ}lpT{GZzXjHU9;RtjS=U9b;64V_Afxt
zP_R(2|HS%1fC1=GXc(l-U`OL4Ba`44IeB|begAVZmaLA6jZ<<8Aq8FAfSAgEbOk8@
zIR2T;|D4Y4_@KsY*dI$Noy=^wsKxys=s!sCLv}(y%H^7flfh)js1I(*@B1*Tz9>ki
zY;6grduSyZbK9fWBq?C@98}o$CMCre#iC7)1;Bnce%*O?tS4%(rSwj{=PUW|lvX_Z
z6jgPB0!TjhJ$aZ$Ch)DmmI7yLbKE{2v&m@YSWXejd_*gSPc-VsNlZ#|F%cL?udYpp
zeiP0%@b!;iQu4QqpEJSKjK0Wbp1u(Zww#~QvzlH2DszLnLG7QVk$y6mVbE}J(POaM
z<+70hp#i7|j5BG52^>*7Uj>JduC|~=sotqaaJjt$xX}iUs~RtGXAckr@X!F%iFeT~
zUq;Q^2=3WZIMUYLkad6TvCKxxSaQMVaq5TdA)tk-c8{X=W{#%I8mGK<ix7&s2%&7H
z>W${-M`l3!RNSfVlC<8<<^R2HR9o`x;iNlOxgOGc-vB<C@S|9LHY%YRd>^;6pDzG&
z!Z?yGbXu>d!*~=nrd_X>Vi1Dqu7@;k;SBM0ifD8g;|L=Q<E3}QI8IuSIp_9PAS7wj
z;aFdfzEct*F6~eCk7V&jFe0jiAXUJvbFD8z{4g7B!oj33J<pWsGfp;8e3iT<d@h9{
z=>P+tgnQ73;FcV|!vwc;Gt!I|l3kH35eZr!C~+XLVd@~mJ*OrzuKu{L!$}mNfaQ7w
z_YE2oqDIJ7EP%x0&rVQwbVtRgs%eSFrX^F<dqSA}?(e#`QC$FXD|eEWENcW5IqXk$
z-KdqJH6f~Z=bqoq)Q3)l2z<2qa*}@9X77#iJCO~|eAT4gg&Z^YSl%%eb^|c_k)k8A
zpyWQHW&A7=$8N}Te;@OkrGTolGn?Lh)G%W)GA2^nr{Jdqt0mKZX=`~Ys?B?^;e?r}
z6|z9zND9xdb6W`x5L`efRcnd*k0!GAD84J!u`YTcoP(`52o;Q8<e1bSmAOpw7#WeS
z4g}K0FW9o)BHXoI;#KoVgpGv@>H<WbkNe^Vd9r*yvxm#p0k)VPLatUY(l0=7{hpyn
zWxPG<3VqIAkWy!Ted(L3&fJmZ?)Ax2O&jlx1H+C-_RNTZ-*x!*xo(u$jrFA}u|+Az
zDc2^)w8{4jB}0oJU=ClG)W3`8aIlJDd)On7FrFrUvDt(0zo7DE=UmxWq0B-;^ZkB>
zi!+>%O_j>)Gr=ewG37DPeRItt+8S8wW)I?smd<}x%l7AeSoZ4f^e&xwWuBS6_7o7}
zW^||nwgwbnYXAkd(f>RA8|^hB5gh7A@&yJHi%}3A+xD+z5AkZEUoG?czZUwn5DN}6
zD*fdi1|njAVt*h}ngQPRWTGwPd9fGzTv#etOh(kf#CX}r=z@bm!SAe-_d{hAG)$Dv
zYHW#}lZ)!n6@(9kr)HK_CXLcOa_*%vr3{TJ`}_>JLpF71RHRD$)O5h{vn_!!-YExh
zYO@Pc-XdWd9C;$usm4Xz4>T5d4-yBZ-V4%=c!<1r+|;AAWDWfLBH>D@42znx3li?v
zE*XD!_nu?y?~NsP%9fMxOV7H^CvjonnMdt|x9~E$!XiCuww%Oyn2Ibh>rCoXpEC!e
zbCf&$GP`bl0%HTyr~-zK6RUSxYV_^B%THaY;I}f{)!vCqdN*&#fnOK;N&eu8UNa{v
zS6=0oLiNf%RZO;U8ihy~u}1V9wMlw&!Iv+8&x<6SP5WE+kJf|__WM(|{=Uy?D>80L
z&+Rj$-0^mNOEt27#ha>KC*F_y;DCrDzW6X@N^_6N>89FQzv3emHs<Eh#+t;LMQ@lY
zuVkMsO^=$EM<i&k>%vne=kTW){6_(>Iwf9>J0w_xFyNmGym>u6g3IUth!mO`4dWv!
zCW-tzGA4a{e=KrF!7nfrET0r&vREA)13EfSDTRdPlyvoM17ou*H~vvM*wViMDGW~d
znjLGQjyJ`%{dWNO`fMekqc3UU*ZtwQta5DOsDUFO79b#YbgM|IaH=TR4+=7=FctE_
zWD7Xpmf=y=+_#EWZB+=lo)La_Re5J5*SsZOY&yhFfQ)gsKW#2^FRREV!+#jo0l@MS
zWH>yVWREI?IgKoHSn=!du5*6IAr>W)ta@u+v*XafID(qihGIB6sw@#eHES1I6Akx~
zAj2-hA;UKC8k$2Vl1y2|^kgdw7XC1eU=mG^{HTQeokBXx6@MN8gK<BqmIi6Wv2_!f
z8+{Bun{9<qd2-w&**tSg^!&&s*Maa&)pb}A1lleDMqm1IZW)bVZ=Bc%i!(0u;65R(
zRV0}N_k9k>!jzB_o@9YU@uXIfc~}@hGhO^?^!p<4#ut!<Pu?BF3>6k~B(8NQFDKOv
zqr`yZTB}$O35m2SoHnmfF9DCOWnj-+rV^70+OM1*g|y9r;F+z}JBi2Cg8Z@HP{ScX
z7~qpQmtIff9uLui9iR0v)_of2(VegC0Y|?QP&#lr;$~a~l3*g#8gC2>1=OTv%^S*b
zWnaaIqw+F#dZVtUQ!XnX$xWcykNNTp)`W4*pD-qmzS%|DH^WxX%SrJN!S0Dv^Jg$N
zCT<Dihm$WXE)3PY%Q4})+i~?w<?E9VG5W^$o(-b|rlP%)XO}AtX%tDIJ&W63)^Zv<
zLbweZrUxd%0Zz}atqlpe`UxJpA0Jb@QIoQwqzVpn0vT)q4)YBAgH={SLv4@$3-FA3
z61UeJf_wp3X+KY^w#e{tVfT#VX6dD@{#0!nwnQ2+-GOD~8uKD_xi&^wDmH$TN~a6w
z3+gao2@y&@;rxUk?Rcr<@<n$`8Z>AqJGIOBCdm=BK4#1PxZis(?z2~8Dtf2ydS$4I
zNeL?F6aVytbI*4#$Vy2%H!QkQ$s5bJgX)mcc5_dA=kvsIvz)n=2tKQt&hA3{Wchf8
zvrH0mO%a&OeAn86%W@FVG&Y98U}1R^1*|r86#rRFWUm%63TxvViCjZEkafxrj{mh9
zL%oJ*iG(zak@Oh`gKr%&7ytdjUNK^=edT-qWnBv*j9?hpF<rL~9C@p0>uJJwZ|UJ6
zn;KO+(=#sM(@s}xpYu}4iuUQhp{k)-&KnBpLjN3L=@cMGqS`8<9-K;sNt=`N@ADso
zpvCJ!Wn@YEYz)+?ouK$fS#GMREeK{iV}Rr4k+^5xJb7lwKJ7#5=jAR%yKg&1HnMX<
z>LS|(clx?L3&KHD7!PGECo$WtERt@Q3yw3Y^}&h~KjMy5&%l@lKuMU;BT<5X1koxD
z=%PNcUa+*Sfzq|hREnneuiTq;4x?mpFP}s(wDN_5jX_*(9eU*#kO<?dB-`xpJY@DT
zuw0$`ZMelAkm+NXQ>q!MzaW;9hp|#^kaov(U5Rw{_;z40+iB}sQmm(xuo`-*syg9t
z0I0`@1JNmK#Kx21G&lf<oyD(nH>AzBh;a(jehMj-I)uU?Ifc`P_X0B6@8Rl>{f|_G
zT2-`a6(hiy{BWufd$G<vNjJU;J!v1{lvZ5Hx9CGYgall)bpV78C45>0IBd|d<TG%f
zz*Fc1u9QVehvb>~Uv<Jxic5LxKnPczcK`DurLJB}^|i}%pk<|L0~{+HZW<TEr&)s2
zp{EyMEpJF}O2N(n-98M>SC(HYYLu5nJtY)l(h1Or<;tqET2H%2LV+AY;<qi~NJz1K
za~{OP7CyfYrwd?Q>~hOg?UZ6=Qe)-W!l#jV5%ZB>e6iiePbSZ&#DF7$^R>L~NTtta
z(oY|4BGDV^0QqvwIgDPmkIS$gU#(ahjBItlB_Hm}maQI|UBZqp$$}kJX4_|#kyQbz
z2AMe?ITH>h2uss7j1kj}{*ahr3%Vaiaz<hNkZJ}fYau3EcXh&AIY%7uf!M4j(2=~S
zEPEk>^5g-=DfXf%^a&!mY;{knJ6}H<dt9)vJPnN3;QJpxT$n%rFmJ-vZ12`j38+J<
z%9I$+>1P0#Nk}zQ&?xUS%j&GCe?MKur8E-%r*szkabdNKAQf6tYvV9R0J&ke9C8i8
zoK99|3S=$4^L@B3*kO;67loJiDi2h9EPD4@BTCJ{-lY5uhA$c4E$(67$#PzmMKVwe
z<p5{G7HK&8bk%D0@L}G2QX$aNND3tnRt5jGIeXsz`f~z5QSl#}EBUw@I{rmMR1Zt9
zG&6%be9*+V2f;^<qgMarx}s~HV-7W0`&h}DOIY1PW~9$w>m8`cn}RkZWG|q-M~b<q
z&C!1F*mg9i>>!UetsYtpHoJT95u11qY9XGTyPj;eF4J*rCoa+JZZEt5_Wu~?5on8r
z%dCQhT}_MYxX7v?*!{g&2I#d0?U|Y!5#=W%GVR5D6~xu>UooGz*!Qv&OT~QJ>f`Ix
ze|-0WmXXrF?(!t+Je82pY47Aw?ASb3YF8lkIi)VfzBwRTymoJet!uZ|F;sa({C<5{
zPJMK$I>6qHSMvhkZL3gA#@An;b<7@)%swK{I`@t_#%mt6(KfB@Q}5>V%v3sq4y8-l
zr6e0GTfSsVje7>iuJ>G7+(S$|G@p1}+pgcfEj@$4p>`L(?}*KTT+kEzon*9e?G4@T
o;o48Ssr{V-rS}gaxN7?lf>mPER!^7NtNNH}bCvou_%i>$0B@lTjsO4v

literal 0
HcmV?d00001

diff --git a/gee-cache/doc/geecache-day3/http_logo.jpg b/gee-cache/doc/geecache-day3/http_logo.jpg
new file mode 100755
index 0000000000000000000000000000000000000000..f681ee696a70a1edaff74de8cdc048239ef6f558
GIT binary patch
literal 6050
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

literal 0
HcmV?d00001

diff --git a/gee-cache/doc/geecache.md b/gee-cache/doc/geecache.md
index fc79090..1b38ab4 100644
--- a/gee-cache/doc/geecache.md
+++ b/gee-cache/doc/geecache.md
@@ -59,8 +59,8 @@ github: https://github.com/geektutu/7days-golang
 ## 3 目录
 
 - [第一天：LRU 缓存淘汰策略](https://geektutu.com/post/geecache-day1.html) | [Code - Github](https://github.com/geektutu/7days-golang/blob/master/gee-cache/day1-lru)
-- 第二天：单机并发缓存 | [Code - Github](https://github.com/geektutu/7days-golang/blob/master/gee-cache/day2-single-node)
-- 第三天：HTTP 服务端 | [Code - Github](https://github.com/geektutu/7days-golang/blob/master/gee-cache/day3-http-server)
+- [第二天：单机并发缓存](https://geektutu.com/post/geecache-day2.html) | [Code - Github](https://github.com/geektutu/7days-golang/blob/master/gee-cache/day2-single-node)
+- [第三天：HTTP 服务端](https://geektutu.com/post/geecache-day3.html) | [Code - Github](https://github.com/geektutu/7days-golang/blob/master/gee-cache/day3-http-server)
 - 第四天：一致性哈希(Hash) | [Code - Github](https://github.com/geektutu/7days-golang/blob/master/gee-cache/day4-consistent-hash)
 - 第五天：分布式节点 | [Code - Github](https://github.com/geektutu/7days-golang/blob/master/gee-cache/day5-multi-nodes)
 - 第六天：防止缓存击穿 | [Code - Github](https://github.com/geektutu/7days-golang/blob/master/gee-cache/day6-single-flight)

From 3a925438fa3e92633ac8837b225667fbc36d8241 Mon Sep 17 00:00:00 2001
From: gzdaijie <gzdaijie@gmail.com>
Date: Thu, 13 Feb 2020 17:50:10 +0800
Subject: [PATCH 031/122] fix refer link format

---
 README.md                 |  6 +++---
 gee-cache/doc/geecache.md |  6 +++---
 gee-web/doc/gee.md        | 15 ++++++++-------
 3 files changed, 14 insertions(+), 13 deletions(-)

diff --git a/README.md b/README.md
index 89fe062..bca1c37 100644
--- a/README.md
+++ b/README.md
@@ -26,9 +26,9 @@
 
 [GeeCache](https://geektutu.com/post/geecache.html) 是一个模仿 [groupcache](https://github.com/golang/groupcache) 实现的分布式缓存系统
 
-- [第一天：LRU 缓存淘汰策略](https://geektutu.com/post/geecache-day1.html) | [Code](gee-cache/day1-lru)
-- [第二天：单机并发缓存](https://geektutu.com/post/geecache-day2.html) | [Code](gee-cache/day2-single-node)
-- [第三天：HTTP 服务端](https://geektutu.com/post/geecache-day3.html) | [Code](gee-cache/day3-http-server)
+- 第一天：[LRU 缓存淘汰策略](https://geektutu.com/post/geecache-day1.html) | [Code](gee-cache/day1-lru)
+- 第二天：[单机并发缓存](https://geektutu.com/post/geecache-day2.html) | [Code](gee-cache/day2-single-node)
+- 第三天：[HTTP 服务端](https://geektutu.com/post/geecache-day3.html) | [Code](gee-cache/day3-http-server)
 - 第四天：一致性哈希(Hash) | [Code](gee-cache/day4-consistent-hash)
 - 第五天：分布式节点 | [Code](gee-cache/day5-multi-nodes)
 - 第六天：防止缓存击穿 | [Code](gee-cache/day6-single-flight)
diff --git a/gee-cache/doc/geecache.md b/gee-cache/doc/geecache.md
index 1b38ab4..0429e78 100644
--- a/gee-cache/doc/geecache.md
+++ b/gee-cache/doc/geecache.md
@@ -58,9 +58,9 @@ github: https://github.com/geektutu/7days-golang
 
 ## 3 目录
 
-- [第一天：LRU 缓存淘汰策略](https://geektutu.com/post/geecache-day1.html) | [Code - Github](https://github.com/geektutu/7days-golang/blob/master/gee-cache/day1-lru)
-- [第二天：单机并发缓存](https://geektutu.com/post/geecache-day2.html) | [Code - Github](https://github.com/geektutu/7days-golang/blob/master/gee-cache/day2-single-node)
-- [第三天：HTTP 服务端](https://geektutu.com/post/geecache-day3.html) | [Code - Github](https://github.com/geektutu/7days-golang/blob/master/gee-cache/day3-http-server)
+- 第一天：[LRU 缓存淘汰策略](https://geektutu.com/post/geecache-day1.html) | [Code - Github](https://github.com/geektutu/7days-golang/blob/master/gee-cache/day1-lru)
+- 第二天：[单机并发缓存](https://geektutu.com/post/geecache-day2.html) | [Code - Github](https://github.com/geektutu/7days-golang/blob/master/gee-cache/day2-single-node)
+- 第三天：[HTTP 服务端](https://geektutu.com/post/geecache-day3.html) | [Code - Github](https://github.com/geektutu/7days-golang/blob/master/gee-cache/day3-http-server)
 - 第四天：一致性哈希(Hash) | [Code - Github](https://github.com/geektutu/7days-golang/blob/master/gee-cache/day4-consistent-hash)
 - 第五天：分布式节点 | [Code - Github](https://github.com/geektutu/7days-golang/blob/master/gee-cache/day5-multi-nodes)
 - 第六天：防止缓存击穿 | [Code - Github](https://github.com/geektutu/7days-golang/blob/master/gee-cache/day6-single-flight)
diff --git a/gee-web/doc/gee.md b/gee-web/doc/gee.md
index c2581cc..87e3a34 100644
--- a/gee-web/doc/gee.md
+++ b/gee-web/doc/gee.md
@@ -63,15 +63,16 @@ func handler(w http.ResponseWriter, r *http.Request) {
 
 ## 目录
 
-- [第一天：前置知识(http.Handler接口)](https://geektutu.com/post/gee-day1.html)，[Code - Github](https://github.com/geektutu/7days-golang/tree/master/gee-web/day1-http-base)
-- [第二天：上下文设计(Context)](https://geektutu.com/post/gee-day2.html)，[Code - Github](https://github.com/geektutu/7days-golang/tree/master/gee-web/day2-context)
-- [第三天：Tire树路由(Router)](https://geektutu.com/post/gee-day3.html)，[Code - Github](https://github.com/geektutu/7days-golang/tree/master/gee-web/day3-router)
-- [第四天：分组控制(Group)](https://geektutu.com/post/gee-day4.html)，[Code - Github](https://github.com/geektutu/7days-golang/tree/master/gee-web/day4-group)
-- [第五天：中间件(Middleware)](https://geektutu.com/post/gee-day5.html)，[Code - Github](https://github.com/geektutu/7days-golang/tree/master/gee-web/day5-middleware)
-- [第六天：HTML模板(Template)](https://geektutu.com/post/gee-day6.html)，[Code - Github](https://github.com/geektutu/7days-golang/tree/master/gee-web/day6-template)
-- [第七天：错误恢复(Panic Recover)](https://geektutu.com/post/gee-day7.html)，[Code - Github](https://github.com/geektutu/7days-golang/tree/master/gee-web/day7-panic-recover)
+- 第一天：[前置知识(http.Handler接口)](https://geektutu.com/post/gee-day1.html)，[Code - Github](https://github.com/geektutu/7days-golang/tree/master/gee-web/day1-http-base)
+- 第二天：[上下文设计(Context)](https://geektutu.com/post/gee-day2.html)，[Code - Github](https://github.com/geektutu/7days-golang/tree/master/gee-web/day2-context)
+- 第三天：[Tire树路由(Router)](https://geektutu.com/post/gee-day3.html)，[Code - Github](https://github.com/geektutu/7days-golang/tree/master/gee-web/day3-router)
+- 第四天：[分组控制(Group)](https://geektutu.com/post/gee-day4.html)，[Code - Github](https://github.com/geektutu/7days-golang/tree/master/gee-web/day4-group)
+- 第五天：[中间件(Middleware)](https://geektutu.com/post/gee-day5.html)，[Code - Github](https://github.com/geektutu/7days-golang/tree/master/gee-web/day5-middleware)
+- 第六天：[HTML模板(Template)](https://geektutu.com/post/gee-day6.html)，[Code - Github](https://github.com/geektutu/7days-golang/tree/master/gee-web/day6-template)
+- 第七天：[错误恢复(Panic Recover)](https://geektutu.com/post/gee-day7.html)，[Code - Github](https://github.com/geektutu/7days-golang/tree/master/gee-web/day7-panic-recover)
 
 ## 推荐阅读
 
 - [Go 语言简明教程](https://geektutu.com/post/quick-golang.html)
+- [Go Test 单元测试简明教程](https://geektutu.com/post/quick-golang.html)
 - [Go Gin 简明教程](https://geektutu.com/post/quick-go-gin.html)
\ No newline at end of file

From d7a003fd3dba3f37f20d1d1eecb692849fd54954 Mon Sep 17 00:00:00 2001
From: gzdaijie <gzdaijie@163.com>
Date: Sat, 15 Feb 2020 14:02:38 +0800
Subject: [PATCH 032/122] fix lru dumplicate key, nbytes update issue

---
 gee-cache/day1-lru/geecache/lru/lru.go                 |  1 +
 gee-cache/day1-lru/geecache/lru/lru_test.go            | 10 ++++++++++
 gee-cache/day2-single-node/geecache/lru/lru.go         |  1 +
 gee-cache/day2-single-node/geecache/lru/lru_test.go    | 10 ++++++++++
 gee-cache/day3-http-server/geecache/lru/lru.go         |  1 +
 gee-cache/day3-http-server/geecache/lru/lru_test.go    | 10 ++++++++++
 gee-cache/day4-consistent-hash/geecache/lru/lru.go     |  1 +
 .../day4-consistent-hash/geecache/lru/lru_test.go      | 10 ++++++++++
 gee-cache/day5-multi-nodes/geecache/lru/lru.go         |  1 +
 gee-cache/day5-multi-nodes/geecache/lru/lru_test.go    | 10 ++++++++++
 gee-cache/day6-single-flight/geecache/lru/lru.go       |  1 +
 gee-cache/day6-single-flight/geecache/lru/lru_test.go  | 10 ++++++++++
 gee-cache/day7-proto-buf/geecache/lru/lru.go           |  1 +
 gee-cache/day7-proto-buf/geecache/lru/lru_test.go      | 10 ++++++++++
 gee-cache/doc/geecache-day1.md                         |  1 +
 15 files changed, 78 insertions(+)

diff --git a/gee-cache/day1-lru/geecache/lru/lru.go b/gee-cache/day1-lru/geecache/lru/lru.go
index 81eee43..6fa617a 100644
--- a/gee-cache/day1-lru/geecache/lru/lru.go
+++ b/gee-cache/day1-lru/geecache/lru/lru.go
@@ -37,6 +37,7 @@ func (c *Cache) Add(key string, value Value) {
 	if ele, ok := c.cache[key]; ok {
 		c.ll.MoveToFront(ele)
 		kv := ele.Value.(*entry)
+		c.nbytes += int64(value.Len()) - int64(kv.value.Len())
 		kv.value = value
 		return
 	}
diff --git a/gee-cache/day1-lru/geecache/lru/lru_test.go b/gee-cache/day1-lru/geecache/lru/lru_test.go
index 7308322..f2d3470 100644
--- a/gee-cache/day1-lru/geecache/lru/lru_test.go
+++ b/gee-cache/day1-lru/geecache/lru/lru_test.go
@@ -53,3 +53,13 @@ func TestOnEvicted(t *testing.T) {
 		t.Fatalf("Call OnEvicted failed, expect keys equals to %s", expect)
 	}
 }
+
+func TestAdd(t *testing.T) {
+	lru := New(int64(0), nil)
+	lru.Add("key", String("1"))
+	lru.Add("key", String("111"))
+
+	if lru.nbytes != int64(len("key")+len("111")) {
+		t.Fatal("expected 6 but got", lru.nbytes)
+	}
+}
diff --git a/gee-cache/day2-single-node/geecache/lru/lru.go b/gee-cache/day2-single-node/geecache/lru/lru.go
index 81eee43..6fa617a 100644
--- a/gee-cache/day2-single-node/geecache/lru/lru.go
+++ b/gee-cache/day2-single-node/geecache/lru/lru.go
@@ -37,6 +37,7 @@ func (c *Cache) Add(key string, value Value) {
 	if ele, ok := c.cache[key]; ok {
 		c.ll.MoveToFront(ele)
 		kv := ele.Value.(*entry)
+		c.nbytes += int64(value.Len()) - int64(kv.value.Len())
 		kv.value = value
 		return
 	}
diff --git a/gee-cache/day2-single-node/geecache/lru/lru_test.go b/gee-cache/day2-single-node/geecache/lru/lru_test.go
index 7308322..f2d3470 100644
--- a/gee-cache/day2-single-node/geecache/lru/lru_test.go
+++ b/gee-cache/day2-single-node/geecache/lru/lru_test.go
@@ -53,3 +53,13 @@ func TestOnEvicted(t *testing.T) {
 		t.Fatalf("Call OnEvicted failed, expect keys equals to %s", expect)
 	}
 }
+
+func TestAdd(t *testing.T) {
+	lru := New(int64(0), nil)
+	lru.Add("key", String("1"))
+	lru.Add("key", String("111"))
+
+	if lru.nbytes != int64(len("key")+len("111")) {
+		t.Fatal("expected 6 but got", lru.nbytes)
+	}
+}
diff --git a/gee-cache/day3-http-server/geecache/lru/lru.go b/gee-cache/day3-http-server/geecache/lru/lru.go
index 81eee43..6fa617a 100644
--- a/gee-cache/day3-http-server/geecache/lru/lru.go
+++ b/gee-cache/day3-http-server/geecache/lru/lru.go
@@ -37,6 +37,7 @@ func (c *Cache) Add(key string, value Value) {
 	if ele, ok := c.cache[key]; ok {
 		c.ll.MoveToFront(ele)
 		kv := ele.Value.(*entry)
+		c.nbytes += int64(value.Len()) - int64(kv.value.Len())
 		kv.value = value
 		return
 	}
diff --git a/gee-cache/day3-http-server/geecache/lru/lru_test.go b/gee-cache/day3-http-server/geecache/lru/lru_test.go
index 7308322..f2d3470 100644
--- a/gee-cache/day3-http-server/geecache/lru/lru_test.go
+++ b/gee-cache/day3-http-server/geecache/lru/lru_test.go
@@ -53,3 +53,13 @@ func TestOnEvicted(t *testing.T) {
 		t.Fatalf("Call OnEvicted failed, expect keys equals to %s", expect)
 	}
 }
+
+func TestAdd(t *testing.T) {
+	lru := New(int64(0), nil)
+	lru.Add("key", String("1"))
+	lru.Add("key", String("111"))
+
+	if lru.nbytes != int64(len("key")+len("111")) {
+		t.Fatal("expected 6 but got", lru.nbytes)
+	}
+}
diff --git a/gee-cache/day4-consistent-hash/geecache/lru/lru.go b/gee-cache/day4-consistent-hash/geecache/lru/lru.go
index 81eee43..6fa617a 100644
--- a/gee-cache/day4-consistent-hash/geecache/lru/lru.go
+++ b/gee-cache/day4-consistent-hash/geecache/lru/lru.go
@@ -37,6 +37,7 @@ func (c *Cache) Add(key string, value Value) {
 	if ele, ok := c.cache[key]; ok {
 		c.ll.MoveToFront(ele)
 		kv := ele.Value.(*entry)
+		c.nbytes += int64(value.Len()) - int64(kv.value.Len())
 		kv.value = value
 		return
 	}
diff --git a/gee-cache/day4-consistent-hash/geecache/lru/lru_test.go b/gee-cache/day4-consistent-hash/geecache/lru/lru_test.go
index 7308322..f2d3470 100644
--- a/gee-cache/day4-consistent-hash/geecache/lru/lru_test.go
+++ b/gee-cache/day4-consistent-hash/geecache/lru/lru_test.go
@@ -53,3 +53,13 @@ func TestOnEvicted(t *testing.T) {
 		t.Fatalf("Call OnEvicted failed, expect keys equals to %s", expect)
 	}
 }
+
+func TestAdd(t *testing.T) {
+	lru := New(int64(0), nil)
+	lru.Add("key", String("1"))
+	lru.Add("key", String("111"))
+
+	if lru.nbytes != int64(len("key")+len("111")) {
+		t.Fatal("expected 6 but got", lru.nbytes)
+	}
+}
diff --git a/gee-cache/day5-multi-nodes/geecache/lru/lru.go b/gee-cache/day5-multi-nodes/geecache/lru/lru.go
index 81eee43..6fa617a 100644
--- a/gee-cache/day5-multi-nodes/geecache/lru/lru.go
+++ b/gee-cache/day5-multi-nodes/geecache/lru/lru.go
@@ -37,6 +37,7 @@ func (c *Cache) Add(key string, value Value) {
 	if ele, ok := c.cache[key]; ok {
 		c.ll.MoveToFront(ele)
 		kv := ele.Value.(*entry)
+		c.nbytes += int64(value.Len()) - int64(kv.value.Len())
 		kv.value = value
 		return
 	}
diff --git a/gee-cache/day5-multi-nodes/geecache/lru/lru_test.go b/gee-cache/day5-multi-nodes/geecache/lru/lru_test.go
index 7308322..f2d3470 100644
--- a/gee-cache/day5-multi-nodes/geecache/lru/lru_test.go
+++ b/gee-cache/day5-multi-nodes/geecache/lru/lru_test.go
@@ -53,3 +53,13 @@ func TestOnEvicted(t *testing.T) {
 		t.Fatalf("Call OnEvicted failed, expect keys equals to %s", expect)
 	}
 }
+
+func TestAdd(t *testing.T) {
+	lru := New(int64(0), nil)
+	lru.Add("key", String("1"))
+	lru.Add("key", String("111"))
+
+	if lru.nbytes != int64(len("key")+len("111")) {
+		t.Fatal("expected 6 but got", lru.nbytes)
+	}
+}
diff --git a/gee-cache/day6-single-flight/geecache/lru/lru.go b/gee-cache/day6-single-flight/geecache/lru/lru.go
index 81eee43..6fa617a 100644
--- a/gee-cache/day6-single-flight/geecache/lru/lru.go
+++ b/gee-cache/day6-single-flight/geecache/lru/lru.go
@@ -37,6 +37,7 @@ func (c *Cache) Add(key string, value Value) {
 	if ele, ok := c.cache[key]; ok {
 		c.ll.MoveToFront(ele)
 		kv := ele.Value.(*entry)
+		c.nbytes += int64(value.Len()) - int64(kv.value.Len())
 		kv.value = value
 		return
 	}
diff --git a/gee-cache/day6-single-flight/geecache/lru/lru_test.go b/gee-cache/day6-single-flight/geecache/lru/lru_test.go
index 7308322..f2d3470 100644
--- a/gee-cache/day6-single-flight/geecache/lru/lru_test.go
+++ b/gee-cache/day6-single-flight/geecache/lru/lru_test.go
@@ -53,3 +53,13 @@ func TestOnEvicted(t *testing.T) {
 		t.Fatalf("Call OnEvicted failed, expect keys equals to %s", expect)
 	}
 }
+
+func TestAdd(t *testing.T) {
+	lru := New(int64(0), nil)
+	lru.Add("key", String("1"))
+	lru.Add("key", String("111"))
+
+	if lru.nbytes != int64(len("key")+len("111")) {
+		t.Fatal("expected 6 but got", lru.nbytes)
+	}
+}
diff --git a/gee-cache/day7-proto-buf/geecache/lru/lru.go b/gee-cache/day7-proto-buf/geecache/lru/lru.go
index 81eee43..6fa617a 100644
--- a/gee-cache/day7-proto-buf/geecache/lru/lru.go
+++ b/gee-cache/day7-proto-buf/geecache/lru/lru.go
@@ -37,6 +37,7 @@ func (c *Cache) Add(key string, value Value) {
 	if ele, ok := c.cache[key]; ok {
 		c.ll.MoveToFront(ele)
 		kv := ele.Value.(*entry)
+		c.nbytes += int64(value.Len()) - int64(kv.value.Len())
 		kv.value = value
 		return
 	}
diff --git a/gee-cache/day7-proto-buf/geecache/lru/lru_test.go b/gee-cache/day7-proto-buf/geecache/lru/lru_test.go
index 7308322..f2d3470 100644
--- a/gee-cache/day7-proto-buf/geecache/lru/lru_test.go
+++ b/gee-cache/day7-proto-buf/geecache/lru/lru_test.go
@@ -53,3 +53,13 @@ func TestOnEvicted(t *testing.T) {
 		t.Fatalf("Call OnEvicted failed, expect keys equals to %s", expect)
 	}
 }
+
+func TestAdd(t *testing.T) {
+	lru := New(int64(0), nil)
+	lru.Add("key", String("1"))
+	lru.Add("key", String("111"))
+
+	if lru.nbytes != int64(len("key")+len("111")) {
+		t.Fatal("expected 6 but got", lru.nbytes)
+	}
+}
diff --git a/gee-cache/doc/geecache-day1.md b/gee-cache/doc/geecache-day1.md
index 6848421..064d90a 100644
--- a/gee-cache/doc/geecache-day1.md
+++ b/gee-cache/doc/geecache-day1.md
@@ -153,6 +153,7 @@ func (c *Cache) Add(key string, value Value) {
 	if ele, ok := c.cache[key]; ok {
 		c.ll.MoveToFront(ele)
 		kv := ele.Value.(*entry)
+		c.nbytes += int64(value.Len()) - int64(kv.value.Len())
 		kv.value = value
 		return
 	}

From 0be9d979491294c1f126a4a64fc01fe8a2c685d1 Mon Sep 17 00:00:00 2001
From: gzdaijie <gzdaijie@gmail.com>
Date: Sun, 16 Feb 2020 21:33:58 +0800
Subject: [PATCH 033/122] add day4/5 doc

---
 README.md                                     |   8 +-
 gee-cache/day6-single-flight/run.sh           |   4 +
 gee-cache/doc/geecache-day3.md                |   2 +-
 gee-cache/doc/geecache-day4.md                | 232 ++++++++++++
 gee-cache/doc/geecache-day4/add_peer.jpg      | Bin 0 -> 41749 bytes
 gee-cache/doc/geecache-day4/hash.jpg          | Bin 0 -> 22150 bytes
 gee-cache/doc/geecache-day4/hash_logo.jpg     | Bin 0 -> 10096 bytes
 gee-cache/doc/geecache-day4/hash_select.jpg   | Bin 0 -> 8310 bytes
 gee-cache/doc/geecache-day5.md                | 355 ++++++++++++++++++
 gee-cache/doc/geecache-day5/dist_nodes.jpg    | Bin 0 -> 21817 bytes
 .../doc/geecache-day5/dist_nodes_logo.jpg     | Bin 0 -> 10792 bytes
 gee-cache/doc/geecache-day6.md                | 203 ++++++++++
 gee-cache/doc/geecache-day6/singleflight.jpg  | Bin 0 -> 22694 bytes
 .../doc/geecache-day6/singleflight_logo.jpg   | Bin 0 -> 9351 bytes
 gee-cache/doc/geecache-day7.md                | 173 +++++++++
 gee-cache/doc/geecache-day7/protobuf.jpg      | Bin 0 -> 21374 bytes
 gee-cache/doc/geecache-day7/protobuf_logo.jpg | Bin 0 -> 9376 bytes
 gee-cache/doc/geecache.md                     |   8 +-
 18 files changed, 976 insertions(+), 9 deletions(-)
 create mode 100644 gee-cache/doc/geecache-day4.md
 create mode 100755 gee-cache/doc/geecache-day4/add_peer.jpg
 create mode 100644 gee-cache/doc/geecache-day4/hash.jpg
 create mode 100644 gee-cache/doc/geecache-day4/hash_logo.jpg
 create mode 100755 gee-cache/doc/geecache-day4/hash_select.jpg
 create mode 100644 gee-cache/doc/geecache-day5.md
 create mode 100644 gee-cache/doc/geecache-day5/dist_nodes.jpg
 create mode 100644 gee-cache/doc/geecache-day5/dist_nodes_logo.jpg
 create mode 100644 gee-cache/doc/geecache-day6.md
 create mode 100644 gee-cache/doc/geecache-day6/singleflight.jpg
 create mode 100644 gee-cache/doc/geecache-day6/singleflight_logo.jpg
 create mode 100644 gee-cache/doc/geecache-day7.md
 create mode 100644 gee-cache/doc/geecache-day7/protobuf.jpg
 create mode 100644 gee-cache/doc/geecache-day7/protobuf_logo.jpg

diff --git a/README.md b/README.md
index bca1c37..469482f 100644
--- a/README.md
+++ b/README.md
@@ -29,10 +29,10 @@
 - 第一天：[LRU 缓存淘汰策略](https://geektutu.com/post/geecache-day1.html) | [Code](gee-cache/day1-lru)
 - 第二天：[单机并发缓存](https://geektutu.com/post/geecache-day2.html) | [Code](gee-cache/day2-single-node)
 - 第三天：[HTTP 服务端](https://geektutu.com/post/geecache-day3.html) | [Code](gee-cache/day3-http-server)
-- 第四天：一致性哈希(Hash) | [Code](gee-cache/day4-consistent-hash)
-- 第五天：分布式节点 | [Code](gee-cache/day5-multi-nodes)
-- 第六天：防止缓存击穿 | [Code](gee-cache/day6-single-flight)
-- 第七天：使用 Protobuf 通信 | [Code](gee-cache/day7-proto-buf)
+- 第四天：[一致性哈希(Hash)](https://geektutu.com/post/geecache-day4.html) | [Code](gee-cache/day4-consistent-hash)
+- 第五天：[分布式节点](https://geektutu.com/post/geecache-day5.html) | [Code](gee-cache/day5-multi-nodes)
+- 第六天：[防止缓存击穿](https://geektutu.com/post/geecache-day6.html) | [Code](gee-cache/day6-single-flight)
+- 第七天：[使用 Protobuf 通信](https://geektutu.com/post/geecache-day7.html) | [Code](gee-cache/day7-proto-buf)
 
 ### WebAssembly 使用示例
 
diff --git a/gee-cache/day6-single-flight/run.sh b/gee-cache/day6-single-flight/run.sh
index 066979d..28b421c 100755
--- a/gee-cache/day6-single-flight/run.sh
+++ b/gee-cache/day6-single-flight/run.sh
@@ -11,5 +11,9 @@ echo ">>> start test"
 curl "http://localhost:9999/api?key=Tom" &
 curl "http://localhost:9999/api?key=Tom" &
 curl "http://localhost:9999/api?key=Tom" &
+curl "http://localhost:9999/api?key=Tom" &
+curl "http://localhost:9999/api?key=Tom" &
+curl "http://localhost:9999/api?key=Tom" &
+curl "http://localhost:9999/api?key=Tom" &
 
 wait
\ No newline at end of file
diff --git a/gee-cache/doc/geecache-day3.md b/gee-cache/doc/geecache-day3.md
index b113e7c..a129432 100644
--- a/gee-cache/doc/geecache-day3.md
+++ b/gee-cache/doc/geecache-day3.md
@@ -1,6 +1,6 @@
 ---
 title: 动手写分布式缓存 - GeeCache第三天 HTTP 服务端
-date: 2020-02-12 22:00:00
+date: 2020-02-12 23:00:00
 description: 7天用 Go语言/golang 从零实现分布式缓存 GeeCache 教程(7 days implement golang distributed cache from scratch tutorial)，动手写分布式缓存，参照 groupcache 的实现。本文介绍了如何使用标准库 http 搭建 HTTP Server，为 GeeCache 单机节点搭建 HTTP 服务，并进行相关的测试。
 tags:
 - Go
diff --git a/gee-cache/doc/geecache-day4.md b/gee-cache/doc/geecache-day4.md
new file mode 100644
index 0000000..30ca624
--- /dev/null
+++ b/gee-cache/doc/geecache-day4.md
@@ -0,0 +1,232 @@
+---
+title: 动手写分布式缓存 - GeeCache第四天 一致性哈希(hash)
+date: 2020-02-16 20:00:00
+description: 7天用 Go语言/golang 从零实现分布式缓存 GeeCache 教程(7 days implement golang distributed cache from scratch tutorial)，动手写分布式缓存，参照 groupcache 的实现。本文介绍了一致性哈希(consistent hashing)的原理、实现以及相关测试用例，一致性哈希为什么能避免缓存雪崩，虚拟节点为什么能解决数据倾斜的问题。
+tags:
+- Go
+nav: 从零实现
+categories:
+- 分布式缓存 - GeeCache
+keywords:
+- Go语言
+- 从零实现
+- 一致性hash
+- consistent hash
+image: post/geecache-day4/hash_logo.jpg
+github: https://github.com/geektutu/7days-golang
+---
+
+![一致性哈希 consistent hashing](geecache-day4/hash.jpg)
+
+本文是[7天用Go从零实现分布式缓存GeeCache](https://geektutu.com/post/geecache.html)的第四篇。
+
+- 一致性哈希(consistent hashing)的原理以及为什么要使用一致性哈希。
+- 实现一致性哈希代码，添加相应的测试用例，**代码约60行**
+
+## 1 为什么使用一致性哈希
+
+今天我们要实现的是一致性哈希算法，一致性哈希算法是 GeeCache 从单节点走向分布式节点的一个重要的环节。那你可能要问了，
+
+> 童鞋，一致性哈希算法是啥？为什么要使用一致性哈希算法？这和分布式有什么关系？
+
+### 1.1 我该访问谁？
+
+对于分布式缓存来说，当一个节点接收到请求，如果该节点并没有存储缓存值，那么它面临的难题是，从谁那获取数据？自己，还是节点1, 2, 3, 4... 。假设包括自己在内一共有 10 个节点，当一个节点接收到请求时，随机选择一个节点，由该节点从数据源获取数据。
+
+假设第一次随机选取了节点 1 ，节点 1 从数据源获取到数据的同时缓存该数据；那第二次，只有 1/10 的可能性再次选择节点 1, 有 9/10 的概率选择了其他节点，如果选择了其他节点，就意味着需要再一次从数据源获取数据，一般来说，这个操作是很耗时的。这样做，一是缓存效率低，二是各个节点上存储着相同的数据，浪费了大量的存储空间。
+
+那有什么办法，对于给定的 key，每一次都选择同一个节点呢？使用 hash 算法也能够做到这一点。那把 key 的每一个字符的 ASCII 码加起来，再除以 10 取余数可以吗？当然可以，这可以认为是自定义的 hash 算法。
+
+![hash select peer](geecache-day4/hash_select.jpg)
+
+从上面的图可以看到，任意一个节点任意时刻请求查找键 `Tom` 对应的值，都会分配给节点 2，有效地解决了上述的问题。
+
+### 1.2 节点数量变化了怎么办？
+
+简单求取 Hash 值解决了缓存性能的问题，但是没有考虑节点数量变化的场景。假设，移除了其中一台节点，只剩下 9 个，那么之前 `hash(key) % 10` 变成了 `hash(key) % 9`，也就意味着几乎缓存值对应的节点都发生了改变。即几乎所有的缓存值都失效了。节点在接收到对应的请求时，均需要重新去数据源获取数据，容易引起 `缓存雪崩`。
+
+> 缓存雪崩：缓存在同一时刻全部失效，造成瞬时DB请求量大、压力骤增，引起雪崩。常因为缓存服务器宕机，或缓存设置了相同的过期时间引起。
+
+那如何解决这个问题呢？一致性哈希算法可以。
+
+## 2 算法原理
+
+### 2.1 步骤
+
+一致性哈希算法将 key 映射到 2^32 的空间中，将这个数字首尾相连，形成一个环。
+
+- 计算节点/机器(通常使用节点的名称、编号和 IP 地址)的哈希值，放置在环上。
+- 计算 key 的哈希值，放置在环上，顺时针寻找到的第一个节点，就是应选取的节点/机器。
+
+![一致性哈希添加节点 consistent hashing add peer](geecache-day4/add_peer.jpg)
+
+环上有 peer2，peer4，peer6 三个节点，`key11`，`key2`，`key27` 均映射到 peer2，`key23` 映射到 peer4。此时，如果新增节点/机器 peer8，假设它新增位置如图所示，那么只有 `key27` 从  peer2 调整到  peer8，其余的映射均没有发生改变。
+
+也就是说，一致性哈希算法，在新增/删除节点时，只需要重新定位该节点附近的一小部分数据，而不需要重新定位所有的节点，这就解决了上述的问题。
+
+### 2.2 数据倾斜问题
+
+如果服务器的节点过少，容易引起 key 的倾斜。例如上面例子中的 peer2，peer4，peer6 分布在环的上半部分，下半部分是空的。那么映射到环下半部分的 key 都会被分配给 peer2，key 过度向 peer2 倾斜，缓存节点间负载不均。
+
+为了解决这个问题，引入了虚拟节点的概念，一个真实节点对应多个虚拟节点。
+
+假设 1 个真实节点对应 3 个虚拟节点，那么 peer1 对应的虚拟节点是  peer1-1、 peer1-2、 peer1-3（通常以添加编号的方式实现），其余节点也以相同的方式操作。
+
+- 第一步，计算虚拟节点的 Hash 值，放置在环上。
+- 第二步，计算 key 的 Hash 值，在环上顺时针寻找到应选取的虚拟节点，例如是 peer2-1，那么就对应真实节点 peer2。
+
+虚拟节点扩充了节点的数量，解决了节点较少的情况下数据容易倾斜的问题。而且代价非常小，只需要增加一个字典(map)维护真实节点与虚拟节点的映射关系即可。
+
+## 3 Go语言实现
+
+我们在 geecache 目录下新建 package `consistenthash`，用来实现一致性哈希算法。
+
+[day4-consistent-hash/geecache/consistenthash/consistenthash.go](https://github.com/geektutu/7days-golang/tree/master/gee-cache/day4-consistent-hash/geecache/consistenthash)
+
+```go
+package consistenthash
+
+import (
+	"hash/crc32"
+	"sort"
+	"strconv"
+)
+
+// Hash maps bytes to uint32
+type Hash func(data []byte) uint32
+
+// Map constains all hashed keys
+type Map struct {
+	hash     Hash
+	replicas int
+	keys     []int // Sorted
+	hashMap  map[int]string
+}
+
+// New creates a Map instance
+func New(replicas int, fn Hash) *Map {
+	m := &Map{
+		replicas: replicas,
+		hash:     fn,
+		hashMap:  make(map[int]string),
+	}
+	if m.hash == nil {
+		m.hash = crc32.ChecksumIEEE
+	}
+	return m
+}
+```
+
+- 定义了函数类型 `Hash`，采取依赖注入的方式，允许用于替换成自定义的 Hash 函数，也方便测试时替换，默认为 `crc32.ChecksumIEEE` 算法。
+- `Map` 是一致性哈希算法的主数据结构，包含 4 个成员变量：Hash 函数 `hash`；虚拟节点倍数 `replicas`；哈希环 `keys`；虚拟节点与真实节点的映射表 `hashMap`，键是虚拟节点的哈希值，值是真实节点的名称。
+- 构造函数 `New()` 允许自定义虚拟节点倍数和 Hash 函数。
+
+接下来，实现添加真实节点/机器的 `Add()` 方法。
+
+```go
+// Add adds some keys to the hash.
+func (m *Map) Add(keys ...string) {
+	for _, key := range keys {
+		for i := 0; i < m.replicas; i++ {
+			hash := int(m.hash([]byte(strconv.Itoa(i) + key)))
+			m.keys = append(m.keys, hash)
+			m.hashMap[hash] = key
+		}
+	}
+	sort.Ints(m.keys)
+}
+```
+
+- `Add` 函数允许传入 0 或 多个真实节点的名称。
+- 对每一个真实节点 `key`，对应创建 `m.replicas` 个虚拟节点，虚拟节点的名称是：`strconv.Itoa(i) + key`，即通过添加编号的方式区分不同虚拟节点。
+- 使用 `m.hash()` 计算虚拟节点的哈希值，使用 `append(m.keys, hash)` 添加到环上。
+- 在 `hashMap` 中增加虚拟节点和真实节点的映射关系。
+- 最后一步，环上的哈希值排序。
+
+最后一步，实现选择节点的 `Get()` 方法。
+
+```go
+// Get gets the closest item in the hash to the provided key.
+func (m *Map) Get(key string) string {
+	if len(m.keys) == 0 {
+		return ""
+	}
+
+	hash := int(m.hash([]byte(key)))
+	// Binary search for appropriate replica.
+	idx := sort.Search(len(m.keys), func(i int) bool {
+		return m.keys[i] >= hash
+	})
+
+	return m.hashMap[m.keys[idx%len(m.keys)]]
+}
+```
+
+- 选择节点就非常简单了，第一步，计算 key 的哈希值。
+- 第二步，顺时针找到第一个匹配的虚拟节点的下标 `idx`，从 m.keys 中获取到对应的哈希值。如果 `idx == len(m.keys)`，说明应选择 `m.keys[0]`，因为 `m.keys` 是一个环状结构，所以用取余数的方式来处理这种情况。
+- 第三步，通过 `hashMap` 映射得到真实的节点。
+
+至此，整个一致性哈希算法就实现完成了。
+
+## 4 测试
+
+最后呢，需要测试用例来验证我们的实现是否有问题。
+
+[day4-consistent-hash/geecache/consistenthash/consistenthash_test.go](https://github.com/geektutu/7days-golang/tree/master/gee-cache/day4-consistent-hash/geecache/consistenthash)
+
+```go
+package consistenthash
+
+import (
+	"strconv"
+	"testing"
+)
+
+func TestHashing(t *testing.T) {
+	hash := New(3, func(key []byte) uint32 {
+		i, _ := strconv.Atoi(string(key))
+		return uint32(i)
+	})
+
+	// Given the above hash function, this will give replicas with "hashes":
+	// 2, 4, 6, 12, 14, 16, 22, 24, 26
+	hash.Add("6", "4", "2")
+
+	testCases := map[string]string{
+		"2":  "2",
+		"11": "2",
+		"23": "4",
+		"27": "2",
+	}
+
+	for k, v := range testCases {
+		if hash.Get(k) != v {
+			t.Errorf("Asking for %s, should have yielded %s", k, v)
+		}
+	}
+
+	// Adds 8, 18, 28
+	hash.Add("8")
+
+	// 27 should now map to 8.
+	testCases["27"] = "8"
+
+	for k, v := range testCases {
+		if hash.Get(k) != v {
+			t.Errorf("Asking for %s, should have yielded %s", k, v)
+		}
+	}
+
+}
+```
+
+如果要进行测试，那么我们需要明确地知道每一个传入的 key 的哈希值，那使用默认的 `crc32.ChecksumIEEE` 算法显然达不到目的。所以在这里使用了自定义的 Hash 算法。自定义的 Hash 算法只处理数字，传入字符串表示的数字，返回对应的数字即可。
+
+- 一开始，有 2/4/6 三个真实节点，对应的虚拟节点的哈希值是 02/12/22、04/14/24、06/16/26。
+- 那么用例 2/11/23/27 选择的虚拟节点分别是 02/12/24/02，也就是真实节点 2/2/4/2。
+- 添加一个真实节点 8，对应虚拟节点的哈希值是 08/18/28，此时，用例 27 对应的虚拟节点从 `02` 变更为 `28`，即真实节点 8。
+
+## 附 推荐阅读
+
+- [Go 语言简明教程](https://geektutu.com/post/quick-golang.html)
+- [Go Test 单元测试简明教程](https://geektutu.com/post/quick-go-test.html)
\ No newline at end of file
diff --git a/gee-cache/doc/geecache-day4/add_peer.jpg b/gee-cache/doc/geecache-day4/add_peer.jpg
new file mode 100755
index 0000000000000000000000000000000000000000..edf56f5856043c8368210b3fc62507aff8fded3c
GIT binary patch
literal 41749
zcmb@t1y~*3k~Z471P|`+?k*uXgy8P(?hptBm*5V;-Q9z`yA#~qC2)7X@BHVUGxwi6
z&pb1|pWVHx-dfeQt81;UUS0cb@$DCYA}uZ@4uF9H02t^4ysZGD0NlI(+4j~Apu&P}
zLNr4FqyQKy0FDa0^#XVx{ooLP&h*a>5(*3g8XV?r8G!wp{T%X7>_2HBqFlg~68{Yn
zT2(=to&43N%evx%^PVjoTf_bvgPr4_J!kcJjZMq1P5#4zb%Jtn8`+g#(sD3ynD+Zi
z3Rf#+b`{b~)8jW2+q#zQA08x4j(|r6RLarfUlPFds(Wddf-U`>9{_-Jp6a$+4<y$*
zL>qm&PY3%U43YuoJn^_DsT{Et{!a3pSilbei=rAEMOIrZYz^%8Q6eGwVmMoRf_r$5
zr3F#}Ac@XDoo28{2~~REXB|O|w~u>q+`$M<(wq4K5crKMDhghL6yE3fYE!J13yp?Q
zR(nc2T55OiLWx10Vb~@IN(aQYGdmmz7`h_4qX&4-_myrnERP!0)j`_9;LXL?PE_Zc
zHFz6Ej+0tDL45#3hMrGc##5rH+zl@S9j!JQe|(I7=Oy`kh5FlX{4W_WDDLZ0cZro9
z=utlaz%9A8s;s(iv26v+*FnM{#bHfPTYIWY%llriSAQ6|hx!(Yka|vMjj&e`frHR|
zSs*4&>6XkO`%zUxD!U!hClrX1OaPka=};I9*G}{_*WKF>PD@{~10;xkv+^52#H-w8
zw?j^wg)oU!I#?hE0>;k=0oa8*O)gO)N<G<r2MNxEJAD9vkmrc>1IU)v4>pJtu7}ey
z?i4u0*My&J1_5OyNdRC!&EPea4>igzU)%0?()rQg2LL43jsSp+lf-K}vpcJ%DRAJP
zA^ns;2^5s9f{ZV4CK&+;KwTjj9fbkFDDf#u4DvJ7OBQ&|cXtqOQvos(0H%hA{)qTi
z9Cm`39vUDP>XU{(=m6~8ft*sPdi>{_A{l`gFi~Zo7Mn2SSyg@o2!uks;?k%Cg`M`<
z1?VT}^ko5npca~HM)RdXMa{;+sKb>o0EF)uH0FZfls`_zeX{8$u$D4r@@mlCAz}!f
znyCEoPA?Tt_fCf#9~2#9Dovqtl0zk_<Tdz_tmSzS10>X-Ze**AM${~VZWg$2K<a^2
z%Xm2PW1AN4@9#M7^(T~9nVkSwPQx}C&d(8+<EBvD#^F$ywz_0^b5K`6rX6Fh%{iP_
zfB+`EBaRqA$-6@91W-3URtOJZK9fy5&E2=vjkx=8v~@bA`hhx3eB$rt7s$->14u+c
zCVk{~on{3h7r$xay1{9{&>et85C!Z(dsvm2PB5hjjT=88bioDy@S}c#xTLQ7pgoDQ
z6#)Gs#>dMXV6g((!Tktg0w0b{c0dRGF{lH8XXw?&4~TJT0(qLt59Dg3*I5vT+KiLg
z38rBRfK`IL{STElwZb5Q31|NGDxfTe9)L+n>I5JX2SM_<=bey~0Hk_DJc}^yp^5x5
z0EV2uRt845h~x$81Q4DH>O~{?I0Il}o+TwWu(&RtlA-|!38}6*KrqxEyrgszBt<#?
z_{n;O<K&Vnb6~L(Kvyeshyza?1}PwXl27bR`)T@JCQ9KZEgFee5+wfd_|98p+Vej7
zcINSZ*$+T>3ugHW;q3<i{L5P2-Ldza_P63ydqkgGfPH5W7uwTppqi2y=NT3N54$NX
zTvXKnaU&Ny>|`jJk@Hvl%y*4J3|wBCEC2x1tWzDeK6`^kJ6LEEh{1F4$9Z0d!k|6R
z*|&=94IM+!q$H#l4FK3XZhinDam)$A0MW0mPMSwHouIIuln2pbd&VHQ<z}b<1(w~Y
zs)0rZgi699h%VdT^#h>8N0|R$*!$FHAVm520z^b&h6w{;L|IjT5Wqb^>Ua`>5X=A5
ziNkY%tI!_6{q5}4`3HoKyup|Tfc{K>cMyf!{-iqnxC&TZJ6ZlgLBoH_JZA`CAsoLa
z29X?IH^eG^Q*=`yX(mg5MjB|FY7;LG#``jbL+jEn45D#ecaSljEGk?Vt^dHFk#7fq
zVk9E}gZK}Dx&xqGvTw5kyv@J<(BFx{N;+ouO8l@Ivj8w9EGrz3TUK|}o00pgCch=#
z`Wq{divU=ZTN@)mAKQ9}QHCpSLHl>oqb|Sw0O0dg?6J+(oahsNt3GUppb^@$OFF_+
z<akG#Bd8Zh-F~B%o6|g}T4N`!v;E6$#yH!1>kdsJvn4+OMrdL|q_5##lyMb!gnZYe
zwfz*%TYW2&1?mYO;w!i!v`Y6Sc<lk~x<j@9qaM#3Xa1^dCjf?}fcZJD3D~;@n07&;
zfO(WyJm)ZITJ6Ma@cYB~pKReBloK?5xJI@yX!^+Pp;eeM$xDI-wv@ofBs3M9bUW6z
z_U_cbPXIIeIKCVfP<T}KTl9MTR<(k5E6iVIr!-{R>e#B~6_ZG8Xy6HXf~zNPa_ZB8
z?cMPA-0&y2#!*hYK%(mHLTv|~Q9;q-C)mHW2^!><<Q5!qKc6a|HVfXZ>yap&{j^Ey
zu-q%nX(&4ql%lHGs<5V}P`}Rb6|$2*o-ZA1qna<Ty-Gcc(_yku_^Dc2DwO0ym;JXo
zDDwPZCLxm|v6Ys@quei*s$v}d>c!!-Sm7^IM%qnr$4@pXU3!N5p77|WwH{GXP(Oqk
zkQM*io&zN;xS(7Gl&}12!U6^k0SN{DSH1#<@~=8Cufol4Kn#eHz0mJQ`T$hP#WCuS
zX%I)6KguJ|D-8g{tcb_f8>9O23xG`t4GqG3M9c62048ylnYiwwa$cWK07y<Xa~r;6
zn>i2$^KqI;Dvk^UO><1H-U1QU4Eo?JM>zXYe0;58D?I?@d6g1B%hJL@LgV*j&I6z_
zY4)boA%pWV8ki{p?=X{To$j8Qxo(DD1E6?}WP$*QPgxLxo*TmbP*0uU>3-1o-D@+;
z04aATjH(~76^x|7azrQ}S2rOve`5(CX|K9}Y=2k22*6OW^|UcRSvX$J8?HC%gQGcJ
zwuQ-AojTVa0^r;!pPd1lNf^!r$P2bnXS_22@}d(UzysTNTSU_C<XQ#bwzB}-8$V!g
z5JEQ^Amu`42K!PC2bfJ0x=5V@5R4tGN^{r5FxEN3@D_)g94C*f10ZvD7IGx7JCP!D
zgkjikC4Ut)>H{XD0FXHZpzi?hZWh6GLGvtALl*2#5n$A4?Kc66TS&7*Nq8q^0B8C6
z(48hoA9Po5cv^=yiUtr|-<LZb!T;e@bEUV?(~SeyZ8rm@iyAjP({^K^d(PI?K=whR
zSDZ%3MJGN#ubG}wkwDmJ^UDQ*-(i#TM9_6K7V%OAx|aX8fnk2rg!69<sgs42X83~y
z9%Gi5n%HOnq$<;ie*Y#5B9Q;Hh=PRpM?``DTSTpRgkFP`KzHO~002g<_vl12Xx@Qa
znlgn4z*yL;+APU_005jnxo#R18vv%oz;S%&kmk?{nh0s?bqBE9`6mITjPr%m3sO)v
zLVdUq3u?e$?vVcW(v46bQCk8a?Lh?Jdc?Yi<<kNT{V&Xwv3=vC{hmVrB2yo3MO=ul
zUZW!*%i$NGr96}D2H;-<SW}i)NYga&08<e#m8S-21ia_%gw_P*H>nIPJjh0i<K_=%
z_<mr8xs6id=Hko%-=QZe-6LhYW2y%ZfEG~EutMqmYOB!+WQ40b0lVqQN`&^}yJbA-
z?f@8`F@W&m_v8z~javaW;0K^q`~sXt0SI|vBo99zWs5KbJmq5+*aEX%HFhU(oJ3^8
z_8S{4>OBDU__%iL{pAf1NlOMe95*2*0d9w60GEs%aUNq3AYcb&kL18RD*(yk7nqGA
z04N0l?<<7CSFbveQpo{;3LR)D2B31<JXB@w4nW>I97v!b;JpRFEJJp^_TJrrqU{3>
zfm3IrJ#>bo(U!`un|7n0B>+T6?<ehEiLm6lXJSNL8Y`n6La`iNP`+|pLArDuoP>(h
z5&a*-07xCSVj;1VD*@O412yu!*Pv|h12^EP`~OG^fg(m51po&FgM@@efQS7PC@=tM
z3PJ@S(MaBtvM8XliYOX5K%tNce{lTj9}}BBg+a{B_F2iWx@MZ3UDPQqr)$Qjw);Xk
zV3Q&~x91X?<D-dRg0XXS-S*DzKc2e4guvc_1CkYBV-TvYd`wTOA)%2e@3}nRX5>)t
z*h0(kNxo%Sb+sez?EeNBZGy@DIyqdr8DfXb@Kaq@-TO}S2ISY3H~Ubn+0fbQN!@En
zuOv<T%uhG$-u!U+zX6RLAXyV@Vbqb=-#^6Ve!2W;tw;PN{yWBFhm^Y#9-370v*C9Y
zXfsY8+K8bgEh(=ce(dnA7>6<|^h!#CJ#uju2m|_@V1@>)k!JODDV0<?G<=5Zpq9u4
zg_^|&Yg4fV5~>!-vf(-^6`GJZX~s#8km4ni)cc-XDQR*?QMM4w$Y2O!#jEMEeM|%M
zT+@aX*AFtY_Ja%FuxL~<`8K9=7;yMrEL;LLx>lN$4CvNQ47g~X(*D+~O0!?i3ydEd
zFXb&I43^%tY>^-?UyL?Ip@~X-5VJ`1$VgcU(is)^p>jkFAjHh&u#mheOW<LQ;3VrS
zPkeSWAnEP-(6pl#rW~V`k?XA1GhJ%h_A!RO?>X&PcPD0FJ~0IVd93WH`J3a6p8-cQ
z`@L{rjR(cFWJxDD4K9Q0-ifOLo+;}$UJTVZ;-(dN_)Ip(Dc4Qy@zI8r>Z>twCyNcq
z%k_eAl+XSl!srUWrG(7yvbQ|6E{U>N_DQeb0OY>3&SN1ri(CiKc3uAz)l)B|1y41!
zWHM;=fd#R8pLougq`>;k%J*GvZ6ZiP?g{qz+@<(|n@M03Xpy>F?`mWm+vu6t>SEas
z$w$6M9HEpFPxX~(K)XB5uh<SWw+}Hq#+NJdwdr3$f)(71+CL^Hz5y-|AF!s61`sZr
zr$$P4V*^6<Aopk)miR_#ToO4w`7b0%v9-5KZWy(^X*KuV!`ziVF4kFwJeAd1lQHNE
zq-Zn{=HBF967|`&4E4%md^r!L8v7aMr4#-29IGf-oLX-F@`u0qB|h@V*N1Z1LyPnY
z#ChSGt}Z5QJC<(0AvaRi<QRKyW6e29@iQAOoy2qcCzUo`J6RI*5y{e=&Xc?fiq_tD
zKI!5MF0O52_WJg&f*O>?7jbVuz#G8)1|Y2^v<nwiC7t<OwFTNY&uXZI7HJxTv6tKQ
zFg_u@&pYFPVH)r0>-qj@vp6z~U=||SmQ>nX)TFJ-DuSq3x3qh3D%yM1xb;NP;m9O(
z@uDVc<bV@yuIKq|lkIbS+7NhO*)Rqfs1B_{j)KSbZH7$R(I&rQK@^e>KH6C`Khh;F
zVyw2?lyVtsy<_E{-KqlHNNGl-pLhi0zmPqY-)nG(ZdI;b!WI!<g=u|wURXKfob0&0
zTlv$pd3Ua7lha(MI7VWB?h%c<$6P{z%Hybs|7i6WRL9ir)9_E}vziKwcdz%EZvdM3
zsDiP$LA@xA!91OoA>bzod4e%|i=@RLGayHnqh`waPPZh+)LEr>w4`lMA4?!5PWGg%
zjD-$bsj3)~h<c;})<A{i>!L`JpiZJ)dicbP5P7=hb*P=x$kL}Z@k`6d?V11l`v!bS
zAyb8)Caqp98^*o`w=(<?Rt?xu`i~ChzGqg!(+Gi>cC2Y(-BMN6b*!RGl4KtqB6n01
zKe$=>8lY71?XHK092`zN8JzWaZMXJc;wNT#`=nS<b<k&^QA^p5Fzx^6oB5c@-J~;)
z*JfGMN13TA1|b2B3CZUh(F>)Nl5H!aYg;=(zYxJ5d!GA?4DA?WA)#T)`6oyDU_&|r
zsi=chZzLhw&)jqzwRbos+SNo$+x2}UT(ImBv1KGB<An&;`PJnVU`b-BR(|FUC*~#V
zCSqNX_d&5|by-uJD$`IGAIoq>7Qz$zFWt~!WvAdi4Mv3LaV!;UYusvH!pq}G(W*rV
z8#WbZ;K5<&9655Hs2yS1p}%t0dhh7^Zq`4k`tN(Ba9{S2F+~P5*;H~-+a^JEe4z0P
z5M^mIv>`7WP1PZDx1yvhY0x96o!#g^(AE3YwR<{j9+UwwEnE-1X^Gf9DMzp+KuQDg
zJ|7!?o{QQQjg5>k{Ie}))+&7;s>TL<iT`N7AHW&w$$)Wp$nH<><BA>4t|$>HL5qVb
zdOla7u^eDu4}DBhLc<q4nGvH7iFQxn)wg4wjV%(hM;f!qC;mN3i#Xds)2lA&t4pgi
zi*RY!)kD)cu3xD17I*p~m!&544wj0{D74$xs*-t1)^FTK(MB%PzXb7UR;*%k<$NXN
zFk^Bk_j*E-nM0A#3~e}&7~ZiS9dptybBLeBaJi^NokNJa8-uCjyQ)go45d;)rKLqp
zPavSr$l<FuSP&?-tA{jvYQ|4-ANGJ<E))2sReed$l{qMZom1L1EcIA6L>?=(OF7Z&
zi_vjRh03q;T<+T3wFK3!%OsN@E7N-^J}RdlM#a)!ZB{I8Sh6QIz7`&{+ax@V{|Tah
z)QKS{X1kcr^22PVUW6Q!T)bmOdCI{me*oj+1X~JE8pxIJ#b<`xx*Y~^CFP)TCDj48
zau=uJS-ij^u6H2Rc2GNJnB7m|#-z>>d+xEES`LLQNsCeIuWKNH8Ek|&z$8BY;J?p~
zFv=uS7i&Sm0Q5gz%4`op&1u3@@0`lupDgCInFrxwu+WFc@Q$QL%b7cokwn+tapTpj
z<)*|qr%FkEesZP4vw%`l`N63mBBzrWNFn?&wk(Z#Geqp0?NDlav8seD%OIJpgB+!H
zPJ)*9*@R2T2h-`Cos3ZuoLEaye3kOFzwR)Il_=r8?}g<ct83I;Nu(b+m$FYH_pr~{
zde9vZQ8KS;w`U|!6+bHIBa~C3YI`8uy(kWI)<o4nRWF3l&HVb##H9F4pOZm;%J&9r
z5TA~kXW5zDq5inJx;tZ&qQuLS%kCk+mLY+7PX!yNh|*bH8T1MhY1S@7z7VLvq(IJ;
z^9j+JD?%0>(?YwCdijfu{cgjEXIo&?7&A**)Ph&94I!c{g+XEjO97=$T3#I*|MmKj
zm0M&Yq%=Hx7#*8+@tD72-5igm{B-3cy+?ju%3fTY<Vc`_((pQZT98B|(O6-a;J4U)
zI$d|^b@N4L@p9Pcj~$qZE@Lm0D^=DtLGTcqlm#}j9DEnE)2*cziV_eKG@${iO``tP
z;+RUZwG|(6znZi#&kUMTUh~4<Yywjy3$RhV(KL!nab-3xEhDaQgc+I?<!Zth$r)u6
z5wU&s$yaxg=H})WG5O|hGf$fD@+QZ~`>%*(m4{nU>S>$Q;QH;KtzRTAwa#iB-uLOX
zj1asYm<63fD)q5Xk06u_eit^Gr=xd=v#*fS#uKY>`vT`02ERq!GB)l?k^ZRuBUIC7
zcv)<Ry9G=AnI4R?e5g-njjC{w_Y3Kz#OG68CPWxx%1-E5bK9!^2^};x{yGaS`yD*>
zqg#3Y$@cZ*g5>JZ{8aafEsfL&bjV0DXJPfrFiupl!<sQ~bGxqyi`j4#>lPJHSn&>-
zl;V*pO-&B853ZYX{EZY}i)yml#-as!88FzOlk+T1L`$3+jV0Zi5QK3md7$vfWL09#
zR!d(dYKEChDmgwpLGgWl@G&}j0{i=3YQ149)n;Q`J~C5x<s1m153w~&r&p8pr2YPZ
zL3aUAK%*U2RWFD&FN9~Ii5aQctf*n;*03r!ZE1?xZC#gzHbf}Rl|oHM;GX3)@3k2X
z7%o_tQ#tV-A#3|45tnL#t2xhBgsvtPlq`%HbT;IO0*ByOXNI54i8fSDc4Zclsikw~
zme%x9>tc!ovJfi72xGo<t1q-!FH(2T20MqEf9l5QUv4~M1JMrOvk>=x@9PIx%=1m$
z>=4R_Q=!~U`4|O1Et<qEvkHEiStE<pSQia73nVc=tOYX);cz`RN&INj2w}|}<M{;@
zFqXO~X25et%N~|3E-$fU(Ij_<k>N>6^UR^0iNTO4e9v;&Xt=4e`5yk4M<zFmJF^5?
zG}cLy8QG9Y)4HODNz@w<SYTOgRcAYUq4b^$!vo7CHd~o*TR)3!l95by1$M})A;8QM
zF~TjqE#LrxvIc98<xn(oR&&;wIhRTInTA5d;Db}aSyc7N%q1Q#6Q5le=aZ|)7w&DL
zRDpyyK&7gZ!v}oveQHNh1LR(13By;O(xY(wPnJ(P|B-2+@awzq6Q^pv@`<rN@-mQ4
zRc6{QK2>j?YnU_pI|r<rH;MC@KnNujT%OWZWY~S|&&2t|$L+=J!c*Ie<7a+Y@iN%)
z-{-p50(VlI!|Y6-yA`XV;_y+hh8xpU{*TO!vLpYB;ao42pFT~-gzwm1&$xWewFOt~
zJFL-u;E4xZCcbLf7ke;nk8rhc*49;$N*a7u>zd(g<ic{e_~g2&<l9pj>+AhtmHt7^
zgTDvw4JekcS!G3rZE?Sp6leksLvjtwYTkCXIsLhVtCQm@>reK-)9)Erd|50#kj|r8
z^#<Mm>F<X(G3=u|yw-MZ4vEn$YuFY-fR%mMuO2p!5>U>G8vo4DoxjuiWI{BhIW5B;
zq9lr4$(T}tOoAS4zGA+Y$PSk!`bmeUm_Kixq+ylj(e`w22=5DN;%1Dy46XYV%L~{^
zTn`o6N28WptkT9MGfT@xZjX^P<W}U@28@D+jr*iHvwmAvm$;WaU%jlQ1aV3dWgB{P
zn8f~jy_CqjXSvnwo2uS*OVk-dvoHKj5}X9``y5U?baMvi`U{9!>2t2Psf9ZT3f09T
zy7oiu2BId@64#0@WdXREwQ-LQi@L)vH?lu%1rIV6M2K(Ybz-JPLa|xTmGtiCE|m-}
zH!e|s3vwZ+IqQ~w@v?tx6gz6XXXx2m!z$TWZTySv>$oatGv!(Sd*r_b|2Tkd??-%(
zKFUKjCUO`Z9Z-^Yqdwvu*R8JRX!WzA2lk38!v+n113lQgOmDIG>kcM(8tc)+Nyv+d
z>M^h)5zOwU$f<mY?n0mJcWq(dk?_Tlg?L{q&cn#*LHkydCpRf%DYC?}qTPJfj)CS<
zo`5&`l_*l+Onui`fdC7U7Pq;iksnECe)HNke9rDnD|oDhN#$p=EfMEIyXxz1llMx_
zt=4nme-E~53sO&5PT+2^9tu0Bit}|>O-T=W7C2~7v&ZwE&>>1@WpxQ-TITEu*-D5g
zAJhx$AaziyNH}~n!mePa<k~Oz_|OyfTNW|#>T;L6<hQl{?(^U^S-)mfV3mF+Yjo!c
z@hsu8gZKW6#P<ALy^WUYT%EZwm4-5y;<z~sMP6tw{9?jX11oMsGbh5S?i-MJRU|FW
zUgKEATl_q**uiLXXWg~?xZf*SPFwvb<{*@Aac2$SfQdADmy&i&B`<boClv?6Ug6Q#
ziZ!+tM$5v83>hDB%P(_ADaWhew)XccHOKE2RyID1Y;mpsz<qog%`|(ouv~5^F9q#B
zYxqazO?p_{o?xUHN6F&rM=J8VzEhp6AGtMuc>}KTc6U=qaF?pLa`sMV1@G7);+Lw&
z(pPv$U_QHVsIPgpCMC7`nU7O{dS4&?vT|GL|7CjeykbO@ccip8+9B7b-D>doE;uom
zan@U5_j$rfHWQBNxk_(27xpT~+L0i}^Q`p2Iq_^`ld0?th@DM4CcFCR+XC{^R89U|
zUT0LdH5qm}ZRUDzf>Q%z@)~wYL41>aF03_v-QiL~#@S7RM)u+&2C=iTLEn7Oj^$|;
zY9Bfky7V-HwQ*>E-<`MwEPl>V7Tf3`#x@GuCUIad^L%ok#7%iP`x$u77H_tZHrel+
zGt4&L5(zh@a0$iJLG4qBY$wpV<3`jmZlWuEu7%L~(ui52)SY1%(Z?E>jOt3^1^zti
znv$X%Kj_VM3R;I^8sf#{#-c0M--(c#bmN9R2NjNLL|jyAEU#VHQm0>LMqk?tVz5ZN
z+t$jD!hV?4eY-S_zDXs1b;NtL(fA&Kd)vxY3;z2qZ}nl|r9kL0XJI(JH#vk#jhW^b
z6NUVS<?`XTw&Zwbl-AETN>lS}4J7RES)$m@t1yhU`Hf^L$Fc)s-hDu)-9~=LC*V}U
zFIdj0N%4*T%D?GjGMSmUeTj#?Vm*IygGL17y*CBUjh~c1Ygi9THmxwm4*QDLXaHV+
zb$>~Pxr$3o#r)ygT+2pj=R=39OV%fA@4dC~Xx~3^>-bw!Na&^i(c&DNFI}I#*ZShK
zQ{KU9t5%%5ayET$TV%iMvL_6O1ZhODCo6QpWDkeQQ2aT}lQn+>R`8q}dyJe24*dc5
z?CLKYc^)g-fWbvoS_LOp1BD;NOG=Z-xpe07d$-ZQJD6g)1EzF;go7eLKDVWw8I#Qn
zZ>pLRNo7U)>b!QH+*NhR-T@qeHh%BBPwLGmveP#<aGZIThy`0Owq4?P6uSu@Frvip
z6-c*wbm~U&PneK!R#a<9B911Z*m1MXp{Qxh?GV8XOM+3dd*McMSsJG0^R#)Xm3Zgb
zyVq0G%eB-xb`uP=<wjzQw)t!oUOSh~8Oq5lD3`foqR4%;_t*Ewvd%w1z%v)|iPXqW
z9u4+(J8B@=V2NJGIpHsK&y9DBYX+1P&+64HsR*b`j-FMh)C`b;75H)rDD2v@c`!!>
zn23F%4Ll-3djp<kGtGW!sV+!C+L2+tTQ%;M<6in~R(GQ*Gcwr3+#jx46=}c4x7>Ym
z0~Sle97ZSkH5sf*EjJI3Vso;2&VY(QLqv7FIifwjRu{X56MI42fi`DTa~A(m&YUyN
zB2A_sXR9wNey-fArv7fJGVnMIubH8~&U4MBPrDp+TB13_>z{bu<y(&J!@M}^9%Q;+
zzS-VnlZXi)&dK*iolN-_?`x?Y#NU9)D->6M9@zS2St{Wd>ruPgTnm^Nv0eOJmSLE_
z2iEiPq<Os|y8y<QLm!iu#Q#mkhLUtu1z8FYZ4_H0>33h^;wpr(yf_}@lJL<_k^5Ho
z6JBdf*-Y%tJuY!rknumDkZ@qv2pLRvQLAhzEG|u&df0=+Sq&|%NmBrxLYEGN*6aM+
zq${moBR_fdG<+%kHyAmQ29ZXZo0`+DPUL5JuZowPp~BibKI#jF3E!7=%6IT2YZ!57
zw@f+Q_%s^d05OGV9Jd~72hn-Z(=aD%<_E6ja~975s_}w#S*s!9<Heqs7T70}H6w91
zb`=c4v)U>oC4(^W8L56AQpb;JZBCmFFAYfdsRHaagsjO|raDbl70_EFDt*7^+Y+M)
z_#LebP}f%ia1Bw*u=Tr3KeOBTi<vAs)Mv$g=*AQns|oz>x1s#$y!4i*{qC$fm(RF_
z)_3DmCy!hZl@WWo>mbuyA*st%^RBHQ-(i4diwUV|Vf4B9GegzcP(!#FaRNj{X$*{I
z)lmFR@yLM(kv!D{3uom+EJFB0aWz+J!`XwI`fO`DZF8&#1G)@?74B?cg-t(sY;U?>
zF?n1<ifFM?)f><f6;p?&lh26Y=zZc`ykERE$a}}UV|h++%Xerp^*!xdkZ(QXoE}@m
zh85D;OXLmf!krUJ`JKsP<o+dIA&k7Y)RzQumv;mhOJbsqXgqfhA8f6^1ik!^kN%J3
zH6_f_oD5$}W8=p8Iw+1lpnnXCl~K?&bhmp=c>bskWKj=-iEO;T*T`y}`Amq)veScl
zCe^B`$-z^d@w=fn(Bu=lclr&#^VO+d9aKWXoQ|A|AMt(fm3gk&vMcpIpK<Q+`tTAK
z_}98qqj94&BAWC5&qvB9q=~JP#!->iF&X$76s}yEb#_c%W7pHKx1faelwOg8ITv3g
zANu6`Gbe3V6)0UXDEJcDytEYqrGq1~OZNK-F%d`IP<^rDLh$rehTitJJHJ?Z(z@cq
z5G=TAf>yJ^nGvajW1OhiZc$xzmgJ7COkQ76e_i%6BD6$dz0+?~A)yPdUZp&<^w$~k
zgHZR(23v32sE0(AAkLVF61r(O+9*{cF@<5tI!Yzn6#r19TG|uM)Nd;(3Sy?a#6Ln^
ztdTAVf@=C^<(>67qG)ZuJY>|xeY-Hg{(i2FFIZx>AN49e^{Kqt6qjo)RK$Gck}2M{
z%JKxaZ96G9{&t7=l|IjpCP9vF>VwU$okm$~UL<L5wRsw(e+6?rgc2`A40Nf29i8Xc
zd1FGm>HW&^dac(9)wiLX_t{BDy**M#hJ7b>v3)3g^rhHK8Wf!Z^z*6+5Oju0$tI2>
zcwNwm#oApwW_8h?u$6;y|HrEa2^G-?mjq_LSp6d;KUzA!dV~l%zUz4Z<CNO5k~h6w
z)lij20@@i-R`#q{4O2qh6jTf36dDT?52=k1)rk~FP3(MLQ>*wi+qv8f(Z?Oa^W=ot
zx`jGKtFjA8tv!bRASP033+yITa+q(&ignRYNbjdc2E%Q=0Sooc;}-#61ivpeCQX?S
z&5LtTFIswt&j}W1^L3r-t|%DdnOaljFw>D-Me6apbrHj-`;Ep`A>M)W%?H`5=U}?e
zM$nE`o6vR_BAK$)Y7uS;k|%to&}EmvJ|x6_98y@2u|WSCteJ%>H^3~l$o~@~3d5-B
zz4fEU_jI3|8};FE(hoXyv2?5qdd%^?R#l3*78pDKuV+s|m!SPF*4>a;hF4rGj69jb
zvzpVDzJ!HsO1Ri?hZ^r#OM+f8LP5GFG9gOau(hO2tgZZ*BbOrjeIv^Oxwqp7{{iBx
zSWjrvsagNi{)C9&Tr6~t;y~|=-^BD0Sdnsi*w*)iVaq5LA)CsjMSRpFiAJW*JdT8|
z<_o38$v*vyl3UeBHU{T+D=kjSkG;NyPs`<_uLf^`jP$2+<%s*p0f$qHoj#ABqVS<i
zY`Q^_a5+UN5@8yjrf_epSmty?&&Tjf-KN(_V+=JY5-+3&R0ru54lzR6>8&VpW+Dxi
zu$V21-@)3+AnxW;Y_o9i)iLNb6l!5`1V)_LS-A=4LsDua&*!4{pcPk$)hC}0I%+<<
zeHEKOcMC<knCYL2|4hgpSuI1yg&V)`kh+kG^i76gt<ai64Qj0t5;5;HG+bD#i&a&c
zD>ay_V;+=M?|3!DHCWo7x;uRb+Lh{n!I2ONJ8OywDGe+u4<wmcnI}Vb+ELysp88>(
z0%;#>4OS_XK|jZ^|1wTTiJn6HJj*&>L>#VlN%LzW>N=1m<;N$imVKusCTJwVfHd{>
z`gpjTrr(g~>pJSdO?8-4N|d5oywmT0DAhbh59c?@b-`VV*XNELk+Du2`2N!H20Ze8
za!v}xizUg??O+d{3H0t+KRd+Tib+6smlY;lyGw-5xESmSfG0qkujM?HpR3ReAK*6<
z3Eo~)#xNN{mkU-`LnAOBzbvtzbu1oS0l&7Gm8-I)=il;)RIokZDL>RZm@mB+KoIDj
zX4AJ3t-7lGS?`m{*M4_M9~4%l+hAkptgM1xHbBh4aAi&sS%@ORezh5?5jFrngXI?6
z(x(;~fT$VLb}afOR*KwD$~jXGLIxqpQPw>%0J1pGusPb2d{oV($%$k7oZhm<t7iaK
z90q<QEOu6zgRF;SWst!$>JZ;)f?c87WS%}dWgMS6TvsVtMORDb7u@1=i|#h-L4x|g
z*L;rR?iLQn4q&!NRN7f{&*;mbE_o<7?*S?TV=4~0waUyv5v)QVg1AqSd!{PrIc@{l
zq3gD++5`Le4IsA5Vl?$ve~gXg*YL`EHQXM$G+XT8x)CU7V&mA8wTxrm@+vFUR*1o+
zAY!C5pgm#%Z(!E_m~%}8!`dcAutmj`W0*j)9ZljO9U~qwt0g|Ivm14ra~8H)C;aUr
zom`n^pX*l6L$g-3<O}}zK6>qRgjKo&V;Ey9O4G}=x&BGKJb4)-s~pXILVjkGH}<5t
z3#v!1#k`eFj{~&d+VCb=ZklAB^=;xu$o<-PRFqRnR{3kcX80>A8Mbujlfl$yr@wxF
zuZg(NW>j_SmiDqEF`y?6nxVu}{7YFDv#O848^T&Rs3PWEFVnXLXV&e=9l{0=vDZ(~
zeOWMN*5)Np2ly3v7EuGNF)l3W@0*MazcoAjl0c}z@AHN<7%@)Rm7sgyZ6P^&1WhIz
z1?BB7k}s-H6+7gD{jIjSO`5yx7v%SQ1w`e``n+df61W}@y!?pD4AkDA!xIM&H4a35
z0;PR3-{jvli3b{H@}QO~<#$P&$X1;e5l<)na?8NCG!>6M=Hx3Y53L^fRuOeU&DL$7
zsOYg`gACUz+kI9l4Hb-+dd|4T-!Ul9yWsA7O4o;5wYE4MKGvq2;2hvuQi_Y1swEF~
zCo`FBuR$7?3cKr}1~J2<p-PEJIT=)^P^&o*lpG)6D%GQ0>FloKG}rer#si5M$*5pT
z=N!=kt90Z84w-pw6oQGck>cnXn9<ZXq*;EE`Hheluc5MwN)}zwdGqiSrW;5q#Qpnf
z)cud0-;Emkh*3q88-fHjM%SOsjn-bq&i_GRlM?&aLw@#G_eYu(v&cM#CH;({1piey
zD;iYqjgilg{oU=Ft794a-j~hm^lze@9XiWXO334!hx_8o<<H^7g`QRT-$vxR68d<L
zEN<Z~;`uu!VxaeVfF@7f(H@7(NON0}iuUA`zlt$6>+*XP-onIHjE&py(P^KM37GJb
z7*vw$d@Jm25)m<Ld~IP)LfLTTN7ogzq2_L*xT9Us9iv>kU8l=Bg=-(k?@iPHX3XEj
zNu#?OCU*B0cN(HN<vs_JS>C=4g4fTK_Pfb}*2lDse-Kj=W3Q(7FW*wuP567mg!)Kc
zj1CavbXH!p1zSKFfspV}16hm0%kbfAsqVE^%Nr0faU|aJ+n31;Em^(0PsgR^!f#oq
z=n#AZ_NxnI>N=aW^VjR(lgWVTCCziU-s&-rvRa2YLPKI#16^uQQ_bW+`-R;-j4+Wq
z+zjWUyCpm{I;VK9Jh!69m994c?<|Vr^@p%bH8Q6;@+++m1gApW80{O-qyGjtrs=Y^
ziA^B{&%6KLU_7fX{*#+i{XSo^rfj2<Sap8Um20ZHRZ?wGMJhS6ECYkdx(}SWH5YOY
zn50=R?N7VEddB@Ra{$+2eS;wwtYpJ3q(u}H+|jwfQnkNv-)K@{-=^-8!$_I|JArRI
z_O(p{_4_3cgIl|V7wuF71HL9D`vqv_@-tWwxh<95$VQiWuJG)%Jh~a}0v=eKgZqA8
zb!#EauU8~|j>DDkO3X%`imLi`0X#t#&5Ckrq^Y{A{at}gmqd=%e%z0W5XR~d0|qtq
zH7x@6RhBl{=VIGq&yNBHKNmm-+Lh-Lrl4!0iAtg3kXaJSQbq=k^#TV4+Z$JsF=SFC
zImE?6lZbg4VY#f55Nu}6QeRwRANq)w8D)|fH7&sAJ(Vy~i(HI6p)Cl|Xky4zK4N*&
z7QtuHr~8>~dbbRdr%HAQN!oA4IS&ZnhS@03JLzbPxXrW~P;yt)fN85IbS|reOCqOz
z5PympS#PCmL%tOCz~!F!c>u>YRmp2Ekt1ezX!5uuu@u_QEA|FR`2Lu-Q};D;Ca&7?
zn!=7J3_%GloR<ua#In4OzsPh}tc+)uJAX7H&M=9BGe0geR_R5JnnaQu&y9ZXH-oan
z@-aFq61r$3jfJO{WqEXflgi>8%^Yr(&b%M5e8v6O8!-BrsMl*=yHfscE3ysrT6rn>
z04)99p*dqB4G+0@t7kv$Ug4F-rZD(8=auyN^ndyIJZ=HWB1Pw5B<?huQ%69hUq8==
z4okF;TO;c>MlwJZheP5<4G~xG^*i7!4Y?xfXE^duEiL$Xm$Hp1iLy&vLX)*!JRHT&
zd8pTqM6)ie?4g6YNt_Twx-$0pP!9Is(?O04CHi+kZDp<+s79YdvQ-@6bNpP8uG020
z)1)^EY)S;5rD-sDz``d9=uJZ9a3yCWvswZU%Kx{2@Ci0^$zQ9bp03`J2a1y9hwk4q
zSt_q3PM^TfSab<GN|-yG3sG-qnF<E>lTO7qhDRP-RsLE~{cCqFvscrFys&Plv^AjB
z6ICFoA+Kk9*Hm$(WT_~!fQo$DBLndnc6VZXj3$B+J5$X`Ol4{Q%*9Bdy>_n@zZ^}M
z#VAu{Nd!Tf-D+CrYs{kEnN_1=|E{Z{MsBg8R9UR!{zN`6w5p_GC^NZbk(~4lsoM|X
zmGwNsSnS8?AVGSanRAu84GyX>$zz=5J73AT(KmpB0kquvPZJk}=5j$bLZiMh?KI|u
z>Bf2C3pmK9`TPygS*TTE-<f<@2OL>_tRr6SPz9*79&H%a@y))LSTw>xX-#P>KXaCs
znr{x^L=P5aU!<$7X@;4~Q=-scFq?Oy5-05~n&{l($M3!Y^Zj5FU9_$JaL!;sqPA#a
zxQXiG7#`&60Si!~ES8{hCMKzxwdBD|%+Cre3teQ4I{mHI)pXLR#z=mKZa|R=zD-9@
zEsNC*orIeSw#f9PPjn};NvY+1dh-UORWp;~Qx5gd>t`<;%#vSxhNdBpLE(qmR3n##
zDLoA9@Hnfgg&aWwL287(@`xRSR^qAb%DodJY0af9%Thv<#+>kA8(0ou7pFt$2K<Le
zlsB}6<;!g<CMGtefu7wtMS}JiSIZ4SY;3IlP$&&vtcAI@E9}JL#!{HVc`)6uJvwRb
zBQtM+*1M)TwFE^8paf+gvah#O!K!5hj^eT^(vaPigPkKEz^N9%G&eWu-ketLt^mWC
z4=Qm&U$ZbkP3IN!U@_>-S`bJ%sa)DAk3w&qK*?qa8EJULsSi#Q1}%zPB^^yYz5#n&
zL&Q@lBu@o7uc!67H;k2O8`BF&P}`E-90vn2f|he_i7N0VxrTnZMes;-Hd-GsDy(sC
zd{z}g$km{GWIOpD849B)TWK4jKd85Y#SAnedUUKvu_?R(vWgLS@ZT0VF4Xn0-3<Fo
z+AxDSq~<Xr3``v2ki=o$dD7P+lJD*gXtm}vYja0p`XS5f<fMyN6fkcdYQ}Opnpo_G
z{t8q<=WGD^)e51-!Fjo%(qri9cJU2(u-bZ*O`-%9Za%~zV1-?M`uPyE`!Xc|`9)(7
zMO-&IN;-sdhzyq$DbczGN}eJb7urODL}l7w9eVhbHZPsy++P?}b*Oy%P6wroIFmhZ
zc>PP)UIE6HYvo3{)Sho*LwSYr0D~N~zjQ_qZQ6Tu=HYPagn}MfV!x7tdX8QGbs3JG
z4osQhUgik%k+M9So+5{Ziph0qN;ys#xBl3goq;5j?4A&3lZ;HIykLS~GC{&)f#$`@
z7e!4q2gCjPNref*4v}GJ9OcNjHM%5I^6D{CU8RxZaq3s|Ev=x}0t-x_HA~PKvWsnJ
zgpq1SB#kS|+*=o?@V;#QnWaO%`-06OAzQ)G{*nFo%LYuFk8DS-S9#YtkrGqU`my=B
zrT}J;EY#)8ibJtnUE_bm?Y#zOM~=8!RtYa}S)U@${!4*#zVWgo9uLgRTsutnb(S|E
zGUp*Fd8Ds&AmZ?Sep1(UV(D&8l?ehTbJ0T(3;onc1Z&TCcqFN)Vn?ffm6DPfwf6+G
z=RrDjdHBCAcu94+%FHtz)>b-t*w&4W!^CxDyJNY-M`ZqwT|)#%{OSgA8aT*KwsbZ-
z|D}2Vr9l0dhV4`-co~Z_>IaUMxSb5hkik_|DEXwdhN;9cqJ1)MqJlKM;`s>P=gSrN
z9ohjEtn>j2LZy@P?C)Z@1=DOs<4$Q@38gnsdt~frpmo;zh-(w2D9USN6+4QoczFcJ
zud<eKO7&Vs*@xmKjgk)$Ei|b@;L<}_N&D}|jKb2=8r_pb5MrmB(4%?As<Flmu|}-g
zG_e)g(iCgBcqO>=?0AL*E^8J(4i)g36cC0ag&v!}+OKVJ<#mf~dZPvzbO^d>n+aiI
zebJebB1yg^E9skFA(W>=_5KYS155|^i4nVqhY>M^Vr_~weQy9eBCDMNmqc%ySbkIh
zl~NSv>h=>CMhjdGCr3q3b^NI+4r^v^lEn_LdN$2>NrLNqbg^$+`N%<oSSCo`8P~yb
z#KE2D9&LKiLXW|Ai!i=EHr1byo`jYfM>AHo1Q}=7o81L&Md=Pc&(IF{bbk8Y@QmeZ
zGi35P3_}b<48ZsEfnt|oH{~ivgf)mGqbcDfln@7tKgSGm?dv*6fB&^)1??i>F2<*_
zEZo}6+eH2D9Q7c1yiNS^cCAHWuKIPnF<=?B@tud{ES7T^n?efXIipI^63VFA&UvsQ
zHM*fIw}M+^la0|JojD0gK3(YIR?Oq5hi6b9zJJC&y%jCGt<E<aRXiL|HJcy`BlL8K
zWd2wt0pHmUxC62doX8KvePovs#Oq_tSn;=DDRnHcstLWlTYr|VZyl+3(1||CAUHAN
zVCK|A=WAeF8@rIi43N=4sxw^SC*-zMQN|ybK{z-|MCsN<XPn5@-T!!?;a{qF1Lo#e
zX$A;)y>wGWs2<q{H%4p;T$acVtP+@5hTJM8+&&`il!qO_X7{=IrusC&E#dIbJab;V
zsh*vjdlnaI^+&>RsA5}vYNYpkUP~q}1{DSH`yna1f?2hZ6R`i}?hgB@oW6nmU^AOb
z^5csxnc8>$6sO2w9Ie<4FC14?V<&AS=AYHUJifD>#e?VPrq<om17r@LeNMbF@XLG(
z=|qr1&<4;e2Yj2=9GQrB$D+&*V(DT=39^>8!VJD3OA>sY)0^8lNJT9Yb!_=ceW5!w
z&?QsKViK$PFy1+euFsHQAxpc1pj}4}v0l~%rS%3V4FbzjJK&STecxu_QLhz#>n+>L
zk-Ul|F5h2=&7P@d9Tseei<T|@(ooZ~Cyq!VOg9nGK&`sETHFr#mX<^j??9A$BDBQk
zjpj97cA6Vv=nI=k?!)+H7k41b%-ld-<RYW#ilF>a*`1b^z(q(bH72G|F2Ztg+CQ}!
zRiW147zdBv&Taj|Zut^%Z1{j@RiAt11eP>wmf)LPnjkJbCTK}vZwxd-hWq^-(?s2f
z4^6Y<x)f6T=Ej{ig<{M(@2?%S`h;A9x@PHzE8wdT3Q3Xlmwv_KZ<keH)2%7>QSGDK
z@~$zMxHyz}!tTO2;E5av{2DEx?GGsY{Y+mi!}(yi{>5criKrGPeR;!J1C<PvSt>gs
zw_U}0NR9r+<v!oL%WFlE=@O&j40%~`uAHl0hkifY)_|M|4MmQp&~O_iu2+{Ab*b%S
z0z0>x(qZl1RzrlPcB)B@#*jL`YJnHAzKb8mO1P0l6t+(DT*ir1vD)Yyzcog_6T@no
zJGh<w^-3ewylEu=leehWcsSb;=A~G|+_fr9X<TKz3sJnO3Wg!N9c7{d{ZGzhwPO=V
zWDf4r-EP6T+*VS2YuOs7_0$g16M4$UWg&?uw#T1twvw?55}IdxIG=6}QZr*r{mmbO
zKef&04D+Uu`!YgITazo=U+N{`8#wHxzvSfZisG;a%Kor2HmZ;dE_NUcXP9mtUzWe<
zFB2`Z@#UU5@qv612UV0+E%J8IC%Na1MH}vytNeD!^|CN>P55H_c{`1H;vq!vhN@sd
zI^CV9f>&DLUFA#Sj94vhKyy8Ec9AtKAFP1hd(#!192^VG)~~%j;02w7FOtRr^z1S(
zH+CP=-nESl#2De_V6QAVh`g{Fw|)r5#Fw9NihKzy4IayS5_6x}dnF3H93ajMsSunj
z=WUiyuWmuTX07=h%9rCQg@&wst6sjzJ-LmyWxp}}fE;bukOG6BJbs8i@Zd)n4z0RX
zlbM6u$J*a&EV7U66Oj1Wv=f&{iE+CD|AhFBD`+J*#3hAjlDYDlBk>S(iAC18mqU+S
zAM#c6X2o<OYa`^9&S!&Em<I(}y*zUMY@<4=b<X~W^yJFdwZ{tHf@I%{2{ifu9%tfT
zPK8O4vMRW%D)@GMX|^zKtNRre-=9txlMJ5G1(^pPF4bu(F+SV^g7La+x8J)3#VRg@
zaIq&oK~)wcG(xmq!yY9n+;i788mr`a>W~=+$TM&%$5pr@+rThnw|3D&lS)4bPjHGS
z?4R&Sh=4lyd=_Ledof-zisTLn-zw5;@<FCTZ4ndT@y-r)_7tM#`$W5dCDoU*k@@`5
zv8&G*olZ|gS24ItP%i65im9fw<?EkUQz{K~s1um~y?T`YqMGGDma9x2*T48Sf&CVg
zhwb~GgoHXtr}U|<be0|n`rt~QhD=&-71+#19?v(VYuDSZn-?S;hL#Lr1@1%<OollB
zziV0f=Ki$NyV9U!5qxVc%dyt>l*Q`oEa()axFNG7@%(jdc+Of36%2Nq7};^v-qpK1
zt@lnVONQzXHYfLgHP0F-_kWnREKbZ5?Sh((wQJ_9vC8`iB5#0)cR-e<4FY!=ch75Z
z!YA>?B|&?W+YmTC9w+0w%H=AOKxKcf0NvRQ0j_i77t?<{bXjLr!#Bs8LuIlHd$lC#
z6k!zWbREk4OLfZu4Zc6RNrDvU1b<slBa`>}kdcEAN4h2z*I2k<wLG->^dII~R$Z+4
zQnf6mW%^_u8wsiVCaqb^O$bi7B&?u7&c2sDJbMHOL+1&o!&BJay8pPhpyRFRXfWAJ
zR6k@ALqzPft5nic{>gWyehE2KZ;ffo>z~ht*`L7@RU)c-O9PW<q8m_4LDh|m=PSM=
zphWlFsNW8!<Jnd17VZt$_01rNy(7q@{h9lrJnBM=^srxjK6R6(>=wMG;X$N3Zvwo0
zZAqMg+aku8nEX2u{O4Iim4p<L1J0=HFqu)?7B*Mn%Mx5lZ5hfgxd?2t58U%&p9Vz`
zYI{F$7^{b;)7PKb5Mzs~n0IMrsU<GJ&dM!8hI|RmQ;y^u$m@C%mVV%lgvHT(c4|?5
zSEuHls5P2WlZ6mHP)P?NTQf(%U=R&h<Gd3a5M;W2Btv_zsn9$u%@tn^`Dl}CEA?X-
z_2-nHO~J5*hga_YPxXDv<s%m+7+7nTpj`NfNT&t{ferj*2l|q)-GOs9xwHtST6{g|
zshlw%t%MCGRhxZGS9LMz#BwDyKR>aWQj@bB!fG1R{My>(M0~$)`vB{@L<ZT3eTC0Q
z>tSJ@&*Y^{@*!6eRYka<6tS+txx&mQx~$v8Tu}hu`e-B^En&w{s!umF?cajI{nZ>)
zqg1_+s#DSE9w$T7KW$~8Za6(uNv2S12gcbLZrU-ZtKyHnqmG@+p7a&Y0w^Vy`Fb2|
zN=eOPV*Hb?emcZit<Ev(lNBla!IFh+KmDbR9z&h~HO0|s;5P?-@fhu5Gl$R^dp|Y!
zO#}yb<pzIhJ_;9^oRH`Ea!=(70t_0=XzRYbtq0YPF2^vMN>-h0w|pmIjU5|hyxY{o
zrmn7vYSB%o-dDb30bVe60zlm%sh@~^u(JQNXa9JG!cIe2x(2x(x6tF)--$oxOf?%A
z_t>%s-|r@>mRI~N6WjKcAv-iqg;qu_84^ZEz~<y|UGVv|LJ6A{T9-o^hiW=yA@g|#
zc?nYvGH&o#mIg_Xq$dwgOJbOxp6`^sn*Srt#~MQ@JkeZY$ACczCY?&f1UhVZjNFKh
zqEeHNgy9s$#Ds-F^9bs$VekP=R%|d8j=4hN9nN^jm|1Hzeg2@iMk67cH-PE4&x!lk
zHrIyLi@d<JdM<WG)n{eISTg)^EvUe$Z8n|gFM%FWpA@v}qG0uN6S*oV6to$1!fX)d
zq9xwnaqf&JE3bPcV!nHp<z-+Ls_|w*T8oVwoivZcy~EvQ{Ef={Vf)^a9OK!wqx|4Q
z^y+p=h7|l@Ov^_A+lVRJ6t}6iXRLlgx`f2)2UHlxY~CS*(~=lQ@mM%PVZoFrN&7kz
zYnXABPM=7gs74y8Mcx<LNZ?fTudtRGm>7FrcoCngUp7D+cQ7y_ER<23I;=|yr2sg<
zBf3ihHP5ql8{Z`{k{HAeD#-ddvtV4E);YDgfCp+tRAk5B2K;8|Chw26oa6SRhHnQG
zhIm?$T)Yer?+eTIu>w`vlO~V@tJbvWKO=;TL2F0azAEA4FE%&ms}7*oGD^#>+UHp6
zzY@uD9hBQeLoL`f#c3BygJrOJ3th{baKbbuz*;vjEi{$grr^j1WF?<IQbE&h(uFfY
zFAQF+Iv9juwQRPL4qSu&(50?MF;pKHo=GQM+vmW93)4Op=2&JQKtF&1HxiNuug1?_
zUSW6-mzP8qri$p^R=-DS%6|e+7wAfE75km0ehY`HP3J37Znx~2B}cw?j;3l$J)<1W
zvM%dG&n_R;_0V(nL*`ulQuhQNOHR<}SzTlE|HIl>2ek2g`zE*(g1ZHGcXxM};_k&M
zCAhn5arfd<+@V;}0xcA1akoP0%lCWl{oVKef1BCN?(EFj+0Aa|%#qI_C5a+3OpRg0
zm@y4?($Dw{Xh^&K)x~GTV#>|vgX~{Dy+vb2pH0xuq>0GXn&TK%i1%@ae4K=)!AY8?
zLj6Wc$C1ua(QXruBgOCyJsJ{q%5X!ZXZ03I<||Ba<2LsC_4Uo~=Z#W*zFCSS69>Ye
zK!u)7#GRd)e>UY3KNF<V2_~dQp{(phS2CmN2)kCe7Mq<N5iGF7#v;kyuS;zI>{6UC
zBWxT<F#bsn-7d&wo;6&|%B1g`c}MK`Q{{wXzjG-2z4xcqSC#)C1#%=KB;)PF?G?U<
zN?QVd5GE<zQ{w-(<EiHzp?;m^#wG<k)JdwUQJLDl3sIzi1JeKQD6D4CznlMD!fmoo
z7M+gi)Y1Nv(s`;mkw|v6sc<<)tp@MK|JOeM&vmyEI-EZ?69^ue%2KfTYGVEcyh5+1
zQ^uDjJ;uZ8ztD#V<KeD4rpz8V#p##kJDc|N?}Dsxj!KsV2*hZt-AuFEg}e<_h%-yZ
zws8pLjma`+5cxKW2yTt&ljJk;L;Vd|>vEWtqevwu!!<{Ae-_Cvs*xR)$F`KP!fQf3
z(ke6IN{bhx6jD;JRe$C7)?#Mbp+Dq%#1E{Eyy!k`*d{)v(Js3Y=vNirm*k0zI<u<9
z@i!6-&lrRGIguT<uOU!WdZ?Y!I^dgo1Uuzbr^fTFMA0`CQ;8pLA0Bc-#LD}&_vF%)
z_7W*$E@*1|<>U$I6Say=vmWJlVX7jZSJ5|l-%z$-wFf5RZ%ouc4$F!;6$qnUkv0I`
z3<`W;qiL4&_6kv*x!duy!}PK|5k-n|=}b^hFQUra_C^Qu94Xf^u-29C{0yZ&eZ0*g
z!U`eE4h5)J^Miz}b@K~gqe;L=K4m%*7mKEfoQsT^F(>Jx4I--|Ton}$<QnsEiytQJ
zCH$u!MT>J7D~l>*ZC}fL0)2Mri%b-Fz1pf1^&@Y+&^U+JWpp@!D^x2^;z|dJ6pS0y
zHw1=bsH0jc9Tu8eQo^HwL0T&R-dJkZ_7dVUJeM5!bS6@<!n*$Bi$HznzA!xn#!&-$
za*F^Wry}Vftr@bK^28SU=CPc;w1zhLR0Lxt>mt4^`Z3Zg;|Tqzd?NU%o|Sg_tD}F`
zGvYE_R>T?>>Qwz`Bi)4*$7tp&XJdQiV6G5Q`!C*XlP{^vt>zBd4W#TKtsnkd)FWdS
zk_cQiD=mu+o33=5S7`mm$Ln@+zKL!#fiVtOiu2{ZB&T%)n8kg*RLbD<R7ks4&D%8o
zwY`-#^r!)cjm;O1?7iXBDkwV-S-PI}A6ogv2Z_Qls|WMl-wL1kzN(&VC~>I}B4?|R
z%?t+>q4pU*SM(D6;=o9q#8B~yO;8F9`l9(MO-;`l5>`h6Sob>ox+@auupFrnr&)pY
zo~U+@x0C>x?j1wv@{UC>z%GTJR*pE!x?4-iw~8I)iob_iwyeO+Yt@z4%}&7?c!l;T
zRih&JzDNDHV3q#6=|tOcq-A0YgzyS<bg|c;WO;;z`esz|NFA&$c%jNJYi4fj7FG>;
zSN>Tl=cHc@<huEIUBTV9D3mHpzS9B?gh-SmYf9!p^|*>%6pAYwZ}A{r@P$~5i(gOk
zAZfmQ5It|_ON_>n%-)1v-F?@~;E`9fqrU*(=xgH(Jk5Lk%ajQ+mBHebM0~=Zw)-Z&
z>VkSpCw{xw!Tn+$Y}c-ek4yZ>g_iiH(!5R_r8C|rB?c}1sX#dZdAcUDCgE?BmKpdX
zx<n2xQSB)|@1i@_FE%6bw7e}(!)s6E6uY6hp5ICph80I6A+;TMyc?DQ(6*WKH;ZF-
z;urx2MvqV^^GsZ^YemU`nLB0}Q)W?4^I}HpO*)8Z?Tk(??FxO^9i563y8p>4OgOrl
z3MU%1nl^3evTjhm$J{!MFhMY7&^9yPj<Hcok8?Qz-M^zpE#Q-xy$;QYf7BJ-H}%wL
z`9<!Nn1W>^AN8QOAKy{qpC2J(FCQ5d>3(mXh(h`3%i1nH9@9_1)*@ndVA3)oWPa#1
zRVy@@tk_n^;2X130BucPr5Sff?BEEG&T#BIF_X<>DMg>Dc3|J|h{?<*b4;7Kd{^Y|
zJ74Gs={FOhXyA>l!mTB?MLTYp3K(o$_jayB$8wwTNPd<f94<`$qw%wirS$0{|BrjJ
zbH!On&sf;=TQ7GyfBqQ9n5=uf908O@r*XM+1%nWhwT?KY;+}cGyktgBbNn(rBWoS@
zI@VGfLER?Y8Rwx$+*XNdN8`KTKX&5hUlcDdL)x9YBR^rX3>xe8OT}#CVubpO4v5{i
zn6!p!JKm<YM)gTr+VtLwvM_i$nw4iF?zYds?f>!wrL`w+8o6Ef)UvHIWnIcNY@%{#
zjiw4$X6=D5!WzVh;S1l9^Pk%I8SMmZQMXC(VW_dDksu1|rwOF~vSo|Zd%?%tH5SKM
znishj*0V<<tw&$qn;~gBBh`^z771=-11}2q_)6UR^r{!8DmF2;pg7YEv9}Wz^sM$w
zrp#<O+PE-g7te0wVIr7Bx@14+&kZeIk*XC{izsfw>%em!XpSbX7Crm)f<7wa$BacK
z%taUI!Q*SR4RWX@T*kB=8r}+eI(lN@?F-ha-uoOlaQHb-Sz?srzO^l*h5C|V;Wrog
zFfH2*Z0*QJGU#W{)E1A$wPayn8TaW|GFw$PxVU$A^vt{`%t@J`tpaj}=S^x^rd~OE
zUt|-6i_>L%fs;c8Ec+>>cW#i@I|p`iPx$9n<h|3XIF^;*KHIwb97~w*1{>>Udg=ZG
zwk2Rr)Y~ypg6Cm3N-e8*dP_4@K>KuR0{(<g4a{{gJ|v63PbK(Mrq0{`2@jVI+C{d*
zOXP5NA?pR%t(Cgw1EPAH03ve{Qm?)tUWM>a4d242X#{z7YIj(+UWjpx0$sA>_ZL5r
zR)*b>GPmv+{vzpB)gC3A6!rj`HuyRJ1q}VBOJYC29wHsKwU3z+%`>w7f)-11#M!}a
z(Z2Z;e$ZdSMg&4YGH$g?!h@^uoi~tEJHN)c9On%?p+JA>j)^QO-iYE#aAiZG8e(9>
z21*cxUDOZ69iolHSa*S#y(j2d4ajmV%k_ip+cpEN(dqu_3-1&rM&(*DV&AB*4Qnt}
z>E;a{PWjRfDH0^^&Oc0$>dmH7={uHtLTqpTv@=Si(}>5arEPaFIrz)`G3#VJ;Q<kw
zqzlX|%S?BiEb7KIzWY0f&Ta|g(EczT^1Ta+?SX{Ky++UFzETr!)ZvmUfgXqj|J>8z
zRxW3<xc5OSJJC8``*c3Yk>vTU9&T4E3FAEK(&!A{dxXG~hH%^BzknUHls|K@sk8W0
zV3PTix>cOXEcX!RM!8~aq!A=vrNVDGNAFEKzOV6#f1eV9i|uLBT=x6%?L6|Xpxp0U
zCZ^=&&R6M*a}+2mKYPaze*oi^B1b*PJ$_hCV^cS=mGy0#G>07y)K3v0^!|D-n|)Ct
zED#lAYogvAFx$_&UNd|IMVQ0MPSRr<;p92&%Pz5@xSATeveKwT+rUnl_IShVN*kdp
z9*@LDki;9Os<pokZ?(5c>({5^{TI+qalJSRiNlXOCswX`8p7N*ryJ38@i!Q1pHjd&
zt<$tx9`5S)xb&W>T|&>?bN+g-ZiactWW;{_Ms`s$cML*%fBNEb+kL#-K5mqEfY(_Y
z%gG~TJE&aa!anmoD*=hNa$!1sG+n_I%uWZvr&Ax1DGGXf=BwovMYQv{WErP<HGzvC
zP%%8+(n#)QLI|A>P(f@cJ9QFUQ(UtqKgi6balU(iE4a0i$JKAE6cz0_HQtt8##3^8
zXpYC<J7R61$Dr?8EFV2jG%XNE^QYSU^EQr{J%={Wujq+oTHll~Ry|A`kWXf)&z085
zw}RIJvueq@*Z2$Q4*B!!OQg-RK0Nh1_=nb4(k5KJ54d~o?Xi8%zD7omXtX&SO^cB!
z0A*aVHVZ5xW7RjvYMwY5ecR^reG^3E%M%p_&eK+yl}nAiR$~p-tI^>*9EAFhY8UP}
z_Hlek7j=f~{OM9~ZO#!(Y4}9dea`Cj>GSLDjp#2|^OPH*CnF)#e*t5iHXKL3TreL|
zLA%WNzS0CDeWqsg@BAiXevqoW$`N#tmJZVPD5sU1`Wj%UbbREEE;y`rg(+T_?E3B{
zPcys3zQX<*q#a}4->a(a6BHt(a%ZK=u^5*7e=ra&M6oosmua0Fwh2Q@<iN>4Z`gh%
z`6Q0yzbR+0Mj0M8Xs&>Q#4;oxXU6sD^~mK%&8F)R&~J2L+uQbF(w%e#aXS8(nU8tb
z!l|GZv|zn8S*x9UVnkthm}YYJ>Rd2^r%2bMP{vs@+V&3V+^lOeck?)V=2|o{=nqlX
z_s8>W?WG95rB=KzYo8_1sa6Mat<qb%v@UcYt>k*B3BSm>xSqP!a1#_#jD_|M_fnKt
znSxIv&kDB7mOlYWcNgnq_~|AHSFYHS44fNNt3sYl9gMFCqSOcx4;@M_uU<c|#W$j6
z@i|C-Qe~<Lb3B+p*@ah<z({OnO75;C6UVHS=FsrVbo-L55O6M*_-TeLO(jO(ko_S`
zxiR^^y`eEB7810K(zdRu!n|eQ-Bmr?szK}c4%86Mj6deQMfj!YNBL>?+5X_+37SK1
zMBX>2VWG<J0~He?oNuy}%()N(A&ZJ_wuw(WK9zso`~^5j_=o)I)6cu|?HlvxHG5mg
zL1>4A!1!Prk;o#v;1Jf>w0Y@l<t^}hpZBsx&LVrorSb{2)NpvwrikG)fAt_~cD&=R
z;W?pvm}A}r`GW@QCf#VYv9|3ZuOY7^t@TsApwF2vNF_+gpcOMXOVCUnKOC+sv)ZqB
zG^`ySt=Ay0<5Y9RCl}`X+5ZN0e{|R$u4<CtTPZK*yEL!D+&X@oj2VC9TFFjhXZq3A
z#MmF!EqxAdb^iTMmPz~>0ChqaDk!1`*;3eu_?k`L<r!Z3mY&<1qb*(DUjUx5=Hz7F
zU|og(`de|ta&$cD01-TW+Nd;&S$^{O?EYu#Wr2z`p^YUL=d&D4K~Y*t<om{mqb7;b
z1RU))@hSm9eFm>nU6Da;!_J>j_Af2}m>3<6kBnY^Y~xfS-??Jm5rI5%bY^<@P9fu}
zH1M|xUwm%E-EMp^2f2SVr}ibX&50$cGLWysQ(kEbjV53*btlYeY<m>H*7J^h?+QsR
z?<1p<JxkO<-*cqIj<>|W%yrjB@1MjQgJ?14IeO4q8vUfjYI;=pX^j7=)A}5=&FhKE
zzIf!$>a@^^_|(<M;EpV8eCHE)gg7l&_ZQH2o^Zaoq<pAmpV~*y-{&iVn?Lti9X05{
z_NnG|ZjUYb$5muy&(VUu5p^~uMyDNTmXodNl&!Xso|U63vy4f@UeNQslp)O+{<#|Y
zZhkDy0GQ7mTj|EP+w33;kucXdpd}a8m)l_qZ-`XP1g+7qBhB#fjmnOjr+H1eqx2y;
zP38|JsY>k#T1D>4jv;HmgxTyctTe$*$n3736)Lqa5^p7SA$O}}tmqolgzN;|%sY%=
z*t|R4{X?);gZ}duvxMF;l5vt-kF~#mgnkA#|5Oz+>p3Y0H_xG}#kOd5DOX4$6QYhh
z<26Cb#p>Hdx#ISviy^m#p?Hc|PV14Ve%_iYJ&o}^E?#YE6~;_rbT%%)a8xFOK|LuA
zt3ykpa$IehhnCc)fS~a$ha2&M-UyK|8=1)_uMll#g#2l>vx$m#m}5yFcPcMZ^{+9a
zIC2G+e0rZ@uNxJ3R#es$#j!d+-&7`L@Z@5F5w0@Vx?B_Cdr)nU^C*!C0ZU&cy^wZd
zYVGwxVn?r8S<ggSG7eGhMqzw!Z{EjV^7^l@3`h+(kssGENQlZtMn~7n-|5Zv<NMkm
zR*Tr^;`He(+w{n$ZkMfEdJkK%`qWliBQ{4O>m}2%i46<26|P=k<vh4z<ame6(+;m^
z-g%%oEiIYJ45vVrw^un!jFHhE^*ka+r=Nmc3KM&1k-eQqGb+>WXm?1bDp>0dt6NTO
z7ZmAY%}*aQ(tT2kvGCT=OP%oD(RC@?9j(FRS6mjYOww9$?L<2C`}|3~v0z@!8j?sk
zGN_@i81IS5d|*adTP)s3t0)1d!x{|)F4Q9Z_Y*R-M<gmcRI?|)ZNFRCRSR>Km)a;F
zFB=%xe!_rqd9q!K0Ei!5PjC?%K_)8N1eKYsTUN#oCSRlUrCZG}z)Tp7KE~24-5p6P
z3|2v8x$)&Lelv0IH%6xqg2uEMhK+HC{4BYIe$_`(GtCFB-;m|m{o?E0>D&cp=2(c!
z?LCkLAdRfhN$u$_Jp-@E#@}e~9KWj!GYbjIrcO#$cEpB9I)&F7Vo2IAe<e@uJxbh@
ze2DcVknw-Z7*!Py<}XFOR40=uwE8b?gu?oB8xL`bel&=BFEMWLZU$GHkBcK*l0QB7
z^PFeAbc*DS84f9tfC0+rPtAkOtJQYFTBY{Q3-VQJJpY(F9^S;*?X5j~-vc|Lg2=Kk
zBGo9y72c-ubd*Yl3a%g_At&GT&Fq$i&!3l6f>;<RZ~`+eX*0c@B!~TsbZKC2vM}pU
z7XTV?zkTmKI~3$KA}6ZTNMg50Qq6~~d%YChE;hyiwoY?i#Sm0Q6`4RiVxb@q?~fcm
zY$1}{B*)pz<Kv^X2Fs~nc?$NpQd(0*E|z3HfJ+)fIkbO~mZZiz{YjDh3pnP0fxAiL
zz|h=)$S5fA$nXg8|KPs?VNludU|ec0DJ>8T*)24+<&uhqlUuT6Xi++CSI5dLth99x
z0q=^|1LmWkY4Kk`l)!%>-1g`QYW5L9@P_N~Q8|T71&zM4N2&(_X1Lh~zoYt%<w>X-
z9N%}>Tsn35Z|GGs0*tF_niw`2l=W5(vLKeY6+D>-?<Wg-dJbFH92P6lvc!1~&QN$#
z(p;I4hmvJRSZfJIQ_`fI`G7~{As=;p*6(zG_Udx?3>-B!d3lTur?iVuo4I%&)s4^4
z$w@+Y^BNGI2g@xOR}6Y53?;PmIqUX(2~cb~@toTqIub$BQ?+WEQ0<6t2SsE*_j%!l
zsbtZCN|lGpUz-i6m~EZF30cNDC4E3nrM|;XaA~elS-^dqtzF_FQx==#j+MH$rxi(6
z^+4qZ)YDgu+pp=EDXt<KIS;=`CN&O)BlEv}1x~4}SyH$Eq4`hKE7iWCzGrDV<qWW7
z6MV_#CH%r=a#dz7sw-q&sLMRqP=;{_sl*&+u4S4wFJIXfbtf)4GP)l?e$LW-eEW%k
zF1B_FnQ+7Ki!5Utlq&I4DTKx7g(2n&((bt?$Z$tN<q0MIlCR3xsx*k(1FUw!5#kFt
zXY2Z!l;u#6H>bzriir?~Ay5C+&kU?L&ES3})=NgkK&hDL5%yh#ND7TvbFAo)$hFDY
zEMqg#{=RO9zKYikhfk;!mdk!QOk5Z=6lEc!f?Uhu6&Vxl0;N=5XuT5UZreZPGe7rC
z%ijTUb)Z``PH*LZ<rOUU{L>l=Xa?4`0rwn^)YKA?YKyBdqCb5YZhAaOQ`G%Q6gWoW
z5y!iW=QvDXvJs(G1^iC`V<|8182@W*FEp%xn|bIl^*PFj3N3#3m?lwB?%&$Dn(R38
z1qdvCK1Dg|VyW0jHM*7e`sWpa-9yJeKR5)#LEf_!HP`Vcaq+HP*t+`<SLZo@eb1ot
zwBpTY)mZ)G_G~cNEEOAEXw($r%4P8QkeEulBit{`(&Hn$+;SQWPu{!d7}6Lul5ZIg
zSb1aigui33CkBasmIkhQ_IV9mN8(t<$^De0xhYKzSXAu$Rc`KiCK+s2g6*)}$p|sD
z`kzv7Z4O~3!onrsvlV5V@e)ine;sI5q@k)abrcsM#z~i=h`(w)50JU9`Piugx4tga
ztFEU!r@KJj(9n;eLpHziVwHdXT3sphq3&@^#JDin=@BdXj-SC4BJx$!mtYgQo|qHZ
zBvdPbRjiQXz^KUjb1!5%yJisoYz+Z5%M|lN;Kteqwo;sL3VRx4u`p;c`i~)$rga%P
zMg?D;gT}aK|GXJz`gCy|XPx_dAmQH=S`ZJifUvZ_(?OOhwSZ%1zQ{O}jr0siD=Q)+
zvdcwHFiTRyj2fqg)Ao<@0GY}Lsk=GQk(I|^KnAWwVXR-@$J4qbE=F_TCUxh55+(-4
zm5&Pd-z5y!&S{@L3#|WpwFprMB6(Ja_i(O!rvqhH)sxqe@X3xICb|Hx9r7PC_x+=9
zVx6)b#k8EQJm7#TboVcpM@^E2T^mmY*fr6|aTiEmiN7WWaYmBzIp4%`ym*C#igH(e
z1A0ztX8NUNIs?YYK5Ud7;3zQMJ3Ps1P5sFe*TVA(h<Q@5Vbc&S8k|N*!<;H?($B$%
zx-4$sRhaEZIs>lagd{#HOw%N3oGxA`JCvnA^S&!(+<%>;Wc&p)5B-A{{PK({%Vd9v
ztd?1~Ss7~KF@ZH0_xaP5z$32PIR%ja5kKf&sdJDNgAVrr>s@JtmDT^1g18(m8C8$l
zi*Tg5xc;xi=>&1SjBAC6!yeh%s70*WuJ-nCTD`i$bzjHp`c;MkrmDZX8dc2GoQZSk
z%O?9D-+^k=RD~PISDmA`1^O3PLvEt#y-&l1BCC4b+9$AY?Bx71>#u%Qe%{LFjGPT@
zh_lY4DHs!qdyDrIxXFOEE#D<wNw~16`c_t_fTmy<?<Y!?pcK2(=zuK2S%%wX)_r-W
zs~`j%)KN%c0g|K{F<jY5+rcA<sA0y+7ZIV^*|1#lJCE>@Bs3XlWp>AASn>U=XPi;(
zcdFzLXgqGG0I^Pq5P2rcdxVv~lV*LH`E&g5zT7CjKmG&$qXt%rK4hdoU71e~-1eU&
zouXrO8S~MpZ)FipFbA?{LY1zCji<c$pM<0)DRg=eiz}0A)ZB^EP`Kjwm^dWtJ%rXU
z)&F}!<{SQ9&$RcSA2FZ2Nr43oKSP4-M!=8^ee+h9Un@zE1elt48~&twKI-F#9e;|h
zL==YA0x1>R7&NNNRs7@!WWL+RqEzo7YLbN;H$Em_RLOF;7<~44XMtYDsJr(u;?zC9
z$g8>S?6L6<heiplK1(3Gx6DBFx3oy?3PSsusCq}~&{a=83B`2R)_QbAcE{y|fbgC{
zm#-&zK`UM}{gzddUT(O-d$u!NTYETdj!$bOu#!B7)hh*NHv+yENLoZo`_vJtE@!8=
zwo>o6S|-Tlb)1p7EUFQgJxYeLE|K-ccUx`!EP^gh$bsDO&nD!$&-BVGdWr8zXlxpS
zW!I{vOPS+@jKk5|M&t0H_Qo1Y+_9*DK5eD6*Hk5j=nQS8Ynn7wqhUhEOh{;1@-y*#
zey~?a;?UH})bir*=LzvYlr9BN9U8uWK3yeMO+}?(UH)PBwp~oe<hy7J-Ff9SYYGkd
zQQK>Ma`?m%EFKX!u{@JkhN(8(5}NR?^`-?n_3C?#Tr?A1RH8`=-LWq6cVZ}u2=>Cl
zGg(aE=-Uw+pEb#kmRS$rxtW|Q`x6i2JVarf2Mkpf69EYSKb!|FN(Z$Tm`lnM9)!y&
z31dA<T80)cskpUwX<!V8w1*e1rbVe$+K+#E4j3lwKd`Y8+><^^vy&!+-9ow8R0Xq^
z`n|oyGjt10Y8G%b1+x~SfID?Nna2j9T*GJg(}Jm1YftaRP?|p&cVt)13uVSH@AV!6
zBWT#(KO`~jNu(rO2qB<Tp~N`WgAkNote;Ts;mf|zvm{k11VOioD1J*<y*&?w{~c*_
z5yu7j_TgsEClFg}E?{QSu8l_0h)Wy|`T;Q=S0oe2yUgAxlXmmjzp|bbS$rq{KHwvP
z`YReVZz}du7h%zI=wboZF!<_~Yvl7c|C|R5by0tL(jUVU3`CwAFxS<EFU^^lfx3K`
zqbx)P*83m&BvqW36F8#HHAwZ^ovv@cwLQ57?>V%y*QVrQ@kdzfc9PxspdLEHKDRgT
z6RvoTQFw7jmkao=Zz{RWUzK3xwxT;l?w|XoQ}0CQw2N4<TGl8)DL;vCbvN@WzpU_A
z)(DtPSAO{%s%&1BTdOlFOksE#5sLcopTqpF%=tP@9~{1j+1A*FdQmL-_(Zkix77>W
zp8d*gvfQu1((>_Gt-+qKO>10J(DwIC(BSBMVxJS6${EnVsGvM>HGJc+won;7dxDm-
zdAuFGW29Y9Zg=uch#@-dFW@RNC-?qiwbvc5%V)S#+Z1QCa7s`$*VX@KIE8c@Ll`#j
zhPp(Lky6Pq|C=RivCqSu{=ne<`m5>dF8j`adqi*GpHJYkllw=N&NApQK*<~aBnyiE
zvBBVj9j!j+$jDBs-{rHB$Rji1KiMD3iU+<L-W5VU@UImuF#^pr>Z>+mGvw4(#5?K;
zhv+WD;|2#FLa;xk(oZHcn1ybGuFd08<8*0r(Kt*9)@YcQ6`V6NVQrgT`!Bsm*1{L@
z74*m8GPpC$sF?8Y0advdals?W-t%n%P6<BQAr};AoCD$UkCEI*m=kA5MO7bCJ}!n2
zlMzFZ`zgPGf3{LnAo#rLmH-WSy$8PEf034`hTzD`;`D1s+GMHnG2~WliEif9ImK`8
zHqlQftL^niNCd}i*3+77y{b!Z2g5mUt$s|bZ9|tANY!Fae?!}^?Y!@osnnFZSHs6M
zz#CFGWycv(>5ew&j&wNig@}9Be9EaZ`IX)oWe#c6D#a<*hg!?WZB8^Uu6%9s;vWiq
zwQBE@?qC#lf-#L=hu2&tjyxVEmbsK}^M`lg**;Q^Ah0;U#P7b;Q`u&1V(_U&zp}~G
zOm7o^%fZK3)_0&C5Chh>;e6#?F$UDr=au!{p0`#?*{X(3=OSiuqchv^*p(Hxtq>g_
z|G&kc7^E|tyj7C9eq1gQY(T+0qcV=ST+iB%$J6J|QUooh60|bT3lYb#_Ne<r$DB6A
zquDbbjo_Yx;FBxAD?t;Mq&CJSKD4oRd69QbxZ<lmSms%E^U&}4R{3SxlgX(@INYr?
zwl=cUld%Oqbmm+0>{7h`-{K4^z-`XYToO8?1<E4UPqjBt2|4OtVdzP2?fU-udDv@t
zz~3TTTSAEXHpsu=T9Ojd6Z(0TF%qe6$)cFK)wyrGYK2kio$m;2;5<^sGHh*$`~Q=W
zMl?yN&t{f(si0u&Q4<@f{~UpBAZ^fXbg*frY~itQ_ohWqk-3p)wqx@LAbjgxCZ;u7
zEkyog@2yAFy|=bvx8tV%X+hxZqm$FgPrLTe2XZs{urVhvX;|df4v%(nnc*WACo+)$
zyzQc#r=Pmtx{4`X8+Dx$-F{4j`FMUbTP5^VLv~?re|0jH@c%l)KO!l1oGwt+`V*cl
z>9mH2r(4IC*Zj?~AbpXOktl89ip^#EUaRY)z6Of(VY3VGR6w>XV%lB}w_Obv>9_IT
z6?#kDo{d_U%1xvu9Yg+j*&&-tsNh>8QHDsH%Od>rVSgPW{#*y#eTkMLk4v|)Tfc1g
z8-uEoSolWgk5Bg#Vm5B<6Njhfp3H&sl|k~q-Y#Ryi~=7T@tID)pO=BEosO}k#)7YO
zR$o1?RW8bUew=+NFn7@}BAHeCHfh**Q`B;Fdd@~scQSWn7V~pE<n}M%V~Zbhc=pcr
zd*fj8dBUgtkd^`1K*S1yg`I+jLqPf`(89l=7GUwB{+<59X1`RNlA5WPB`sG&i@VU2
z|KOE_{sO*-B0)NFSlQMsfcj*X7S|rTBhgr7f`F7NZ^kVe8CGswdx~p<G~7x2jt(vr
zQ(P&7j8Wv2mfrpUswni+u~@xKrj)U8^?ts6e&~JHSbLf|kE<%F8s0+#l@45(*J)`<
z`RI{83RH2D#<i9sQ8%L;k#mb!rTpjb93snrGDc(czPL9g27P~`w%9&M^035O;4;d=
zt!YN+D+t7Bno2mutni%}78_*Bg6RyANaOGfEioFL%zq=b5FnC2Q^XJ-;OF6n5(R&N
z0h>PBkKA`Z=Jv=z-#Py*lZ_VTzV}MfBKau~5;xOjF?a>Pqc31f*vccv*sy2LClps_
zeDhXe=O7D5Or*s<Or2dYuH~E+iFE}D>mF#W>rfy*p5nQY03z{Fh~@c2$k$dcKL6=2
zfFTN!3zkhsiLH(^!4OsmbvAdoE0!(cQHdB;QW*Gxap8pxx7yD2v0TRlsu2|QxhIQv
zng=C8SYS>V!=d@TDBNnVM3*QMc%|W8cJE&RWot~7m3vRC-<zAYdAPIh;b@@ZN$HGf
zwpo<7)6T{vfy4!sYA0w9->tkjf*C2|aWX9NQ3>7-N$NrAOc2ZrB+IhPIfbw|l(-;g
zKgM32o<auge~imeZ^1;ULN7o6?9TsWd76HG`?_|MK?m(cdHrCU%(tT##-(C~WTNZU
z7bDWvh$ksD+IeO~*e`AVmc!{udiGa=mZ>7T6dZFZC@kS>%?Krf0WSM!AmvukN3a&7
zWJT2Ur_le<{hjbNNbFdpqdWQmyTe#Gq9`|N3*S+!fu{k%5{&&Ti6wo^(C8NVF95(u
zXq6W2%?yC!q#UCRNgE)JsCmyImegD<FSSLP_D+3q^><Yg4VZ<?hU|rt??rkb_6@j+
zRl76<JP@l9LB{ZTNTs!&C@vQ&pp8p4amA7*6v4p7PJh6oq;Ix9Zy-J;F@bw6!02L+
z5mo*|*Jqjt+SWywM+?WLjZ5mD{X&c}qk7hN$W+AQ(&Cbu8l^|C-16YZkocp)=MbNf
zHvEmqg}*YQ&u|&*V{8j@$Vo|74q4~=nT!8m6oxFmwv{Qupap>CF+(=Tv{Jxh|K!bR
z)1JYVpr%s1e8?XDiyVWM$GQxb45K3#^!9WFgUgPd&5kdzCb;o~IQ$J87PuqKCDmhd
z4^LP1s_U#3FLJyDXE<Gs6AqKXA$ed*$Ez=G4q?R+)2g6o6)G30YU2FPpY`<YQI17k
z{Yq&1&)CXzM5i7{<||TUSz=pu8(yOhxpZY!w9wjxf%KgZtwZjj?XT(&vFPZ0UZpXX
z(`vq%b85j+JCg;Y^tWGPKcb=8FhaGQ0pwPl$$pnzy-5WW)a0B(NT1s))(CzMmNG~W
zhM~!ZV~&n0>0@#~lkM40o-{S0D3f-6Gi)kWMmnMF@z%TJcy2%v#GB!M-0m+l)kSnc
z=*MXLR9S%N5|eW5nPqFm8%c4a-bDocrueott)<Gs-oIr<-mVs*Te^EYcK5zJIQ-(;
zzk(Pt97~?NPfQzj85KIA%6{YX>6M@(_|&UhKwLRJP|!Rl&GyX)(2XA#Y_?7vhoc;;
z_L7RriOwRHU>(M&no&Z32d|xCLq(e!rjVQLwWbFeg%F44T)<nf*Skvvv2zJwQAi#(
zyvQSlEe!6vD4b2FzrB)ac^n!VX0iO{iu+9mJzj+#y^S}ywwyMJn3lYF-}(^YsrbN4
zH-Eu5+hmZbn_K<IDZG=svfQjUO-|d9y4$cX8@j_KKUzY$&7Td#rQZMm6)PzP%eN0B
zM!x!fMj;eZ2q0JzmhzSk(K)M?3|^B-tBS$>=_xtFnFn#%BZ6j2r{Mm^PVJNc^+>4w
z1vEKH>u*yi!J$xvq0kbDQ0|_HFSYV|mX+gv_7?i80y9R#ek>>^X15Zov%;8c|H>bh
zs0@dFTw$a&Ti&^<$>TH<W+}{k|2CNRNB&dOL^lW#FkLLNe9H1j%-b}#$hW{!u{f6w
z%tWBVp2I42_b<HGHTaHiG;V#)#V4I-RyPBn%6jT&J1txv5;(=&upaX`yXsHYN`k1j
zQ29BW{r2IkCI03dx~fK!owi~ZG(Q<4kh+8`p}pX!WBanUWA9mK!1+oajcUGtl{D2T
z|A}n-F910vX0D0p`d}uT-L%`w+P6Qnjh7nN!jdFxj7P~Kr5hLGUj7v+D}`TCLNVSN
z4HlRM09;`8pH1qHR)Pe?N=vUQm%CelC)-M?viffpVkOYyy-_F^cZXr_(VKY+OjD}W
zDQpM-Lw}!;5JmfQC_<#ISzsUnB7ja2*wX>eymT}RhZWbu{iQGm>;_z7JNcaY<&MUb
zO4>WPv?#g?e}Q`YVYtatVgyUVI)s2<IHZUZ0iCyyf$yO1OmV-PPEwvW)CD%yig{&{
z;Ybpg?9W#y009U9fC~a}^2R!UtHpKmQ^W}$Chs+8<8%dO9xLZ52;Rc0lW?>(sVM;n
z*IaIqLF|gBK+A@|9tN5g=Hk4PV3@Cj%wa&LxPUbjEQ&@m2le-(Duzo|V_}1iMDPnu
zBApEHS^NEPy?bz`QF3y+T}--2-Ow4)iV<oD<@G$YYiXyd@)<YltDDwZo+?8S)zW_b
z1%$YECBW<90(INqEU99uHE&Yh<w0d3IzBg6sq0Q?`a0SfbeKtzl~fkUIZ!Zu1`%k+
zqHF9I?lj;2bDG*84;&;tWLh6XAak=Wv>B@HW<Vlnycy0iD7C}q)v$U|LX9Oon9n$k
zs@1%c22>TGH=Bo3zI-+iR$RWSs1GLG0)02F)>n|SV|0>2{4#n%1~<b#AYKc93-3D<
z+D$YdOfXvt3;4k6ikgGu|4hD;z{%YWASf`DFFuxe&sjX$wmCj&Yni@~WV6NS%sxWM
zPdFLN>!M5=WNk6Bq?&1DCrrInz$`t+Cc`>L%6U>Dm!0xabPvA?fU&@B+FLGK9IiYF
z3+e(-f%LQP`8!-0Cs4L}GHeoxTgJ4?m4;jU#-#g9u30nwwWnPDwPZR=6RwBZtGF8%
zg?%sdh)0chM7D#2i^+txixKWe&GX&cF+FTn$ZDe=G#kI18(o<}Hi~L6Hy!cT9mN5V
zJU?%|Y6rd_=251*0dEODbm^sOZ{FB1xoX0NwGL_s_zjkYCD76fykV0z(KF+Toa;kp
zYC+hExM$VflguT~UpYtkR@h=*tR;(qM`a^BW3^~RuLGH}(nm%dCCqb7q@mvfe2I{r
zmFmR36y1sSPD{H34{s3W2gny!(K2LhzkxObDRPe#M_REWYk-^0>p6qMKy0ZiE0z5L
zooVPldJotV_Q<htXQ*7d4Y4>Mt{rX06!f^1`!cDH*e3gktvpPNLr4@8pRh?A=)W*U
zs@aK`7UgCd@(q<kQYL1dV9>~<F-x@gUqY}iJOK~ush%P$6l^WdQ-P$bDQ9UFm)KEe
zRv-ZaSz!DjHGw=Nz7gczRjLy+WpPTliPpIU%(fub0(!%pDJOvAOHy)V$tDwUj<!6Z
z345kleJXa0EXE8<`{-JY566QGLsR_C4sPE$!tQXXY`M`P=Q+9LRW$`IPVFeM-fClr
zJrZA2maFMQjXCL3?}JjdNQ0Wwk0Bqf%!(Na5cMR1dT_bi#bF71gaCY31$3kYT7Kz0
zLvy8yJOxQ>tmI*e>Nv-B%F($d!|%(aGLKEwIP~~<L+O^R=8GZ$3iBVt-#y*@oIbyz
zijQOsO>MiowA_-{xE^DiLxPv2k|19Df)^1Q&RyHdv$kH2#mZ!)^Wn2p$ju-1=}ii1
z%yoeW)C8pp_4@0V2It-;YD_UpY-W?KSaMw2QcQKD-v|mdVxAi%5LqvFfGcOeOr=fS
z17fyA`)$cO6|{fILuhcLy@r^-f=FxFB4!)ah`|dlDKMAuz*dqFZtSO*A!h6_dYQ^F
zo1`9qP9K1(=K>6<DlkRQq{5_+_i(tw6jlbZmgK0C#@NN)6bslhe*nW5Q^SBu@GKRM
z@tkpHWC1q?H)_~sJVH{?NpDTPxfdp4@e|~#U(}b8OH~-5pkK|nDTYxLc({Zf=_=LV
z?O~DgsBLBlv`t-?EQKO8&lKYl=HrRROHi_M(jftQ3kZ?vY!Bt3h3s=wgWDP9SiaX<
zfG|<^750`utbu5^w$z?k#2L2;!iiQnAObA`f{djPyaQDc933Y*TFDAXgwfZDhV;@u
zXaHcJ9=n(!BL9a3_Kd*+1`z-*6ot4@O#oU26rksVsG<SNR^y6Jg`)2!q*;%vsyi&c
z<;H{L)3q<4xqZq|1;Y~}D(x3fxWmH&FO1ddEv!V>1CXf@$;+#~pM}lR+M`5aaS>6F
zay~X<U}`0_QV-hzBP{JB8FA^Y=%1aH!DCh9htu>xt$n!rN<NA%&$uB%f;EOINj|C8
zmH98yURF43)#e3RVfH@C-x$qWcAP?nU*sD@PWlNQJ|BNBpdG<O3vi$tQ!m%PacCuE
zYsYXM+}Sl;j`5}xq{9(TMyf>&mw6`4%*I1S<bw|ExXNP{@fHIlb!Ee7XpATbl0Pc*
z5?1IL8R@OK)p<3xX}!Fy&JPJ^Btpgj$$(lCd6aG(5N_aAW;Vn7E{*lr4#Bd;;PtGt
z;8z8tNsUgYV8N$yl+9vrm^LueB9EP^N4mBe7{SdwMg_Z{P!yQ93i@>n_3Ju-hA0Dd
zO*%tf(a{4mHUzd@UBNv$n;&~~n`z#RyR_1O{iX-xm|KC>A~7<Q?}n$}jL@%lvtlge
z!R0vRw75XYq*@t}AtRXW*=2B1rFSNL*)p3VrRu$;fl}h2Z+UgfDj?GRGSKWr(N{K1
z%i#X?Vl8xUckr?{;p)Z5OBerJxN_K_VZ=rFarm<~Nc&ta2>}sbet~+2I$XOJjS-;5
z$OWeqmh$0cpKM=Js1DEK=vVJYZDWmrSXm46ns>~;w{}G?9I}d3R%$*Ka7^rzyZS&|
ztF3A09gHLd^zXzu{fl{Y`0)73%Mrwi`y%lfsI9a9VP0};sR+ZL{h|e0FXK}Eu%%qD
zbR>&Kb-0hTsVz&?1j=}r_yc{=y1yr-MoG>VQwOeCI5K}gD|X{Qyu*xB)Sl*^;KU;7
zc(46hG@oo0*xPa7IloSYNpP9Gh>{CdHyi(vDvFS0y7A}$3X_~=aUXL2v4_r)TPeJ6
zW08(RMgJs51rb9ZhQGdP;jIOCVAKNI!jBN=sX0;KN_pmYy$B&Qhp|(OK@|bT7!`!Z
z07-xa04vm;ow>DlIss-z<_@0SnB;&yQozlyc`r9?!56<LGO`_n{j{*Sb_4)cq#eGQ
z^o+vccMQ!MM&d;ykpp@f`65d<V_}nTzEZzUT$Jp=bifA_ZS&QG(Phgkli>~$8r-DP
zq445f#F;{HI>nT#W(H1K8Z=ltLm&SFQ09W!9`6YhhmnOqJEhymJ{S+g!cX6=EF3H_
zzd+fm2_1ppFCtVEC?}(_rjJO2kUY*UH*NvZTO2Zo*rcQHYx2xex7mo9+WSG64sE$;
zvEoq%0G7u35xp)kSkq&Q%oD*A<;7gVJc{^JAx*QivT?3OGG&9z**ncDD<ThF$X6<N
zR0xtR+5swp5~EPtaTwENsj7}vUcLmXQd+p}2a~=mpB92P(mf#)tR&{Wr0diB0JLAq
zJc`xQlV2TsO%s0Vc@hAGu|>Zow5cFKyHIuMg29<kA<juU!*W%&KkSfe_>wm{zV|?-
z^gFhlKJ@sbmY~XHK|_8ec14QSTi=^76*++)nql0*Ooiau3}=(XewyoB$T^NL{+~eC
z_VA47;_Xv-;~EKetmSt~Hz%nyvaw)@Vk(VXl;3RK85;YnNvMR})+NzIwkkr^6fHF~
zkWo4ESZ+1e<B?61SdmwooB0~NX~l_ZhQb8}V7g|$kzKzwtGXsZ>C$Lu7mm}M_VkU;
z`Y)QYu{e(H7z<@UT^h~}Tnz@N4;H*4z#(PtUoPGf=9)m4+Ys{{tj84)o3HI}cc~bF
zx6)OT0CwzXhtmuT9-DHC?qVc(JoKe2oh1W9$wiVCs6h^gNJTZ<sKn1-AE@!9r99X>
z_7-t`_VryC;ANg(KH!lMD{pXGHXo|cmE3el^Zbe?%Bh@ymH_C5$6rV2lT0m)M6gm)
zM#bEqX)d{rpaP$@lHm#fnv)sh{qy_0$~SFd88z*i*ZNEGS-JfjJ)uiWjYAxki@7xH
z%4Nz_l9Ih7gXYdh>gzl9T$8dliT=en5Jk1Q-bH=q(436NZ=l$G`3oeaD0|e=IAVp-
z{J6ZOS||ol`0^hrqMx!-IIP)1A!itd9?&nEtUIoBX;>!oU#wo1l|eZ2L%>OD^w_H^
zPC~V<3;pt{u;Rc_Csyu-VK7x%exojWK<Tjj_&yx5WHztzh^d1$k+=i#Vc7|kN!oAy
zQ+`~OhfZ^NGcwZ8rsu(+5hsjM2<jLf6aM?d6#1K!@|P@<BI2TO^y99?#uuZQrb7;A
zR5=>6r#`jr1a?ne&Ru^2O#*5HdnB4I#ECZ#iyNgHiwGA40U|Qv^KCnmy-jZ-tZO_J
z-?piM`PERee{Fb0$&(e=qy3Ij#><CmvM>hz9uazn^oar?m9K!o${F!UQR|o0wp`@z
z-yp{E;*eofOI?nJ9&`n#BzhrJq=QQQEc&PFJ%+sidF03Ss)1~GQ+_1>Qmx#Wilk0t
z={F-d`}XRE!rn&<IXUG;on=1XpMtJ0P3RRxM;}akZ!66e3sR;^EqQG&MS-CxF@fxt
zOdK^JRv}Eq8OJz3K2J$N_&%=HTD1J?yL6c;7@g%R^+KSjS`$l|&NNdc(Ii6Zq9!@W
zyP7fwiYtJ2$SvNIn+BNveuwIf4zD1Ap3l<W7dnJgG#IxG=A=@iqO|;kv0km<=$(yY
z(N-E@$iQPd#xuEk!{EF))-N5Z3&=DC&>2Xg=E=7CYu}Uv#hdPnmyfjpoAgGdh{3X5
ziK9N026;*_^z2VT1mc>EzjE@wXVn*PrxxiM4zqri+_BIA%G00A%uSxaA?5_82}RO#
z*mz4J7MV#AuoA#44pLMAVrZnPVp3u@a3UNdXOFKpSqkM=pTw&RVlkF$&=FAgL0_o_
z!`Un-#;{`H(d^18EFenYZ{6@$CWBq49Eg~MF|;&_*~DE*WopUOVWv_5V+7XLWOdBY
zqUQ1*q91YVJ_ztaTZQb&2FzE8pi!7b!F7ZjK3OzEcr#KG#!MZh2I5k*CQ6pM<i5TU
zK6y0+5n4P5=n!dcYS|1#N;TMR*ybEgj1g1M2n~VRzhxcQ{W<K_;bUV&N+`}pA*HUK
z%Pve^6kCIxlghqv2!K$M(E5O`1m!@9NdV7;>FdznRnC|Ywsfbx<sMJ9l1s!dQa%1{
znPHGlBaI9;f?D87qvBAbtI}Uv(@gc3!vR<!fte7VAsx*Z8dwAt=VH%F@%)ihs3cI=
zf=L;`+>D<JXJ~O|YSs|!gKFY4hHVRnO5^f-#H~3L)fF_T45pOpt(z!U3eA$ng&rT8
z3T7~>kTY>X(UnxFSE}0az_5^NY8e8kNuJuJpe)2{C$$<(^^UD)&p>7=6mTfcFkR}_
ztwkh+w3+@3Au!ZlIye~oT)6U(uNSuG!K|ndpvbT5K(VDcltv6k$^vwv{e^?quH^@?
zHHFh_<|8O;qdm1+8;^nX91trXYac%c*Rpcc97j?u8G6a%43|z59fo!mYvNm=>JJg>
zEikq5YZ8oLDB@qkNqfrHN5+hKq##-5tFWw-yx5;45z9itOQT(wN_<;^wW4E3Xv_pg
zDRr7Qd_evi910tm@|yQX)xDpGE{w-VJuMfXGsxrjczB9AalQTO3fPOsQ>1v=y4A{~
zbn0=)W#n$~5H;cSBx#vD&;m?2vqA)q4JxB$sA}1<TKdi{C1F-+urXW`Xn`(uDxuUf
z0NmBcvIw5UdN=*}h{o>P`0zb5X(sSn^ox$<x={3=OGY|iPw4e#R`>d|M18$M7cU9-
zR*>^rNMD5%^=J21+R6vYnak8_F1SNS22Qo(n_HA(eGtaOu!QiYqp2I+d+USMPnU-?
zyL0MO{cs2S_!|LA?Q22}PPVlK_lXNuJXnlMx4iJMZoyba_zdHnshaSrr+sY9b>v|>
zF(ys3_FK8S56gOE;U*WZ5^;967Xk;GG3ZwBvEPY@Nh|KVi7EFobcrawbOm}p<?WZk
zUi7p>>V(G06=0F-Md;d=`TG4kY)-{c$?j0bZfdX+E-Fe{JatA6x==G&*s})0fEyij
zuEy&1%|C*of8<3{o*t2`zd(xmdTUi54=)Z1(=zr=0P;q>dljiPbh3<w*ksD16pYmc
z4K)e`oAmEK{dYUlyum+wimH0WsDjKjpW#q;nxjrVRHdlsdZNsk6jMsv;~A!3ggedt
zoFn9uLI75lAVh))q|;fARObBJVZ#(HA`~WsEL_}kn0-tYNr%P+@((<~6%me)pX+wB
zd6bC|8ioLzHIPPW^yPz91Lh^5Qxg@3vku*gRunu<+C5l-AGaywsRWrs)$8|qVSaC>
zxq+o3_4-F%hc_Z}nCfjIEzUj-2n58T#%ZNbbohKe?>1*w$@-aeg93a_3qa;j{h$d?
zWt)f~Whn)+P>Lb~OGQJ%C%^k0-QlM?B)Zf$>a+MQ>#+_}e_&w_J07-Zc3rmlj*=IO
zqrO^VEd|H*EsesZxgHP!gNg;NW3#(AZRnmZ=ar1@8_cMc7$Fry)Wb$Q!$vPbU5=hV
z_|q$xB*o)KJ2Sz0_6u@vUQ@+?D7Qx83jfez0^_?)IIN=q!VXmFvIJ;YjZP=T8u(kL
zD<gww$~hS+Y)|x&QzEx>knJ_&5J!HCq9~Ive&<X2__anStGLyIUJ`_w0z62Lz;Q`o
z-nKc6s?Y!_`F3UDfM_C&Vh7X_Xodxn^)sGWyN_vvM4YTcwLaqkEDumWaXQ3y$_wR2
z_|#gG7l$o+G*DlU@z|sKNJegbH~+96a2`z7=%5cMin<+ggWvNRsi({G35$s=k<p?d
z*4?*+^nF_ZX3`v93-g0#OK?Yy&S`I70+OSCMT2q~Re|_vQaC)0mBcxmI;=|C+c{Y@
zMzm>+*m6|FjnhR=ym<nZiNdBR#o#Ox9Nvz3hjs-lt{)qU*e}@RO56psrzMS#7LTn@
zZwE#LE$$6C(5lC9Cir{ci>Zk7%o2YpQVJal%3{A&;-scaq+|Y>ud?|?#+%FVhRDU+
z$Y>Z`ufmIf1A<3EiA>=#wsKe9l<W%PeuGX{;|TIV%#pZ{=bklY_lo8ZsBx;Tovy8I
zt=%>-M?R`mpk+Zv!IRB_lXP+MC+i-@L?%Z14q}p_ASC;dmeRU!8*-Tsq_AQ64PXM4
zBSQ5OO`j}aukybOquclKgB&DMs)-gnxpW$^mDDh&5qP}hyVt>>oFCXM7X@5N{*K-B
zM-D#{fdHr&$mAFs$@gxE0R$J(rfs`p1-J2m@qdV6<yTNL!5{{)cXrSRt3jop)Zr?&
zzV!DDS8q_Xb@jnrP&GU&?+kz<;t!e{uMLV6n^tkHy)vK*5tslm>}ojQVHM+tQH^9a
zk|T?|<V6}4YSp?RbfXLLjY}!;uItb5V)#~4byhfgjrx0JV+C}_cbCg(RD<xgAYxnO
zAmZRg{us#xQUDoR1Wyjn*RbL+d^6RzvxeQcG!*ItYeBN{74RSyq=eCYO1sj0BsPI1
zXe~gwqjTGVV2DBAjtr&`1wqwclG)_**s9V&OuAATBAG7-Awq*zP1Y#qa<MoK7k%;~
zxLP$Axn;xTiOw8JM-K?p_YSQr6`v)UKDbpJgrgVprsw6biOZ}P#7pZaouRnEkbxr@
zckrT=<EF<a*H?GH|IU97?sk8(9>6LKD3$)@di~N^A@|(s&lfhqzcI!qBeyIim#PS7
zk&#~AB8imtwRV^BZe(5ErLSTbkFqmoQEkImgWv;Nj#OaCh_=i?t<Bp<Kpy=SNq?lA
zqE_Cu&y}Z6hJA=SNq>tu+@KR9bTAT<v$E}^-uJ%v0ls-=zo*14hU)e5lHWO%vFFh(
zDImDRjS}C)tFQPZI{<1+fle3pBE9NLT}^$5qq7P0fB<U4Sn#OZG`@ou4NV74C)b^n
zaXY=paGA;tEw)tdIM9rrKL%RgO3kWJNM^NrQelGXOthqNEyZTz9VrLkp$s^QI;AI(
zD|kjG#%H0!VJnF7_{vx&n*@8_faU1Mf*qM>rwp;Jm5|(JJeMgfq00b>mW6vYJFP#F
z=s+U35~fvAJfLo{rjOeuy>j9?L8Ro$^Fo!M7@4VZ!|K3?o_ZDZeKmkemvt#7wsMe4
zdM+8=hZu~HI!4HIzri?!962uVW8RM=t_4JjCfe}4uV`oAjgKgdw|trTo#y`(b)NBX
z2JIeRYq9!jQKGC~BZwAJcD3leNAE-siQd*?^-gqFjV?+;NURz}l#M7+7YPzX?<Ggx
z^Pb=NHXrW!HuIbR^UQVK(<amb+><t^=(1WMX${h@lN9U_u}JURVxgb-JoP=3dO?bh
zUA`u|lvH~akNMCiMBHFdul1eH8uQZQ3zya740FRW=P#RRm8>2A1y8(TUd=wg2mA?a
z_kZ)o=IoLBm5mc<Fvnl9){T+3(yw*cFogc5owwYIlgL#0+NjhMRAI6&QJwutdeerv
zyyWcr1X^T);YCvTGC_b^d$cQT&o_NK(r*v7x+V9xeqoWmuaGF>*>hdoN|zF7|0v*R
zuZS5NhMrO90A54$Oo<qky0Kc(V?g4fR=2z>OZR81q)>=ti3Dk`@xc9Ej}!JQl07y9
zq%@nCs_fP`$mU$RZPeOrM@(nux_v^bp(f*v$OQUCgmq56D`!Y`V6L{xE|I;YjvyVz
zQoiw)PKZS=AxfGnY>14$#Zt3S*}u^{sQRW6x(4DVhrJKX*Z?|*YeWpkBV8_GGyv^c
z(nJ4h^ANa^v_&puJfNEeh!BE!gnt(NB0+yYXzqaWMS!kLPF(#9saRP9RTYO8S_zWj
z6>*U@JSgX!Q;v<t4-B`U5|-a5S3fRMC$6EZXQn-q{%Q#HV3T+Wge&OYOuFMhTdw4Q
zAiVXe;157YW!hn|KdBrDB;NhVO^<2@quYnvISgIs<+zYv{hw&2C--hoy`<%zlKM#l
z>lPmZq*@qg;py#-IX2uuM{&*#P*|c0jD#whiMEsICJh3P?Afjv!CFKGbZh^(2|=n`
zSOO0pkC5oU*aYDAm<IgQ21Nd815nt1=)IMF@BeoMZn23~A_$t%M4)ne2{urJ8})s4
zcO#kH=@FBpT18;|+ya3fb}UYx=_&C*5!rX<t1TjSeGRfIoJfY>f)?0Lm`qfc^<s$8
z2<W&i>qR8{l%zkuN#oW+w6?IYiqsTyzs$8M&bYn3XY?ywQKI-ljeXmyoRC|ElgW6N
zSe7A0l&sVK>HMp*IU(e+2)F0FumAaA@_=n=;;a51e$*E;BZ{02lYJmTT|EPF*QaZ%
z7yas=Y@r@KNe)Kdgb*AjbBwjP3tW4Z<o4CM)ZZ~X2fz<RZr{bEN#xO#N&NR{D^!rV
ze*sb_6UqUhyHR8L@hk6-p<NGN`f;<J?ABc;@eH=)Kf)_9tAfLj;00!xg`EcnR=yoC
zL&>uC-h6~*QzXq;oDyk9I`kuy22?k_iX-o=$kKHgaW*Q=GLQpJ9nyzeyj$FNtItC-
zT!Dyf^dsqws8F2_h)`*=3OEtEzDu0vA1swC$2a_LWjlmXI0AK6J>cH4Vre#;;w(b0
zx0qjpE77i^<K=5u<Lq|Z`jxCL5{%$3e>_ezX!z}PDqlOXP^~ZqnmjFBL(Oc0RkyEN
z;Acb-fxuh>@2x1x*u6;aZZJ;E$vcv~>mjSb;n&Yw<`hvKLv$lJKf8|5nf%~2!Fvb1
z{V_+b__=?JLfoza=D7+;iQO%A(y&Z$bz+c??G*!}zE0RZWeN{!b*$TCqClrjxp%U^
zX3Tl#t$1#9-{|4)?$F_<9J44NiDvEduET`aezGYWD(VO`Mi<@bLK6KxZVu)@uHF?H
zEnbsGZKfA%xW!pAqO^m`w*<tcD2BC%0lQ;|Nv*Fo_t&(#gVdbaGXRODBIO_RW5DO4
zM^=1OH~7JeTBtqx*<C7!Ww__e>@`OB9z(ZM9~&3|HUrAFRvOE^xVdoYTcLz7Mz8)n
zktbZ}Eo+jMxb0(t$s_LgNdECOl(z^Wi9d3R>D>EaV1|wb7{w#*;K+Syal4z_*YXUj
z2zb*L<#_kJCHQ`fWsnQwwk;3>mI1~Ldf>c$Zc^AhJ7xh9JqyX(a^az2e*w=#fm+P`
zK1V34KfPsIGL0z8s_I|m-mJTex|M}PvglB}QZ&iVceM&ho-5y(hjzB)+fG6%R9t*p
zMK!D4+++au#3K>!YSmvfRaK`O!-J+a_@_-r6L>(j`QzYJs-r-KamsfW4tNQigH=*b
zCtW&^C3J}DZKl&#rM8Kx=uKmWE6y?<#Sjzu@mh}J(;7A2pXPNoBznoawYfwPfoY7^
zw6&dW_n+teaEPqEkni-}rKN?cLG<BE0^~V9#NRy!UcHdK#DD?e6T6-bqgNr6<GRm6
zJDU*@`$z&%C$wq**W)H*xVlcEd@%$-U~E!TdwS+UAr<oWCt}yJa(#)H_s3sAaE}4}
z`GdV-=n9(A^UcLaG~h1V%;@gJ5YfvkcgnUP=<kiml;y^-PX+71Ci`x^M|Gg;d7n%}
z5+vv`xPh#9UDMmv-{T}aW-QAP@<opvm)#rlGVEcXKOieH4_-k<jAJ1E{7P8c5<&#D
zpmPEt9o>J|C_4M9_Q3B0D`7V?x^|JnJwLquTz8J&yR>9t2>1vveuNO1_4^`4XG?;z
zH)d8(tQ4N48h)jbvymp-zt*zGP#|MqPgG&!xcRB&7k#UdOvwRl|4M|#C=pMuSe;Wt
zZfLluADfavO^+_<x#ZMoJj;VoH?_Cks{9=Y{7eLCr&c!;Ia`Brm5`fC!WhO14XkP>
z{Q3e7kS1cx6Rni;VcfyoFXQla!}7>Dbi6ijKT_zr*jk&bqOHnR{k<^ofrm=88b!OZ
z4uqWRlItVJvbUZB{k}tY0(p6@j>;C?sL)(xs?jjA%pO^Cd+M4G5WGwz8b!o4eHT0k
zvb1ab`SPT2k>DyU49*vzpm=?0K?fv_*eH$+Jtc-<Oa0Bd2rlHh4Jz?twRoN|tIF;a
zO5l}F|J=g<X1yrBbG9;w@rYHOP53I$a_ZGJ0cPpEDlR_!K|bp8gOG?rfCoq7D_Z=Z
z{V`b2eP|qD@THBtvKl5#7Rditu8)|}JaM_v7c+dW5YAbsRvNNU9G*IV5H_>FKwo&7
z<sim$JidCW^H^U&AthB`mW56r{lT}Fx77F38>+@LRm=+0?bzQlaB^jw2y<9>Tx_%Z
zOegS<$GFy|3p`gx$>#rR{<l8a04bMwM#za}dlu;N<G^osfk^O3!E0V4Lh?eO=yX{d
zWPpsej|5K#$Xl$K=cGk~8Ooh6%0OcKIcbhSQ8A}=Jq}<rkUYvAsMQzMC(`$UiPGTW
z@c3hw+-gE?<ezKNt=Ey!UCS-%_}+$WNg~4<gqbDU@pn8(EfzfS<A@7oP8^5xRQL^O
z)3Tz<2v$b)UzIfO9ES)D^3JEYur6N5L=vT4F3)Hpq`jWs*Oj{`pzQB287fZ@z9qNT
zx4pd{bc6ZuXb#?#VjXUsXNLFN&5o93AneXOno8{$L&AP4Q;=5*#?D{vE_Ej@UQwRz
ztcRcx+QntV*PoI@E{A2UFkuA&=W=^kgg%b$gz@3wS1vC0sYOI*!{E=o%Wa?dntGc|
z-*5g3@-Bf@=*E)IN7o;MnT!Q7^WD1$ewahQ!NrCaWZdcd=j_W7MQ*0h4`T|ieHa+S
zVv21zXI_sC!9Y|<6>@<7;X{RvorRRRUzfjrVwQg>v`x*i+&4UKYYueP#uRmo>&)E6
z?GN69PBxVDXC2)PGHjTf#cjL2E*`dL#jlG{vw_lK?I%`24s9OoGVO9l*%F&BTWvEM
zxSr$FYu$7~FNC3!Y;GlU#HT+*{$JLvCTAm&pch>q*!<7uvLpZ8_N|71%u(z2*M7=3
z_LS!H|3q`3orUR53=(rgwa=c<0zeur)|8!BGyiHOaF>|T0QucREksn)@0i6uUjTeq
z5q9GZ`8)!-ih0nJQOAefE{c2+1hLTD9wq@+YTzs_=^iFqf?Cj?l6^0BZDJY*jW?kX
zn0jU09D*O4c~PXxYA!2WIwzYa-?#0S=|Q{jJvDcv05=?P-#&o7&brHQuOW*zQ=1o*
z<aKN!?N(}(;2o#l>=kWT^H?>|CJmrx!q1o$M?I`Mf{w70^_DP&Y`l9>haYjjC`rOo
zF}8r!Y=}7K1xv_!>ZlW{VI;DokO4}pY?bAAMj+b0w{yuxBcC_oBzq8?J8@uRYQtDN
z39WS&vSV6B-8ZD;RpxW7lO37qXLfZLG8RLEDtqPcYPVFPs%UJjd7dlr>?R@#mon`v
z68JJGzA2G$kKz&BrCn>M58u_-zN>6NK+pa<H^^N09+iLvr(&l~EUXo8QzCu9P<Tk|
zDT#;wH}a_dgO?K!-d89r+D8k1eoiN#Mi40_?0o0BZ6CX<NEI)XE(5$PPDQ=xH|!bh
z+|bH0X6wOBD6$$oo4^`11Bif1-iEkZZv(A4Hqu{kW;Z+%#2uvM`J#)}7;ERp!;MB6
z5;%8}+l{Mzl+};r?aPlZk0p9DY_C(UM83>cS(6YPvVn=+9&zdWRj)R<KvDa>-*>Dh
zy|>UqT_V49D0#Q4_Zqvuvajiyo9#c|soutRB^EyaprVBCn!n=l(l3S|FNgXN?lqFW
z(A4s9nr%L@9@k}Il;xZN66sa@aI!r_z6V}Z9QS)?!G1}uGx(}*G%egU9OCj`b~#bw
zuwx}CA_hJOOFPv1uFqzt;a#&83cutopf!D&3-NB{?&%PdnGG3w3A{PlW}dkxBLYOh
zhVWv@*wMB@O*1c;$+mnFG_%&(an0rPKrY1SSwNq2hX}72kJQBpI2WCK|LK)Fk%L{U
zY+lw!jSg@?)yI75SxFy2Awyeml=36X@D;CrWHZ%mKnH?A{|V^-C7anr0dW0)`Md-I
z75S&vz-|-ze>L8JO3iIV-zOKK%OBHFq0x~RbmFLu>EqAOCp&a?pS-o8@vD{Lk`d*`
zw!DBU1oMxarQ?OQ>l!Md0q0Z-^#(yu3F+JVagGL>#0yB<Gh*xhjPe<}bTJBGyopH-
zfrk!INKMb#iS8{E4rvDO4o~jee;f;o;7R^{bw=S=(+-(2CRR<WYUHS!%MrK0gI8H(
z)%j0e+<agKJdpSTJL`Q5X9)0b=8m={YgXPdHwOwzDcg5MLt?ne#%kOQNF=(ylur=*
zB(xYOiah0)7G&+xM1Le<HX{FexRUz2?-QLC4&g`zN5utPzY|iR4Y<GN>ijxQbShZK
znGlDPl4A?VS5P$y0m$W#K>Aag48#hpSQHX_`>F<wD7-tM=^AH}OgiM6ANmcpNlk1M
z$H(K~vq|4#N?lYW_99e<1E_WrroJYT^IC?nZP8Ro2*Y`d8%m#xsL@bysLXzN-&Ha6
z*`<K%$hu2Y;f@0*SBbEmD3-iGjSZ0N4BY*+m9|Zy_NHN*xknzLF{|>M=w<)2*mc4Z
z420T5(NRAGkDAzy&{!kNeSO?wi=U(>I-wU&1ajLTIL<_T;O<h-r2@KJkZ5Ny(Xi3s
zyJ1;Vv=tIzCixfOzSx~QMNwzRZJABBo!4)|A?O)d#ib6y)7N-aB4HH^N=)G+$pUbv
z(U>HTk|_h|vuVBHvzM$N%paQ0d8=ud^QE?rHYaBk*p`{n>LzjlABTs~a`SUOd@7uY
zlq}f7J&E!cZU21^AZaV|y)jkajiNRGoaFZoN<AYZKKK1;;T|{gm&C7V$Ej~dNtJaQ
zF3En#&5U`7^X(LZC$$5``oKn^B{PG57Mn5*vqY!x@xe^4@b+BpOc|mTvXy<lgNc}v
zTauX7)_==-qv_fUxo^#AEojPi@-eV?9y*254BqRlpISTiEHXpWf<QymZ^%h%wV3qZ
zduBg6vsq25rp^2+U!>_KMlH257M&PA*K2HUWHoU(pi!`p(&pJ=zg^c57H@8-TQB!<
zuRM!4-WEID$|=fk5;1i~aTX)K8H~RS<SUX0&L+!5+t{JJBVT$ruRcUPNssMGrMhQl
z*GYl@2HC8^LA%cVWz=1Vm@tk}Qbg4?+9PNKZmKO6*0LLIVq!BriKWiS&A7A)kuKv_
z;3YPJ{@x5}dB;BLgE%QVgMOX&4NA0^C>78yebN0qCkksW3VsF}GqTeI7^fS*qV9!K
z^HcGy2EE`<<*s9lRI>QVikiTNEGo>rJvyfTl&GFTL-Stfp=NsA3Ox-CP3H3a2o=>|
z0OwQ^!O}d2>39%RnafGu@-DfIPI6jS1)-kfdv#vQ0lmG%0Em+Y+6((h-!wexs{8!C
zYfQKACMX`krzxcWI=i#|D^fs+dpn?}X7PId+t3omMmnvnroz>*DBSX6pn7+Gwfp-@
zQ}dKN+;}<Vb9uR|EN=ZG`6yii)+d{5(I$CwnRCsTf!a~};qDhd9r3unsD}_LfphWl
z)b(zq5WQYB0Y9lCjxSQIH!cF=Xo?biA~29-(0#QNMq<crn&26Osq*q-jG``1pCvVk
zU==X2WoWJacG~Z5ZKE7%4GQ2aMn(->*e1B)NCe|$i|Ha>(w{*T@yeUXMj7(55ssA-
z>26A8JnXUY2>KG4x26z&raJK_c{SzzY9q$mD~MNcC{;SgD|0<DaAr3wUBHb4n^^AR
zBX+<52G%G)cqI_SXB^i)op5LFXU!z);f}?UXz}<s<sO4mIdw4ZG<emi(EO+bTkt$Q
zIFPKGu%4>5zyW2pq#FNPHF%Y=?8`QONo)fk+HGRWJDqF+AE=V0l?GAKXo3Eih@`rg
z38++2#lr56h-=+x{SdF5`h-t;Drx`1qDy#G@BHirFKXdW-}ilffXC~WAF1i7Due#Z
z<>*D0o=tA>D_jCW)f-MpTQ!aM&ZTHRG4h=B*z?mbjk?szQA@NZM_km3PX_jH{sQ)l
zN0L6N)yY^F$PuaIVH@jUZ>jY7;ze0XCa9-jdJO22c%@BIVjdE8$)oz!voH)Qod<q<
zZVcU!7U+h<=a%B)cv8zWl&0m_#jtEC#W?D_g|#uU_)-twTvI40rA(|HNncY|x<tsy
zw$8j>qx~8jww2<gdNf_=hAJoP{c!gGRTL~hS~>UuS6o%$^G`onA6~2*ruv7Ehv<C_
zt~yE1;UI=KiD+=OA~jk(=$ubM?wN_$+fSp!F`$^Uc{4r#Q`d<~jv9^$5-~dtPLc;)
z^-k$9b@@`oJkb$h>{?ruqpRuG$3Xivk;2DY0F5D5Qe;$*K2$3%XBs7erR7l0%6>=}
zF%E0u8osqpVLFa5^tUX=Ob9bCTU*&@4s-dxfSrqreZptf_ov?53UJh_K0ihXk#Tbj
z6Zi0)KkB^E|IJj8(zlX%aCwcXffmdijO-Rs*k|2tcp#LMLpkMkzre%*x<FYpF%~;K
zph8W3Q<wPeUgu5lUU(X9(%3qtr7yesf&Fcdhr{`}ElzexRA*?Y9hGvF{@u72lPY&e
zF@!fWUts_+<q!5!^XrV?Y6S4nq3g8b5CEX9>!t<HG-x5$#O+MLtB00t>7rs#3q5;y
zQ>^0d>L1`XScw^P)-)iJ8Sc;f)SRPoE6s+xg{$~6T|fP_wA{16dL!J%`{&vv8Pak3
z$e}oC$JG7ORtvqnd7cQYx3Y;myrwTAE5NoGZtwOHTlqA;4T?!W64)`tcOpF637f?W
z`q&XVzIQSnE<oP1szc02{Z1f_h)9+dfJ~qC@Hz@_U+xPhzezbI7gN*LDwhvWzXAOE
z0bO8~HiO+s2cg_Ff5oPDmnqe^V36_V3~oucrFXB{{zzRYEc}~I%VQoVPQNzEQO*EP
z_1v7Kg1)DEZUW^j>aHi~zFiW^%<D>boX9JQGYfk3cq&v<OQ89g*#I>+Bw8v*sE&I3
zHyQ*0i|D;8Qm#vsE8-nx+2=UGU5T<-3YRT|>S#Im2@OWM_*GjS$W-(dU89;x<7xx?
z9R+F768J_DMk3z~G*&^-XxbY62Q?Ki7Bc?T@F-3*sE`CN3ZmR&-LE20i|31I;5XpX
znoJjJ;rX%;)@Mg4?nM|i_ZyUJuYzf@&Rif+US-zj8Y3ivs}9daX(;0fkJByP<y^3@
z(zEioOpDdhbW6)%7X8(I&K+KBhV9|V93!#dFN7sPvEB${ge!@0B-Bkx|3M`{l$gD}
ze?%O0C*B=vd1D&n`Yr0cMKZmrB8RAJm<n?mZdDu!GZax(G+8yN6ikKai4eL^ndC^(
zKtS7p=@A4^ey<|XCW^ljjs^+_YAZPBa;!JMJ<Wk`>h<<0=8c@R`+@k%B(nCec%F)a
zKb?6Mrka=YtP(G2*sq#Ua}Zu2fn(1r`3UXJ35+M=1SLLOSsI%^C8%Rit^smaIEM_D
zl5%|zfg*&e39-zgFfJstkfYq&-F2Q+t4zEBUL3S?%TV+|M`kGiPDm)ynXyA|`AW2W
z1GpbGiImlO-0RBjO@<rpZr*Vp#w~Z<s3JFUsMu$+`ReJtdr6N!vnrPFpd2e%vm=wF
zLhilEYNqfjT;?xTNe^bO_xxj#4{+~;keM1II%!ySBMJ+|ae>Jio5Kv~3=7PRUS33-
z9ed!LQdK6bI!4XEXT$~%&Vg4WR?%Wv-Qh%4l{fP~WTS4nC6(b+qP@mI%;>v{=xdYN
zI|Z|`t)o;LQ9=Vg?2ZH2^~J1djq3mvXbJJ%tmuv@IwuZyK?!_Lbkurzf+Gh*xu@_7
z--Dpu7et>IzoIgzcxK=F<<~0GCr!Am@U+w%P%y8)z{DOhRapf?^l4)mfDsS|_ieDR
f0a?V8`YYi&<vJa8x^JmI8mSqp%YOl+f4~0^0N-(o

literal 0
HcmV?d00001

diff --git a/gee-cache/doc/geecache-day4/hash.jpg b/gee-cache/doc/geecache-day4/hash.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..e579467c46b7619e74cb476ad84054a15bbd7c9f
GIT binary patch
literal 22150
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

literal 0
HcmV?d00001

diff --git a/gee-cache/doc/geecache-day4/hash_logo.jpg b/gee-cache/doc/geecache-day4/hash_logo.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..95778c9636dd2739189edb4c4cc89c1415f9f95b
GIT binary patch
literal 10096
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
L!leJIL!A9@i&ZT!

literal 0
HcmV?d00001

diff --git a/gee-cache/doc/geecache-day4/hash_select.jpg b/gee-cache/doc/geecache-day4/hash_select.jpg
new file mode 100755
index 0000000000000000000000000000000000000000..7914cfa5d5d064ea7e21d034fb0b73f13766d1be
GIT binary patch
literal 8310
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

literal 0
HcmV?d00001

diff --git a/gee-cache/doc/geecache-day5.md b/gee-cache/doc/geecache-day5.md
new file mode 100644
index 0000000..28111ae
--- /dev/null
+++ b/gee-cache/doc/geecache-day5.md
@@ -0,0 +1,355 @@
+---
+title: 动手写分布式缓存 - GeeCache第五天 分布式节点
+date: 2020-02-16 21:30:00
+description: 7天用 Go语言/golang 从零实现分布式缓存 GeeCache 教程(7 days implement golang distributed cache from scratch tutorial)，动手写分布式缓存，参照 groupcache 的实现。本文介绍了为 GeeCache 添加了注册节点与选择节点的功能，并实现了 HTTP 客户端，与远程节点的服务端通信。
+tags:
+- Go
+nav: 从零实现
+categories:
+- 分布式缓存 - GeeCache
+keywords:
+- Go语言
+- 从零实现
+- HTTP客户端
+- 分布式节点
+image: post/geecache-day5/dist_nodes_logo.jpg
+github: https://github.com/geektutu/7days-golang
+---
+
+![分布式缓存节点](geecache-day5/dist_nodes.jpg)
+
+本文是[7天用Go从零实现分布式缓存GeeCache](https://geektutu.com/post/geecache.html)的第五篇。
+
+- 注册节点(Register Peers)，借助一致性哈希算法选择节点。
+- 实现 HTTP 客户端，与远程节点的服务端通信，**代码约90行**
+
+## 1 流程回顾
+
+```bash
+                            是
+接收 key --> 检查是否被缓存 -----> 返回缓存值 ⑴
+                |  否                         是
+                |-----> 是否应当从远程节点获取 -----> 与远程节点交互 --> 返回缓存值 ⑵
+                            |  否
+                            |-----> 调用`回调函数`，获取值并添加到缓存 --> 返回缓存值 ⑶
+```
+
+我们在[GeeCache 第二天](https://geektutu.com/post/geecache-day2.html) 中描述了 geecache 的流程。在这之前已经实现了流程 ⑴ 和 ⑶，今天实现流程 ⑵，从远程节点获取缓存值。
+
+我们进一步细化流程 ⑵：
+
+```bash
+使用一致性哈希选择节点        是                                    是
+    |-----> 是否是远程节点 -----> HTTP 客户端访问远程节点 --> 成功？-----> 服务端返回返回值
+                    |  否                                    ↓  否
+                    |----------------------------> 回退到本地节点处理。
+```
+
+## 2 抽象 PeerPicker
+
+[day5-multi-nodes/geecache/peers.go - github](https://github.com/geektutu/7days-golang/tree/master/gee-cache/day5-multi-nodes/geecache)
+
+
+```go
+package geecache
+
+// PeerPicker is the interface that must be implemented to locate
+// the peer that owns a specific key.
+type PeerPicker interface {
+	PickPeer(key string) (peer PeerGetter, ok bool)
+}
+
+// PeerGetter is the interface that must be implemented by a peer.
+type PeerGetter interface {
+	Get(group string, key string) ([]byte, error)
+}
+```
+
+- 在这里，抽象出 2 个接口，PeerPicker 的 `PickPeer()` 方法用于根据传入的 key 选择相应节点 PeerGetter。
+- 接口 PeerGetter 的 `Get()` 方法用于从对应 group 查找缓存值。PeerGetter 就对应于上述流程中的 HTTP 客户端。
+
+## 3 节点选择与 HTTP 客户端
+
+
+在 [GeeCache 第三天](https://geektutu.com/post/geecache-day3.html) 中我们为 `HTTPPool` 实现了服务端功能，通信不仅需要服务端还需要客户端，因此，我们接下来要为 `HTTPPool` 实现客户端的功能。
+
+首先创建具体的 HTTP 客户端类 `httpGetter`，实现 PeerGetter 接口。
+
+[day5-multi-nodes/geecache/http.go - github](https://github.com/geektutu/7days-golang/tree/master/gee-cache/day5-multi-nodes/geecache)
+
+```go
+type httpGetter struct {
+	baseURL string
+}
+
+func (h *httpGetter) Get(group string, key string) ([]byte, error) {
+	u := fmt.Sprintf(
+		"%v%v/%v",
+		h.baseURL,
+		url.QueryEscape(group),
+		url.QueryEscape(key),
+	)
+	res, err := http.Get(u)
+	if err != nil {
+		return nil, err
+	}
+	defer res.Body.Close()
+
+	if res.StatusCode != http.StatusOK {
+		return nil, fmt.Errorf("server returned: %v", res.Status)
+	}
+
+	bytes, err := ioutil.ReadAll(res.Body)
+	if err != nil {
+		return nil, fmt.Errorf("reading response body: %v", err)
+	}
+
+	return bytes, nil
+}
+
+var _ PeerGetter = (*httpGetter)(nil)
+```
+
+- baseURL 表示将要访问的远程节点的地址，例如 `http://example.com/_geecache/`。
+- 使用 `http.Get()` 方式获取返回值，并转换为 `[]bytes` 类型。
+
+第二步，为 HTTPPool 添加节点选择的功能。
+
+```go
+const (
+	defaultBasePath = "/_geecache/"
+	defaultReplicas = 50
+)
+// HTTPPool implements PeerPicker for a pool of HTTP peers.
+type HTTPPool struct {
+	// this peer's base URL, e.g. "https://example.net:8000"
+	self        string
+	basePath    string
+	mu          sync.Mutex // guards peers and httpGetters
+	peers       *consistenthash.Map
+	httpGetters map[string]*httpGetter // keyed by e.g. "http://10.0.0.2:8008"
+}
+```
+
+- 新增成员变量 `peers`，类型是一致性哈希算法的 `Map`，用来根据具体的 key 选择节点。
+- 新增成员变量 `httpGetters`，映射远程节点与对应的 httpGetter。每一个远程节点对应一个 httpGetter，因为 httpGetter 与远程节点的地址 `baseURL` 有关。
+
+第三步，实现 PeerPicker 接口。
+
+```go
+// Set updates the pool's list of peers.
+func (p *HTTPPool) Set(peers ...string) {
+	p.mu.Lock()
+	defer p.mu.Unlock()
+	p.peers = consistenthash.New(defaultReplicas, nil)
+	p.peers.Add(peers...)
+	p.httpGetters = make(map[string]*httpGetter, len(peers))
+	for _, peer := range peers {
+		p.httpGetters[peer] = &httpGetter{baseURL: peer + p.basePath}
+	}
+}
+
+// PickPeer picks a peer according to key
+func (p *HTTPPool) PickPeer(key string) (PeerGetter, bool) {
+	p.mu.Lock()
+	defer p.mu.Unlock()
+	if peer := p.peers.Get(key); peer != "" && peer != p.self {
+		p.Log("Pick peer %s", peer)
+		return p.httpGetters[peer], true
+	}
+	return nil, false
+}
+
+var _ PeerPicker = (*HTTPPool)(nil)
+```
+
+- `Set()` 方法实例化了一致性哈希算法，并且添加了传入的节点。
+- 并为每一个节点创建了一个 HTTP 客户端 `httpGetter`。
+- `PickerPeer()` 包装了一致性哈希算法的 `Get()` 方法，根据具体的 key，选择节点，返回节点对应的 HTTP 客户端。
+
+至此，HTTPPool 既具备了提供 HTTP 服务的能力，也具备了根据具体的 key，创建 HTTP 客户端从远程节点获取缓存值的能力。
+
+## 4 实现主流程
+
+最后，我们需要将上述新增的功能集成在主流程(geecache.go)中。
+
+[day5-multi-nodes/geecache/geecache.go - github](https://github.com/geektutu/7days-golang/tree/master/gee-cache/day5-multi-nodes/geecache)
+
+```go
+// A Group is a cache namespace and associated data loaded spread over
+type Group struct {
+	name      string
+	getter    Getter
+	mainCache cache
+	peers     PeerPicker
+}
+
+// RegisterPeers registers a PeerPicker for choosing remote peer
+func (g *Group) RegisterPeers(peers PeerPicker) {
+	if g.peers != nil {
+		panic("RegisterPeerPicker called more than once")
+	}
+	g.peers = peers
+}
+
+func (g *Group) load(key string) (value ByteView, err error) {
+	if g.peers != nil {
+		if peer, ok := g.peers.PickPeer(key); ok {
+			if value, err = g.getFromPeer(peer, key); err == nil {
+				return value, nil
+			}
+			log.Println("[GeeCache] Failed to get from peer", err)
+		}
+	}
+
+	return g.getLocally(key)
+}
+
+func (g *Group) getFromPeer(peer PeerGetter, key string) (ByteView, error) {
+	bytes, err := peer.Get(g.name, key)
+	if err != nil {
+		return ByteView{}, err
+	}
+	return ByteView{b: bytes}, nil
+}
+```
+
+- 新增 `RegisterPeers()` 方法，将 实现了 PeerPicker 接口的 HTTPPool 注入到 Group 中。
+- 新增 `getFromPeer()` 方法，使用实现了 PeerGetter 接口的 httpGetter 从访问远程节点，获取缓存值。
+- 修改 load 方法，使用 `PickPeer()` 方法选择节点，若非本机节点，则调用 `getFromPeer()` 从远程获取。若是本机节点或失败，则回退到 `getLocally()`。
+
+## 5 main 函数测试。
+
+[day5-multi-nodes/main.go - github](https://github.com/geektutu/7days-golang/tree/master/gee-cache/day5-multi-nodes)
+
+```go
+var db = map[string]string{
+	"Tom":  "630",
+	"Jack": "589",
+	"Sam":  "567",
+}
+
+func createGroup() *geecache.Group {
+	return geecache.NewGroup("scores", 2<<10, geecache.GetterFunc(
+		func(key string) ([]byte, error) {
+			log.Println("[SlowDB] search key", key)
+			if v, ok := db[key]; ok {
+				return []byte(v), nil
+			}
+			return nil, fmt.Errorf("%s not exist", key)
+		}))
+}
+
+func startCacheServer(addr string, addrs []string, gee *geecache.Group) {
+	peers := geecache.NewHTTPPool(addr)
+	peers.Set(addrs...)
+	gee.RegisterPeers(peers)
+	log.Println("geecache is running at", addr)
+	log.Fatal(http.ListenAndServe(addr[7:], peers))
+}
+
+func startAPIServer(apiAddr string, gee *geecache.Group) {
+	http.Handle("/api", http.HandlerFunc(
+		func(w http.ResponseWriter, r *http.Request) {
+			key := r.URL.Query().Get("key")
+			view, err := gee.Get(key)
+			if err != nil {
+				http.Error(w, err.Error(), http.StatusInternalServerError)
+				return
+			}
+			w.Header().Set("Content-Type", "application/octet-stream")
+			w.Write(view.ByteSlice())
+
+		}))
+	log.Println("fontend server is running at", apiAddr)
+	log.Fatal(http.ListenAndServe(apiAddr[7:], nil))
+
+}
+
+func main() {
+	var port int
+	var api bool
+	flag.IntVar(&port, "port", 8001, "Geecache server port")
+	flag.BoolVar(&api, "api", false, "Start a api server?")
+	flag.Parse()
+
+	apiAddr := "http://localhost:9999"
+	addrMap := map[int]string{
+		8001: "http://localhost:8001",
+		8002: "http://localhost:8002",
+		8003: "http://localhost:8003",
+	}
+
+	addrs := make([]string, 3)
+
+	for _, v := range addrMap {
+		addrs = append(addrs, v)
+	}
+
+	gee := createGroup()
+	if api {
+		go startAPIServer(apiAddr, gee)
+	}
+	startCacheServer(addrMap[port], []string(addrs), gee)
+}
+```
+
+main 函数的代码比较多，但是逻辑是非常简单的。
+
+- `startCacheServer()` 用来启动缓存服务器：创建 HTTPPool，添加节点信息，注册到 gee 中，启动 HTTP 服务（共3个端口，8001/8002/8003），用户不感知。
+- `startAPIServer()` 用来启动一个 API 服务（端口 9999），与用户进行交互，用户感知。
+- `main()` 函数需要命令行传入 `port` 和 `api` 2 个参数，用来在指定端口启动 HTTP 服务。
+
+为了方便，我们将启动的命令封装为一个 `shell` 脚本：
+
+```bash
+#!/bin/bash
+trap "rm server;kill 0" EXIT
+
+go build -o server
+./server -port=8001 &
+./server -port=8002 &
+./server -port=8003 -api=1 &
+
+sleep 2
+echo ">>> start test"
+curl "http://localhost:9999/api?key=Tom" &
+curl "http://localhost:9999/api?key=Tom" &
+curl "http://localhost:9999/api?key=Tom" &
+
+wait
+```
+
+- `trap` 命令用于在 shell 脚本退出时，删掉临时文件，结束子进程。
+
+```bash
+$ ./run.sh
+2020/02/16 21:17:43 geecache is running at http://localhost:8001
+2020/02/16 21:17:43 geecache is running at http://localhost:8002
+2020/02/16 21:17:43 geecache is running at http://localhost:8003
+2020/02/16 21:17:43 fontend server is running at http://localhost:9999
+>>> start test
+2020/02/16 21:17:45 [Server http://localhost:8003] Pick peer http://localhost:8001
+2020/02/16 21:17:45 [Server http://localhost:8003] Pick peer http://localhost:8001
+2020/02/16 21:17:45 [Server http://localhost:8003] Pick peer http://localhost:8001
+...
+630630630
+```
+
+此时，我们可以打开一个新的 shell，进行测试：
+
+```bash
+$ curl "http://localhost:9999/api?key=Tom"
+630
+$ curl "http://localhost:9999/api?key=kkk"
+kkk not exist
+```
+
+测试的时候，我们并发了 3 个请求 `?key=Tom`，从日志中可以看到，三次均选择了节点 `8001`，这是一致性哈希算法的功劳。但是有一个问题在于，同时向 `8001` 发起了 3 次请求。试想，假如有 10 万个在并发请求该数据呢？那就会向 `8001` 同时发起 10 万次请求，如果 `8001` 又同时向数据库发起 10 万次查询请求，很容易导致缓存被击穿。
+
+三次请求的结果是一致的，对于相同的 key，能不能只向 `8001` 发起一次请求？这个问题下一次解决。
+
+## 附 推荐阅读
+
+- [Go 语言简明教程](https://geektutu.com/post/quick-golang.html)
+- [Go Test 单元测试简明教程](https://geektutu.com/post/quick-go-test.html)
\ No newline at end of file
diff --git a/gee-cache/doc/geecache-day5/dist_nodes.jpg b/gee-cache/doc/geecache-day5/dist_nodes.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..ff04b0dce174e46fa57009f5425a4daf7b06fcf8
GIT binary patch
literal 21817
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
YiaC@p_;Bmol0{)ZB;BX<fwSFz1IVQ$+5i9m

literal 0
HcmV?d00001

diff --git a/gee-cache/doc/geecache-day5/dist_nodes_logo.jpg b/gee-cache/doc/geecache-day5/dist_nodes_logo.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..82aadb3cc98f60058093c7f5bf5f4e0f4ee7d076
GIT binary patch
literal 10792
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
U=l|qI^h<xUB*1^s;3Llc518X}@c;k-

literal 0
HcmV?d00001

diff --git a/gee-cache/doc/geecache-day6.md b/gee-cache/doc/geecache-day6.md
new file mode 100644
index 0000000..a2236f6
--- /dev/null
+++ b/gee-cache/doc/geecache-day6.md
@@ -0,0 +1,203 @@
+---
+title: 动手写分布式缓存 - GeeCache第六天 防止缓存击穿
+date: 2020-02-16 23:00:00
+description: 7天用 Go语言/golang 从零实现分布式缓存 GeeCache 教程(7 days implement golang distributed cache from scratch tutorial)，动手写分布式缓存，参照 groupcache 的实现。本文介绍了缓存雪崩、缓存击穿与缓存穿透的概念，使用 singleflight 防止缓存击穿，实现与测试。
+tags:
+- Go
+nav: 从零实现
+categories:
+- 分布式缓存 - GeeCache
+keywords:
+- Go语言
+- 从零实现
+- HTTP客户端
+- 分布式节点
+image: post/geecache-day6/singleflight_logo.jpg
+github: https://github.com/geektutu/7days-golang
+---
+
+![geecache single flight](geecache-day6/singleflight.jpg)
+
+本文是[7天用Go从零实现分布式缓存GeeCache](https://geektutu.com/post/geecache.html)的第六篇。
+
+- 缓存雪崩、缓存击穿与缓存穿透的概念简介。
+- 使用 singleflight 防止缓存击穿，实现与测试。**代码约70行**
+
+## 1 缓存雪崩、缓存击穿与缓存穿透
+
+[GeeCache 第五天](https://geektutu.com/post/geecache-day5.html) 提到了缓存雪崩和缓存击穿，在这里做下总结：
+
+> **缓存雪崩**：缓存在同一时刻全部失效，造成瞬时DB请求量大、压力骤增，引起雪崩。缓存雪崩通常因为缓存服务器宕机、缓存的 key 设置了相同的过期时间等引起。
+
+> **缓存击穿**：一个存在的key，在缓存过期的一刻，同时有大量的请求，这些请求都会击穿到 DB ，造成瞬时DB请求量大、压力骤增。
+
+> **缓存穿透**：查询一个不存在的数据，因为不存在则不会写到缓存中，所以每次都会去请求 DB，如果瞬间流量过大，穿透到 DB，导致宕机。
+
+## 2 singleflight 的实现
+
+还记得 [GeeCache 第五天](https://geektutu.com/post/geecache-day5.html) 最后的测试结果吗？
+
+```bash
+2020/02/16 21:17:45 [Server http://localhost:8003] Pick peer http://localhost:8001
+2020/02/16 21:17:45 [Server http://localhost:8003] Pick peer http://localhost:8001
+2020/02/16 21:17:45 [Server http://localhost:8003] Pick peer http://localhost:8001
+```
+
+我们并发了 N 个请求 `?key=Tom`，8003 节点向 8001 同时发起了 N 次请求。假设对数据库的访问没有做任何限制的，很可能向数据库也发起 N 次请求，容易导致缓存击穿和穿透。即使对数据库做了防护，HTTP 请求是非常耗费资源的操作，针对相同的 key，8003 节点向 8001 发起三次请求也是没有必要的。那这种情况下，我们如何做到只向远端节点发起一次请求呢？
+
+geecache 实现了一个名为 singleflight 的 package 来解决这个问题。
+
+[day6-single-flight/geecache/singleflight/singleflight.go - github](https://github.com/geektutu/7days-golang/tree/master/gee-cache/day6-single-flight/geecache/singleflight)
+
+首先创建 `call` 和 `Group` 类型。
+
+```go
+package singleflight
+
+import "sync"
+
+type call struct {
+	wg  sync.WaitGroup
+	val interface{}
+	err error
+}
+
+type Group struct {
+	mu sync.Mutex       // protects m
+	m  map[string]*call
+}
+```
+
+- `call` 代表正在进行中，或已经结束的请求。使用 `sync.WaitGroup` 锁避免重入。
+- `Group` 是 singleflight 的主数据结构，管理不同 key 的请求(call)。
+
+实现 `Do` 方法
+
+```go
+func (g *Group) Do(key string, fn func() (interface{}, error)) (interface{}, error) {
+	g.mu.Lock()
+	if g.m == nil {
+		g.m = make(map[string]*call)
+	}
+	if c, ok := g.m[key]; ok {
+		g.mu.Unlock()
+		c.wg.Wait()
+		return c.val, c.err
+	}
+	c := new(call)
+	c.wg.Add(1)
+	g.m[key] = c
+	g.mu.Unlock()
+
+	c.val, c.err = fn()
+	c.wg.Done()
+
+	g.mu.Lock()
+	delete(g.m, key)
+	g.mu.Unlock()
+
+	return c.val, c.err
+}
+```
+
+- Do 方法，接收 2 个参数，第一个参数是 `key`，第二个参数是一个函数 `fn`。Do 的作用就是，针对相同的 key，无论 Do 被调用多少次，函数 `fn` 都只会被调用一次，等待 fn 调用结束了，返回返回值或错误。
+
+`g.mu` 是保护 Group 的成员变量 `m` 不被并发读写而加上的锁。为了便于理解 `Do` 函数，我们将 `g.mu` 暂时去掉。并且把 `g.m` 延迟初始化的部分去掉，延迟初始化的目的很简单，提高内存使用效率。
+
+剩下的逻辑就很清晰了：
+
+```go
+func (g *Group) Do(key string, fn func() (interface{}, error)) (interface{}, error) {
+	if c, ok := g.m[key]; ok {
+		c.wg.Wait()   // 如果请求正在进行中，则等待
+		return c.val, c.err  // 请求结束，返回结果
+	}
+	c := new(call)
+	c.wg.Add(1)       // 发起请求前加锁
+	g.m[key] = c      // 添加到 g.m，表明 key 已经有对应的请求在处理
+
+	c.val, c.err = fn() // 调用 fn，发起请求
+	c.wg.Done()         // 请求结束
+
+    delete(g.m, key)    // 更新 g.m
+    
+	return c.val, c.err // 返回结果
+}
+```
+
+并发协程之间不需要消息传递，非常适合 `sync.WaitGroup`。
+
+- wg.Add(1) 锁加1。
+- wg.Wait() 阻塞，直到锁被释放。
+- wg.Done() 锁减1。
+
+## 3 singleflight 的使用
+
+[day6-single-flight/geecache/geecache.go - github](https://github.com/geektutu/7days-golang/tree/master/gee-cache/day6-single-flight/geecache)
+
+```go
+type Group struct {
+	name      string
+	getter    Getter
+	mainCache cache
+	peers     PeerPicker
+	// use singleflight.Group to make sure that
+	// each key is only fetched once
+	loader *singleflight.Group
+}
+
+func NewGroup(name string, cacheBytes int64, getter Getter) *Group {
+    // ...
+	g := &Group{
+        // ...
+		loader:    &singleflight.Group{},
+	}
+	return g
+}
+
+func (g *Group) load(key string) (value ByteView, err error) {
+	// each key is only fetched once (either locally or remotely)
+	// regardless of the number of concurrent callers.
+	viewi, err := g.loader.Do(key, func() (interface{}, error) {
+		if g.peers != nil {
+			if peer, ok := g.peers.PickPeer(key); ok {
+				if value, err = g.getFromPeer(peer, key); err == nil {
+					return value, nil
+				}
+				log.Println("[GeeCache] Failed to get from peer", err)
+			}
+		}
+
+		return g.getLocally(key)
+	})
+
+	if err == nil {
+		return viewi.(ByteView), nil
+	}
+	return
+}
+```
+
+- 修改 `geecache.go` 中的 `Group`，添加成员变量 loader，并更新构建函数 `NewGroup`。
+- 修改 `load` 函数，将原来的 load 的逻辑，使用 `g.loader.Do` 包裹起来即可，这样确保了并发场景下针对相同的 key，`load` 过程只会调用一次。
+
+## 4 测试
+
+执行 `run.sh` 就可以看到效果了。
+
+```bash
+$ ./run.sh
+2020/02/16 22:36:00 [Server http://localhost:8003] Pick peer http://localhost:8001
+2020/02/16 22:36:00 [Server http://localhost:8001] GET /_geecache/scores/Tom
+2020/02/16 22:36:00 [SlowDB] search key Tom
+630630630
+```
+
+可以看到，向 API 发起了三次并发请求，但8003 只向 8001 发起了一次请求，就搞定了。
+
+如果并发度不够高，可能仍会看到向 8001 请求三次的场景。这种情况下三次请求是串行执行的，并没有触发 `singleflight` 的锁机制工作，可以加大并发数量再测试。即，将 `run.sh` 中的 `curl` 命令复制 N 次。
+
+## 附 推荐
+
+- [Go 语言简明教程#并发编程](https://geektutu.com/post/quick-golang.html#7-%E5%B9%B6%E5%8F%91%E7%BC%96%E7%A8%8B-goroutine)
+- [Go Test 单元测试简明教程](https://geektutu.com/post/quick-go-test.html)
\ No newline at end of file
diff --git a/gee-cache/doc/geecache-day6/singleflight.jpg b/gee-cache/doc/geecache-day6/singleflight.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..09d0d88de986c79c2b3e8585d8418d6b8fc73380
GIT binary patch
literal 22694
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

literal 0
HcmV?d00001

diff --git a/gee-cache/doc/geecache-day6/singleflight_logo.jpg b/gee-cache/doc/geecache-day6/singleflight_logo.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..a53fb410020fe1f00e0219b0ca0b5a488c9b9bf2
GIT binary patch
literal 9351
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
Bj;8<s

literal 0
HcmV?d00001

diff --git a/gee-cache/doc/geecache-day7.md b/gee-cache/doc/geecache-day7.md
new file mode 100644
index 0000000..c1bb34c
--- /dev/null
+++ b/gee-cache/doc/geecache-day7.md
@@ -0,0 +1,173 @@
+---
+title: 动手写分布式缓存 - GeeCache第七天 使用 Protobuf 通信
+date: 2020-02-17 00:30:00
+description: 7天用 Go语言/golang 从零实现分布式缓存 GeeCache 教程(7 days implement golang distributed cache from scratch tutorial)，动手写分布式缓存，参照 groupcache 的实现。本文介绍了使用 protobuf(protocol buffer) 进行节点间通信，编码报文，提高效率
+tags:
+- Go
+nav: 从零实现
+categories:
+- 分布式缓存 - GeeCache
+keywords:
+- Go语言
+- 从零实现
+- HTTP客户端
+- 分布式节点
+image: post/geecache-day7/protobuf_logo.jpg
+github: https://github.com/geektutu/7days-golang
+---
+
+![geecache protobuf](geecache-day7/protobuf.jpg)
+
+本文是[7天用Go从零实现分布式缓存GeeCache](https://geektutu.com/post/geecache.html)的第七篇。
+
+- 为什么要使用 protobuf？
+- 使用 protobuf 进行节点间通信，编码报文，提高效率。**代码约50行**
+
+## 1 为什么要使用 protobuf
+
+> protobuf 即 Protocol Buffers，Google 开发的一种数据描述语言，是一种轻便高效的结构化数据存储格式，与语言、平台无关，可扩展可序列化。protobuf 以二进制方式存储，占用空间小。
+
+protobuf 的安装和使用教程请移步 [Go Protobuf 简明教程](https://geektutu.com/post/quick-go-protobuf.html)，这篇文章就不再赘述了。protobuf 广泛地应用于远程过程调用(RPC) 的二进制传输，使用 protobuf 的目的非常简单，为了获得更高的性能。传输前使用 protobuf 编码，接收方再进行解码，可以显著地降低二进制传输的大小。另外一方面，protobuf 可非常适合传输结构化数据，便于通信字段的扩展。
+
+使用 protobuf 一般分为以下 2 步：
+
+- 按照 protobuf 的语法，在 `.proto` 文件中定义数据结构，并使用 `protoc` 生成 Go 代码（`.proto` 文件是跨平台的，还可以生成 C、Java 等其他源码文件）。
+- 在项目代码中引用生成的 Go 代码。
+
+## 2 使用 protobuf 通信
+
+新建 package `geecachepb`，定义 `geecachepb.proto`
+
+[day7-proto-buf/geecache/geecachepb/geecachepb.proto - github](https://github.com/geektutu/7days-golang/tree/master/gee-cache/day7-proto-buf/geecache/geecachepb)
+
+```go
+syntax = "proto3";
+
+package geecachepb;
+
+message Request {
+  string group = 1;
+  string key = 2;
+}
+
+message Response {
+  bytes value = 1;
+}
+
+service GroupCache {
+  rpc Get(Request) returns (Response);
+}
+```
+
+- `Request` 包含 2 个字段， group 和 cache，这与我们之前定义的接口 `/_geecache/<group>/<name>` 所需的参数吻合。
+- `Response` 包含 1 个字段，bytes，类型为 byte 数组，与之前吻合。
+
+生成 `geecache.pb.go`
+
+```bash
+$ protoc --go_out=. *.proto
+$ ls
+geecachepb.pb.go  geecachepb.proto
+```
+
+可以看到 `geecachepb.pb.go` 中有如下数据类型：
+
+```go
+type Request struct {
+	Group string   `protobuf:"bytes,1,opt,name=group,proto3" json:"group,omitempty"`
+    Key   string   `protobuf:"bytes,2,opt,name=key,proto3" json:"key,omitempty"`
+    ...
+}
+type Response struct {
+	Value []byte   `protobuf:"bytes,1,opt,name=value,proto3" json:"value,omitempty"`
+}
+```
+
+接下来，修改 `peers.go` 中的 `PeerGetter` 接口，参数使用 `geecachepb.pb.go` 中的数据类型。
+
+[day7-proto-buf/geecache/peers.go - github](https://github.com/geektutu/7days-golang/tree/master/gee-cache/day7-proto-buf/geecache)
+
+```go
+import pb "geecache/geecachepb"
+
+type PeerGetter interface {
+	Get(in *pb.Request, out *pb.Response) error
+}
+```
+
+最后，修改 `geecache.go` 和 `http.go` 中使用了 `PeerGetter` 接口的地方。
+
+[day7-proto-buf/geecache/geecache.go - github](https://github.com/geektutu/7days-golang/tree/master/gee-cache/day7-proto-buf/geecache)
+
+```go
+import (
+    // ...
+    pb "geecache/geecachepb"
+)
+
+func (g *Group) getFromPeer(peer PeerGetter, key string) (ByteView, error) {
+	req := &pb.Request{
+		Group: g.name,
+		Key:   key,
+	}
+	res := &pb.Response{}
+	err := peer.Get(req, res)
+	if err != nil {
+		return ByteView{}, err
+	}
+	return ByteView{b: res.Value}, nil
+}
+```
+
+[day7-proto-buf/geecache/http.go - github](https://github.com/geektutu/7days-golang/tree/master/gee-cache/day7-proto-buf/geecache)
+
+```go
+import (
+    // ...
+	pb "geecache/geecachepb"
+	"github.com/golang/protobuf/proto"
+)
+
+func (p *HTTPPool) ServeHTTP(w http.ResponseWriter, r *http.Request) {
+    // ...
+	// Write the value to the response body as a proto message.
+	body, err := proto.Marshal(&pb.Response{Value: view.ByteSlice()})
+	if err != nil {
+		http.Error(w, err.Error(), http.StatusInternalServerError)
+		return
+	}
+	w.Header().Set("Content-Type", "application/octet-stream")
+	w.Write(body)
+}
+
+func (h *httpGetter) Get(in *pb.Request, out *pb.Response) error {
+	u := fmt.Sprintf(
+		"%v%v/%v",
+		h.baseURL,
+		url.QueryEscape(in.GetGroup()),
+		url.QueryEscape(in.GetKey()),
+	)
+    res, err := http.Get(u)
+	// ...
+	if err = proto.Unmarshal(bytes, out); err != nil {
+		return fmt.Errorf("decoding response body: %v", err)
+	}
+
+	return nil
+}
+```
+
+- `ServeHTTP()` 中使用 `proto.Marshal()` 编码 HTTP 响应。
+- `Get()` 中使用 `proto.Unmarshal()` 解码 HTTP 响应。
+
+至此，我们已经将 HTTP 通信的中间载体替换成了 protobuf。运行 `run.sh` 即可以测试 GeeCache 能否正常工作。
+
+## 总结
+
+到这一篇为止，7 天用 Go 动手写/从零实现分布式缓存 GeeCache 这个系列就完成了。简单回顾下。第一天，为了解决资源限制的问题，实现了 LRU 缓存淘汰算法；第二天实现了单机并发，并给用户提供了自定义数据源的回调函数；第三天实现了 HTTP 服务端；第四天实现了一致性哈希算法，解决远程节点的挑选问题；第五天创建 HTTP 客户端，实现了多节点间的通信；第六天实现了 singleflight 解决缓存击穿的问题；第七天，使用 protobuf 库，优化了节点间通信的性能。如果看到这里，还没有动手写的话呢，赶紧动手写起来吧。一天差不多只需要实现 100 行代码呢。
+
+## 附 推荐
+
+- [Go 语言简明教程](https://geektutu.com/post/quick-golang.html)
+- [Go Test 单元测试简明教程](https://geektutu.com/post/quick-go-test.html)
+- [Go Protobuf 简明教程](https://geektutu.com/post/quick-go-protobuf.html)
\ No newline at end of file
diff --git a/gee-cache/doc/geecache-day7/protobuf.jpg b/gee-cache/doc/geecache-day7/protobuf.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..ee96320b0ee08ee29d2f6dcf73db60b1fcc50a56
GIT binary patch
literal 21374
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
N1yEk205ku;2>=MDH9`OY

literal 0
HcmV?d00001

diff --git a/gee-cache/doc/geecache-day7/protobuf_logo.jpg b/gee-cache/doc/geecache-day7/protobuf_logo.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..cacd9628408559325a6c74adddb4d6146711ac37
GIT binary patch
literal 9376
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

literal 0
HcmV?d00001

diff --git a/gee-cache/doc/geecache.md b/gee-cache/doc/geecache.md
index 0429e78..3eb89ad 100644
--- a/gee-cache/doc/geecache.md
+++ b/gee-cache/doc/geecache.md
@@ -61,10 +61,10 @@ github: https://github.com/geektutu/7days-golang
 - 第一天：[LRU 缓存淘汰策略](https://geektutu.com/post/geecache-day1.html) | [Code - Github](https://github.com/geektutu/7days-golang/blob/master/gee-cache/day1-lru)
 - 第二天：[单机并发缓存](https://geektutu.com/post/geecache-day2.html) | [Code - Github](https://github.com/geektutu/7days-golang/blob/master/gee-cache/day2-single-node)
 - 第三天：[HTTP 服务端](https://geektutu.com/post/geecache-day3.html) | [Code - Github](https://github.com/geektutu/7days-golang/blob/master/gee-cache/day3-http-server)
-- 第四天：一致性哈希(Hash) | [Code - Github](https://github.com/geektutu/7days-golang/blob/master/gee-cache/day4-consistent-hash)
-- 第五天：分布式节点 | [Code - Github](https://github.com/geektutu/7days-golang/blob/master/gee-cache/day5-multi-nodes)
-- 第六天：防止缓存击穿 | [Code - Github](https://github.com/geektutu/7days-golang/blob/master/gee-cache/day6-single-flight)
-- 第七天：使用 Protobuf 通信 | [Code - Github](https://github.com/geektutu/7days-golang/blob/master/gee-cache/day7-proto-buf)
+- 第四天：[一致性哈希(Hash)](https://geektutu.com/post/geecache-day4.html) | [Code - Github](https://github.com/geektutu/7days-golang/blob/master/gee-cache/day4-consistent-hash)
+- 第五天：[分布式节点](https://geektutu.com/post/geecache-day5.html) | [Code - Github](https://github.com/geektutu/7days-golang/blob/master/gee-cache/day5-multi-nodes)
+- 第六天：[防止缓存击穿](https://geektutu.com/post/geecache-day6.html) | [Code - Github](https://github.com/geektutu/7days-golang/blob/master/gee-cache/day6-single-flight)
+- 第七天：[使用 Protobuf 通信](https://geektutu.com/post/geecache-day7.html) | [Code - Github](https://github.com/geektutu/7days-golang/blob/master/gee-cache/day7-proto-buf)
 
 ## 附 推荐阅读
 

From 30aad5035a981de4afe4c54679f8debd0446395b Mon Sep 17 00:00:00 2001
From: gzdaijie <gzdaijie@gmail.com>
Date: Thu, 20 Feb 2020 20:26:30 +0800
Subject: [PATCH 034/122] use go modules to replace relative path

---
 gee-web/day1-http-base/base1/go.mod     |  3 +++
 gee-web/day1-http-base/base2/go.mod     |  3 +++
 gee-web/day1-http-base/base3/gee/go.mod |  3 +++
 gee-web/day1-http-base/base3/go.mod     |  7 +++++++
 gee-web/day1-http-base/base3/main.go    |  2 +-
 gee-web/day2-context/gee/go.mod         |  3 +++
 gee-web/day2-context/go.mod             |  7 +++++++
 gee-web/day2-context/main.go            |  2 +-
 gee-web/day3-router/gee/go.mod          |  3 +++
 gee-web/day3-router/go.mod              |  7 +++++++
 gee-web/day3-router/main.go             |  2 +-
 gee-web/day4-group/gee/go.mod           |  3 +++
 gee-web/day4-group/go.mod               |  7 +++++++
 gee-web/day4-group/main.go              |  2 +-
 gee-web/day5-middleware/gee/go.mod      |  3 +++
 gee-web/day5-middleware/go.mod          |  7 +++++++
 gee-web/day5-middleware/main.go         |  2 +-
 gee-web/day6-template/gee/go.mod        |  3 +++
 gee-web/day6-template/go.mod            |  7 +++++++
 gee-web/day6-template/main.go           |  2 +-
 gee-web/day7-panic-recover/gee/go.mod   |  3 +++
 gee-web/day7-panic-recover/go.mod       |  7 +++++++
 gee-web/day7-panic-recover/main.go      |  2 +-
 gee-web/doc/gee-day1.md                 | 22 +++++++++++++++++++++-
 gee-web/doc/gee-day6.md                 | 20 ++++++++++++++++++++
 gee-web/doc/gee-day7.md                 |  2 +-
 26 files changed, 125 insertions(+), 9 deletions(-)
 create mode 100644 gee-web/day1-http-base/base1/go.mod
 create mode 100644 gee-web/day1-http-base/base2/go.mod
 create mode 100644 gee-web/day1-http-base/base3/gee/go.mod
 create mode 100644 gee-web/day1-http-base/base3/go.mod
 create mode 100644 gee-web/day2-context/gee/go.mod
 create mode 100644 gee-web/day2-context/go.mod
 create mode 100644 gee-web/day3-router/gee/go.mod
 create mode 100644 gee-web/day3-router/go.mod
 create mode 100644 gee-web/day4-group/gee/go.mod
 create mode 100644 gee-web/day4-group/go.mod
 create mode 100644 gee-web/day5-middleware/gee/go.mod
 create mode 100644 gee-web/day5-middleware/go.mod
 create mode 100644 gee-web/day6-template/gee/go.mod
 create mode 100644 gee-web/day6-template/go.mod
 create mode 100644 gee-web/day7-panic-recover/gee/go.mod
 create mode 100644 gee-web/day7-panic-recover/go.mod

diff --git a/gee-web/day1-http-base/base1/go.mod b/gee-web/day1-http-base/base1/go.mod
new file mode 100644
index 0000000..8d2394a
--- /dev/null
+++ b/gee-web/day1-http-base/base1/go.mod
@@ -0,0 +1,3 @@
+module example
+
+go 1.13
diff --git a/gee-web/day1-http-base/base2/go.mod b/gee-web/day1-http-base/base2/go.mod
new file mode 100644
index 0000000..8d2394a
--- /dev/null
+++ b/gee-web/day1-http-base/base2/go.mod
@@ -0,0 +1,3 @@
+module example
+
+go 1.13
diff --git a/gee-web/day1-http-base/base3/gee/go.mod b/gee-web/day1-http-base/base3/gee/go.mod
new file mode 100644
index 0000000..c944c8a
--- /dev/null
+++ b/gee-web/day1-http-base/base3/gee/go.mod
@@ -0,0 +1,3 @@
+module gee
+
+go 1.13
diff --git a/gee-web/day1-http-base/base3/go.mod b/gee-web/day1-http-base/base3/go.mod
new file mode 100644
index 0000000..b27ebc4
--- /dev/null
+++ b/gee-web/day1-http-base/base3/go.mod
@@ -0,0 +1,7 @@
+module example
+
+go 1.13
+
+require gee v0.0.0
+
+replace gee => ./gee
diff --git a/gee-web/day1-http-base/base3/main.go b/gee-web/day1-http-base/base3/main.go
index 5f55dc2..5cdac75 100644
--- a/gee-web/day1-http-base/base3/main.go
+++ b/gee-web/day1-http-base/base3/main.go
@@ -12,7 +12,7 @@ import (
 	"fmt"
 	"net/http"
 
-	"./gee"
+	"gee"
 )
 
 func main() {
diff --git a/gee-web/day2-context/gee/go.mod b/gee-web/day2-context/gee/go.mod
new file mode 100644
index 0000000..c944c8a
--- /dev/null
+++ b/gee-web/day2-context/gee/go.mod
@@ -0,0 +1,3 @@
+module gee
+
+go 1.13
diff --git a/gee-web/day2-context/go.mod b/gee-web/day2-context/go.mod
new file mode 100644
index 0000000..b27ebc4
--- /dev/null
+++ b/gee-web/day2-context/go.mod
@@ -0,0 +1,7 @@
+module example
+
+go 1.13
+
+require gee v0.0.0
+
+replace gee => ./gee
diff --git a/gee-web/day2-context/main.go b/gee-web/day2-context/main.go
index a493d3f..6f86bee 100644
--- a/gee-web/day2-context/main.go
+++ b/gee-web/day2-context/main.go
@@ -25,7 +25,7 @@ $ curl "http://localhost:9999/xxx"
 import (
 	"net/http"
 
-	"./gee"
+	"gee"
 )
 
 func main() {
diff --git a/gee-web/day3-router/gee/go.mod b/gee-web/day3-router/gee/go.mod
new file mode 100644
index 0000000..c944c8a
--- /dev/null
+++ b/gee-web/day3-router/gee/go.mod
@@ -0,0 +1,3 @@
+module gee
+
+go 1.13
diff --git a/gee-web/day3-router/go.mod b/gee-web/day3-router/go.mod
new file mode 100644
index 0000000..b27ebc4
--- /dev/null
+++ b/gee-web/day3-router/go.mod
@@ -0,0 +1,7 @@
+module example
+
+go 1.13
+
+require gee v0.0.0
+
+replace gee => ./gee
diff --git a/gee-web/day3-router/main.go b/gee-web/day3-router/main.go
index 60a7d9a..25f623e 100644
--- a/gee-web/day3-router/main.go
+++ b/gee-web/day3-router/main.go
@@ -29,7 +29,7 @@ $ curl "http://localhost:9999/xxx"
 import (
 	"net/http"
 
-	"./gee"
+	"gee"
 )
 
 func main() {
diff --git a/gee-web/day4-group/gee/go.mod b/gee-web/day4-group/gee/go.mod
new file mode 100644
index 0000000..c944c8a
--- /dev/null
+++ b/gee-web/day4-group/gee/go.mod
@@ -0,0 +1,3 @@
+module gee
+
+go 1.13
diff --git a/gee-web/day4-group/go.mod b/gee-web/day4-group/go.mod
new file mode 100644
index 0000000..b27ebc4
--- /dev/null
+++ b/gee-web/day4-group/go.mod
@@ -0,0 +1,7 @@
+module example
+
+go 1.13
+
+require gee v0.0.0
+
+replace gee => ./gee
diff --git a/gee-web/day4-group/main.go b/gee-web/day4-group/main.go
index 68c2d74..4336a9c 100644
--- a/gee-web/day4-group/main.go
+++ b/gee-web/day4-group/main.go
@@ -37,7 +37,7 @@ $ curl "http://localhost:9999/hello"
 import (
 	"net/http"
 
-	"./gee"
+	"gee"
 )
 
 func main() {
diff --git a/gee-web/day5-middleware/gee/go.mod b/gee-web/day5-middleware/gee/go.mod
new file mode 100644
index 0000000..c944c8a
--- /dev/null
+++ b/gee-web/day5-middleware/gee/go.mod
@@ -0,0 +1,3 @@
+module gee
+
+go 1.13
diff --git a/gee-web/day5-middleware/go.mod b/gee-web/day5-middleware/go.mod
new file mode 100644
index 0000000..b27ebc4
--- /dev/null
+++ b/gee-web/day5-middleware/go.mod
@@ -0,0 +1,7 @@
+module example
+
+go 1.13
+
+require gee v0.0.0
+
+replace gee => ./gee
diff --git a/gee-web/day5-middleware/main.go b/gee-web/day5-middleware/main.go
index 469de0d..b66dbdc 100644
--- a/gee-web/day5-middleware/main.go
+++ b/gee-web/day5-middleware/main.go
@@ -24,7 +24,7 @@ import (
 	"net/http"
 	"time"
 
-	"./gee"
+	"gee"
 )
 
 func onlyForV2() gee.HandlerFunc {
diff --git a/gee-web/day6-template/gee/go.mod b/gee-web/day6-template/gee/go.mod
new file mode 100644
index 0000000..c944c8a
--- /dev/null
+++ b/gee-web/day6-template/gee/go.mod
@@ -0,0 +1,3 @@
+module gee
+
+go 1.13
diff --git a/gee-web/day6-template/go.mod b/gee-web/day6-template/go.mod
new file mode 100644
index 0000000..b27ebc4
--- /dev/null
+++ b/gee-web/day6-template/go.mod
@@ -0,0 +1,7 @@
+module example
+
+go 1.13
+
+require gee v0.0.0
+
+replace gee => ./gee
diff --git a/gee-web/day6-template/main.go b/gee-web/day6-template/main.go
index 2400183..79b89bc 100644
--- a/gee-web/day6-template/main.go
+++ b/gee-web/day6-template/main.go
@@ -39,7 +39,7 @@ import (
 	"net/http"
 	"time"
 
-	"./gee"
+	"gee"
 )
 
 type student struct {
diff --git a/gee-web/day7-panic-recover/gee/go.mod b/gee-web/day7-panic-recover/gee/go.mod
new file mode 100644
index 0000000..c944c8a
--- /dev/null
+++ b/gee-web/day7-panic-recover/gee/go.mod
@@ -0,0 +1,3 @@
+module gee
+
+go 1.13
diff --git a/gee-web/day7-panic-recover/go.mod b/gee-web/day7-panic-recover/go.mod
new file mode 100644
index 0000000..b27ebc4
--- /dev/null
+++ b/gee-web/day7-panic-recover/go.mod
@@ -0,0 +1,7 @@
+module example
+
+go 1.13
+
+require gee v0.0.0
+
+replace gee => ./gee
diff --git a/gee-web/day7-panic-recover/main.go b/gee-web/day7-panic-recover/main.go
index a342f66..c5b309b 100644
--- a/gee-web/day7-panic-recover/main.go
+++ b/gee-web/day7-panic-recover/main.go
@@ -35,7 +35,7 @@ Traceback:
 import (
 	"net/http"
 
-	"./gee"
+	"gee"
 )
 
 func main() {
diff --git a/gee-web/doc/gee-day1.md b/gee-web/doc/gee-day1.md
index ca00e8a..de30bc9 100644
--- a/gee-web/doc/gee-day1.md
+++ b/gee-web/doc/gee-day1.md
@@ -131,9 +131,29 @@ func main() {
 ```bash
 gee/
   |--gee.go
+  |--go.mod
 main.go
+go.mod
 ```
 
+### go.mod
+
+**[day1-http-base/base3/go.mod](https://github.com/geektutu/7days-golang/tree/master/gee-web/day1-http-base/base3)**
+
+```bash
+module example
+
+go 1.13
+
+require gee v0.0.0
+
+replace gee => ./gee
+```
+
+- 在 `go.mod` 中使用 `replace` 将 gee 指向 `./gee`
+
+> 从 go 1.11 版本开始，引用相对路径的 package 需要使用上述方式。
+
 ### main.go
 
 **[day1-http-base/base3/main.go](https://github.com/geektutu/7days-golang/tree/master/gee-web/day1-http-base/base3)**
@@ -145,7 +165,7 @@ import (
 	"fmt"
 	"net/http"
 
-	"./gee"
+	"gee"
 )
 
 func main() {
diff --git a/gee-web/doc/gee-day6.md b/gee-web/doc/gee-day6.md
index b77f041..a12ff30 100644
--- a/gee-web/doc/gee-day6.md
+++ b/gee-web/doc/gee-day6.md
@@ -107,6 +107,12 @@ func (engine *Engine) LoadHTMLGlob(pattern string) {
 [day6-template/gee/context.go](https://github.com/geektutu/7days-golang/tree/master/gee-web/day6-template)
 
 ```go
+type Context struct {
+    // ...
+	// engine pointer
+	engine *Engine
+}
+
 func (c *Context) HTML(code int, name string, data interface{}) {
 	c.Writer.WriteHeader(code)
 	c.Writer.Header().Set("Content-Type", "text/html")
@@ -116,6 +122,20 @@ func (c *Context) HTML(code int, name string, data interface{}) {
 }
 ```
 
+我们在 `Context` 中添加了成员变量 `engine *Engine`，这样就能够通过 Context 访问 Engine 中的 HTML 模板。实例化 Context 时，还需要给 `c.engine` 赋值。
+
+[day6-template/gee/gee.go](https://github.com/geektutu/7days-golang/tree/master/gee-web/day6-template)
+
+```go
+func (engine *Engine) ServeHTTP(w http.ResponseWriter, req *http.Request) {
+	// ...
+	c := newContext(w, req)
+	c.handlers = middlewares
+	c.engine = engine
+	engine.router.handle(c)
+}
+```
+
 ## 使用Demo
 
 最终的目录结构
diff --git a/gee-web/doc/gee-day7.md b/gee-web/doc/gee-day7.md
index b3f6873..08310ca 100644
--- a/gee-web/doc/gee-day7.md
+++ b/gee-web/doc/gee-day7.md
@@ -228,7 +228,7 @@ package main
 import (
 	"net/http"
 
-	"./gee"
+	"gee"
 )
 
 func main() {

From 78b6e80ae25cb71dbd0a23a9376c4405f5d93118 Mon Sep 17 00:00:00 2001
From: gzdaijie <gzdaijie@gmail.com>
Date: Thu, 20 Feb 2020 21:00:29 +0800
Subject: [PATCH 035/122] add zhihu zhuanlan & weibo link

---
 README.md | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 469482f..50682a1 100644
--- a/README.md
+++ b/README.md
@@ -8,7 +8,9 @@
 
 7天能写什么呢？类似 gin 的 web 框架？类似 groupcache 的分布式缓存？或者一个简单的 Python 解释器？希望这个仓库能给你答案。
 
-推荐先阅读 **[Go 语言简明教程](https://geektutu.com/post/quick-golang.html)**，一篇文章了解Go的基本语法、并发编程，依赖管理等内容
+推荐先阅读 **[Go 语言简明教程](https://geektutu.com/post/quick-golang.html)**，一篇文章了解Go的基本语法、并发编程，依赖管理等内容。
+
+期待关注我的「[知乎专栏](https://zhuanlan.zhihu.com/geekgo)」和「[微博](http://weibo.com/geektutu)」，查看最近的文章和动态。
 
 ### 7天用Go从零实现Web框架 - Gee
 

From c5c650bee4885987182c847e8d1857168fc389f9 Mon Sep 17 00:00:00 2001
From: gzdaijie <gzdaijie@gmail.com>
Date: Sat, 22 Feb 2020 15:10:47 +0800
Subject: [PATCH 036/122] geeorm: a gorm-like orm framework

---
 .gitignore                                    |  6 +-
 .../geeorm/dialect/dialect.go                 | 19 ++++++
 .../geeorm/dialect/sqlite3.go                 | 43 ++++++++++++
 .../geeorm/dialect/sqlite3_test.go            | 25 +++++++
 gee-orm/day1-database-sql/geeorm/geeorm.go    | 67 +++++++++++++++++++
 .../day1-database-sql/geeorm/geeorm_test.go   | 20 ++++++
 gee-orm/day1-database-sql/geeorm/go.mod       |  5 ++
 .../day1-database-sql/geeorm/schema/field.go  | 13 ++++
 .../day1-database-sql/geeorm/schema/schema.go | 45 +++++++++++++
 .../geeorm/schema/schema_test.go              | 20 ++++++
 gee-orm/day1-database-sql/geeorm/session.go   | 48 +++++++++++++
 .../day1-database-sql/geeorm/session_test.go  | 29 ++++++++
 12 files changed, 339 insertions(+), 1 deletion(-)
 create mode 100644 gee-orm/day1-database-sql/geeorm/dialect/dialect.go
 create mode 100644 gee-orm/day1-database-sql/geeorm/dialect/sqlite3.go
 create mode 100644 gee-orm/day1-database-sql/geeorm/dialect/sqlite3_test.go
 create mode 100644 gee-orm/day1-database-sql/geeorm/geeorm.go
 create mode 100644 gee-orm/day1-database-sql/geeorm/geeorm_test.go
 create mode 100644 gee-orm/day1-database-sql/geeorm/go.mod
 create mode 100644 gee-orm/day1-database-sql/geeorm/schema/field.go
 create mode 100644 gee-orm/day1-database-sql/geeorm/schema/schema.go
 create mode 100644 gee-orm/day1-database-sql/geeorm/schema/schema_test.go
 create mode 100644 gee-orm/day1-database-sql/geeorm/session.go
 create mode 100644 gee-orm/day1-database-sql/geeorm/session_test.go

diff --git a/.gitignore b/.gitignore
index ae93b1b..d9335e2 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,2 +1,6 @@
 .DS_Store
-tmp
\ No newline at end of file
+.idea
+.vscode
+tmp
+*.db
+*.sum
\ No newline at end of file
diff --git a/gee-orm/day1-database-sql/geeorm/dialect/dialect.go b/gee-orm/day1-database-sql/geeorm/dialect/dialect.go
new file mode 100644
index 0000000..ee07db3
--- /dev/null
+++ b/gee-orm/day1-database-sql/geeorm/dialect/dialect.go
@@ -0,0 +1,19 @@
+package dialect
+
+import "reflect"
+
+var dialectsMap = map[string]Dialect{}
+
+type Dialect interface {
+	DataTypeOf(typ reflect.Value) string
+	PrimaryKeyTag(key string) string
+}
+
+func RegisterDialect(name string, dialect Dialect) {
+	dialectsMap[name] = dialect
+}
+
+func GetDialect(name string) (dialect Dialect, ok bool) {
+	dialect, ok = dialectsMap[name]
+	return
+}
diff --git a/gee-orm/day1-database-sql/geeorm/dialect/sqlite3.go b/gee-orm/day1-database-sql/geeorm/dialect/sqlite3.go
new file mode 100644
index 0000000..8eca05a
--- /dev/null
+++ b/gee-orm/day1-database-sql/geeorm/dialect/sqlite3.go
@@ -0,0 +1,43 @@
+package dialect
+
+import (
+	"fmt"
+	"reflect"
+	"time"
+)
+
+type sqlite3 struct{}
+
+var _ Dialect = (*sqlite3)(nil)
+
+func init() {
+	RegisterDialect("sqlite3", &sqlite3{})
+}
+
+// Get Data Type for Sqlite Dialect
+func (s *sqlite3) DataTypeOf(typ reflect.Value) string {
+	switch typ.Kind() {
+	case reflect.Bool:
+		return "bool"
+	case reflect.Int, reflect.Int8, reflect.Int16, reflect.Int32,
+		reflect.Uint, reflect.Uint8, reflect.Uint16, reflect.Uint32, reflect.Uintptr:
+		return "integer"
+	case reflect.Int64, reflect.Uint64:
+		return "bigint"
+	case reflect.Float32, reflect.Float64:
+		return "real"
+	case reflect.String:
+		return "text"
+	case reflect.Array, reflect.Slice:
+		return "blob"
+	case reflect.Struct:
+		if _, ok := typ.Interface().(time.Time); ok {
+			return "datetime"
+		}
+	}
+	panic(fmt.Sprintf("invalid sql type %s (%s)", typ.Type().Name(), typ.Kind()))
+}
+
+func (s *sqlite3) PrimaryKeyTag(key string) string {
+	return "INTEGER PRIMARY KEY AUTOINCREMENT"
+}
diff --git a/gee-orm/day1-database-sql/geeorm/dialect/sqlite3_test.go b/gee-orm/day1-database-sql/geeorm/dialect/sqlite3_test.go
new file mode 100644
index 0000000..3df5f07
--- /dev/null
+++ b/gee-orm/day1-database-sql/geeorm/dialect/sqlite3_test.go
@@ -0,0 +1,25 @@
+package dialect
+
+import (
+	"reflect"
+	"testing"
+)
+
+func TestDataTypeOf(t *testing.T) {
+	dial := &sqlite3{}
+	cases := []struct {
+		Value interface{}
+		Type  string
+	}{
+		{"Tom", "text"},
+		{123, "integer"},
+		{1.2, "real"},
+		{[]int{1, 2, 3}, "blob"},
+	}
+
+	for _, c := range cases {
+		if typ := dial.DataTypeOf(reflect.ValueOf(c.Value)); typ != c.Type {
+			t.Fatalf("expect %s, but got %s", c.Type, typ)
+		}
+	}
+}
diff --git a/gee-orm/day1-database-sql/geeorm/geeorm.go b/gee-orm/day1-database-sql/geeorm/geeorm.go
new file mode 100644
index 0000000..a1d1f7e
--- /dev/null
+++ b/gee-orm/day1-database-sql/geeorm/geeorm.go
@@ -0,0 +1,67 @@
+package geeorm
+
+import (
+	"database/sql"
+	"fmt"
+	"log"
+	"os"
+
+	"geeorm/dialect"
+	"geeorm/schema"
+)
+
+var (
+	ErrorLog = log.New(os.Stdout, "[error] ", log.LstdFlags)
+	InfoLog  = log.New(os.Stdout, "[info ] ", log.LstdFlags)
+)
+
+type Engine struct {
+	db      *sql.DB
+	dialect dialect.Dialect
+}
+
+func NewEngine(driver, source string) (e *Engine, err error) {
+	db, err := sql.Open(driver, source)
+	if err != nil {
+		ErrorLog.Println(err)
+		return
+	}
+	// Send a ping to make sure the database connection is alive.
+	if err = db.Ping(); err != nil {
+		ErrorLog.Println(err)
+		return
+	}
+	// make sure the specific dialect exists
+	dial, ok := dialect.GetDialect(driver)
+	if !ok {
+		err = fmt.Errorf("dialect %s Not Found", driver)
+		ErrorLog.Println(err)
+		return
+	}
+	e = &Engine{db: db, dialect: dial}
+	InfoLog.Println("Connect database success")
+	return
+}
+
+func (e *Engine) Close() (err error) {
+	if err = e.db.Close(); err == nil {
+		InfoLog.Println("Close database success")
+	}
+	return
+}
+
+func (e *Engine) CreateTable(value interface{}) error {
+	_, err := e.NewSession(value).CreateTable().Exec()
+	return err
+}
+
+func (e *Engine) NewSession(value interface{}) *Session {
+	var refTable *schema.Schema
+	if value != nil {
+		refTable = schema.Parse(value, e.dialect)
+	}
+	return &Session{
+		refTable: refTable,
+		engine:   e,
+	}
+}
diff --git a/gee-orm/day1-database-sql/geeorm/geeorm_test.go b/gee-orm/day1-database-sql/geeorm/geeorm_test.go
new file mode 100644
index 0000000..c6da191
--- /dev/null
+++ b/gee-orm/day1-database-sql/geeorm/geeorm_test.go
@@ -0,0 +1,20 @@
+package geeorm
+
+import (
+	_ "github.com/mattn/go-sqlite3"
+	"testing"
+)
+
+func OpenDB(t *testing.T) *Engine {
+	t.Helper()
+	engine, err := NewEngine("sqlite3", "gee.db")
+	if err != nil {
+		t.Fatal("failed to connect", err)
+	}
+	return engine
+}
+
+func TestNewEngine(t *testing.T) {
+	engine := OpenDB(t)
+	defer engine.Close()
+}
diff --git a/gee-orm/day1-database-sql/geeorm/go.mod b/gee-orm/day1-database-sql/geeorm/go.mod
new file mode 100644
index 0000000..043b1c6
--- /dev/null
+++ b/gee-orm/day1-database-sql/geeorm/go.mod
@@ -0,0 +1,5 @@
+module geeorm
+
+go 1.13
+
+require github.com/mattn/go-sqlite3 v2.0.3+incompatible
diff --git a/gee-orm/day1-database-sql/geeorm/schema/field.go b/gee-orm/day1-database-sql/geeorm/schema/field.go
new file mode 100644
index 0000000..46e82e4
--- /dev/null
+++ b/gee-orm/day1-database-sql/geeorm/schema/field.go
@@ -0,0 +1,13 @@
+package schema
+
+import "fmt"
+
+type Field struct {
+	Name  string
+	Value interface{}
+	Tag   string
+}
+
+func (f *Field) String() string {
+	return fmt.Sprintf("%s %s", f.Name, f.Tag)
+}
diff --git a/gee-orm/day1-database-sql/geeorm/schema/schema.go b/gee-orm/day1-database-sql/geeorm/schema/schema.go
new file mode 100644
index 0000000..ae8ea7b
--- /dev/null
+++ b/gee-orm/day1-database-sql/geeorm/schema/schema.go
@@ -0,0 +1,45 @@
+package schema
+
+import (
+	"fmt"
+	"go/ast"
+	"reflect"
+	"strings"
+
+	"geeorm/dialect"
+)
+
+type Schema struct {
+	Table        string
+	PrimaryField *Field
+	Fields       []*Field
+}
+
+func Parse(dest interface{}, d dialect.Dialect) *Schema {
+	modelType := reflect.Indirect(reflect.ValueOf(dest)).Type()
+
+	schema := &Schema{
+		Table:        modelType.Name(),
+		PrimaryField: &Field{Name: "ID", Value: 0},
+	}
+
+	for i := 0; i < modelType.NumField(); i++ {
+		p := modelType.Field(i)
+		if !p.Anonymous && ast.IsExported(p.Name) {
+			schema.Fields = append(schema.Fields, &Field{
+				Name: p.Name,
+				Tag:  d.DataTypeOf(reflect.Indirect(reflect.New(p.Type))),
+			})
+		}
+	}
+	return schema
+}
+
+func (s *Schema) String() string {
+	var fieldStr []string
+	for _, field := range s.Fields {
+		fieldStr = append(fieldStr, field.String())
+	}
+
+	return fmt.Sprintf("TABLE %s(%s)", s.Table, strings.Join(fieldStr, ", "))
+}
diff --git a/gee-orm/day1-database-sql/geeorm/schema/schema_test.go b/gee-orm/day1-database-sql/geeorm/schema/schema_test.go
new file mode 100644
index 0000000..5e1ad2d
--- /dev/null
+++ b/gee-orm/day1-database-sql/geeorm/schema/schema_test.go
@@ -0,0 +1,20 @@
+package schema
+
+import (
+	"geeorm/dialect"
+	"testing"
+)
+
+type User struct {
+	Name string
+	Age  int
+}
+
+func TestParse(t *testing.T) {
+	dial, _ := dialect.GetDialect("sqlite3")
+	schema := Parse(&User{"Tom", 18}, dial)
+
+	if schema.Table != "User" || len(schema.Fields) != 2 {
+		t.Fatal("failed to parse User struct")
+	}
+}
diff --git a/gee-orm/day1-database-sql/geeorm/session.go b/gee-orm/day1-database-sql/geeorm/session.go
new file mode 100644
index 0000000..f1cd36a
--- /dev/null
+++ b/gee-orm/day1-database-sql/geeorm/session.go
@@ -0,0 +1,48 @@
+package geeorm
+
+import (
+	"database/sql"
+	"fmt"
+	"strings"
+
+	"geeorm/schema"
+)
+
+type Session struct {
+	engine   *Engine
+	refTable *schema.Schema
+
+	Value   interface{}
+	SQL     strings.Builder
+	SQLVars []interface{}
+}
+
+func (s *Session) Exec() (result sql.Result, err error) {
+	if result, err = s.engine.db.Exec(s.SQL.String(), s.SQLVars...); err != nil {
+		ErrorLog.Println(err)
+	}
+	return
+}
+
+func (s *Session) QueryRows() (rows *sql.Rows, err error) {
+	if rows, err = s.engine.db.Query(s.SQL.String(), s.SQLVars...); err != nil {
+		ErrorLog.Println(err)
+	}
+	return
+}
+
+func (s *Session) Raw(sql string, values ...interface{}) *Session {
+	s.SQL.WriteString(sql)
+	s.SQLVars = values
+	return s
+}
+
+func (s *Session) CreateTable() *Session {
+	var columns []string
+	for _, field := range s.refTable.Fields {
+		columns = append(columns, fmt.Sprintf("%s %s", field.Name, field.Tag))
+	}
+	desc := strings.Join(columns, ",")
+	s.SQL.WriteString(fmt.Sprintf("CREATE TABLE %s (%s);", s.refTable.Table, desc))
+	return s
+}
diff --git a/gee-orm/day1-database-sql/geeorm/session_test.go b/gee-orm/day1-database-sql/geeorm/session_test.go
new file mode 100644
index 0000000..ea30d7c
--- /dev/null
+++ b/gee-orm/day1-database-sql/geeorm/session_test.go
@@ -0,0 +1,29 @@
+package geeorm
+
+import "testing"
+
+func TestExec(t *testing.T) {
+	engine := OpenDB(t)
+	defer engine.Close()
+	engine.NewSession(nil).Raw("DROP TABLE USER;").Exec()
+	engine.NewSession(nil).Raw("CREATE TABLE USER(name text);").Exec()
+	result, _ := engine.NewSession(nil).Raw("INSERT INTO USER(`name`) values (?), (?)", "Tom", "Sam").Exec()
+	if count, err := result.RowsAffected(); err != nil || count != 2 {
+		t.Fatal("expect 2, but got", count)
+	}
+}
+
+func TestQuery(t *testing.T) {
+	engine := OpenDB(t)
+	defer engine.Close()
+	engine.NewSession(nil).Raw("DROP TABLE USER;").Exec()
+	engine.NewSession(nil).Raw("CREATE TABLE USER(name text);").Exec()
+	rows, _ := engine.NewSession(nil).Raw("SELECT count(*) FROM USER").QueryRows()
+	defer rows.Close()
+	var count int
+	for rows.Next() {
+		if err := rows.Scan(&count); err != nil || count != 0 {
+			t.Fatal("failed to query db", err)
+		}
+	}
+}

From 8db04ddad961073b7995ca0dd14be1323caa2467 Mon Sep 17 00:00:00 2001
From: gzdaijie <gzdaijie@gmail.com>
Date: Sun, 23 Feb 2020 00:10:20 +0800
Subject: [PATCH 037/122] add day2 schema design

---
 README.md                                     | 14 ++++-
 gee-orm/day1-database-sql/geeorm/geeorm.go    | 40 +++-----------
 .../day1-database-sql/geeorm/session_raw.go   | 40 ++++++++++++++
 .../geeorm/session_raw_test.go                | 30 +++++++++++
 .../day1-database-sql/geeorm/session_test.go  | 29 ----------
 .../geeorm/dialect/dialect.go                 |  1 +
 .../geeorm/dialect/sqlite3.go                 |  7 ++-
 .../geeorm/dialect/sqlite3_test.go            |  0
 gee-orm/day2-reflect-schema/geeorm/geeorm.go  | 54 +++++++++++++++++++
 .../day2-reflect-schema/geeorm/geeorm_test.go | 20 +++++++
 gee-orm/day2-reflect-schema/geeorm/go.mod     |  5 ++
 .../geeorm/schema/field.go                    |  0
 .../geeorm/schema/schema.go                   |  6 +--
 .../geeorm/schema/schema_test.go              |  2 +-
 .../geeorm/session_raw.go}                    | 18 +++----
 .../geeorm/session_raw_test.go                | 32 +++++++++++
 .../geeorm/session_schema.go                  | 53 ++++++++++++++++++
 .../geeorm/session_schema_test.go             | 18 +++++++
 18 files changed, 291 insertions(+), 78 deletions(-)
 create mode 100644 gee-orm/day1-database-sql/geeorm/session_raw.go
 create mode 100644 gee-orm/day1-database-sql/geeorm/session_raw_test.go
 delete mode 100644 gee-orm/day1-database-sql/geeorm/session_test.go
 rename gee-orm/{day1-database-sql => day2-reflect-schema}/geeorm/dialect/dialect.go (86%)
 rename gee-orm/{day1-database-sql => day2-reflect-schema}/geeorm/dialect/sqlite3.go (80%)
 rename gee-orm/{day1-database-sql => day2-reflect-schema}/geeorm/dialect/sqlite3_test.go (100%)
 create mode 100644 gee-orm/day2-reflect-schema/geeorm/geeorm.go
 create mode 100644 gee-orm/day2-reflect-schema/geeorm/geeorm_test.go
 create mode 100644 gee-orm/day2-reflect-schema/geeorm/go.mod
 rename gee-orm/{day1-database-sql => day2-reflect-schema}/geeorm/schema/field.go (100%)
 rename gee-orm/{day1-database-sql => day2-reflect-schema}/geeorm/schema/schema.go (85%)
 rename gee-orm/{day1-database-sql => day2-reflect-schema}/geeorm/schema/schema_test.go (81%)
 rename gee-orm/{day1-database-sql/geeorm/session.go => day2-reflect-schema/geeorm/session_raw.go} (68%)
 create mode 100644 gee-orm/day2-reflect-schema/geeorm/session_raw_test.go
 create mode 100755 gee-orm/day2-reflect-schema/geeorm/session_schema.go
 create mode 100755 gee-orm/day2-reflect-schema/geeorm/session_schema_test.go

diff --git a/README.md b/README.md
index 50682a1..aee281f 100644
--- a/README.md
+++ b/README.md
@@ -36,6 +36,12 @@
 - 第六天：[防止缓存击穿](https://geektutu.com/post/geecache-day6.html) | [Code](gee-cache/day6-single-flight)
 - 第七天：[使用 Protobuf 通信](https://geektutu.com/post/geecache-day7.html) | [Code](gee-cache/day7-proto-buf)
 
+### 7天用Go从零实现ORM框架 GeeORM
+
+[GeeORM] 是一个模仿 [gorm](https://github.com/jinzhu/gorm) 和 [xorm](https://github.com/go-xorm/xorm) 的 ORM 框架
+
+gorm 准备推出完全重写的 v2 版本(目前还在开发中)，相对 gorm-v1 来说，xorm 的设计更容易理解，所以 geeorm 接口设计上主要参考了 xorm，具体实现参考了 gorm。
+
 ### WebAssembly 使用示例
 
 具体的实践过程记录在 [Go WebAssembly 简明教程](https://geektutu.com/post/quick-go-wasm.html)。
@@ -62,7 +68,7 @@ What can I write in 7 days? A gin-like web framework? A distributed cache like g
 - Day 6 - Embeded Template Support [Code](gee-web/day6-template)
 - Day 7 - Panic Recover & Make it Robust [Code](gee-web/day7-panic-recover)
 
-## Distributed Cache - Geecache
+## Distributed Cache - GeeCache
 
 [GeeCache](https://geektutu.com/post/geecache.html) is a [groupcache](https://github.com/golang/groupcache)-like distributed cache
 
@@ -74,6 +80,12 @@ What can I write in 7 days? A gin-like web framework? A distributed cache like g
 - Day 6 - Cache Breakdown & Single Flight  | [Code](gee-cache/day6-single-flight)
 - Day 7 - Use Protobuf as RPC Data Exchange Type | [Code](gee-cache/day7-proto-buf)
 
+## Object Relational Mapping - GeeOrm
+
+[GeeOrm] is a [gorm](https://github.com/jinzhu/gorm)-like and [xorm](https://github.com/go-xorm/xorm)-like object relational mapping library
+
+Xorm's desgin is easier to understand than gorm-v1, so the main designs references xorm and some detailed implementions references gorm-v1.
+
 ## Golang WebAssembly Demo
 
 - Demo 1 - Hello World [Code](demo-wasm/hello-world)
diff --git a/gee-orm/day1-database-sql/geeorm/geeorm.go b/gee-orm/day1-database-sql/geeorm/geeorm.go
index a1d1f7e..b978bf0 100644
--- a/gee-orm/day1-database-sql/geeorm/geeorm.go
+++ b/gee-orm/day1-database-sql/geeorm/geeorm.go
@@ -2,22 +2,17 @@ package geeorm
 
 import (
 	"database/sql"
-	"fmt"
 	"log"
 	"os"
-
-	"geeorm/dialect"
-	"geeorm/schema"
 )
 
 var (
-	ErrorLog = log.New(os.Stdout, "[error] ", log.LstdFlags)
-	InfoLog  = log.New(os.Stdout, "[info ] ", log.LstdFlags)
+	ErrorLog = log.New(os.Stdout, "[error] ", log.LstdFlags|log.Lshortfile)
+	InfoLog  = log.New(os.Stdout, "[info ] ", log.LstdFlags|log.Lshortfile)
 )
 
 type Engine struct {
-	db      *sql.DB
-	dialect dialect.Dialect
+	db *sql.DB
 }
 
 func NewEngine(driver, source string) (e *Engine, err error) {
@@ -31,37 +26,18 @@ func NewEngine(driver, source string) (e *Engine, err error) {
 		ErrorLog.Println(err)
 		return
 	}
-	// make sure the specific dialect exists
-	dial, ok := dialect.GetDialect(driver)
-	if !ok {
-		err = fmt.Errorf("dialect %s Not Found", driver)
-		ErrorLog.Println(err)
-		return
-	}
-	e = &Engine{db: db, dialect: dial}
+	e = &Engine{db: db}
 	InfoLog.Println("Connect database success")
 	return
 }
 
-func (e *Engine) Close() (err error) {
-	if err = e.db.Close(); err == nil {
+func (engine *Engine) Close() (err error) {
+	if err = engine.db.Close(); err == nil {
 		InfoLog.Println("Close database success")
 	}
 	return
 }
 
-func (e *Engine) CreateTable(value interface{}) error {
-	_, err := e.NewSession(value).CreateTable().Exec()
-	return err
-}
-
-func (e *Engine) NewSession(value interface{}) *Session {
-	var refTable *schema.Schema
-	if value != nil {
-		refTable = schema.Parse(value, e.dialect)
-	}
-	return &Session{
-		refTable: refTable,
-		engine:   e,
-	}
+func (engine *Engine) NewSession() *Session {
+	return &Session{engine: engine}
 }
diff --git a/gee-orm/day1-database-sql/geeorm/session_raw.go b/gee-orm/day1-database-sql/geeorm/session_raw.go
new file mode 100644
index 0000000..c73f1c8
--- /dev/null
+++ b/gee-orm/day1-database-sql/geeorm/session_raw.go
@@ -0,0 +1,40 @@
+package geeorm
+
+import (
+	"database/sql"
+	"strings"
+)
+
+type Session struct {
+	engine *Engine
+
+	SQL     strings.Builder
+	SQLVars []interface{}
+}
+
+func (s *Session) Exec() (result sql.Result, err error) {
+	InfoLog.Println(s.SQL, s.SQLVars)
+	if result, err = s.engine.db.Exec(s.SQL.String(), s.SQLVars...); err != nil {
+		ErrorLog.Println(err)
+	}
+	return
+}
+
+func (s *Session) QueryRow() *sql.Row {
+	InfoLog.Println(s.SQL, s.SQLVars)
+	return s.engine.db.QueryRow(s.SQL.String(), s.SQLVars...)
+}
+
+func (s *Session) QueryRows() (rows *sql.Rows, err error) {
+	InfoLog.Println(s.SQL, s.SQLVars)
+	if rows, err = s.engine.db.Query(s.SQL.String(), s.SQLVars...); err != nil {
+		ErrorLog.Println(err)
+	}
+	return
+}
+
+func (s *Session) Raw(sql string, values ...interface{}) *Session {
+	s.SQL.WriteString(sql)
+	s.SQLVars = values
+	return s
+}
diff --git a/gee-orm/day1-database-sql/geeorm/session_raw_test.go b/gee-orm/day1-database-sql/geeorm/session_raw_test.go
new file mode 100644
index 0000000..8b879ea
--- /dev/null
+++ b/gee-orm/day1-database-sql/geeorm/session_raw_test.go
@@ -0,0 +1,30 @@
+package geeorm
+
+import (
+	"testing"
+)
+
+func TestSession_Exec(t *testing.T) {
+	engine := OpenDB(t)
+	defer engine.Close()
+	_, _ = engine.NewSession().Raw("DROP TABLE USER;").Exec()
+	_, _ = engine.NewSession().Raw("CREATE TABLE USER(name text);").Exec()
+	result, _ := engine.NewSession().
+		Raw("INSERT INTO USER(`name`) values (?), (?)", "Tom", "Sam").Exec()
+	if count, err := result.RowsAffected(); err != nil || count != 2 {
+		t.Fatal("expect 2, but got", count)
+	}
+}
+
+func TestSession_QueryRow(t *testing.T) {
+	engine := OpenDB(t)
+	defer engine.Close()
+	_, _ = engine.NewSession().Raw("DROP TABLE USER;").Exec()
+	_, _ = engine.NewSession().Raw("CREATE TABLE USER(name text);").Exec()
+	row := engine.NewSession().Raw("SELECT count(*) FROM USER").QueryRow()
+
+	var count int
+	if err := row.Scan(&count); err != nil || count != 0 {
+		t.Fatal("failed to query db", err)
+	}
+}
diff --git a/gee-orm/day1-database-sql/geeorm/session_test.go b/gee-orm/day1-database-sql/geeorm/session_test.go
deleted file mode 100644
index ea30d7c..0000000
--- a/gee-orm/day1-database-sql/geeorm/session_test.go
+++ /dev/null
@@ -1,29 +0,0 @@
-package geeorm
-
-import "testing"
-
-func TestExec(t *testing.T) {
-	engine := OpenDB(t)
-	defer engine.Close()
-	engine.NewSession(nil).Raw("DROP TABLE USER;").Exec()
-	engine.NewSession(nil).Raw("CREATE TABLE USER(name text);").Exec()
-	result, _ := engine.NewSession(nil).Raw("INSERT INTO USER(`name`) values (?), (?)", "Tom", "Sam").Exec()
-	if count, err := result.RowsAffected(); err != nil || count != 2 {
-		t.Fatal("expect 2, but got", count)
-	}
-}
-
-func TestQuery(t *testing.T) {
-	engine := OpenDB(t)
-	defer engine.Close()
-	engine.NewSession(nil).Raw("DROP TABLE USER;").Exec()
-	engine.NewSession(nil).Raw("CREATE TABLE USER(name text);").Exec()
-	rows, _ := engine.NewSession(nil).Raw("SELECT count(*) FROM USER").QueryRows()
-	defer rows.Close()
-	var count int
-	for rows.Next() {
-		if err := rows.Scan(&count); err != nil || count != 0 {
-			t.Fatal("failed to query db", err)
-		}
-	}
-}
diff --git a/gee-orm/day1-database-sql/geeorm/dialect/dialect.go b/gee-orm/day2-reflect-schema/geeorm/dialect/dialect.go
similarity index 86%
rename from gee-orm/day1-database-sql/geeorm/dialect/dialect.go
rename to gee-orm/day2-reflect-schema/geeorm/dialect/dialect.go
index ee07db3..63c4e69 100644
--- a/gee-orm/day1-database-sql/geeorm/dialect/dialect.go
+++ b/gee-orm/day2-reflect-schema/geeorm/dialect/dialect.go
@@ -7,6 +7,7 @@ var dialectsMap = map[string]Dialect{}
 type Dialect interface {
 	DataTypeOf(typ reflect.Value) string
 	PrimaryKeyTag(key string) string
+	TableExistSQL(tableName string) (string, []interface{})
 }
 
 func RegisterDialect(name string, dialect Dialect) {
diff --git a/gee-orm/day1-database-sql/geeorm/dialect/sqlite3.go b/gee-orm/day2-reflect-schema/geeorm/dialect/sqlite3.go
similarity index 80%
rename from gee-orm/day1-database-sql/geeorm/dialect/sqlite3.go
rename to gee-orm/day2-reflect-schema/geeorm/dialect/sqlite3.go
index 8eca05a..3a3a444 100644
--- a/gee-orm/day1-database-sql/geeorm/dialect/sqlite3.go
+++ b/gee-orm/day2-reflect-schema/geeorm/dialect/sqlite3.go
@@ -14,7 +14,7 @@ func init() {
 	RegisterDialect("sqlite3", &sqlite3{})
 }
 
-// Get Data Type for Sqlite Dialect
+// Get Data Type for sqlite3 Dialect
 func (s *sqlite3) DataTypeOf(typ reflect.Value) string {
 	switch typ.Kind() {
 	case reflect.Bool:
@@ -41,3 +41,8 @@ func (s *sqlite3) DataTypeOf(typ reflect.Value) string {
 func (s *sqlite3) PrimaryKeyTag(key string) string {
 	return "INTEGER PRIMARY KEY AUTOINCREMENT"
 }
+
+func (s *sqlite3) TableExistSQL(tableName string) (string, []interface{}) {
+	args := []interface{}{tableName}
+	return "SELECT name FROM sqlite_master WHERE type='table' and name = ?", args
+}
diff --git a/gee-orm/day1-database-sql/geeorm/dialect/sqlite3_test.go b/gee-orm/day2-reflect-schema/geeorm/dialect/sqlite3_test.go
similarity index 100%
rename from gee-orm/day1-database-sql/geeorm/dialect/sqlite3_test.go
rename to gee-orm/day2-reflect-schema/geeorm/dialect/sqlite3_test.go
diff --git a/gee-orm/day2-reflect-schema/geeorm/geeorm.go b/gee-orm/day2-reflect-schema/geeorm/geeorm.go
new file mode 100644
index 0000000..0121bfe
--- /dev/null
+++ b/gee-orm/day2-reflect-schema/geeorm/geeorm.go
@@ -0,0 +1,54 @@
+package geeorm
+
+import (
+	"database/sql"
+	"fmt"
+	"log"
+	"os"
+
+	"geeorm/dialect"
+)
+
+var (
+	ErrorLog = log.New(os.Stdout, "[error] ", log.LstdFlags|log.Lshortfile)
+	InfoLog  = log.New(os.Stdout, "[info ] ", log.LstdFlags|log.Lshortfile)
+)
+
+type Engine struct {
+	db      *sql.DB
+	dialect dialect.Dialect
+}
+
+func NewEngine(driver, source string) (e *Engine, err error) {
+	db, err := sql.Open(driver, source)
+	if err != nil {
+		ErrorLog.Println(err)
+		return
+	}
+	// Send a ping to make sure the database connection is alive.
+	if err = db.Ping(); err != nil {
+		ErrorLog.Println(err)
+		return
+	}
+	// make sure the specific dialect exists
+	dial, ok := dialect.GetDialect(driver)
+	if !ok {
+		err = fmt.Errorf("dialect %s Not Found", driver)
+		ErrorLog.Println(err)
+		return
+	}
+	e = &Engine{db: db, dialect: dial}
+	InfoLog.Println("Connect database success")
+	return
+}
+
+func (e *Engine) Close() (err error) {
+	if err = e.db.Close(); err == nil {
+		InfoLog.Println("Close database success")
+	}
+	return
+}
+
+func (e *Engine) NewSession() *Session {
+	return &Session{engine: e}
+}
diff --git a/gee-orm/day2-reflect-schema/geeorm/geeorm_test.go b/gee-orm/day2-reflect-schema/geeorm/geeorm_test.go
new file mode 100644
index 0000000..c6da191
--- /dev/null
+++ b/gee-orm/day2-reflect-schema/geeorm/geeorm_test.go
@@ -0,0 +1,20 @@
+package geeorm
+
+import (
+	_ "github.com/mattn/go-sqlite3"
+	"testing"
+)
+
+func OpenDB(t *testing.T) *Engine {
+	t.Helper()
+	engine, err := NewEngine("sqlite3", "gee.db")
+	if err != nil {
+		t.Fatal("failed to connect", err)
+	}
+	return engine
+}
+
+func TestNewEngine(t *testing.T) {
+	engine := OpenDB(t)
+	defer engine.Close()
+}
diff --git a/gee-orm/day2-reflect-schema/geeorm/go.mod b/gee-orm/day2-reflect-schema/geeorm/go.mod
new file mode 100644
index 0000000..043b1c6
--- /dev/null
+++ b/gee-orm/day2-reflect-schema/geeorm/go.mod
@@ -0,0 +1,5 @@
+module geeorm
+
+go 1.13
+
+require github.com/mattn/go-sqlite3 v2.0.3+incompatible
diff --git a/gee-orm/day1-database-sql/geeorm/schema/field.go b/gee-orm/day2-reflect-schema/geeorm/schema/field.go
similarity index 100%
rename from gee-orm/day1-database-sql/geeorm/schema/field.go
rename to gee-orm/day2-reflect-schema/geeorm/schema/field.go
diff --git a/gee-orm/day1-database-sql/geeorm/schema/schema.go b/gee-orm/day2-reflect-schema/geeorm/schema/schema.go
similarity index 85%
rename from gee-orm/day1-database-sql/geeorm/schema/schema.go
rename to gee-orm/day2-reflect-schema/geeorm/schema/schema.go
index ae8ea7b..03fcdce 100644
--- a/gee-orm/day1-database-sql/geeorm/schema/schema.go
+++ b/gee-orm/day2-reflect-schema/geeorm/schema/schema.go
@@ -10,7 +10,7 @@ import (
 )
 
 type Schema struct {
-	Table        string
+	TableName    string
 	PrimaryField *Field
 	Fields       []*Field
 }
@@ -19,7 +19,7 @@ func Parse(dest interface{}, d dialect.Dialect) *Schema {
 	modelType := reflect.Indirect(reflect.ValueOf(dest)).Type()
 
 	schema := &Schema{
-		Table:        modelType.Name(),
+		TableName:    modelType.Name(),
 		PrimaryField: &Field{Name: "ID", Value: 0},
 	}
 
@@ -41,5 +41,5 @@ func (s *Schema) String() string {
 		fieldStr = append(fieldStr, field.String())
 	}
 
-	return fmt.Sprintf("TABLE %s(%s)", s.Table, strings.Join(fieldStr, ", "))
+	return fmt.Sprintf("TABLE %s(%s)", s.TableName, strings.Join(fieldStr, ", "))
 }
diff --git a/gee-orm/day1-database-sql/geeorm/schema/schema_test.go b/gee-orm/day2-reflect-schema/geeorm/schema/schema_test.go
similarity index 81%
rename from gee-orm/day1-database-sql/geeorm/schema/schema_test.go
rename to gee-orm/day2-reflect-schema/geeorm/schema/schema_test.go
index 5e1ad2d..4142b95 100644
--- a/gee-orm/day1-database-sql/geeorm/schema/schema_test.go
+++ b/gee-orm/day2-reflect-schema/geeorm/schema/schema_test.go
@@ -14,7 +14,7 @@ func TestParse(t *testing.T) {
 	dial, _ := dialect.GetDialect("sqlite3")
 	schema := Parse(&User{"Tom", 18}, dial)
 
-	if schema.Table != "User" || len(schema.Fields) != 2 {
+	if schema.TableName != "User" || len(schema.Fields) != 2 {
 		t.Fatal("failed to parse User struct")
 	}
 }
diff --git a/gee-orm/day1-database-sql/geeorm/session.go b/gee-orm/day2-reflect-schema/geeorm/session_raw.go
similarity index 68%
rename from gee-orm/day1-database-sql/geeorm/session.go
rename to gee-orm/day2-reflect-schema/geeorm/session_raw.go
index f1cd36a..48b8309 100644
--- a/gee-orm/day1-database-sql/geeorm/session.go
+++ b/gee-orm/day2-reflect-schema/geeorm/session_raw.go
@@ -2,7 +2,6 @@ package geeorm
 
 import (
 	"database/sql"
-	"fmt"
 	"strings"
 
 	"geeorm/schema"
@@ -18,13 +17,20 @@ type Session struct {
 }
 
 func (s *Session) Exec() (result sql.Result, err error) {
+	InfoLog.Println(s.SQL.String(), s.SQLVars)
 	if result, err = s.engine.db.Exec(s.SQL.String(), s.SQLVars...); err != nil {
 		ErrorLog.Println(err)
 	}
 	return
 }
 
+func (s *Session) QueryRow() *sql.Row {
+	InfoLog.Println(s.SQL.String(), s.SQLVars)
+	return s.engine.db.QueryRow(s.SQL.String(), s.SQLVars...)
+}
+
 func (s *Session) QueryRows() (rows *sql.Rows, err error) {
+	InfoLog.Println(s.SQL.String(), s.SQLVars)
 	if rows, err = s.engine.db.Query(s.SQL.String(), s.SQLVars...); err != nil {
 		ErrorLog.Println(err)
 	}
@@ -36,13 +42,3 @@ func (s *Session) Raw(sql string, values ...interface{}) *Session {
 	s.SQLVars = values
 	return s
 }
-
-func (s *Session) CreateTable() *Session {
-	var columns []string
-	for _, field := range s.refTable.Fields {
-		columns = append(columns, fmt.Sprintf("%s %s", field.Name, field.Tag))
-	}
-	desc := strings.Join(columns, ",")
-	s.SQL.WriteString(fmt.Sprintf("CREATE TABLE %s (%s);", s.refTable.Table, desc))
-	return s
-}
diff --git a/gee-orm/day2-reflect-schema/geeorm/session_raw_test.go b/gee-orm/day2-reflect-schema/geeorm/session_raw_test.go
new file mode 100644
index 0000000..c541a37
--- /dev/null
+++ b/gee-orm/day2-reflect-schema/geeorm/session_raw_test.go
@@ -0,0 +1,32 @@
+package geeorm
+
+import (
+	"testing"
+)
+
+func TestSession_Exec(t *testing.T) {
+	engine := OpenDB(t)
+	defer engine.Close()
+	_, _ = engine.NewSession().Raw("DROP TABLE USER;").Exec()
+	_, _ = engine.NewSession().Raw("CREATE TABLE USER(name text);").Exec()
+	result, _ := engine.NewSession().
+		Raw("INSERT INTO USER(`name`) values (?), (?)", "Tom", "Sam").Exec()
+	if count, err := result.RowsAffected(); err != nil || count != 2 {
+		t.Fatal("expect 2, but got", count)
+	}
+}
+
+func TestSession_QueryRows(t *testing.T) {
+	engine := OpenDB(t)
+	defer engine.Close()
+	_, _ = engine.NewSession().Raw("DROP TABLE USER;").Exec()
+	_, _ = engine.NewSession().Raw("CREATE TABLE USER(name text);").Exec()
+	rows, _ := engine.NewSession().Raw("SELECT count(*) FROM USER").QueryRows()
+	defer rows.Close()
+	var count int
+	for rows.Next() {
+		if err := rows.Scan(&count); err != nil || count != 0 {
+			t.Fatal("failed to query db", err)
+		}
+	}
+}
diff --git a/gee-orm/day2-reflect-schema/geeorm/session_schema.go b/gee-orm/day2-reflect-schema/geeorm/session_schema.go
new file mode 100755
index 0000000..38a0bdc
--- /dev/null
+++ b/gee-orm/day2-reflect-schema/geeorm/session_schema.go
@@ -0,0 +1,53 @@
+package geeorm
+
+import (
+	"fmt"
+	"strings"
+
+	"geeorm/schema"
+)
+
+func (s *Session) RefTable(value interface{}) *schema.Schema {
+	if value == nil {
+		panic("value is nil")
+	}
+	if s.refTable == nil {
+		s.refTable = schema.Parse(value, s.engine.dialect)
+	}
+	return s.refTable
+}
+
+func (s *Session) CreateTable(value interface{}) error {
+	table := s.RefTable(value)
+	var columns []string
+	for _, field := range table.Fields {
+		columns = append(columns, fmt.Sprintf("%s %s", field.Name, field.Tag))
+	}
+	desc := strings.Join(columns, ",")
+	_, err := s.Raw(fmt.Sprintf("CREATE TABLE %s (%s);", table.TableName, desc)).Exec()
+	return err
+}
+
+func (s *Session) DropTable(value interface{}) error {
+	table := s.RefTable(value)
+	_, err := s.Raw(fmt.Sprintf("DROP TABLE %s", table.TableName)).Exec()
+	return err
+}
+
+func (s *Session) HasTable(value interface{}) bool {
+	tableName, ok := value.(string)
+	if !ok {
+		tableName = s.RefTable(value).TableName
+	}
+
+	sql, values := s.engine.dialect.TableExistSQL(tableName)
+	row := s.Raw(sql, values...).QueryRow()
+
+
+
+	var tmp string
+	if err := row.Scan(&tmp); err != nil {
+		ErrorLog.Println(err)
+	}
+	return tmp == tableName
+}
diff --git a/gee-orm/day2-reflect-schema/geeorm/session_schema_test.go b/gee-orm/day2-reflect-schema/geeorm/session_schema_test.go
new file mode 100755
index 0000000..4c0ba43
--- /dev/null
+++ b/gee-orm/day2-reflect-schema/geeorm/session_schema_test.go
@@ -0,0 +1,18 @@
+package geeorm
+
+import "testing"
+
+type User struct {
+	Name string
+	Age  int
+}
+
+func TestSession_CreateTable(t *testing.T) {
+	engine := OpenDB(t)
+	defer engine.Close()
+	_ = engine.NewSession().DropTable(&User{})
+	_ = engine.NewSession().CreateTable(&User{})
+	if ! engine.NewSession().HasTable("User") {
+		t.Fatal("failed to create table User")
+	}
+}

From ba6512370d6141c39ee617321d30ab111893e5ba Mon Sep 17 00:00:00 2001
From: Dai Jie <gzdaijie@163.com>
Date: Sun, 23 Feb 2020 21:56:26 +0800
Subject: [PATCH 038/122] Create LICENSE

---
 LICENSE | 21 +++++++++++++++++++++
 1 file changed, 21 insertions(+)
 create mode 100644 LICENSE

diff --git a/LICENSE b/LICENSE
new file mode 100644
index 0000000..5763570
--- /dev/null
+++ b/LICENSE
@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2020 Dai Jie
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

From d2c408982d6d0894566c49d17247e856bf302709 Mon Sep 17 00:00:00 2001
From: gzdaijie <gzdaijie@gmail.com>
Date: Sun, 23 Feb 2020 16:55:02 +0800
Subject: [PATCH 039/122] mv session to single directory - day2 reflect schema
 from struct - day3 query & save

---
 gee-orm/day1-database-sql/geeorm/geeorm.go    | 25 +++----
 .../day1-database-sql/geeorm/geeorm_test.go   |  2 +-
 gee-orm/day1-database-sql/geeorm/log/log.go   | 13 ++++
 .../day1-database-sql/geeorm/session/raw.go   | 53 ++++++++++++++
 .../geeorm/session/raw_test.go                | 50 ++++++++++++++
 .../day1-database-sql/geeorm/session_raw.go   | 40 -----------
 .../geeorm/session_raw_test.go                | 30 --------
 .../geeorm/dialect/dialect.go                 |  4 +-
 .../geeorm/dialect/sqlite3.go                 |  5 +-
 gee-orm/day2-reflect-schema/geeorm/geeorm.go  | 28 ++++----
 .../day2-reflect-schema/geeorm/geeorm_test.go |  2 +-
 gee-orm/day2-reflect-schema/geeorm/log/log.go | 13 ++++
 .../geeorm/schema/field.go                    | 13 ----
 .../geeorm/schema/schema.go                   | 50 ++++++++++----
 .../geeorm/schema/schema_test.go              | 23 +++++--
 .../day2-reflect-schema/geeorm/session/raw.go | 61 ++++++++++++++++
 .../geeorm/session/raw_test.go                | 54 +++++++++++++++
 .../geeorm/session/schema.go                  | 59 ++++++++++++++++
 .../geeorm/session/schema_test.go             | 18 +++++
 .../day2-reflect-schema/geeorm/session_raw.go | 44 ------------
 .../geeorm/session_raw_test.go                | 32 ---------
 .../geeorm/session_schema_test.go             | 18 -----
 .../day3-save-query/geeorm/dialect/dialect.go | 22 ++++++
 .../day3-save-query/geeorm/dialect/sqlite3.go | 45 ++++++++++++
 .../geeorm/dialect/sqlite3_test.go            | 25 +++++++
 gee-orm/day3-save-query/geeorm/geeorm.go      | 54 +++++++++++++++
 gee-orm/day3-save-query/geeorm/geeorm_test.go | 20 ++++++
 gee-orm/day3-save-query/geeorm/go.mod         |  5 ++
 gee-orm/day3-save-query/geeorm/log/log.go     | 13 ++++
 .../day3-save-query/geeorm/schema/schema.go   | 69 +++++++++++++++++++
 .../geeorm/schema/schema_test.go              | 36 ++++++++++
 gee-orm/day3-save-query/geeorm/session/raw.go | 61 ++++++++++++++++
 .../geeorm/session/raw_test.go                | 54 +++++++++++++++
 .../day3-save-query/geeorm/session/record.go  | 43 ++++++++++++
 .../geeorm/session/record_test.go             | 16 +++++
 .../geeorm/session/schema.go}                 | 22 +++---
 .../geeorm/session/schema_test.go             | 18 +++++
 37 files changed, 905 insertions(+), 235 deletions(-)
 create mode 100644 gee-orm/day1-database-sql/geeorm/log/log.go
 create mode 100644 gee-orm/day1-database-sql/geeorm/session/raw.go
 create mode 100644 gee-orm/day1-database-sql/geeorm/session/raw_test.go
 delete mode 100644 gee-orm/day1-database-sql/geeorm/session_raw.go
 delete mode 100644 gee-orm/day1-database-sql/geeorm/session_raw_test.go
 create mode 100644 gee-orm/day2-reflect-schema/geeorm/log/log.go
 delete mode 100644 gee-orm/day2-reflect-schema/geeorm/schema/field.go
 create mode 100644 gee-orm/day2-reflect-schema/geeorm/session/raw.go
 create mode 100644 gee-orm/day2-reflect-schema/geeorm/session/raw_test.go
 create mode 100644 gee-orm/day2-reflect-schema/geeorm/session/schema.go
 create mode 100644 gee-orm/day2-reflect-schema/geeorm/session/schema_test.go
 delete mode 100644 gee-orm/day2-reflect-schema/geeorm/session_raw.go
 delete mode 100644 gee-orm/day2-reflect-schema/geeorm/session_raw_test.go
 delete mode 100755 gee-orm/day2-reflect-schema/geeorm/session_schema_test.go
 create mode 100644 gee-orm/day3-save-query/geeorm/dialect/dialect.go
 create mode 100644 gee-orm/day3-save-query/geeorm/dialect/sqlite3.go
 create mode 100644 gee-orm/day3-save-query/geeorm/dialect/sqlite3_test.go
 create mode 100644 gee-orm/day3-save-query/geeorm/geeorm.go
 create mode 100644 gee-orm/day3-save-query/geeorm/geeorm_test.go
 create mode 100644 gee-orm/day3-save-query/geeorm/go.mod
 create mode 100644 gee-orm/day3-save-query/geeorm/log/log.go
 create mode 100644 gee-orm/day3-save-query/geeorm/schema/schema.go
 create mode 100644 gee-orm/day3-save-query/geeorm/schema/schema_test.go
 create mode 100644 gee-orm/day3-save-query/geeorm/session/raw.go
 create mode 100644 gee-orm/day3-save-query/geeorm/session/raw_test.go
 create mode 100644 gee-orm/day3-save-query/geeorm/session/record.go
 create mode 100644 gee-orm/day3-save-query/geeorm/session/record_test.go
 rename gee-orm/{day2-reflect-schema/geeorm/session_schema.go => day3-save-query/geeorm/session/schema.go} (63%)
 mode change 100755 => 100644
 create mode 100644 gee-orm/day3-save-query/geeorm/session/schema_test.go

diff --git a/gee-orm/day1-database-sql/geeorm/geeorm.go b/gee-orm/day1-database-sql/geeorm/geeorm.go
index b978bf0..10de8b9 100644
--- a/gee-orm/day1-database-sql/geeorm/geeorm.go
+++ b/gee-orm/day1-database-sql/geeorm/geeorm.go
@@ -2,42 +2,43 @@ package geeorm
 
 import (
 	"database/sql"
-	"log"
-	"os"
-)
 
-var (
-	ErrorLog = log.New(os.Stdout, "[error] ", log.LstdFlags|log.Lshortfile)
-	InfoLog  = log.New(os.Stdout, "[info ] ", log.LstdFlags|log.Lshortfile)
+	"geeorm/log"
+	"geeorm/session"
 )
 
+// Engine is the main struct of geeorm, manages all db sessions and transactions.
 type Engine struct {
 	db *sql.DB
 }
 
+// NewEngine create a instance of Engine
+// connect database and ping it to test whether it's alive
 func NewEngine(driver, source string) (e *Engine, err error) {
 	db, err := sql.Open(driver, source)
 	if err != nil {
-		ErrorLog.Println(err)
+		log.Error.Println(err)
 		return
 	}
 	// Send a ping to make sure the database connection is alive.
 	if err = db.Ping(); err != nil {
-		ErrorLog.Println(err)
+		log.Error.Println(err)
 		return
 	}
 	e = &Engine{db: db}
-	InfoLog.Println("Connect database success")
+	log.Info.Println("Connect database success")
 	return
 }
 
+// Close database connection
 func (engine *Engine) Close() (err error) {
 	if err = engine.db.Close(); err == nil {
-		InfoLog.Println("Close database success")
+		log.Info.Println("Close database success")
 	}
 	return
 }
 
-func (engine *Engine) NewSession() *Session {
-	return &Session{engine: engine}
+// NewSession creates a new session for next operations
+func (engine *Engine) NewSession() *session.Session {
+	return session.New(engine.db)
 }
diff --git a/gee-orm/day1-database-sql/geeorm/geeorm_test.go b/gee-orm/day1-database-sql/geeorm/geeorm_test.go
index c6da191..35628be 100644
--- a/gee-orm/day1-database-sql/geeorm/geeorm_test.go
+++ b/gee-orm/day1-database-sql/geeorm/geeorm_test.go
@@ -16,5 +16,5 @@ func OpenDB(t *testing.T) *Engine {
 
 func TestNewEngine(t *testing.T) {
 	engine := OpenDB(t)
-	defer engine.Close()
+	_ = engine.Close()
 }
diff --git a/gee-orm/day1-database-sql/geeorm/log/log.go b/gee-orm/day1-database-sql/geeorm/log/log.go
new file mode 100644
index 0000000..4e326f3
--- /dev/null
+++ b/gee-orm/day1-database-sql/geeorm/log/log.go
@@ -0,0 +1,13 @@
+package log
+
+import (
+	"log"
+	"os"
+)
+
+var (
+	// Error is a logger for logging error messages
+	Error = log.New(os.Stdout, "[error] ", log.LstdFlags|log.Lshortfile)
+	// Info is a logger for logging normal messages
+	Info = log.New(os.Stdout, "[info ] ", log.LstdFlags|log.Lshortfile)
+)
diff --git a/gee-orm/day1-database-sql/geeorm/session/raw.go b/gee-orm/day1-database-sql/geeorm/session/raw.go
new file mode 100644
index 0000000..2d5101a
--- /dev/null
+++ b/gee-orm/day1-database-sql/geeorm/session/raw.go
@@ -0,0 +1,53 @@
+package session
+
+import (
+	"database/sql"
+	"strings"
+
+	"geeorm/log"
+)
+
+// Session keep a pointer to sql.DB and provides all execution of all
+// kind of database operations.
+type Session struct {
+	db *sql.DB
+
+	SQL     strings.Builder
+	SQLVars []interface{}
+}
+
+// New creates a instance of Session
+func New(db *sql.DB) *Session {
+	return &Session{db: db}
+}
+
+// Exec raw SQL with SQLVars
+func (s *Session) Exec() (result sql.Result, err error) {
+	log.Info.Println(s.SQL.String(), s.SQLVars)
+	if result, err = s.db.Exec(s.SQL.String(), s.SQLVars...); err != nil {
+		log.Error.Println(err)
+	}
+	return
+}
+
+// QueryRow gets a record from db
+func (s *Session) QueryRow() *sql.Row {
+	log.Info.Println(s.SQL.String(), s.SQLVars)
+	return s.db.QueryRow(s.SQL.String(), s.SQLVars...)
+}
+
+// QueryRows gets a list of records from db
+func (s *Session) QueryRows() (rows *sql.Rows, err error) {
+	log.Info.Println(s.SQL.String(), s.SQLVars)
+	if rows, err = s.db.Query(s.SQL.String(), s.SQLVars...); err != nil {
+		log.Error.Println(err)
+	}
+	return
+}
+
+// Raw appends SQL and SQLVars
+func (s *Session) Raw(sql string, values ...interface{}) *Session {
+	s.SQL.WriteString(sql)
+	s.SQLVars = append(s.SQLVars, values...)
+	return s
+}
diff --git a/gee-orm/day1-database-sql/geeorm/session/raw_test.go b/gee-orm/day1-database-sql/geeorm/session/raw_test.go
new file mode 100644
index 0000000..1502a7e
--- /dev/null
+++ b/gee-orm/day1-database-sql/geeorm/session/raw_test.go
@@ -0,0 +1,50 @@
+package session
+
+import (
+	"database/sql"
+	"os"
+	"testing"
+
+	_ "github.com/mattn/go-sqlite3"
+)
+
+var TestDB *sql.DB
+
+func setup() {
+	TestDB, _ = sql.Open("sqlite3", "gee.db")
+}
+
+func teardown() {
+	_ = TestDB.Close()
+}
+func TestMain(m *testing.M) {
+	setup()
+	code := m.Run()
+	teardown()
+	os.Exit(code)
+}
+
+func NewSession() *Session {
+	return &Session{db: TestDB}
+}
+
+func TestSession_Exec(t *testing.T) {
+	_, _ = NewSession().Raw("DROP TABLE USER;").Exec()
+	_, _ = NewSession().Raw("CREATE TABLE USER(name text);").Exec()
+	result, _ := NewSession().
+		Raw("INSERT INTO USER(`name`) values (?), (?)", "Tom", "Sam").Exec()
+	if count, err := result.RowsAffected(); err != nil || count != 2 {
+		t.Fatal("expect 2, but got", count)
+	}
+}
+
+func TestSession_QueryRow(t *testing.T) {
+	_, _ = NewSession().Raw("DROP TABLE USER;").Exec()
+	_, _ = NewSession().Raw("CREATE TABLE USER(name text);").Exec()
+	row := NewSession().Raw("SELECT count(*) FROM USER").QueryRow()
+
+	var count int
+	if err := row.Scan(&count); err != nil || count != 0 {
+		t.Fatal("failed to query db", err)
+	}
+}
diff --git a/gee-orm/day1-database-sql/geeorm/session_raw.go b/gee-orm/day1-database-sql/geeorm/session_raw.go
deleted file mode 100644
index c73f1c8..0000000
--- a/gee-orm/day1-database-sql/geeorm/session_raw.go
+++ /dev/null
@@ -1,40 +0,0 @@
-package geeorm
-
-import (
-	"database/sql"
-	"strings"
-)
-
-type Session struct {
-	engine *Engine
-
-	SQL     strings.Builder
-	SQLVars []interface{}
-}
-
-func (s *Session) Exec() (result sql.Result, err error) {
-	InfoLog.Println(s.SQL, s.SQLVars)
-	if result, err = s.engine.db.Exec(s.SQL.String(), s.SQLVars...); err != nil {
-		ErrorLog.Println(err)
-	}
-	return
-}
-
-func (s *Session) QueryRow() *sql.Row {
-	InfoLog.Println(s.SQL, s.SQLVars)
-	return s.engine.db.QueryRow(s.SQL.String(), s.SQLVars...)
-}
-
-func (s *Session) QueryRows() (rows *sql.Rows, err error) {
-	InfoLog.Println(s.SQL, s.SQLVars)
-	if rows, err = s.engine.db.Query(s.SQL.String(), s.SQLVars...); err != nil {
-		ErrorLog.Println(err)
-	}
-	return
-}
-
-func (s *Session) Raw(sql string, values ...interface{}) *Session {
-	s.SQL.WriteString(sql)
-	s.SQLVars = values
-	return s
-}
diff --git a/gee-orm/day1-database-sql/geeorm/session_raw_test.go b/gee-orm/day1-database-sql/geeorm/session_raw_test.go
deleted file mode 100644
index 8b879ea..0000000
--- a/gee-orm/day1-database-sql/geeorm/session_raw_test.go
+++ /dev/null
@@ -1,30 +0,0 @@
-package geeorm
-
-import (
-	"testing"
-)
-
-func TestSession_Exec(t *testing.T) {
-	engine := OpenDB(t)
-	defer engine.Close()
-	_, _ = engine.NewSession().Raw("DROP TABLE USER;").Exec()
-	_, _ = engine.NewSession().Raw("CREATE TABLE USER(name text);").Exec()
-	result, _ := engine.NewSession().
-		Raw("INSERT INTO USER(`name`) values (?), (?)", "Tom", "Sam").Exec()
-	if count, err := result.RowsAffected(); err != nil || count != 2 {
-		t.Fatal("expect 2, but got", count)
-	}
-}
-
-func TestSession_QueryRow(t *testing.T) {
-	engine := OpenDB(t)
-	defer engine.Close()
-	_, _ = engine.NewSession().Raw("DROP TABLE USER;").Exec()
-	_, _ = engine.NewSession().Raw("CREATE TABLE USER(name text);").Exec()
-	row := engine.NewSession().Raw("SELECT count(*) FROM USER").QueryRow()
-
-	var count int
-	if err := row.Scan(&count); err != nil || count != 0 {
-		t.Fatal("failed to query db", err)
-	}
-}
diff --git a/gee-orm/day2-reflect-schema/geeorm/dialect/dialect.go b/gee-orm/day2-reflect-schema/geeorm/dialect/dialect.go
index 63c4e69..4696314 100644
--- a/gee-orm/day2-reflect-schema/geeorm/dialect/dialect.go
+++ b/gee-orm/day2-reflect-schema/geeorm/dialect/dialect.go
@@ -4,16 +4,18 @@ import "reflect"
 
 var dialectsMap = map[string]Dialect{}
 
+// Dialect is an interface contains methods that a dialect has to implement
 type Dialect interface {
 	DataTypeOf(typ reflect.Value) string
-	PrimaryKeyTag(key string) string
 	TableExistSQL(tableName string) (string, []interface{})
 }
 
+// RegisterDialect register a dialect to the global variable
 func RegisterDialect(name string, dialect Dialect) {
 	dialectsMap[name] = dialect
 }
 
+// Get the dialect from global variable if it exists
 func GetDialect(name string) (dialect Dialect, ok bool) {
 	dialect, ok = dialectsMap[name]
 	return
diff --git a/gee-orm/day2-reflect-schema/geeorm/dialect/sqlite3.go b/gee-orm/day2-reflect-schema/geeorm/dialect/sqlite3.go
index 3a3a444..f3c3897 100644
--- a/gee-orm/day2-reflect-schema/geeorm/dialect/sqlite3.go
+++ b/gee-orm/day2-reflect-schema/geeorm/dialect/sqlite3.go
@@ -38,10 +38,7 @@ func (s *sqlite3) DataTypeOf(typ reflect.Value) string {
 	panic(fmt.Sprintf("invalid sql type %s (%s)", typ.Type().Name(), typ.Kind()))
 }
 
-func (s *sqlite3) PrimaryKeyTag(key string) string {
-	return "INTEGER PRIMARY KEY AUTOINCREMENT"
-}
-
+// TableExistSQL returns SQL that judge whether the table exists in database
 func (s *sqlite3) TableExistSQL(tableName string) (string, []interface{}) {
 	args := []interface{}{tableName}
 	return "SELECT name FROM sqlite_master WHERE type='table' and name = ?", args
diff --git a/gee-orm/day2-reflect-schema/geeorm/geeorm.go b/gee-orm/day2-reflect-schema/geeorm/geeorm.go
index 0121bfe..ee3ec33 100644
--- a/gee-orm/day2-reflect-schema/geeorm/geeorm.go
+++ b/gee-orm/day2-reflect-schema/geeorm/geeorm.go
@@ -3,52 +3,52 @@ package geeorm
 import (
 	"database/sql"
 	"fmt"
-	"log"
-	"os"
 
 	"geeorm/dialect"
+	"geeorm/log"
+	"geeorm/session"
 )
 
-var (
-	ErrorLog = log.New(os.Stdout, "[error] ", log.LstdFlags|log.Lshortfile)
-	InfoLog  = log.New(os.Stdout, "[info ] ", log.LstdFlags|log.Lshortfile)
-)
-
+// Engine is the main struct of geeorm, manages all db sessions and transactions.
 type Engine struct {
 	db      *sql.DB
 	dialect dialect.Dialect
 }
 
+// NewEngine create a instance of Engine
+// connect database and ping it to test whether it's alive
 func NewEngine(driver, source string) (e *Engine, err error) {
 	db, err := sql.Open(driver, source)
 	if err != nil {
-		ErrorLog.Println(err)
+		log.Error.Println(err)
 		return
 	}
 	// Send a ping to make sure the database connection is alive.
 	if err = db.Ping(); err != nil {
-		ErrorLog.Println(err)
+		log.Error.Println(err)
 		return
 	}
 	// make sure the specific dialect exists
 	dial, ok := dialect.GetDialect(driver)
 	if !ok {
 		err = fmt.Errorf("dialect %s Not Found", driver)
-		ErrorLog.Println(err)
+		log.Error.Println(err)
 		return
 	}
 	e = &Engine{db: db, dialect: dial}
-	InfoLog.Println("Connect database success")
+	log.Info.Println("Connect database success")
 	return
 }
 
+// Close database connection
 func (e *Engine) Close() (err error) {
 	if err = e.db.Close(); err == nil {
-		InfoLog.Println("Close database success")
+		log.Info.Println("Close database success")
 	}
 	return
 }
 
-func (e *Engine) NewSession() *Session {
-	return &Session{engine: e}
+// NewSession creates a new session for next operations
+func (e *Engine) NewSession() *session.Session {
+	return session.New(e.db, e.dialect)
 }
diff --git a/gee-orm/day2-reflect-schema/geeorm/geeorm_test.go b/gee-orm/day2-reflect-schema/geeorm/geeorm_test.go
index c6da191..35628be 100644
--- a/gee-orm/day2-reflect-schema/geeorm/geeorm_test.go
+++ b/gee-orm/day2-reflect-schema/geeorm/geeorm_test.go
@@ -16,5 +16,5 @@ func OpenDB(t *testing.T) *Engine {
 
 func TestNewEngine(t *testing.T) {
 	engine := OpenDB(t)
-	defer engine.Close()
+	_ = engine.Close()
 }
diff --git a/gee-orm/day2-reflect-schema/geeorm/log/log.go b/gee-orm/day2-reflect-schema/geeorm/log/log.go
new file mode 100644
index 0000000..4e326f3
--- /dev/null
+++ b/gee-orm/day2-reflect-schema/geeorm/log/log.go
@@ -0,0 +1,13 @@
+package log
+
+import (
+	"log"
+	"os"
+)
+
+var (
+	// Error is a logger for logging error messages
+	Error = log.New(os.Stdout, "[error] ", log.LstdFlags|log.Lshortfile)
+	// Info is a logger for logging normal messages
+	Info = log.New(os.Stdout, "[info ] ", log.LstdFlags|log.Lshortfile)
+)
diff --git a/gee-orm/day2-reflect-schema/geeorm/schema/field.go b/gee-orm/day2-reflect-schema/geeorm/schema/field.go
deleted file mode 100644
index 46e82e4..0000000
--- a/gee-orm/day2-reflect-schema/geeorm/schema/field.go
+++ /dev/null
@@ -1,13 +0,0 @@
-package schema
-
-import "fmt"
-
-type Field struct {
-	Name  string
-	Value interface{}
-	Tag   string
-}
-
-func (f *Field) String() string {
-	return fmt.Sprintf("%s %s", f.Name, f.Tag)
-}
diff --git a/gee-orm/day2-reflect-schema/geeorm/schema/schema.go b/gee-orm/day2-reflect-schema/geeorm/schema/schema.go
index 03fcdce..299368f 100644
--- a/gee-orm/day2-reflect-schema/geeorm/schema/schema.go
+++ b/gee-orm/day2-reflect-schema/geeorm/schema/schema.go
@@ -2,44 +2,68 @@ package schema
 
 import (
 	"fmt"
+	"geeorm/dialect"
 	"go/ast"
 	"reflect"
-	"strings"
-
-	"geeorm/dialect"
 )
 
+// Field represents a column of database
+type Field struct {
+	Name string
+	Tag  string
+}
+
+// Schema represents a table of database
 type Schema struct {
 	TableName    string
 	PrimaryField *Field
 	Fields       []*Field
+	FieldNames   []string
+	BindVars     []string
 }
 
+// Values return the values of dest's member variables
+func (schema *Schema) Values(dest interface{}) []interface{} {
+	destValue := reflect.Indirect(reflect.ValueOf(dest))
+	var fieldValues []interface{}
+	for _, field := range schema.Fields {
+		fieldValues = append(fieldValues, destValue.FieldByName(field.Name).Interface())
+	}
+	return fieldValues
+}
+
+// Parse a struct to a Schema instance
 func Parse(dest interface{}, d dialect.Dialect) *Schema {
 	modelType := reflect.Indirect(reflect.ValueOf(dest)).Type()
-
 	schema := &Schema{
 		TableName:    modelType.Name(),
-		PrimaryField: &Field{Name: "ID", Value: 0},
+		PrimaryField: &Field{Name: "ID", Tag: ""},
 	}
 
 	for i := 0; i < modelType.NumField(); i++ {
 		p := modelType.Field(i)
 		if !p.Anonymous && ast.IsExported(p.Name) {
-			schema.Fields = append(schema.Fields, &Field{
+			field := &Field{
 				Name: p.Name,
 				Tag:  d.DataTypeOf(reflect.Indirect(reflect.New(p.Type))),
-			})
+			}
+			if v, ok := p.Tag.Lookup("geeorm"); ok && v == "primary_key" {
+				schema.PrimaryField = field
+			}
+			schema.Fields = append(schema.Fields, field)
+			schema.FieldNames = append(schema.FieldNames, p.Name)
+			schema.BindVars = append(schema.BindVars, "?")
 		}
 	}
 	return schema
 }
 
-func (s *Schema) String() string {
-	var fieldStr []string
-	for _, field := range s.Fields {
-		fieldStr = append(fieldStr, field.String())
-	}
+// String returns readable string
+func (field *Field) String() string {
+	return fmt.Sprintf("(%s %s)", field.Name, field.Tag)
+}
 
-	return fmt.Sprintf("TABLE %s(%s)", s.TableName, strings.Join(fieldStr, ", "))
+// String returns readable string
+func (schema *Schema) String() string {
+	return fmt.Sprintf("TABLE %s(%v)", schema.TableName, schema.Fields)
 }
diff --git a/gee-orm/day2-reflect-schema/geeorm/schema/schema_test.go b/gee-orm/day2-reflect-schema/geeorm/schema/schema_test.go
index 4142b95..34725b7 100644
--- a/gee-orm/day2-reflect-schema/geeorm/schema/schema_test.go
+++ b/gee-orm/day2-reflect-schema/geeorm/schema/schema_test.go
@@ -6,15 +6,30 @@ import (
 )
 
 type User struct {
-	Name string
+	Name string `geeorm:"primary_key"`
 	Age  int
 }
 
-func TestParse(t *testing.T) {
-	dial, _ := dialect.GetDialect("sqlite3")
-	schema := Parse(&User{"Tom", 18}, dial)
+var TestDial, _ = dialect.GetDialect("sqlite3")
 
+func TestParse(t *testing.T) {
+	schema := Parse(&User{}, TestDial)
 	if schema.TableName != "User" || len(schema.Fields) != 2 {
 		t.Fatal("failed to parse User struct")
 	}
+	if schema.PrimaryField.Name != "Name" {
+		t.Fatal("failed to parse primary key")
+	}
+}
+
+func TestSchema_Values(t *testing.T) {
+	schema := Parse(&User{}, TestDial)
+	values := schema.Values(&User{"Tom", 18})
+
+	name := values[0].(string)
+	age := values[1].(int)
+
+	if name != "Tom" || age != 18 {
+		t.Fatal("failed to get values")
+	}
 }
diff --git a/gee-orm/day2-reflect-schema/geeorm/session/raw.go b/gee-orm/day2-reflect-schema/geeorm/session/raw.go
new file mode 100644
index 0000000..02ea7df
--- /dev/null
+++ b/gee-orm/day2-reflect-schema/geeorm/session/raw.go
@@ -0,0 +1,61 @@
+package session
+
+import (
+	"database/sql"
+	"strings"
+
+	"geeorm/dialect"
+	"geeorm/log"
+	"geeorm/schema"
+)
+
+// Session keep a pointer to sql.DB and provides all execution of all
+// kind of database operations.
+type Session struct {
+	db       *sql.DB
+	dialect  dialect.Dialect
+	refTable *schema.Schema
+
+	Value   interface{}
+	SQL     strings.Builder
+	SQLVars []interface{}
+}
+
+// New creates a instance of Session
+func New(db *sql.DB, dialect dialect.Dialect) *Session {
+	return &Session{
+		db:      db,
+		dialect: dialect,
+	}
+}
+
+// Exec raw SQL with SQLVars
+func (s *Session) Exec() (result sql.Result, err error) {
+	log.Info.Println(s.SQL.String(), s.SQLVars)
+	if result, err = s.db.Exec(s.SQL.String(), s.SQLVars...); err != nil {
+		log.Error.Println(err)
+	}
+	return
+}
+
+// QueryRow gets a record from db
+func (s *Session) QueryRow() *sql.Row {
+	log.Info.Println(s.SQL.String(), s.SQLVars)
+	return s.db.QueryRow(s.SQL.String(), s.SQLVars...)
+}
+
+// QueryRows gets a list of records from db
+func (s *Session) QueryRows() (rows *sql.Rows, err error) {
+	log.Info.Println(s.SQL.String(), s.SQLVars)
+	if rows, err = s.db.Query(s.SQL.String(), s.SQLVars...); err != nil {
+		log.Error.Println(err)
+	}
+	return
+}
+
+// Raw appends SQL and SQLVars
+func (s *Session) Raw(sql string, values ...interface{}) *Session {
+	s.SQL.WriteString(sql)
+	s.SQLVars = append(s.SQLVars, values...)
+	return s
+}
diff --git a/gee-orm/day2-reflect-schema/geeorm/session/raw_test.go b/gee-orm/day2-reflect-schema/geeorm/session/raw_test.go
new file mode 100644
index 0000000..bfcfb80
--- /dev/null
+++ b/gee-orm/day2-reflect-schema/geeorm/session/raw_test.go
@@ -0,0 +1,54 @@
+package session
+
+import (
+	"database/sql"
+	"os"
+	"testing"
+
+	"geeorm/dialect"
+	_ "github.com/mattn/go-sqlite3"
+)
+
+var (
+	TestDB   *sql.DB
+	TestDial dialect.Dialect
+)
+
+func setup() {
+	TestDB, _ = sql.Open("sqlite3", "gee.db")
+	TestDial, _ = dialect.GetDialect("sqlite3")
+}
+
+func teardown() {
+	_ = TestDB.Close()
+}
+
+func TestMain(m *testing.M) {
+	setup()
+	code := m.Run()
+	teardown()
+	os.Exit(code)
+}
+
+func NewSession() *Session {
+	return &Session{db: TestDB, dialect: TestDial}
+}
+
+func TestSession_Exec(t *testing.T) {
+	_, _ = NewSession().Raw("DROP TABLE USER;").Exec()
+	_, _ = NewSession().Raw("CREATE TABLE USER(name text);").Exec()
+	result, _ := NewSession().Raw("INSERT INTO USER(`name`) values (?), (?)", "Tom", "Sam").Exec()
+	if count, err := result.RowsAffected(); err != nil || count != 2 {
+		t.Fatal("expect 2, but got", count)
+	}
+}
+
+func TestSession_QueryRows(t *testing.T) {
+	_, _ = NewSession().Raw("DROP TABLE USER;").Exec()
+	_, _ = NewSession().Raw("CREATE TABLE USER(name text);").Exec()
+	row := NewSession().Raw("SELECT count(*) FROM USER").QueryRow()
+	var count int
+	if err := row.Scan(&count); err != nil || count != 0 {
+		t.Fatal("failed to query db", err)
+	}
+}
diff --git a/gee-orm/day2-reflect-schema/geeorm/session/schema.go b/gee-orm/day2-reflect-schema/geeorm/session/schema.go
new file mode 100644
index 0000000..0767d67
--- /dev/null
+++ b/gee-orm/day2-reflect-schema/geeorm/session/schema.go
@@ -0,0 +1,59 @@
+package session
+
+import (
+	"fmt"
+	"strings"
+
+	"geeorm/log"
+	"geeorm/schema"
+)
+
+// RefTable returns a Schema instance that contains all parsed fields
+func (s *Session) RefTable(value interface{}) *schema.Schema {
+	if value == nil {
+		panic("value is nil")
+	}
+	if s.refTable == nil {
+		s.refTable = schema.Parse(value, s.dialect)
+	}
+	return s.refTable
+}
+
+// CreateTable create a table in database with a model
+func (s *Session) CreateTable(value interface{}) error {
+	table := s.RefTable(value)
+	var columns []string
+	for _, field := range table.Fields {
+		tag := field.Tag
+		if field.Name == table.PrimaryField.Name {
+			tag = table.PrimaryField.Tag
+		}
+		columns = append(columns, fmt.Sprintf("%s %s", field.Name, tag))
+	}
+	desc := strings.Join(columns, ",")
+	_, err := s.Raw(fmt.Sprintf("CREATE TABLE %s (%s);", table.TableName, desc)).Exec()
+	return err
+}
+
+// DropTable drops a table with the name of model
+func (s *Session) DropTable(value interface{}) error {
+	table := s.RefTable(value)
+	_, err := s.Raw(fmt.Sprintf("DROP TABLE %s", table.TableName)).Exec()
+	return err
+}
+
+// HasTable returns true of the table exists
+func (s *Session) HasTable(value interface{}) bool {
+	tableName, ok := value.(string)
+	if !ok {
+		tableName = s.RefTable(value).TableName
+	}
+
+	sql, values := s.dialect.TableExistSQL(tableName)
+	row := s.Raw(sql, values...).QueryRow()
+	var tmp string
+	if err := row.Scan(&tmp); err != nil {
+		log.Error.Println(err)
+	}
+	return tmp == tableName
+}
diff --git a/gee-orm/day2-reflect-schema/geeorm/session/schema_test.go b/gee-orm/day2-reflect-schema/geeorm/session/schema_test.go
new file mode 100644
index 0000000..8405886
--- /dev/null
+++ b/gee-orm/day2-reflect-schema/geeorm/session/schema_test.go
@@ -0,0 +1,18 @@
+package session
+
+import (
+	"testing"
+)
+
+type User struct {
+	Name string
+	Age  int
+}
+
+func TestSession_CreateTable(t *testing.T) {
+	_ = NewSession().DropTable(&User{})
+	_ = NewSession().CreateTable(&User{})
+	if !NewSession().HasTable("User") {
+		t.Fatal("failed to create table User")
+	}
+}
diff --git a/gee-orm/day2-reflect-schema/geeorm/session_raw.go b/gee-orm/day2-reflect-schema/geeorm/session_raw.go
deleted file mode 100644
index 48b8309..0000000
--- a/gee-orm/day2-reflect-schema/geeorm/session_raw.go
+++ /dev/null
@@ -1,44 +0,0 @@
-package geeorm
-
-import (
-	"database/sql"
-	"strings"
-
-	"geeorm/schema"
-)
-
-type Session struct {
-	engine   *Engine
-	refTable *schema.Schema
-
-	Value   interface{}
-	SQL     strings.Builder
-	SQLVars []interface{}
-}
-
-func (s *Session) Exec() (result sql.Result, err error) {
-	InfoLog.Println(s.SQL.String(), s.SQLVars)
-	if result, err = s.engine.db.Exec(s.SQL.String(), s.SQLVars...); err != nil {
-		ErrorLog.Println(err)
-	}
-	return
-}
-
-func (s *Session) QueryRow() *sql.Row {
-	InfoLog.Println(s.SQL.String(), s.SQLVars)
-	return s.engine.db.QueryRow(s.SQL.String(), s.SQLVars...)
-}
-
-func (s *Session) QueryRows() (rows *sql.Rows, err error) {
-	InfoLog.Println(s.SQL.String(), s.SQLVars)
-	if rows, err = s.engine.db.Query(s.SQL.String(), s.SQLVars...); err != nil {
-		ErrorLog.Println(err)
-	}
-	return
-}
-
-func (s *Session) Raw(sql string, values ...interface{}) *Session {
-	s.SQL.WriteString(sql)
-	s.SQLVars = values
-	return s
-}
diff --git a/gee-orm/day2-reflect-schema/geeorm/session_raw_test.go b/gee-orm/day2-reflect-schema/geeorm/session_raw_test.go
deleted file mode 100644
index c541a37..0000000
--- a/gee-orm/day2-reflect-schema/geeorm/session_raw_test.go
+++ /dev/null
@@ -1,32 +0,0 @@
-package geeorm
-
-import (
-	"testing"
-)
-
-func TestSession_Exec(t *testing.T) {
-	engine := OpenDB(t)
-	defer engine.Close()
-	_, _ = engine.NewSession().Raw("DROP TABLE USER;").Exec()
-	_, _ = engine.NewSession().Raw("CREATE TABLE USER(name text);").Exec()
-	result, _ := engine.NewSession().
-		Raw("INSERT INTO USER(`name`) values (?), (?)", "Tom", "Sam").Exec()
-	if count, err := result.RowsAffected(); err != nil || count != 2 {
-		t.Fatal("expect 2, but got", count)
-	}
-}
-
-func TestSession_QueryRows(t *testing.T) {
-	engine := OpenDB(t)
-	defer engine.Close()
-	_, _ = engine.NewSession().Raw("DROP TABLE USER;").Exec()
-	_, _ = engine.NewSession().Raw("CREATE TABLE USER(name text);").Exec()
-	rows, _ := engine.NewSession().Raw("SELECT count(*) FROM USER").QueryRows()
-	defer rows.Close()
-	var count int
-	for rows.Next() {
-		if err := rows.Scan(&count); err != nil || count != 0 {
-			t.Fatal("failed to query db", err)
-		}
-	}
-}
diff --git a/gee-orm/day2-reflect-schema/geeorm/session_schema_test.go b/gee-orm/day2-reflect-schema/geeorm/session_schema_test.go
deleted file mode 100755
index 4c0ba43..0000000
--- a/gee-orm/day2-reflect-schema/geeorm/session_schema_test.go
+++ /dev/null
@@ -1,18 +0,0 @@
-package geeorm
-
-import "testing"
-
-type User struct {
-	Name string
-	Age  int
-}
-
-func TestSession_CreateTable(t *testing.T) {
-	engine := OpenDB(t)
-	defer engine.Close()
-	_ = engine.NewSession().DropTable(&User{})
-	_ = engine.NewSession().CreateTable(&User{})
-	if ! engine.NewSession().HasTable("User") {
-		t.Fatal("failed to create table User")
-	}
-}
diff --git a/gee-orm/day3-save-query/geeorm/dialect/dialect.go b/gee-orm/day3-save-query/geeorm/dialect/dialect.go
new file mode 100644
index 0000000..4696314
--- /dev/null
+++ b/gee-orm/day3-save-query/geeorm/dialect/dialect.go
@@ -0,0 +1,22 @@
+package dialect
+
+import "reflect"
+
+var dialectsMap = map[string]Dialect{}
+
+// Dialect is an interface contains methods that a dialect has to implement
+type Dialect interface {
+	DataTypeOf(typ reflect.Value) string
+	TableExistSQL(tableName string) (string, []interface{})
+}
+
+// RegisterDialect register a dialect to the global variable
+func RegisterDialect(name string, dialect Dialect) {
+	dialectsMap[name] = dialect
+}
+
+// Get the dialect from global variable if it exists
+func GetDialect(name string) (dialect Dialect, ok bool) {
+	dialect, ok = dialectsMap[name]
+	return
+}
diff --git a/gee-orm/day3-save-query/geeorm/dialect/sqlite3.go b/gee-orm/day3-save-query/geeorm/dialect/sqlite3.go
new file mode 100644
index 0000000..f3c3897
--- /dev/null
+++ b/gee-orm/day3-save-query/geeorm/dialect/sqlite3.go
@@ -0,0 +1,45 @@
+package dialect
+
+import (
+	"fmt"
+	"reflect"
+	"time"
+)
+
+type sqlite3 struct{}
+
+var _ Dialect = (*sqlite3)(nil)
+
+func init() {
+	RegisterDialect("sqlite3", &sqlite3{})
+}
+
+// Get Data Type for sqlite3 Dialect
+func (s *sqlite3) DataTypeOf(typ reflect.Value) string {
+	switch typ.Kind() {
+	case reflect.Bool:
+		return "bool"
+	case reflect.Int, reflect.Int8, reflect.Int16, reflect.Int32,
+		reflect.Uint, reflect.Uint8, reflect.Uint16, reflect.Uint32, reflect.Uintptr:
+		return "integer"
+	case reflect.Int64, reflect.Uint64:
+		return "bigint"
+	case reflect.Float32, reflect.Float64:
+		return "real"
+	case reflect.String:
+		return "text"
+	case reflect.Array, reflect.Slice:
+		return "blob"
+	case reflect.Struct:
+		if _, ok := typ.Interface().(time.Time); ok {
+			return "datetime"
+		}
+	}
+	panic(fmt.Sprintf("invalid sql type %s (%s)", typ.Type().Name(), typ.Kind()))
+}
+
+// TableExistSQL returns SQL that judge whether the table exists in database
+func (s *sqlite3) TableExistSQL(tableName string) (string, []interface{}) {
+	args := []interface{}{tableName}
+	return "SELECT name FROM sqlite_master WHERE type='table' and name = ?", args
+}
diff --git a/gee-orm/day3-save-query/geeorm/dialect/sqlite3_test.go b/gee-orm/day3-save-query/geeorm/dialect/sqlite3_test.go
new file mode 100644
index 0000000..3df5f07
--- /dev/null
+++ b/gee-orm/day3-save-query/geeorm/dialect/sqlite3_test.go
@@ -0,0 +1,25 @@
+package dialect
+
+import (
+	"reflect"
+	"testing"
+)
+
+func TestDataTypeOf(t *testing.T) {
+	dial := &sqlite3{}
+	cases := []struct {
+		Value interface{}
+		Type  string
+	}{
+		{"Tom", "text"},
+		{123, "integer"},
+		{1.2, "real"},
+		{[]int{1, 2, 3}, "blob"},
+	}
+
+	for _, c := range cases {
+		if typ := dial.DataTypeOf(reflect.ValueOf(c.Value)); typ != c.Type {
+			t.Fatalf("expect %s, but got %s", c.Type, typ)
+		}
+	}
+}
diff --git a/gee-orm/day3-save-query/geeorm/geeorm.go b/gee-orm/day3-save-query/geeorm/geeorm.go
new file mode 100644
index 0000000..ee3ec33
--- /dev/null
+++ b/gee-orm/day3-save-query/geeorm/geeorm.go
@@ -0,0 +1,54 @@
+package geeorm
+
+import (
+	"database/sql"
+	"fmt"
+
+	"geeorm/dialect"
+	"geeorm/log"
+	"geeorm/session"
+)
+
+// Engine is the main struct of geeorm, manages all db sessions and transactions.
+type Engine struct {
+	db      *sql.DB
+	dialect dialect.Dialect
+}
+
+// NewEngine create a instance of Engine
+// connect database and ping it to test whether it's alive
+func NewEngine(driver, source string) (e *Engine, err error) {
+	db, err := sql.Open(driver, source)
+	if err != nil {
+		log.Error.Println(err)
+		return
+	}
+	// Send a ping to make sure the database connection is alive.
+	if err = db.Ping(); err != nil {
+		log.Error.Println(err)
+		return
+	}
+	// make sure the specific dialect exists
+	dial, ok := dialect.GetDialect(driver)
+	if !ok {
+		err = fmt.Errorf("dialect %s Not Found", driver)
+		log.Error.Println(err)
+		return
+	}
+	e = &Engine{db: db, dialect: dial}
+	log.Info.Println("Connect database success")
+	return
+}
+
+// Close database connection
+func (e *Engine) Close() (err error) {
+	if err = e.db.Close(); err == nil {
+		log.Info.Println("Close database success")
+	}
+	return
+}
+
+// NewSession creates a new session for next operations
+func (e *Engine) NewSession() *session.Session {
+	return session.New(e.db, e.dialect)
+}
diff --git a/gee-orm/day3-save-query/geeorm/geeorm_test.go b/gee-orm/day3-save-query/geeorm/geeorm_test.go
new file mode 100644
index 0000000..35628be
--- /dev/null
+++ b/gee-orm/day3-save-query/geeorm/geeorm_test.go
@@ -0,0 +1,20 @@
+package geeorm
+
+import (
+	_ "github.com/mattn/go-sqlite3"
+	"testing"
+)
+
+func OpenDB(t *testing.T) *Engine {
+	t.Helper()
+	engine, err := NewEngine("sqlite3", "gee.db")
+	if err != nil {
+		t.Fatal("failed to connect", err)
+	}
+	return engine
+}
+
+func TestNewEngine(t *testing.T) {
+	engine := OpenDB(t)
+	_ = engine.Close()
+}
diff --git a/gee-orm/day3-save-query/geeorm/go.mod b/gee-orm/day3-save-query/geeorm/go.mod
new file mode 100644
index 0000000..043b1c6
--- /dev/null
+++ b/gee-orm/day3-save-query/geeorm/go.mod
@@ -0,0 +1,5 @@
+module geeorm
+
+go 1.13
+
+require github.com/mattn/go-sqlite3 v2.0.3+incompatible
diff --git a/gee-orm/day3-save-query/geeorm/log/log.go b/gee-orm/day3-save-query/geeorm/log/log.go
new file mode 100644
index 0000000..4e326f3
--- /dev/null
+++ b/gee-orm/day3-save-query/geeorm/log/log.go
@@ -0,0 +1,13 @@
+package log
+
+import (
+	"log"
+	"os"
+)
+
+var (
+	// Error is a logger for logging error messages
+	Error = log.New(os.Stdout, "[error] ", log.LstdFlags|log.Lshortfile)
+	// Info is a logger for logging normal messages
+	Info = log.New(os.Stdout, "[info ] ", log.LstdFlags|log.Lshortfile)
+)
diff --git a/gee-orm/day3-save-query/geeorm/schema/schema.go b/gee-orm/day3-save-query/geeorm/schema/schema.go
new file mode 100644
index 0000000..299368f
--- /dev/null
+++ b/gee-orm/day3-save-query/geeorm/schema/schema.go
@@ -0,0 +1,69 @@
+package schema
+
+import (
+	"fmt"
+	"geeorm/dialect"
+	"go/ast"
+	"reflect"
+)
+
+// Field represents a column of database
+type Field struct {
+	Name string
+	Tag  string
+}
+
+// Schema represents a table of database
+type Schema struct {
+	TableName    string
+	PrimaryField *Field
+	Fields       []*Field
+	FieldNames   []string
+	BindVars     []string
+}
+
+// Values return the values of dest's member variables
+func (schema *Schema) Values(dest interface{}) []interface{} {
+	destValue := reflect.Indirect(reflect.ValueOf(dest))
+	var fieldValues []interface{}
+	for _, field := range schema.Fields {
+		fieldValues = append(fieldValues, destValue.FieldByName(field.Name).Interface())
+	}
+	return fieldValues
+}
+
+// Parse a struct to a Schema instance
+func Parse(dest interface{}, d dialect.Dialect) *Schema {
+	modelType := reflect.Indirect(reflect.ValueOf(dest)).Type()
+	schema := &Schema{
+		TableName:    modelType.Name(),
+		PrimaryField: &Field{Name: "ID", Tag: ""},
+	}
+
+	for i := 0; i < modelType.NumField(); i++ {
+		p := modelType.Field(i)
+		if !p.Anonymous && ast.IsExported(p.Name) {
+			field := &Field{
+				Name: p.Name,
+				Tag:  d.DataTypeOf(reflect.Indirect(reflect.New(p.Type))),
+			}
+			if v, ok := p.Tag.Lookup("geeorm"); ok && v == "primary_key" {
+				schema.PrimaryField = field
+			}
+			schema.Fields = append(schema.Fields, field)
+			schema.FieldNames = append(schema.FieldNames, p.Name)
+			schema.BindVars = append(schema.BindVars, "?")
+		}
+	}
+	return schema
+}
+
+// String returns readable string
+func (field *Field) String() string {
+	return fmt.Sprintf("(%s %s)", field.Name, field.Tag)
+}
+
+// String returns readable string
+func (schema *Schema) String() string {
+	return fmt.Sprintf("TABLE %s(%v)", schema.TableName, schema.Fields)
+}
diff --git a/gee-orm/day3-save-query/geeorm/schema/schema_test.go b/gee-orm/day3-save-query/geeorm/schema/schema_test.go
new file mode 100644
index 0000000..aba3e0b
--- /dev/null
+++ b/gee-orm/day3-save-query/geeorm/schema/schema_test.go
@@ -0,0 +1,36 @@
+package schema
+
+import (
+	"geeorm/dialect"
+	"testing"
+)
+
+type User struct {
+	Name string `geeorm:"primary_key"`
+	Age  int
+}
+
+var TestDial, _ = dialect.GetDialect("sqlite3")
+
+func TestParse(t *testing.T) {
+	schema := Parse(&User{}, TestDial)
+	if schema.TableName != "User" || len(schema.Fields) != 2 {
+		t.Fatal("failed to parse User struct")
+	}
+	if schema.PrimaryField.Name != "Name" {
+		t.Fatal("failed to parse primary key")
+	}
+	t.Log(schema)
+}
+
+func TestSchema_Values(t *testing.T) {
+	schema := Parse(&User{}, TestDial)
+	values := schema.Values(&User{"Tom", 18})
+
+	name := values[0].(string)
+	age := values[1].(int)
+
+	if name != "Tom" || age != 18 {
+		t.Fatal("failed to get values")
+	}
+}
diff --git a/gee-orm/day3-save-query/geeorm/session/raw.go b/gee-orm/day3-save-query/geeorm/session/raw.go
new file mode 100644
index 0000000..02ea7df
--- /dev/null
+++ b/gee-orm/day3-save-query/geeorm/session/raw.go
@@ -0,0 +1,61 @@
+package session
+
+import (
+	"database/sql"
+	"strings"
+
+	"geeorm/dialect"
+	"geeorm/log"
+	"geeorm/schema"
+)
+
+// Session keep a pointer to sql.DB and provides all execution of all
+// kind of database operations.
+type Session struct {
+	db       *sql.DB
+	dialect  dialect.Dialect
+	refTable *schema.Schema
+
+	Value   interface{}
+	SQL     strings.Builder
+	SQLVars []interface{}
+}
+
+// New creates a instance of Session
+func New(db *sql.DB, dialect dialect.Dialect) *Session {
+	return &Session{
+		db:      db,
+		dialect: dialect,
+	}
+}
+
+// Exec raw SQL with SQLVars
+func (s *Session) Exec() (result sql.Result, err error) {
+	log.Info.Println(s.SQL.String(), s.SQLVars)
+	if result, err = s.db.Exec(s.SQL.String(), s.SQLVars...); err != nil {
+		log.Error.Println(err)
+	}
+	return
+}
+
+// QueryRow gets a record from db
+func (s *Session) QueryRow() *sql.Row {
+	log.Info.Println(s.SQL.String(), s.SQLVars)
+	return s.db.QueryRow(s.SQL.String(), s.SQLVars...)
+}
+
+// QueryRows gets a list of records from db
+func (s *Session) QueryRows() (rows *sql.Rows, err error) {
+	log.Info.Println(s.SQL.String(), s.SQLVars)
+	if rows, err = s.db.Query(s.SQL.String(), s.SQLVars...); err != nil {
+		log.Error.Println(err)
+	}
+	return
+}
+
+// Raw appends SQL and SQLVars
+func (s *Session) Raw(sql string, values ...interface{}) *Session {
+	s.SQL.WriteString(sql)
+	s.SQLVars = append(s.SQLVars, values...)
+	return s
+}
diff --git a/gee-orm/day3-save-query/geeorm/session/raw_test.go b/gee-orm/day3-save-query/geeorm/session/raw_test.go
new file mode 100644
index 0000000..bfcfb80
--- /dev/null
+++ b/gee-orm/day3-save-query/geeorm/session/raw_test.go
@@ -0,0 +1,54 @@
+package session
+
+import (
+	"database/sql"
+	"os"
+	"testing"
+
+	"geeorm/dialect"
+	_ "github.com/mattn/go-sqlite3"
+)
+
+var (
+	TestDB   *sql.DB
+	TestDial dialect.Dialect
+)
+
+func setup() {
+	TestDB, _ = sql.Open("sqlite3", "gee.db")
+	TestDial, _ = dialect.GetDialect("sqlite3")
+}
+
+func teardown() {
+	_ = TestDB.Close()
+}
+
+func TestMain(m *testing.M) {
+	setup()
+	code := m.Run()
+	teardown()
+	os.Exit(code)
+}
+
+func NewSession() *Session {
+	return &Session{db: TestDB, dialect: TestDial}
+}
+
+func TestSession_Exec(t *testing.T) {
+	_, _ = NewSession().Raw("DROP TABLE USER;").Exec()
+	_, _ = NewSession().Raw("CREATE TABLE USER(name text);").Exec()
+	result, _ := NewSession().Raw("INSERT INTO USER(`name`) values (?), (?)", "Tom", "Sam").Exec()
+	if count, err := result.RowsAffected(); err != nil || count != 2 {
+		t.Fatal("expect 2, but got", count)
+	}
+}
+
+func TestSession_QueryRows(t *testing.T) {
+	_, _ = NewSession().Raw("DROP TABLE USER;").Exec()
+	_, _ = NewSession().Raw("CREATE TABLE USER(name text);").Exec()
+	row := NewSession().Raw("SELECT count(*) FROM USER").QueryRow()
+	var count int
+	if err := row.Scan(&count); err != nil || count != 0 {
+		t.Fatal("failed to query db", err)
+	}
+}
diff --git a/gee-orm/day3-save-query/geeorm/session/record.go b/gee-orm/day3-save-query/geeorm/session/record.go
new file mode 100644
index 0000000..9b63548
--- /dev/null
+++ b/gee-orm/day3-save-query/geeorm/session/record.go
@@ -0,0 +1,43 @@
+package session
+
+import (
+	"fmt"
+	"strings"
+)
+
+// Create one or more records in database
+func (s *Session) Create(values ...interface{}) (int64, error) {
+	var flag bool
+	for i, value := range values {
+		table := s.RefTable(value)
+		filedSQL := strings.Join(table.FieldNames, ", ")
+		bindVarSQL := strings.Join(table.BindVars, ", ")
+		if !flag {
+			s.Raw(fmt.Sprintf("INSERT INTO %s (%v) VALUES ", table.TableName, filedSQL))
+			flag = true
+		}
+		s.Raw(fmt.Sprintf("(%v)", bindVarSQL), table.Values(value)...)
+		if i == len(values)-1 {
+			s.Raw(";")
+		} else {
+			s.Raw(",")
+		}
+	}
+
+	result, err := s.Exec()
+	if err != nil {
+		return 0, err
+	}
+
+	return result.RowsAffected()
+}
+
+func (s *Session) First(value interface{}) error {
+	table := s.RefTable(value)
+	fieldSQL := strings.Join(table.FieldNames, ", ")
+	sql := fmt.Sprintf("SELECT (%v) FROM %s LIMIT 1", fieldSQL, table.TableName)
+
+	row := s.Raw(sql).QueryRow()
+
+	return row.Scan(value)
+}
diff --git a/gee-orm/day3-save-query/geeorm/session/record_test.go b/gee-orm/day3-save-query/geeorm/session/record_test.go
new file mode 100644
index 0000000..abf157a
--- /dev/null
+++ b/gee-orm/day3-save-query/geeorm/session/record_test.go
@@ -0,0 +1,16 @@
+package session
+
+import "testing"
+
+var (
+	user1 = &User{"Tom", 18}
+	user2 = &User{"Sam", 25}
+)
+
+func TestSession_Create(t *testing.T) {
+	_ = NewSession().DropTable(&User{})
+	_ = NewSession().CreateTable(&User{})
+	if affected, err := NewSession().Create(user1, user2); err != nil || affected != 2 {
+		t.Fatal("failed to create record")
+	}
+}
diff --git a/gee-orm/day2-reflect-schema/geeorm/session_schema.go b/gee-orm/day3-save-query/geeorm/session/schema.go
old mode 100755
new mode 100644
similarity index 63%
rename from gee-orm/day2-reflect-schema/geeorm/session_schema.go
rename to gee-orm/day3-save-query/geeorm/session/schema.go
index 38a0bdc..d9135f9
--- a/gee-orm/day2-reflect-schema/geeorm/session_schema.go
+++ b/gee-orm/day3-save-query/geeorm/session/schema.go
@@ -1,53 +1,59 @@
-package geeorm
+package session
 
 import (
 	"fmt"
 	"strings"
 
+	"geeorm/log"
 	"geeorm/schema"
 )
 
+// RefTable returns a Schema instance that contains all parsed fields
 func (s *Session) RefTable(value interface{}) *schema.Schema {
 	if value == nil {
 		panic("value is nil")
 	}
 	if s.refTable == nil {
-		s.refTable = schema.Parse(value, s.engine.dialect)
+		s.refTable = schema.Parse(value, s.dialect)
 	}
 	return s.refTable
 }
 
+// CreateTable create a table in database with a model
 func (s *Session) CreateTable(value interface{}) error {
 	table := s.RefTable(value)
 	var columns []string
 	for _, field := range table.Fields {
-		columns = append(columns, fmt.Sprintf("%s %s", field.Name, field.Tag))
+		tag := field.Tag
+		if field.Name == table.PrimaryField.Name {
+			tag += " PRIMARY KEY"
+		}
+		columns = append(columns, fmt.Sprintf("%s %s", field.Name, tag))
 	}
 	desc := strings.Join(columns, ",")
 	_, err := s.Raw(fmt.Sprintf("CREATE TABLE %s (%s);", table.TableName, desc)).Exec()
 	return err
 }
 
+// DropTable drops a table with the name of model
 func (s *Session) DropTable(value interface{}) error {
 	table := s.RefTable(value)
 	_, err := s.Raw(fmt.Sprintf("DROP TABLE %s", table.TableName)).Exec()
 	return err
 }
 
+// HasTable returns true of the table exists
 func (s *Session) HasTable(value interface{}) bool {
 	tableName, ok := value.(string)
 	if !ok {
 		tableName = s.RefTable(value).TableName
 	}
 
-	sql, values := s.engine.dialect.TableExistSQL(tableName)
+	sql, values := s.dialect.TableExistSQL(tableName)
 	row := s.Raw(sql, values...).QueryRow()
-
-
-
 	var tmp string
 	if err := row.Scan(&tmp); err != nil {
-		ErrorLog.Println(err)
+		log.Error.Println(err)
 	}
 	return tmp == tableName
 }
diff --git a/gee-orm/day3-save-query/geeorm/session/schema_test.go b/gee-orm/day3-save-query/geeorm/session/schema_test.go
new file mode 100644
index 0000000..5c934fa
--- /dev/null
+++ b/gee-orm/day3-save-query/geeorm/session/schema_test.go
@@ -0,0 +1,18 @@
+package session
+
+import (
+	"testing"
+)
+
+type User struct {
+	Name string `geeorm:"primary_key"`
+	Age  int
+}
+
+func TestSession_CreateTable(t *testing.T) {
+	_ = NewSession().DropTable(&User{})
+	_ = NewSession().CreateTable(&User{})
+	if !NewSession().HasTable("User") {
+		t.Fatal("failed to create table User")
+	}
+}

From 95814ae9ae52dc1b446f7506189eede16685dd78 Mon Sep 17 00:00:00 2001
From: gzdaijie <gzdaijie@163.com>
Date: Mon, 24 Feb 2020 01:24:05 +0800
Subject: [PATCH 040/122] day3 add find multi records & find first record

---
 .../day3-save-query/geeorm/session/record.go  | 44 +++++++++++++++++--
 .../geeorm/session/record_test.go             | 21 +++++++++
 2 files changed, 62 insertions(+), 3 deletions(-)

diff --git a/gee-orm/day3-save-query/geeorm/session/record.go b/gee-orm/day3-save-query/geeorm/session/record.go
index 9b63548..2b7c7da 100644
--- a/gee-orm/day3-save-query/geeorm/session/record.go
+++ b/gee-orm/day3-save-query/geeorm/session/record.go
@@ -2,6 +2,7 @@ package session
 
 import (
 	"fmt"
+	"reflect"
 	"strings"
 )
 
@@ -32,12 +33,49 @@ func (s *Session) Create(values ...interface{}) (int64, error) {
 	return result.RowsAffected()
 }
 
+// First gets the 1st row
 func (s *Session) First(value interface{}) error {
 	table := s.RefTable(value)
+
 	fieldSQL := strings.Join(table.FieldNames, ", ")
-	sql := fmt.Sprintf("SELECT (%v) FROM %s LIMIT 1", fieldSQL, table.TableName)
+	selectSQL := fmt.Sprintf("SELECT %v FROM %s LIMIT 1", fieldSQL, table.TableName)
+	row := s.Raw(selectSQL).QueryRow()
+
+	dest := reflect.ValueOf(value).Elem()
+	var values []interface{}
+	for _, name := range table.FieldNames {
+		values = append(values, dest.FieldByName(name).Addr().Interface())
+	}
 
-	row := s.Raw(sql).QueryRow()
+	return row.Scan(values...)
+}
 
-	return row.Scan(value)
+// Find gets all eligible records
+func (s *Session) Find(values interface{}) error {
+	destSlice := reflect.Indirect(reflect.ValueOf(values))
+	destType := destSlice.Type().Elem()
+	table := s.RefTable(reflect.New(destType).Elem().Interface())
+
+	fieldSQL := strings.Join(table.FieldNames, ", ")
+	selectSQL := fmt.Sprintf("SELECT %v FROM %s", fieldSQL, table.TableName)
+	rows, err := s.Raw(selectSQL).QueryRows()
+	if err != nil {
+		return err
+	}
+
+	for rows.Next() {
+		dest := reflect.New(destType).Elem()
+		var values []interface{}
+		for _, name := range table.FieldNames {
+			values = append(values, dest.FieldByName(name).Addr().Interface())
+		}
+		if err := rows.Scan(values...); err != nil {
+			return err
+		}
+		destSlice.Set(reflect.Append(destSlice, dest))
+	}
+	if err := rows.Close(); err != nil {
+		return err
+	}
+	return nil
 }
diff --git a/gee-orm/day3-save-query/geeorm/session/record_test.go b/gee-orm/day3-save-query/geeorm/session/record_test.go
index abf157a..f57680e 100644
--- a/gee-orm/day3-save-query/geeorm/session/record_test.go
+++ b/gee-orm/day3-save-query/geeorm/session/record_test.go
@@ -14,3 +14,24 @@ func TestSession_Create(t *testing.T) {
 		t.Fatal("failed to create record")
 	}
 }
+
+func TestSession_First(t *testing.T) {
+	_ = NewSession().DropTable(&User{})
+	_ = NewSession().CreateTable(&User{})
+	_, _ = NewSession().Create(user1)
+	u := &User{}
+	err := NewSession().First(u)
+	if err != nil || u.Age != user1.Age || u.Name != user1.Name {
+		t.Fatal("failed to query first")
+	}
+}
+
+func TestSession_Find(t *testing.T) {
+	_ = NewSession().DropTable(&User{})
+	_ = NewSession().CreateTable(&User{})
+	_, _ = NewSession().Create(user1, user2)
+	users := []User{}
+	if err := NewSession().Find(&users); err != nil || len(users) != 2 {
+		t.Fatal("failed to query all")
+	}
+}

From 66fdda820ed4f585623ceefda5dff37f6e6c0a52 Mon Sep 17 00:00:00 2001
From: gzdaijie <gzdaijie@gmail.com>
Date: Mon, 24 Feb 2020 22:15:26 +0800
Subject: [PATCH 041/122] refactor a better logger that supports different
 levels

---
 gee-orm/day1-database-sql/geeorm/geeorm.go    |  8 ++--
 gee-orm/day1-database-sql/geeorm/log/log.go   | 42 +++++++++++++++++--
 .../day1-database-sql/geeorm/log/log_test.go  | 17 ++++++++
 .../day1-database-sql/geeorm/session/raw.go   | 10 ++---
 .../geeorm/session/raw_test.go                |  2 +
 gee-orm/day2-reflect-schema/geeorm/geeorm.go  | 13 +++---
 gee-orm/day2-reflect-schema/geeorm/log/log.go | 42 +++++++++++++++++--
 .../geeorm/log/log_test.go                    | 17 ++++++++
 .../geeorm/schema/schema.go                   |  4 +-
 .../day2-reflect-schema/geeorm/session/raw.go | 10 ++---
 .../geeorm/session/raw_test.go                |  2 +
 .../geeorm/session/schema.go                  |  2 +-
 gee-orm/day3-save-query/geeorm/geeorm.go      | 13 +++---
 gee-orm/day3-save-query/geeorm/log/log.go     | 42 +++++++++++++++++--
 .../day3-save-query/geeorm/log/log_test.go    | 17 ++++++++
 .../day3-save-query/geeorm/schema/schema.go   |  4 +-
 gee-orm/day3-save-query/geeorm/session/raw.go | 10 ++---
 .../geeorm/session/raw_test.go                |  2 +
 .../day3-save-query/geeorm/session/schema.go  |  2 +-
 19 files changed, 206 insertions(+), 53 deletions(-)
 create mode 100644 gee-orm/day1-database-sql/geeorm/log/log_test.go
 create mode 100644 gee-orm/day2-reflect-schema/geeorm/log/log_test.go
 create mode 100644 gee-orm/day3-save-query/geeorm/log/log_test.go

diff --git a/gee-orm/day1-database-sql/geeorm/geeorm.go b/gee-orm/day1-database-sql/geeorm/geeorm.go
index 10de8b9..ae2ef44 100644
--- a/gee-orm/day1-database-sql/geeorm/geeorm.go
+++ b/gee-orm/day1-database-sql/geeorm/geeorm.go
@@ -17,23 +17,23 @@ type Engine struct {
 func NewEngine(driver, source string) (e *Engine, err error) {
 	db, err := sql.Open(driver, source)
 	if err != nil {
-		log.Error.Println(err)
+		log.Error(err)
 		return
 	}
 	// Send a ping to make sure the database connection is alive.
 	if err = db.Ping(); err != nil {
-		log.Error.Println(err)
+		log.Error(err)
 		return
 	}
 	e = &Engine{db: db}
-	log.Info.Println("Connect database success")
+	log.Info("Connect database success")
 	return
 }
 
 // Close database connection
 func (engine *Engine) Close() (err error) {
 	if err = engine.db.Close(); err == nil {
-		log.Info.Println("Close database success")
+		log.Info("Close database success")
 	}
 	return
 }
diff --git a/gee-orm/day1-database-sql/geeorm/log/log.go b/gee-orm/day1-database-sql/geeorm/log/log.go
index 4e326f3..684a718 100644
--- a/gee-orm/day1-database-sql/geeorm/log/log.go
+++ b/gee-orm/day1-database-sql/geeorm/log/log.go
@@ -1,13 +1,47 @@
 package log
 
 import (
+	"io/ioutil"
 	"log"
 	"os"
+	"sync"
 )
 
 var (
-	// Error is a logger for logging error messages
-	Error = log.New(os.Stdout, "[error] ", log.LstdFlags|log.Lshortfile)
-	// Info is a logger for logging normal messages
-	Info = log.New(os.Stdout, "[info ] ", log.LstdFlags|log.Lshortfile)
+	errorLog = log.New(os.Stdout, "\033[31m[error]\033[0m ", log.LstdFlags|log.Lshortfile)
+	infoLog  = log.New(os.Stdout, "\033[34m[info ]\033[0m ", log.LstdFlags|log.Lshortfile)
+	loggers  = []*log.Logger{errorLog, infoLog}
+	mu       sync.Mutex
 )
+
+// log methods
+var (
+	Error  = errorLog.Println
+	Errorf = errorLog.Printf
+	Info   = infoLog.Println
+	Infof  = infoLog.Printf
+)
+
+// log levels
+const (
+	InfoLevel  = 0
+	ErrorLevel = 1
+	Disabled   = 9999
+)
+
+// SetLevel controls log level
+func SetLevel(level int) {
+	mu.Lock()
+	defer mu.Unlock()
+
+	for _, logger := range loggers {
+		logger.SetOutput(os.Stdout)
+	}
+
+	if ErrorLevel < level {
+		errorLog.SetOutput(ioutil.Discard)
+	}
+	if InfoLevel < level {
+		infoLog.SetOutput(ioutil.Discard)
+	}
+}
diff --git a/gee-orm/day1-database-sql/geeorm/log/log_test.go b/gee-orm/day1-database-sql/geeorm/log/log_test.go
new file mode 100644
index 0000000..8cd403c
--- /dev/null
+++ b/gee-orm/day1-database-sql/geeorm/log/log_test.go
@@ -0,0 +1,17 @@
+package log
+
+import (
+	"os"
+	"testing"
+)
+
+func TestSetLevel(t *testing.T) {
+	SetLevel(ErrorLevel)
+	if infoLog.Writer() == os.Stdout || errorLog.Writer() != os.Stdout {
+		t.Fatal("failed to set log level")
+	}
+	SetLevel(Disabled)
+	if infoLog.Writer() == os.Stdout || errorLog.Writer() == os.Stdout {
+		t.Fatal("failed to set log level")
+	}
+}
\ No newline at end of file
diff --git a/gee-orm/day1-database-sql/geeorm/session/raw.go b/gee-orm/day1-database-sql/geeorm/session/raw.go
index 2d5101a..6f9693c 100644
--- a/gee-orm/day1-database-sql/geeorm/session/raw.go
+++ b/gee-orm/day1-database-sql/geeorm/session/raw.go
@@ -23,24 +23,24 @@ func New(db *sql.DB) *Session {
 
 // Exec raw SQL with SQLVars
 func (s *Session) Exec() (result sql.Result, err error) {
-	log.Info.Println(s.SQL.String(), s.SQLVars)
+	log.Info(s.SQL.String(), s.SQLVars)
 	if result, err = s.db.Exec(s.SQL.String(), s.SQLVars...); err != nil {
-		log.Error.Println(err)
+		log.Error(err)
 	}
 	return
 }
 
 // QueryRow gets a record from db
 func (s *Session) QueryRow() *sql.Row {
-	log.Info.Println(s.SQL.String(), s.SQLVars)
+	log.Info(s.SQL.String(), s.SQLVars)
 	return s.db.QueryRow(s.SQL.String(), s.SQLVars...)
 }
 
 // QueryRows gets a list of records from db
 func (s *Session) QueryRows() (rows *sql.Rows, err error) {
-	log.Info.Println(s.SQL.String(), s.SQLVars)
+	log.Info(s.SQL.String(), s.SQLVars)
 	if rows, err = s.db.Query(s.SQL.String(), s.SQLVars...); err != nil {
-		log.Error.Println(err)
+		log.Error(err)
 	}
 	return
 }
diff --git a/gee-orm/day1-database-sql/geeorm/session/raw_test.go b/gee-orm/day1-database-sql/geeorm/session/raw_test.go
index 1502a7e..9fe7460 100644
--- a/gee-orm/day1-database-sql/geeorm/session/raw_test.go
+++ b/gee-orm/day1-database-sql/geeorm/session/raw_test.go
@@ -2,6 +2,7 @@ package session
 
 import (
 	"database/sql"
+	"geeorm/log"
 	"os"
 	"testing"
 
@@ -12,6 +13,7 @@ var TestDB *sql.DB
 
 func setup() {
 	TestDB, _ = sql.Open("sqlite3", "gee.db")
+	log.SetLevel(log.ErrorLevel)
 }
 
 func teardown() {
diff --git a/gee-orm/day2-reflect-schema/geeorm/geeorm.go b/gee-orm/day2-reflect-schema/geeorm/geeorm.go
index ee3ec33..61ee9e0 100644
--- a/gee-orm/day2-reflect-schema/geeorm/geeorm.go
+++ b/gee-orm/day2-reflect-schema/geeorm/geeorm.go
@@ -2,8 +2,6 @@ package geeorm
 
 import (
 	"database/sql"
-	"fmt"
-
 	"geeorm/dialect"
 	"geeorm/log"
 	"geeorm/session"
@@ -20,30 +18,29 @@ type Engine struct {
 func NewEngine(driver, source string) (e *Engine, err error) {
 	db, err := sql.Open(driver, source)
 	if err != nil {
-		log.Error.Println(err)
+		log.Error(err)
 		return
 	}
 	// Send a ping to make sure the database connection is alive.
 	if err = db.Ping(); err != nil {
-		log.Error.Println(err)
+		log.Error(err)
 		return
 	}
 	// make sure the specific dialect exists
 	dial, ok := dialect.GetDialect(driver)
 	if !ok {
-		err = fmt.Errorf("dialect %s Not Found", driver)
-		log.Error.Println(err)
+		log.Errorf("dialect %s Not Found", driver)
 		return
 	}
 	e = &Engine{db: db, dialect: dial}
-	log.Info.Println("Connect database success")
+	log.Info("Connect database success")
 	return
 }
 
 // Close database connection
 func (e *Engine) Close() (err error) {
 	if err = e.db.Close(); err == nil {
-		log.Info.Println("Close database success")
+		log.Info("Close database success")
 	}
 	return
 }
diff --git a/gee-orm/day2-reflect-schema/geeorm/log/log.go b/gee-orm/day2-reflect-schema/geeorm/log/log.go
index 4e326f3..684a718 100644
--- a/gee-orm/day2-reflect-schema/geeorm/log/log.go
+++ b/gee-orm/day2-reflect-schema/geeorm/log/log.go
@@ -1,13 +1,47 @@
 package log
 
 import (
+	"io/ioutil"
 	"log"
 	"os"
+	"sync"
 )
 
 var (
-	// Error is a logger for logging error messages
-	Error = log.New(os.Stdout, "[error] ", log.LstdFlags|log.Lshortfile)
-	// Info is a logger for logging normal messages
-	Info = log.New(os.Stdout, "[info ] ", log.LstdFlags|log.Lshortfile)
+	errorLog = log.New(os.Stdout, "\033[31m[error]\033[0m ", log.LstdFlags|log.Lshortfile)
+	infoLog  = log.New(os.Stdout, "\033[34m[info ]\033[0m ", log.LstdFlags|log.Lshortfile)
+	loggers  = []*log.Logger{errorLog, infoLog}
+	mu       sync.Mutex
 )
+
+// log methods
+var (
+	Error  = errorLog.Println
+	Errorf = errorLog.Printf
+	Info   = infoLog.Println
+	Infof  = infoLog.Printf
+)
+
+// log levels
+const (
+	InfoLevel  = 0
+	ErrorLevel = 1
+	Disabled   = 9999
+)
+
+// SetLevel controls log level
+func SetLevel(level int) {
+	mu.Lock()
+	defer mu.Unlock()
+
+	for _, logger := range loggers {
+		logger.SetOutput(os.Stdout)
+	}
+
+	if ErrorLevel < level {
+		errorLog.SetOutput(ioutil.Discard)
+	}
+	if InfoLevel < level {
+		infoLog.SetOutput(ioutil.Discard)
+	}
+}
diff --git a/gee-orm/day2-reflect-schema/geeorm/log/log_test.go b/gee-orm/day2-reflect-schema/geeorm/log/log_test.go
new file mode 100644
index 0000000..8cd403c
--- /dev/null
+++ b/gee-orm/day2-reflect-schema/geeorm/log/log_test.go
@@ -0,0 +1,17 @@
+package log
+
+import (
+	"os"
+	"testing"
+)
+
+func TestSetLevel(t *testing.T) {
+	SetLevel(ErrorLevel)
+	if infoLog.Writer() == os.Stdout || errorLog.Writer() != os.Stdout {
+		t.Fatal("failed to set log level")
+	}
+	SetLevel(Disabled)
+	if infoLog.Writer() == os.Stdout || errorLog.Writer() == os.Stdout {
+		t.Fatal("failed to set log level")
+	}
+}
\ No newline at end of file
diff --git a/gee-orm/day2-reflect-schema/geeorm/schema/schema.go b/gee-orm/day2-reflect-schema/geeorm/schema/schema.go
index 299368f..f942aa0 100644
--- a/gee-orm/day2-reflect-schema/geeorm/schema/schema.go
+++ b/gee-orm/day2-reflect-schema/geeorm/schema/schema.go
@@ -65,5 +65,5 @@ func (field *Field) String() string {
 
 // String returns readable string
 func (schema *Schema) String() string {
-	return fmt.Sprintf("TABLE %s(%v)", schema.TableName, schema.Fields)
-}
+	return fmt.Sprintf("TABLE %s %v", schema.TableName, schema.Fields)
+}
\ No newline at end of file
diff --git a/gee-orm/day2-reflect-schema/geeorm/session/raw.go b/gee-orm/day2-reflect-schema/geeorm/session/raw.go
index 02ea7df..61be125 100644
--- a/gee-orm/day2-reflect-schema/geeorm/session/raw.go
+++ b/gee-orm/day2-reflect-schema/geeorm/session/raw.go
@@ -31,24 +31,24 @@ func New(db *sql.DB, dialect dialect.Dialect) *Session {
 
 // Exec raw SQL with SQLVars
 func (s *Session) Exec() (result sql.Result, err error) {
-	log.Info.Println(s.SQL.String(), s.SQLVars)
+	log.Info(s.SQL.String(), s.SQLVars)
 	if result, err = s.db.Exec(s.SQL.String(), s.SQLVars...); err != nil {
-		log.Error.Println(err)
+		log.Error(err)
 	}
 	return
 }
 
 // QueryRow gets a record from db
 func (s *Session) QueryRow() *sql.Row {
-	log.Info.Println(s.SQL.String(), s.SQLVars)
+	log.Info(s.SQL.String(), s.SQLVars)
 	return s.db.QueryRow(s.SQL.String(), s.SQLVars...)
 }
 
 // QueryRows gets a list of records from db
 func (s *Session) QueryRows() (rows *sql.Rows, err error) {
-	log.Info.Println(s.SQL.String(), s.SQLVars)
+	log.Info(s.SQL.String(), s.SQLVars)
 	if rows, err = s.db.Query(s.SQL.String(), s.SQLVars...); err != nil {
-		log.Error.Println(err)
+		log.Error(err)
 	}
 	return
 }
diff --git a/gee-orm/day2-reflect-schema/geeorm/session/raw_test.go b/gee-orm/day2-reflect-schema/geeorm/session/raw_test.go
index bfcfb80..fd804ee 100644
--- a/gee-orm/day2-reflect-schema/geeorm/session/raw_test.go
+++ b/gee-orm/day2-reflect-schema/geeorm/session/raw_test.go
@@ -2,6 +2,7 @@ package session
 
 import (
 	"database/sql"
+	"geeorm/log"
 	"os"
 	"testing"
 
@@ -17,6 +18,7 @@ var (
 func setup() {
 	TestDB, _ = sql.Open("sqlite3", "gee.db")
 	TestDial, _ = dialect.GetDialect("sqlite3")
+	log.SetLevel(log.ErrorLevel)
 }
 
 func teardown() {
diff --git a/gee-orm/day2-reflect-schema/geeorm/session/schema.go b/gee-orm/day2-reflect-schema/geeorm/session/schema.go
index 0767d67..1ef9a80 100644
--- a/gee-orm/day2-reflect-schema/geeorm/session/schema.go
+++ b/gee-orm/day2-reflect-schema/geeorm/session/schema.go
@@ -53,7 +53,7 @@ func (s *Session) HasTable(value interface{}) bool {
 	row := s.Raw(sql, values...).QueryRow()
 	var tmp string
 	if err := row.Scan(&tmp); err != nil {
-		log.Error.Println(err)
+		log.Error(err)
 	}
 	return tmp == tableName
 }
diff --git a/gee-orm/day3-save-query/geeorm/geeorm.go b/gee-orm/day3-save-query/geeorm/geeorm.go
index ee3ec33..61ee9e0 100644
--- a/gee-orm/day3-save-query/geeorm/geeorm.go
+++ b/gee-orm/day3-save-query/geeorm/geeorm.go
@@ -2,8 +2,6 @@ package geeorm
 
 import (
 	"database/sql"
-	"fmt"
-
 	"geeorm/dialect"
 	"geeorm/log"
 	"geeorm/session"
@@ -20,30 +18,29 @@ type Engine struct {
 func NewEngine(driver, source string) (e *Engine, err error) {
 	db, err := sql.Open(driver, source)
 	if err != nil {
-		log.Error.Println(err)
+		log.Error(err)
 		return
 	}
 	// Send a ping to make sure the database connection is alive.
 	if err = db.Ping(); err != nil {
-		log.Error.Println(err)
+		log.Error(err)
 		return
 	}
 	// make sure the specific dialect exists
 	dial, ok := dialect.GetDialect(driver)
 	if !ok {
-		err = fmt.Errorf("dialect %s Not Found", driver)
-		log.Error.Println(err)
+		log.Errorf("dialect %s Not Found", driver)
 		return
 	}
 	e = &Engine{db: db, dialect: dial}
-	log.Info.Println("Connect database success")
+	log.Info("Connect database success")
 	return
 }
 
 // Close database connection
 func (e *Engine) Close() (err error) {
 	if err = e.db.Close(); err == nil {
-		log.Info.Println("Close database success")
+		log.Info("Close database success")
 	}
 	return
 }
diff --git a/gee-orm/day3-save-query/geeorm/log/log.go b/gee-orm/day3-save-query/geeorm/log/log.go
index 4e326f3..684a718 100644
--- a/gee-orm/day3-save-query/geeorm/log/log.go
+++ b/gee-orm/day3-save-query/geeorm/log/log.go
@@ -1,13 +1,47 @@
 package log
 
 import (
+	"io/ioutil"
 	"log"
 	"os"
+	"sync"
 )
 
 var (
-	// Error is a logger for logging error messages
-	Error = log.New(os.Stdout, "[error] ", log.LstdFlags|log.Lshortfile)
-	// Info is a logger for logging normal messages
-	Info = log.New(os.Stdout, "[info ] ", log.LstdFlags|log.Lshortfile)
+	errorLog = log.New(os.Stdout, "\033[31m[error]\033[0m ", log.LstdFlags|log.Lshortfile)
+	infoLog  = log.New(os.Stdout, "\033[34m[info ]\033[0m ", log.LstdFlags|log.Lshortfile)
+	loggers  = []*log.Logger{errorLog, infoLog}
+	mu       sync.Mutex
 )
+
+// log methods
+var (
+	Error  = errorLog.Println
+	Errorf = errorLog.Printf
+	Info   = infoLog.Println
+	Infof  = infoLog.Printf
+)
+
+// log levels
+const (
+	InfoLevel  = 0
+	ErrorLevel = 1
+	Disabled   = 9999
+)
+
+// SetLevel controls log level
+func SetLevel(level int) {
+	mu.Lock()
+	defer mu.Unlock()
+
+	for _, logger := range loggers {
+		logger.SetOutput(os.Stdout)
+	}
+
+	if ErrorLevel < level {
+		errorLog.SetOutput(ioutil.Discard)
+	}
+	if InfoLevel < level {
+		infoLog.SetOutput(ioutil.Discard)
+	}
+}
diff --git a/gee-orm/day3-save-query/geeorm/log/log_test.go b/gee-orm/day3-save-query/geeorm/log/log_test.go
new file mode 100644
index 0000000..8cd403c
--- /dev/null
+++ b/gee-orm/day3-save-query/geeorm/log/log_test.go
@@ -0,0 +1,17 @@
+package log
+
+import (
+	"os"
+	"testing"
+)
+
+func TestSetLevel(t *testing.T) {
+	SetLevel(ErrorLevel)
+	if infoLog.Writer() == os.Stdout || errorLog.Writer() != os.Stdout {
+		t.Fatal("failed to set log level")
+	}
+	SetLevel(Disabled)
+	if infoLog.Writer() == os.Stdout || errorLog.Writer() == os.Stdout {
+		t.Fatal("failed to set log level")
+	}
+}
\ No newline at end of file
diff --git a/gee-orm/day3-save-query/geeorm/schema/schema.go b/gee-orm/day3-save-query/geeorm/schema/schema.go
index 299368f..f942aa0 100644
--- a/gee-orm/day3-save-query/geeorm/schema/schema.go
+++ b/gee-orm/day3-save-query/geeorm/schema/schema.go
@@ -65,5 +65,5 @@ func (field *Field) String() string {
 
 // String returns readable string
 func (schema *Schema) String() string {
-	return fmt.Sprintf("TABLE %s(%v)", schema.TableName, schema.Fields)
-}
+	return fmt.Sprintf("TABLE %s %v", schema.TableName, schema.Fields)
+}
\ No newline at end of file
diff --git a/gee-orm/day3-save-query/geeorm/session/raw.go b/gee-orm/day3-save-query/geeorm/session/raw.go
index 02ea7df..61be125 100644
--- a/gee-orm/day3-save-query/geeorm/session/raw.go
+++ b/gee-orm/day3-save-query/geeorm/session/raw.go
@@ -31,24 +31,24 @@ func New(db *sql.DB, dialect dialect.Dialect) *Session {
 
 // Exec raw SQL with SQLVars
 func (s *Session) Exec() (result sql.Result, err error) {
-	log.Info.Println(s.SQL.String(), s.SQLVars)
+	log.Info(s.SQL.String(), s.SQLVars)
 	if result, err = s.db.Exec(s.SQL.String(), s.SQLVars...); err != nil {
-		log.Error.Println(err)
+		log.Error(err)
 	}
 	return
 }
 
 // QueryRow gets a record from db
 func (s *Session) QueryRow() *sql.Row {
-	log.Info.Println(s.SQL.String(), s.SQLVars)
+	log.Info(s.SQL.String(), s.SQLVars)
 	return s.db.QueryRow(s.SQL.String(), s.SQLVars...)
 }
 
 // QueryRows gets a list of records from db
 func (s *Session) QueryRows() (rows *sql.Rows, err error) {
-	log.Info.Println(s.SQL.String(), s.SQLVars)
+	log.Info(s.SQL.String(), s.SQLVars)
 	if rows, err = s.db.Query(s.SQL.String(), s.SQLVars...); err != nil {
-		log.Error.Println(err)
+		log.Error(err)
 	}
 	return
 }
diff --git a/gee-orm/day3-save-query/geeorm/session/raw_test.go b/gee-orm/day3-save-query/geeorm/session/raw_test.go
index bfcfb80..fd804ee 100644
--- a/gee-orm/day3-save-query/geeorm/session/raw_test.go
+++ b/gee-orm/day3-save-query/geeorm/session/raw_test.go
@@ -2,6 +2,7 @@ package session
 
 import (
 	"database/sql"
+	"geeorm/log"
 	"os"
 	"testing"
 
@@ -17,6 +18,7 @@ var (
 func setup() {
 	TestDB, _ = sql.Open("sqlite3", "gee.db")
 	TestDial, _ = dialect.GetDialect("sqlite3")
+	log.SetLevel(log.ErrorLevel)
 }
 
 func teardown() {
diff --git a/gee-orm/day3-save-query/geeorm/session/schema.go b/gee-orm/day3-save-query/geeorm/session/schema.go
index d9135f9..c8ea3de 100644
--- a/gee-orm/day3-save-query/geeorm/session/schema.go
+++ b/gee-orm/day3-save-query/geeorm/session/schema.go
@@ -53,7 +53,7 @@ func (s *Session) HasTable(value interface{}) bool {
 	row := s.Raw(sql, values...).QueryRow()
 	var tmp string
 	if err := row.Scan(&tmp); err != nil {
-		log.Error.Println(err)
+		log.Error(err)
 	}
 	return tmp == tableName
 }

From cf3ae163e6d826db95158777e8cfefced872b8c4 Mon Sep 17 00:00:00 2001
From: gzdaijie <gzdaijie@gmail.com>
Date: Mon, 24 Feb 2020 22:22:19 +0800
Subject: [PATCH 042/122] refactor Session, remove Value & lower SQL & SQLVars

---
 .../day1-database-sql/geeorm/session/raw.go   | 29 ++++----
 .../day2-reflect-schema/geeorm/session/raw.go | 28 ++++----
 .../geeorm/session/raw_test.go                |  2 -
 .../day3-save-query/geeorm/clause/clause.go   | 46 +++++++++++++
 .../geeorm/clause/clause_test.go              | 32 +++++++++
 .../geeorm/clause/generator.go                | 68 +++++++++++++++++++
 .../day3-save-query/geeorm/schema/schema.go   |  4 +-
 gee-orm/day3-save-query/geeorm/session/raw.go | 30 ++++----
 .../geeorm/session/raw_test.go                |  2 -
 .../day3-save-query/geeorm/session/record.go  | 34 +++++-----
 10 files changed, 204 insertions(+), 71 deletions(-)
 create mode 100755 gee-orm/day3-save-query/geeorm/clause/clause.go
 create mode 100755 gee-orm/day3-save-query/geeorm/clause/clause_test.go
 create mode 100755 gee-orm/day3-save-query/geeorm/clause/generator.go

diff --git a/gee-orm/day1-database-sql/geeorm/session/raw.go b/gee-orm/day1-database-sql/geeorm/session/raw.go
index 6f9693c..aecc158 100644
--- a/gee-orm/day1-database-sql/geeorm/session/raw.go
+++ b/gee-orm/day1-database-sql/geeorm/session/raw.go
@@ -2,18 +2,15 @@ package session
 
 import (
 	"database/sql"
-	"strings"
-
 	"geeorm/log"
 )
 
 // Session keep a pointer to sql.DB and provides all execution of all
 // kind of database operations.
 type Session struct {
-	db *sql.DB
-
-	SQL     strings.Builder
-	SQLVars []interface{}
+	db      *sql.DB
+	sql     string
+	sqlVars []interface{}
 }
 
 // New creates a instance of Session
@@ -21,10 +18,10 @@ func New(db *sql.DB) *Session {
 	return &Session{db: db}
 }
 
-// Exec raw SQL with SQLVars
+// Exec raw sql with sqlVars
 func (s *Session) Exec() (result sql.Result, err error) {
-	log.Info(s.SQL.String(), s.SQLVars)
-	if result, err = s.db.Exec(s.SQL.String(), s.SQLVars...); err != nil {
+	log.Info(s.sql, s.sqlVars)
+	if result, err = s.db.Exec(s.sql, s.sqlVars...); err != nil {
 		log.Error(err)
 	}
 	return
@@ -32,22 +29,22 @@ func (s *Session) Exec() (result sql.Result, err error) {
 
 // QueryRow gets a record from db
 func (s *Session) QueryRow() *sql.Row {
-	log.Info(s.SQL.String(), s.SQLVars)
-	return s.db.QueryRow(s.SQL.String(), s.SQLVars...)
+	log.Info(s.sql, s.sqlVars)
+	return s.db.QueryRow(s.sql, s.sqlVars...)
 }
 
 // QueryRows gets a list of records from db
 func (s *Session) QueryRows() (rows *sql.Rows, err error) {
-	log.Info(s.SQL.String(), s.SQLVars)
-	if rows, err = s.db.Query(s.SQL.String(), s.SQLVars...); err != nil {
+	log.Info(s.sql, s.sqlVars)
+	if rows, err = s.db.Query(s.sql, s.sqlVars...); err != nil {
 		log.Error(err)
 	}
 	return
 }
 
-// Raw appends SQL and SQLVars
+// Raw appends sql and sqlVars
 func (s *Session) Raw(sql string, values ...interface{}) *Session {
-	s.SQL.WriteString(sql)
-	s.SQLVars = append(s.SQLVars, values...)
+	s.sql += sql
+	s.sqlVars = append(s.sqlVars, values...)
 	return s
 }
diff --git a/gee-orm/day2-reflect-schema/geeorm/session/raw.go b/gee-orm/day2-reflect-schema/geeorm/session/raw.go
index 61be125..6892e0c 100644
--- a/gee-orm/day2-reflect-schema/geeorm/session/raw.go
+++ b/gee-orm/day2-reflect-schema/geeorm/session/raw.go
@@ -2,8 +2,6 @@ package session
 
 import (
 	"database/sql"
-	"strings"
-
 	"geeorm/dialect"
 	"geeorm/log"
 	"geeorm/schema"
@@ -15,10 +13,8 @@ type Session struct {
 	db       *sql.DB
 	dialect  dialect.Dialect
 	refTable *schema.Schema
-
-	Value   interface{}
-	SQL     strings.Builder
-	SQLVars []interface{}
+	sql      string
+	sqlVars  []interface{}
 }
 
 // New creates a instance of Session
@@ -29,10 +25,10 @@ func New(db *sql.DB, dialect dialect.Dialect) *Session {
 	}
 }
 
-// Exec raw SQL with SQLVars
+// Exec raw sql with sqlVars
 func (s *Session) Exec() (result sql.Result, err error) {
-	log.Info(s.SQL.String(), s.SQLVars)
-	if result, err = s.db.Exec(s.SQL.String(), s.SQLVars...); err != nil {
+	log.Info(s.sql, s.sqlVars)
+	if result, err = s.db.Exec(s.sql, s.sqlVars...); err != nil {
 		log.Error(err)
 	}
 	return
@@ -40,22 +36,22 @@ func (s *Session) Exec() (result sql.Result, err error) {
 
 // QueryRow gets a record from db
 func (s *Session) QueryRow() *sql.Row {
-	log.Info(s.SQL.String(), s.SQLVars)
-	return s.db.QueryRow(s.SQL.String(), s.SQLVars...)
+	log.Info(s.sql, s.sqlVars)
+	return s.db.QueryRow(s.sql, s.sqlVars...)
 }
 
 // QueryRows gets a list of records from db
 func (s *Session) QueryRows() (rows *sql.Rows, err error) {
-	log.Info(s.SQL.String(), s.SQLVars)
-	if rows, err = s.db.Query(s.SQL.String(), s.SQLVars...); err != nil {
+	log.Info(s.sql, s.sqlVars)
+	if rows, err = s.db.Query(s.sql, s.sqlVars...); err != nil {
 		log.Error(err)
 	}
 	return
 }
 
-// Raw appends SQL and SQLVars
+// Raw appends sql and sqlVars
 func (s *Session) Raw(sql string, values ...interface{}) *Session {
-	s.SQL.WriteString(sql)
-	s.SQLVars = append(s.SQLVars, values...)
+	s.sql += sql
+	s.sqlVars = append(s.sqlVars, values...)
 	return s
 }
diff --git a/gee-orm/day2-reflect-schema/geeorm/session/raw_test.go b/gee-orm/day2-reflect-schema/geeorm/session/raw_test.go
index fd804ee..bfcfb80 100644
--- a/gee-orm/day2-reflect-schema/geeorm/session/raw_test.go
+++ b/gee-orm/day2-reflect-schema/geeorm/session/raw_test.go
@@ -2,7 +2,6 @@ package session
 
 import (
 	"database/sql"
-	"geeorm/log"
 	"os"
 	"testing"
 
@@ -18,7 +17,6 @@ var (
 func setup() {
 	TestDB, _ = sql.Open("sqlite3", "gee.db")
 	TestDial, _ = dialect.GetDialect("sqlite3")
-	log.SetLevel(log.ErrorLevel)
 }
 
 func teardown() {
diff --git a/gee-orm/day3-save-query/geeorm/clause/clause.go b/gee-orm/day3-save-query/geeorm/clause/clause.go
new file mode 100755
index 0000000..8ee7b16
--- /dev/null
+++ b/gee-orm/day3-save-query/geeorm/clause/clause.go
@@ -0,0 +1,46 @@
+package clause
+
+import (
+	"strings"
+)
+
+// Clause contains SQL conditions
+type Clause struct {
+	sql     map[Type]string
+	sqlVars map[Type][]interface{}
+}
+
+// Type is the type of Clause
+type Type int
+
+// Support types for Clause
+const (
+	INSERT Type = 0
+	VALUES Type = 1
+	SELECT Type = 2
+	LIMIT  Type = 3
+)
+
+// Set adds a sub clause of specific type
+func (c *Clause) Set(name Type, vars ...interface{}) {
+	if c.sql == nil {
+		c.sql = make(map[Type]string)
+		c.sqlVars = make(map[Type][]interface{})
+	}
+	sql, vars := generators[name](vars...)
+	c.sql[name] = sql
+	c.sqlVars[name] = vars
+}
+
+// Build generate the final SQL and SQLVars
+func (c *Clause) Build(orders []Type) (string, []interface{}) {
+	var sqls []string
+	var vars []interface{}
+	for _, order := range orders {
+		if sql, ok := c.sql[order]; ok {
+			sqls = append(sqls, sql)
+			vars = append(vars, c.sqlVars[order]...)
+		}
+	}
+	return strings.Join(sqls, " "), vars
+}
diff --git a/gee-orm/day3-save-query/geeorm/clause/clause_test.go b/gee-orm/day3-save-query/geeorm/clause/clause_test.go
new file mode 100755
index 0000000..99bb513
--- /dev/null
+++ b/gee-orm/day3-save-query/geeorm/clause/clause_test.go
@@ -0,0 +1,32 @@
+package clause
+
+import (
+	"reflect"
+	"testing"
+)
+
+func TestClause_Set(t *testing.T) {
+	var clause Clause
+	clause.Set(INSERT, "User", "Name,Age")
+	sql := clause.sql[INSERT]
+	vars := clause.sqlVars[INSERT]
+	t.Log(sql, vars)
+	if sql != "INSERT INTO User (Name,Age)" || len(vars) != 0 {
+		t.Fatal("failed to get clause")
+	}
+}
+
+func TestClause_Build(t *testing.T) {
+	var clause Clause
+	clause.Set(LIMIT, 3)
+	clause.Set(SELECT, "User", "*")
+	orders := []Type{SELECT, LIMIT}
+	sql, vars := clause.Build(orders)
+	t.Log(sql, vars)
+	if sql != "SELECT * FROM User LIMIT ?" {
+		t.Fatal("failed to build SQL")
+	}
+	if !reflect.DeepEqual(vars, []interface{}{3}) {
+		t.Fatal("failed to build SQLVars")
+	}
+}
diff --git a/gee-orm/day3-save-query/geeorm/clause/generator.go b/gee-orm/day3-save-query/geeorm/clause/generator.go
new file mode 100755
index 0000000..78b4989
--- /dev/null
+++ b/gee-orm/day3-save-query/geeorm/clause/generator.go
@@ -0,0 +1,68 @@
+package clause
+
+import (
+	"fmt"
+	"log"
+	"strings"
+)
+
+type generator func(values ...interface{}) (string, []interface{})
+
+var generators map[Type]generator
+
+func init() {
+	generators = make(map[Type]generator)
+	generators[INSERT] = _insert
+	generators[VALUES] = _values
+	generators[SELECT] = _select
+	generators[LIMIT] = _limit
+}
+
+func genBindVars(num int) string {
+	var vars []string
+	for i := 0; i < num; i++ {
+		vars = append(vars, "?")
+	}
+	return strings.Join(vars, ", ")
+}
+
+func _insert(values ...interface{}) (string, []interface{}) {
+	// INSERT INTO $tableName ($fields)
+	tableName := values[0]
+	fields := values[1]
+	return fmt.Sprintf("INSERT INTO %s (%v)", tableName, fields), []interface{}{}
+}
+
+func _values(values ...interface{}) (string, []interface{}) {
+	// VALUES ($v1), (&v2), ...
+	var bindStr string
+	var sql strings.Builder
+	var vars []interface{}
+	sql.WriteString("VALUES ")
+	for i, value := range values {
+		v := value.([]interface{})
+		if bindStr == "" {
+			bindStr = genBindVars(len(v))
+		}
+		sql.WriteString(fmt.Sprintf("(%v)", bindStr))
+		if i+1 != len(values) {
+			sql.WriteString(", ")
+		}
+		vars = append(vars, v...)
+	}
+	return sql.String(), vars
+
+}
+
+func _select(values ...interface{}) (string, []interface{}) {
+	// SELECT $fields FROM $tableName
+	tableName := values[0]
+	fields := values[1]
+	return fmt.Sprintf("SELECT %v FROM %s", fields, tableName), []interface{}{}
+}
+
+func _limit(values ...interface{}) (string, []interface{}) {
+	// LIMIT $num
+	log.Println(values...)
+	return "LIMIT ?", values
+}
diff --git a/gee-orm/day3-save-query/geeorm/schema/schema.go b/gee-orm/day3-save-query/geeorm/schema/schema.go
index f942aa0..8519fd4 100644
--- a/gee-orm/day3-save-query/geeorm/schema/schema.go
+++ b/gee-orm/day3-save-query/geeorm/schema/schema.go
@@ -19,7 +19,6 @@ type Schema struct {
 	PrimaryField *Field
 	Fields       []*Field
 	FieldNames   []string
-	BindVars     []string
 }
 
 // Values return the values of dest's member variables
@@ -52,7 +51,6 @@ func Parse(dest interface{}, d dialect.Dialect) *Schema {
 			}
 			schema.Fields = append(schema.Fields, field)
 			schema.FieldNames = append(schema.FieldNames, p.Name)
-			schema.BindVars = append(schema.BindVars, "?")
 		}
 	}
 	return schema
@@ -66,4 +64,4 @@ func (field *Field) String() string {
 // String returns readable string
 func (schema *Schema) String() string {
 	return fmt.Sprintf("TABLE %s %v", schema.TableName, schema.Fields)
-}
\ No newline at end of file
+}
diff --git a/gee-orm/day3-save-query/geeorm/session/raw.go b/gee-orm/day3-save-query/geeorm/session/raw.go
index 61be125..6cb72c9 100644
--- a/gee-orm/day3-save-query/geeorm/session/raw.go
+++ b/gee-orm/day3-save-query/geeorm/session/raw.go
@@ -2,8 +2,7 @@ package session
 
 import (
 	"database/sql"
-	"strings"
-
+	"geeorm/clause"
 	"geeorm/dialect"
 	"geeorm/log"
 	"geeorm/schema"
@@ -15,10 +14,9 @@ type Session struct {
 	db       *sql.DB
 	dialect  dialect.Dialect
 	refTable *schema.Schema
-
-	Value   interface{}
-	SQL     strings.Builder
-	SQLVars []interface{}
+	clause   clause.Clause
+	sql      string
+	sqlVars  []interface{}
 }
 
 // New creates a instance of Session
@@ -29,10 +27,10 @@ func New(db *sql.DB, dialect dialect.Dialect) *Session {
 	}
 }
 
-// Exec raw SQL with SQLVars
+// Exec raw sql with sqlVars
 func (s *Session) Exec() (result sql.Result, err error) {
-	log.Info(s.SQL.String(), s.SQLVars)
-	if result, err = s.db.Exec(s.SQL.String(), s.SQLVars...); err != nil {
+	log.Info(s.sql, s.sqlVars)
+	if result, err = s.db.Exec(s.sql, s.sqlVars...); err != nil {
 		log.Error(err)
 	}
 	return
@@ -40,22 +38,22 @@ func (s *Session) Exec() (result sql.Result, err error) {
 
 // QueryRow gets a record from db
 func (s *Session) QueryRow() *sql.Row {
-	log.Info(s.SQL.String(), s.SQLVars)
-	return s.db.QueryRow(s.SQL.String(), s.SQLVars...)
+	log.Info(s.sql, s.sqlVars)
+	return s.db.QueryRow(s.sql, s.sqlVars...)
 }
 
 // QueryRows gets a list of records from db
 func (s *Session) QueryRows() (rows *sql.Rows, err error) {
-	log.Info(s.SQL.String(), s.SQLVars)
-	if rows, err = s.db.Query(s.SQL.String(), s.SQLVars...); err != nil {
+	log.Info(s.sql, s.sqlVars)
+	if rows, err = s.db.Query(s.sql, s.sqlVars...); err != nil {
 		log.Error(err)
 	}
 	return
 }
 
-// Raw appends SQL and SQLVars
+// Raw appends sql and sqlVars
 func (s *Session) Raw(sql string, values ...interface{}) *Session {
-	s.SQL.WriteString(sql)
-	s.SQLVars = append(s.SQLVars, values...)
+	s.sql += sql
+	s.sqlVars = append(s.sqlVars, values...)
 	return s
 }
diff --git a/gee-orm/day3-save-query/geeorm/session/raw_test.go b/gee-orm/day3-save-query/geeorm/session/raw_test.go
index fd804ee..bfcfb80 100644
--- a/gee-orm/day3-save-query/geeorm/session/raw_test.go
+++ b/gee-orm/day3-save-query/geeorm/session/raw_test.go
@@ -2,7 +2,6 @@ package session
 
 import (
 	"database/sql"
-	"geeorm/log"
 	"os"
 	"testing"
 
@@ -18,7 +17,6 @@ var (
 func setup() {
 	TestDB, _ = sql.Open("sqlite3", "gee.db")
 	TestDial, _ = dialect.GetDialect("sqlite3")
-	log.SetLevel(log.ErrorLevel)
 }
 
 func teardown() {
diff --git a/gee-orm/day3-save-query/geeorm/session/record.go b/gee-orm/day3-save-query/geeorm/session/record.go
index 2b7c7da..3d160bf 100644
--- a/gee-orm/day3-save-query/geeorm/session/record.go
+++ b/gee-orm/day3-save-query/geeorm/session/record.go
@@ -1,7 +1,7 @@
 package session
 
 import (
-	"fmt"
+	"geeorm/clause"
 	"reflect"
 	"strings"
 )
@@ -9,23 +9,20 @@ import (
 // Create one or more records in database
 func (s *Session) Create(values ...interface{}) (int64, error) {
 	var flag bool
-	for i, value := range values {
+	recordValues := make([]interface{}, 0)
+	for _, value := range values {
 		table := s.RefTable(value)
-		filedSQL := strings.Join(table.FieldNames, ", ")
-		bindVarSQL := strings.Join(table.BindVars, ", ")
 		if !flag {
-			s.Raw(fmt.Sprintf("INSERT INTO %s (%v) VALUES ", table.TableName, filedSQL))
 			flag = true
+			fieldSQL := strings.Join(table.FieldNames, ", ")
+			s.clause.Set(clause.INSERT, table.TableName, fieldSQL)
 		}
-		s.Raw(fmt.Sprintf("(%v)", bindVarSQL), table.Values(value)...)
-		if i == len(values)-1 {
-			s.Raw(";")
-		} else {
-			s.Raw(",")
-		}
+		recordValues = append(recordValues, table.Values(value))
 	}
 
-	result, err := s.Exec()
+	s.clause.Set(clause.VALUES, recordValues...)
+	sql, vars := s.clause.Build([]clause.Type{clause.INSERT, clause.VALUES})
+	result, err := s.Raw(sql, vars...).Exec()
 	if err != nil {
 		return 0, err
 	}
@@ -38,8 +35,12 @@ func (s *Session) First(value interface{}) error {
 	table := s.RefTable(value)
 
 	fieldSQL := strings.Join(table.FieldNames, ", ")
-	selectSQL := fmt.Sprintf("SELECT %v FROM %s LIMIT 1", fieldSQL, table.TableName)
-	row := s.Raw(selectSQL).QueryRow()
+
+	s.clause.Set(clause.SELECT, table.TableName, fieldSQL)
+	s.clause.Set(clause.LIMIT, 1)
+
+	sql, vars := s.clause.Build([]clause.Type{clause.SELECT, clause.LIMIT})
+	row := s.Raw(sql, vars...).QueryRow()
 
 	dest := reflect.ValueOf(value).Elem()
 	var values []interface{}
@@ -57,8 +58,9 @@ func (s *Session) Find(values interface{}) error {
 	table := s.RefTable(reflect.New(destType).Elem().Interface())
 
 	fieldSQL := strings.Join(table.FieldNames, ", ")
-	selectSQL := fmt.Sprintf("SELECT %v FROM %s", fieldSQL, table.TableName)
-	rows, err := s.Raw(selectSQL).QueryRows()
+	s.clause.Set(clause.SELECT, table.TableName, fieldSQL)
+	sql, vars := s.clause.Build([]clause.Type{clause.SELECT})
+	rows, err := s.Raw(sql, vars...).QueryRows()
 	if err != nil {
 		return err
 	}

From 01b2b4c4ce035637bd7233d7a93cdbd1593ee595 Mon Sep 17 00:00:00 2001
From: gzdaijie <gzdaijie@163.com>
Date: Wed, 26 Feb 2020 00:08:18 +0800
Subject: [PATCH 043/122] fix Drop table

---
 .../geeorm/session/raw_test.go                | 29 ++++++------------
 .../geeorm/session/raw_test.go                | 30 +++++++------------
 .../geeorm/session/schema.go                  |  7 ++---
 .../geeorm/clause/clause_test.go              |  4 +--
 .../geeorm/clause/generator.go                |  6 ++--
 .../geeorm/session/raw_test.go                | 30 +++++++------------
 .../day3-save-query/geeorm/session/record.go  | 20 +++----------
 .../day3-save-query/geeorm/session/schema.go  |  7 ++---
 8 files changed, 43 insertions(+), 90 deletions(-)

diff --git a/gee-orm/day1-database-sql/geeorm/session/raw_test.go b/gee-orm/day1-database-sql/geeorm/session/raw_test.go
index 9fe7460..1cd7712 100644
--- a/gee-orm/day1-database-sql/geeorm/session/raw_test.go
+++ b/gee-orm/day1-database-sql/geeorm/session/raw_test.go
@@ -2,7 +2,6 @@ package session
 
 import (
 	"database/sql"
-	"geeorm/log"
 	"os"
 	"testing"
 
@@ -11,18 +10,10 @@ import (
 
 var TestDB *sql.DB
 
-func setup() {
-	TestDB, _ = sql.Open("sqlite3", "gee.db")
-	log.SetLevel(log.ErrorLevel)
-}
-
-func teardown() {
-	_ = TestDB.Close()
-}
 func TestMain(m *testing.M) {
-	setup()
+	TestDB, _ = sql.Open("sqlite3", "gee.db")
 	code := m.Run()
-	teardown()
+	_ = TestDB.Close()
 	os.Exit(code)
 }
 
@@ -31,20 +22,18 @@ func NewSession() *Session {
 }
 
 func TestSession_Exec(t *testing.T) {
-	_, _ = NewSession().Raw("DROP TABLE USER;").Exec()
-	_, _ = NewSession().Raw("CREATE TABLE USER(name text);").Exec()
-	result, _ := NewSession().
-		Raw("INSERT INTO USER(`name`) values (?), (?)", "Tom", "Sam").Exec()
+	_, _ = NewSession().Raw("DROP TABLE IF EXISTS User;").Exec()
+	_, _ = NewSession().Raw("CREATE TABLE User(name text);").Exec()
+	result, _ := NewSession().Raw("INSERT INTO User(`name`) values (?), (?)", "Tom", "Sam").Exec()
 	if count, err := result.RowsAffected(); err != nil || count != 2 {
 		t.Fatal("expect 2, but got", count)
 	}
 }
 
-func TestSession_QueryRow(t *testing.T) {
-	_, _ = NewSession().Raw("DROP TABLE USER;").Exec()
-	_, _ = NewSession().Raw("CREATE TABLE USER(name text);").Exec()
-	row := NewSession().Raw("SELECT count(*) FROM USER").QueryRow()
-
+func TestSession_QueryRows(t *testing.T) {
+	_, _ = NewSession().Raw("DROP TABLE IF EXISTS User;").Exec()
+	_, _ = NewSession().Raw("CREATE TABLE User(name text);").Exec()
+	row := NewSession().Raw("SELECT count(*) FROM User").QueryRow()
 	var count int
 	if err := row.Scan(&count); err != nil || count != 0 {
 		t.Fatal("failed to query db", err)
diff --git a/gee-orm/day2-reflect-schema/geeorm/session/raw_test.go b/gee-orm/day2-reflect-schema/geeorm/session/raw_test.go
index bfcfb80..ce1e75b 100644
--- a/gee-orm/day2-reflect-schema/geeorm/session/raw_test.go
+++ b/gee-orm/day2-reflect-schema/geeorm/session/raw_test.go
@@ -6,27 +6,19 @@ import (
 	"testing"
 
 	"geeorm/dialect"
+
 	_ "github.com/mattn/go-sqlite3"
 )
 
 var (
-	TestDB   *sql.DB
-	TestDial dialect.Dialect
-)
-
-func setup() {
-	TestDB, _ = sql.Open("sqlite3", "gee.db")
+	TestDB      *sql.DB
 	TestDial, _ = dialect.GetDialect("sqlite3")
-}
-
-func teardown() {
-	_ = TestDB.Close()
-}
+)
 
 func TestMain(m *testing.M) {
-	setup()
+	TestDB, _ = sql.Open("sqlite3", "gee.db")
 	code := m.Run()
-	teardown()
+	_ = TestDB.Close()
 	os.Exit(code)
 }
 
@@ -35,18 +27,18 @@ func NewSession() *Session {
 }
 
 func TestSession_Exec(t *testing.T) {
-	_, _ = NewSession().Raw("DROP TABLE USER;").Exec()
-	_, _ = NewSession().Raw("CREATE TABLE USER(name text);").Exec()
-	result, _ := NewSession().Raw("INSERT INTO USER(`name`) values (?), (?)", "Tom", "Sam").Exec()
+	_, _ = NewSession().Raw("DROP TABLE IF EXISTS User;").Exec()
+	_, _ = NewSession().Raw("CREATE TABLE User(name text);").Exec()
+	result, _ := NewSession().Raw("INSERT INTO User(`name`) values (?), (?)", "Tom", "Sam").Exec()
 	if count, err := result.RowsAffected(); err != nil || count != 2 {
 		t.Fatal("expect 2, but got", count)
 	}
 }
 
 func TestSession_QueryRows(t *testing.T) {
-	_, _ = NewSession().Raw("DROP TABLE USER;").Exec()
-	_, _ = NewSession().Raw("CREATE TABLE USER(name text);").Exec()
-	row := NewSession().Raw("SELECT count(*) FROM USER").QueryRow()
+	_, _ = NewSession().Raw("DROP TABLE IF EXISTS User;").Exec()
+	_, _ = NewSession().Raw("CREATE TABLE User(name text);").Exec()
+	row := NewSession().Raw("SELECT count(*) FROM User").QueryRow()
 	var count int
 	if err := row.Scan(&count); err != nil || count != 0 {
 		t.Fatal("failed to query db", err)
diff --git a/gee-orm/day2-reflect-schema/geeorm/session/schema.go b/gee-orm/day2-reflect-schema/geeorm/session/schema.go
index 1ef9a80..35c5a68 100644
--- a/gee-orm/day2-reflect-schema/geeorm/session/schema.go
+++ b/gee-orm/day2-reflect-schema/geeorm/session/schema.go
@@ -4,7 +4,6 @@ import (
 	"fmt"
 	"strings"
 
-	"geeorm/log"
 	"geeorm/schema"
 )
 
@@ -38,7 +37,7 @@ func (s *Session) CreateTable(value interface{}) error {
 // DropTable drops a table with the name of model
 func (s *Session) DropTable(value interface{}) error {
 	table := s.RefTable(value)
-	_, err := s.Raw(fmt.Sprintf("DROP TABLE %s", table.TableName)).Exec()
+	_, err := s.Raw(fmt.Sprintf("DROP TABLE IF EXISTS %s", table.TableName)).Exec()
 	return err
 }
 
@@ -52,8 +51,6 @@ func (s *Session) HasTable(value interface{}) bool {
 	sql, values := s.dialect.TableExistSQL(tableName)
 	row := s.Raw(sql, values...).QueryRow()
 	var tmp string
-	if err := row.Scan(&tmp); err != nil {
-		log.Error(err)
-	}
+	_ = row.Scan(&tmp)
 	return tmp == tableName
 }
diff --git a/gee-orm/day3-save-query/geeorm/clause/clause_test.go b/gee-orm/day3-save-query/geeorm/clause/clause_test.go
index 99bb513..0f3db6d 100755
--- a/gee-orm/day3-save-query/geeorm/clause/clause_test.go
+++ b/gee-orm/day3-save-query/geeorm/clause/clause_test.go
@@ -7,7 +7,7 @@ import (
 
 func TestClause_Set(t *testing.T) {
 	var clause Clause
-	clause.Set(INSERT, "User", "Name,Age")
+	clause.Set(INSERT, "User", []string{"Name", "Age"})
 	sql := clause.sql[INSERT]
 	vars := clause.sqlVars[INSERT]
 	t.Log(sql, vars)
@@ -19,7 +19,7 @@ func TestClause_Set(t *testing.T) {
 func TestClause_Build(t *testing.T) {
 	var clause Clause
 	clause.Set(LIMIT, 3)
-	clause.Set(SELECT, "User", "*")
+	clause.Set(SELECT, "User", []string{"*"})
 	orders := []Type{SELECT, LIMIT}
 	sql, vars := clause.Build(orders)
 	t.Log(sql, vars)
diff --git a/gee-orm/day3-save-query/geeorm/clause/generator.go b/gee-orm/day3-save-query/geeorm/clause/generator.go
index 78b4989..78608d6 100755
--- a/gee-orm/day3-save-query/geeorm/clause/generator.go
+++ b/gee-orm/day3-save-query/geeorm/clause/generator.go
@@ -2,7 +2,6 @@ package clause
 
 import (
 	"fmt"
-	"log"
 	"strings"
 )
 
@@ -29,7 +28,7 @@ func genBindVars(num int) string {
 func _insert(values ...interface{}) (string, []interface{}) {
 	// INSERT INTO $tableName ($fields)
 	tableName := values[0]
-	fields := values[1]
+	fields := strings.Join(values[1].([]string), ",")
 	return fmt.Sprintf("INSERT INTO %s (%v)", tableName, fields), []interface{}{}
 }
 
@@ -57,12 +56,11 @@ func _values(values ...interface{}) (string, []interface{}) {
 func _select(values ...interface{}) (string, []interface{}) {
 	// SELECT $fields FROM $tableName
 	tableName := values[0]
-	fields := values[1]
+	fields := strings.Join(values[1].([]string), ",")
 	return fmt.Sprintf("SELECT %v FROM %s", fields, tableName), []interface{}{}
 }
 
 func _limit(values ...interface{}) (string, []interface{}) {
 	// LIMIT $num
-	log.Println(values...)
 	return "LIMIT ?", values
 }
diff --git a/gee-orm/day3-save-query/geeorm/session/raw_test.go b/gee-orm/day3-save-query/geeorm/session/raw_test.go
index bfcfb80..ce1e75b 100644
--- a/gee-orm/day3-save-query/geeorm/session/raw_test.go
+++ b/gee-orm/day3-save-query/geeorm/session/raw_test.go
@@ -6,27 +6,19 @@ import (
 	"testing"
 
 	"geeorm/dialect"
+
 	_ "github.com/mattn/go-sqlite3"
 )
 
 var (
-	TestDB   *sql.DB
-	TestDial dialect.Dialect
-)
-
-func setup() {
-	TestDB, _ = sql.Open("sqlite3", "gee.db")
+	TestDB      *sql.DB
 	TestDial, _ = dialect.GetDialect("sqlite3")
-}
-
-func teardown() {
-	_ = TestDB.Close()
-}
+)
 
 func TestMain(m *testing.M) {
-	setup()
+	TestDB, _ = sql.Open("sqlite3", "gee.db")
 	code := m.Run()
-	teardown()
+	_ = TestDB.Close()
 	os.Exit(code)
 }
 
@@ -35,18 +27,18 @@ func NewSession() *Session {
 }
 
 func TestSession_Exec(t *testing.T) {
-	_, _ = NewSession().Raw("DROP TABLE USER;").Exec()
-	_, _ = NewSession().Raw("CREATE TABLE USER(name text);").Exec()
-	result, _ := NewSession().Raw("INSERT INTO USER(`name`) values (?), (?)", "Tom", "Sam").Exec()
+	_, _ = NewSession().Raw("DROP TABLE IF EXISTS User;").Exec()
+	_, _ = NewSession().Raw("CREATE TABLE User(name text);").Exec()
+	result, _ := NewSession().Raw("INSERT INTO User(`name`) values (?), (?)", "Tom", "Sam").Exec()
 	if count, err := result.RowsAffected(); err != nil || count != 2 {
 		t.Fatal("expect 2, but got", count)
 	}
 }
 
 func TestSession_QueryRows(t *testing.T) {
-	_, _ = NewSession().Raw("DROP TABLE USER;").Exec()
-	_, _ = NewSession().Raw("CREATE TABLE USER(name text);").Exec()
-	row := NewSession().Raw("SELECT count(*) FROM USER").QueryRow()
+	_, _ = NewSession().Raw("DROP TABLE IF EXISTS User;").Exec()
+	_, _ = NewSession().Raw("CREATE TABLE User(name text);").Exec()
+	row := NewSession().Raw("SELECT count(*) FROM User").QueryRow()
 	var count int
 	if err := row.Scan(&count); err != nil || count != 0 {
 		t.Fatal("failed to query db", err)
diff --git a/gee-orm/day3-save-query/geeorm/session/record.go b/gee-orm/day3-save-query/geeorm/session/record.go
index 3d160bf..cf35552 100644
--- a/gee-orm/day3-save-query/geeorm/session/record.go
+++ b/gee-orm/day3-save-query/geeorm/session/record.go
@@ -3,20 +3,14 @@ package session
 import (
 	"geeorm/clause"
 	"reflect"
-	"strings"
 )
 
 // Create one or more records in database
 func (s *Session) Create(values ...interface{}) (int64, error) {
-	var flag bool
 	recordValues := make([]interface{}, 0)
 	for _, value := range values {
 		table := s.RefTable(value)
-		if !flag {
-			flag = true
-			fieldSQL := strings.Join(table.FieldNames, ", ")
-			s.clause.Set(clause.INSERT, table.TableName, fieldSQL)
-		}
+		s.clause.Set(clause.INSERT, table.TableName, table.FieldNames)
 		recordValues = append(recordValues, table.Values(value))
 	}
 
@@ -34,9 +28,7 @@ func (s *Session) Create(values ...interface{}) (int64, error) {
 func (s *Session) First(value interface{}) error {
 	table := s.RefTable(value)
 
-	fieldSQL := strings.Join(table.FieldNames, ", ")
-
-	s.clause.Set(clause.SELECT, table.TableName, fieldSQL)
+	s.clause.Set(clause.SELECT, table.TableName, table.FieldNames)
 	s.clause.Set(clause.LIMIT, 1)
 
 	sql, vars := s.clause.Build([]clause.Type{clause.SELECT, clause.LIMIT})
@@ -57,8 +49,7 @@ func (s *Session) Find(values interface{}) error {
 	destType := destSlice.Type().Elem()
 	table := s.RefTable(reflect.New(destType).Elem().Interface())
 
-	fieldSQL := strings.Join(table.FieldNames, ", ")
-	s.clause.Set(clause.SELECT, table.TableName, fieldSQL)
+	s.clause.Set(clause.SELECT, table.TableName, table.FieldNames)
 	sql, vars := s.clause.Build([]clause.Type{clause.SELECT})
 	rows, err := s.Raw(sql, vars...).QueryRows()
 	if err != nil {
@@ -76,8 +67,5 @@ func (s *Session) Find(values interface{}) error {
 		}
 		destSlice.Set(reflect.Append(destSlice, dest))
 	}
-	if err := rows.Close(); err != nil {
-		return err
-	}
-	return nil
+	return rows.Close()
 }
diff --git a/gee-orm/day3-save-query/geeorm/session/schema.go b/gee-orm/day3-save-query/geeorm/session/schema.go
index c8ea3de..11ff63b 100644
--- a/gee-orm/day3-save-query/geeorm/session/schema.go
+++ b/gee-orm/day3-save-query/geeorm/session/schema.go
@@ -4,7 +4,6 @@ import (
 	"fmt"
 	"strings"
 
-	"geeorm/log"
 	"geeorm/schema"
 )
 
@@ -38,7 +37,7 @@ func (s *Session) CreateTable(value interface{}) error {
 // DropTable drops a table with the name of model
 func (s *Session) DropTable(value interface{}) error {
 	table := s.RefTable(value)
-	_, err := s.Raw(fmt.Sprintf("DROP TABLE %s", table.TableName)).Exec()
+	_, err := s.Raw(fmt.Sprintf("DROP TABLE IF EXISTS %s", table.TableName)).Exec()
 	return err
 }
 
@@ -52,8 +51,6 @@ func (s *Session) HasTable(value interface{}) bool {
 	sql, values := s.dialect.TableExistSQL(tableName)
 	row := s.Raw(sql, values...).QueryRow()
 	var tmp string
-	if err := row.Scan(&tmp); err != nil {
-		log.Error(err)
-	}
+	_ = row.Scan(&tmp)
 	return tmp == tableName
 }

From 80881c5c31caaa4e6e32d50b0f727780608474c9 Mon Sep 17 00:00:00 2001
From: gzdaijie <gzdaijie@163.com>
Date: Wed, 26 Feb 2020 00:47:28 +0800
Subject: [PATCH 044/122] add day4 chain operation

---
 .../day3-save-query/geeorm/clause/clause.go   | 12 +--
 .../geeorm/clause/clause_test.go              |  9 ++-
 .../geeorm/clause/generator.go                | 12 +++
 .../day3-save-query/geeorm/session/record.go  | 23 +-----
 .../geeorm/session/record_test.go             | 31 ++++---
 .../geeorm/clause/clause.go                   | 48 +++++++++++
 .../geeorm/clause/clause_test.go              | 33 ++++++++
 .../geeorm/clause/generator.go                | 78 ++++++++++++++++++
 .../geeorm/dialect/dialect.go                 | 22 +++++
 .../geeorm/dialect/sqlite3.go                 | 45 +++++++++++
 .../geeorm/dialect/sqlite3_test.go            | 25 ++++++
 gee-orm/day4-chain-operation/geeorm/geeorm.go | 51 ++++++++++++
 .../geeorm/geeorm_test.go                     | 20 +++++
 gee-orm/day4-chain-operation/geeorm/go.mod    |  5 ++
 .../day4-chain-operation/geeorm/log/log.go    | 47 +++++++++++
 .../geeorm/log/log_test.go                    | 17 ++++
 .../geeorm/schema/schema.go                   | 67 ++++++++++++++++
 .../geeorm/schema/schema_test.go              | 36 +++++++++
 .../geeorm/session/raw.go                     | 59 ++++++++++++++
 .../geeorm/session/raw_test.go                | 46 +++++++++++
 .../geeorm/session/record.go                  | 80 +++++++++++++++++++
 .../geeorm/session/record_test.go             | 76 ++++++++++++++++++
 .../geeorm/session/schema.go                  | 56 +++++++++++++
 .../geeorm/session/schema_test.go             | 18 +++++
 24 files changed, 870 insertions(+), 46 deletions(-)
 create mode 100755 gee-orm/day4-chain-operation/geeorm/clause/clause.go
 create mode 100755 gee-orm/day4-chain-operation/geeorm/clause/clause_test.go
 create mode 100755 gee-orm/day4-chain-operation/geeorm/clause/generator.go
 create mode 100644 gee-orm/day4-chain-operation/geeorm/dialect/dialect.go
 create mode 100644 gee-orm/day4-chain-operation/geeorm/dialect/sqlite3.go
 create mode 100644 gee-orm/day4-chain-operation/geeorm/dialect/sqlite3_test.go
 create mode 100644 gee-orm/day4-chain-operation/geeorm/geeorm.go
 create mode 100644 gee-orm/day4-chain-operation/geeorm/geeorm_test.go
 create mode 100644 gee-orm/day4-chain-operation/geeorm/go.mod
 create mode 100644 gee-orm/day4-chain-operation/geeorm/log/log.go
 create mode 100644 gee-orm/day4-chain-operation/geeorm/log/log_test.go
 create mode 100644 gee-orm/day4-chain-operation/geeorm/schema/schema.go
 create mode 100644 gee-orm/day4-chain-operation/geeorm/schema/schema_test.go
 create mode 100644 gee-orm/day4-chain-operation/geeorm/session/raw.go
 create mode 100644 gee-orm/day4-chain-operation/geeorm/session/raw_test.go
 create mode 100644 gee-orm/day4-chain-operation/geeorm/session/record.go
 create mode 100644 gee-orm/day4-chain-operation/geeorm/session/record_test.go
 create mode 100644 gee-orm/day4-chain-operation/geeorm/session/schema.go
 create mode 100644 gee-orm/day4-chain-operation/geeorm/session/schema_test.go

diff --git a/gee-orm/day3-save-query/geeorm/clause/clause.go b/gee-orm/day3-save-query/geeorm/clause/clause.go
index 8ee7b16..77d88bc 100755
--- a/gee-orm/day3-save-query/geeorm/clause/clause.go
+++ b/gee-orm/day3-save-query/geeorm/clause/clause.go
@@ -15,10 +15,12 @@ type Type int
 
 // Support types for Clause
 const (
-	INSERT Type = 0
-	VALUES Type = 1
-	SELECT Type = 2
-	LIMIT  Type = 3
+	INSERT  Type = 0
+	VALUES  Type = 1
+	SELECT  Type = 2
+	LIMIT   Type = 3
+	WHERE   Type = 4
+	ORDERBY Type = 5
 )
 
 // Set adds a sub clause of specific type
@@ -33,7 +35,7 @@ func (c *Clause) Set(name Type, vars ...interface{}) {
 }
 
 // Build generate the final SQL and SQLVars
-func (c *Clause) Build(orders []Type) (string, []interface{}) {
+func (c *Clause) Build(orders ...Type) (string, []interface{}) {
 	var sqls []string
 	var vars []interface{}
 	for _, order := range orders {
diff --git a/gee-orm/day3-save-query/geeorm/clause/clause_test.go b/gee-orm/day3-save-query/geeorm/clause/clause_test.go
index 0f3db6d..3062bbd 100755
--- a/gee-orm/day3-save-query/geeorm/clause/clause_test.go
+++ b/gee-orm/day3-save-query/geeorm/clause/clause_test.go
@@ -20,13 +20,14 @@ func TestClause_Build(t *testing.T) {
 	var clause Clause
 	clause.Set(LIMIT, 3)
 	clause.Set(SELECT, "User", []string{"*"})
-	orders := []Type{SELECT, LIMIT}
-	sql, vars := clause.Build(orders)
+	clause.Set(WHERE, "Name = ?", 18)
+	clause.Set(ORDERBY, "Age ASC")
+	sql, vars := clause.Build(SELECT, WHERE, ORDERBY, LIMIT)
 	t.Log(sql, vars)
-	if sql != "SELECT * FROM User LIMIT ?" {
+	if sql != "SELECT * FROM User WHERE Name = ? ORDER BY Age ASC LIMIT ?" {
 		t.Fatal("failed to build SQL")
 	}
-	if !reflect.DeepEqual(vars, []interface{}{3}) {
+	if !reflect.DeepEqual(vars, []interface{}{18, 3}) {
 		t.Fatal("failed to build SQLVars")
 	}
 }
diff --git a/gee-orm/day3-save-query/geeorm/clause/generator.go b/gee-orm/day3-save-query/geeorm/clause/generator.go
index 78608d6..0ac29ee 100755
--- a/gee-orm/day3-save-query/geeorm/clause/generator.go
+++ b/gee-orm/day3-save-query/geeorm/clause/generator.go
@@ -15,6 +15,8 @@ func init() {
 	generators[VALUES] = _values
 	generators[SELECT] = _select
 	generators[LIMIT] = _limit
+	generators[WHERE] = _where
+	generators[ORDERBY] = _orderby
 }
 
 func genBindVars(num int) string {
@@ -64,3 +66,13 @@ func _limit(values ...interface{}) (string, []interface{}) {
 	// LIMIT $num
 	return "LIMIT ?", values
 }
+
+func _where(values ...interface{}) (string, []interface{}) {
+	// WHERE $desc
+	desc, vars := values[0], values[1:]
+	return fmt.Sprintf("WHERE %s", desc), vars
+}
+
+func _orderby(values ...interface{}) (string, []interface{}) {
+	return fmt.Sprintf("ORDER BY %s", values[0]), []interface{}{}
+}
diff --git a/gee-orm/day3-save-query/geeorm/session/record.go b/gee-orm/day3-save-query/geeorm/session/record.go
index cf35552..1a0672a 100644
--- a/gee-orm/day3-save-query/geeorm/session/record.go
+++ b/gee-orm/day3-save-query/geeorm/session/record.go
@@ -15,7 +15,7 @@ func (s *Session) Create(values ...interface{}) (int64, error) {
 	}
 
 	s.clause.Set(clause.VALUES, recordValues...)
-	sql, vars := s.clause.Build([]clause.Type{clause.INSERT, clause.VALUES})
+	sql, vars := s.clause.Build(clause.INSERT, clause.VALUES)
 	result, err := s.Raw(sql, vars...).Exec()
 	if err != nil {
 		return 0, err
@@ -24,25 +24,6 @@ func (s *Session) Create(values ...interface{}) (int64, error) {
 	return result.RowsAffected()
 }
 
-// First gets the 1st row
-func (s *Session) First(value interface{}) error {
-	table := s.RefTable(value)
-
-	s.clause.Set(clause.SELECT, table.TableName, table.FieldNames)
-	s.clause.Set(clause.LIMIT, 1)
-
-	sql, vars := s.clause.Build([]clause.Type{clause.SELECT, clause.LIMIT})
-	row := s.Raw(sql, vars...).QueryRow()
-
-	dest := reflect.ValueOf(value).Elem()
-	var values []interface{}
-	for _, name := range table.FieldNames {
-		values = append(values, dest.FieldByName(name).Addr().Interface())
-	}
-
-	return row.Scan(values...)
-}
-
 // Find gets all eligible records
 func (s *Session) Find(values interface{}) error {
 	destSlice := reflect.Indirect(reflect.ValueOf(values))
@@ -50,7 +31,7 @@ func (s *Session) Find(values interface{}) error {
 	table := s.RefTable(reflect.New(destType).Elem().Interface())
 
 	s.clause.Set(clause.SELECT, table.TableName, table.FieldNames)
-	sql, vars := s.clause.Build([]clause.Type{clause.SELECT})
+	sql, vars := s.clause.Build(clause.SELECT, clause.WHERE, clause.ORDERBY, clause.LIMIT)
 	rows, err := s.Raw(sql, vars...).QueryRows()
 	if err != nil {
 		return err
diff --git a/gee-orm/day3-save-query/geeorm/session/record_test.go b/gee-orm/day3-save-query/geeorm/session/record_test.go
index f57680e..27b6d77 100644
--- a/gee-orm/day3-save-query/geeorm/session/record_test.go
+++ b/gee-orm/day3-save-query/geeorm/session/record_test.go
@@ -5,31 +5,30 @@ import "testing"
 var (
 	user1 = &User{"Tom", 18}
 	user2 = &User{"Sam", 25}
+	user3 = &User{"Jack", 25}
 )
 
-func TestSession_Create(t *testing.T) {
-	_ = NewSession().DropTable(&User{})
-	_ = NewSession().CreateTable(&User{})
-	if affected, err := NewSession().Create(user1, user2); err != nil || affected != 2 {
-		t.Fatal("failed to create record")
+func testRecordInit(t *testing.T) {
+	t.Helper()
+	err1 := NewSession().DropTable(&User{})
+	err2 := NewSession().CreateTable(&User{})
+	_, err3 := NewSession().Create(user1, user2)
+	if err1 != nil || err2 != nil || err3 != nil {
+		t.Fatal("failed init test records")
 	}
+
 }
 
-func TestSession_First(t *testing.T) {
-	_ = NewSession().DropTable(&User{})
-	_ = NewSession().CreateTable(&User{})
-	_, _ = NewSession().Create(user1)
-	u := &User{}
-	err := NewSession().First(u)
-	if err != nil || u.Age != user1.Age || u.Name != user1.Name {
-		t.Fatal("failed to query first")
+func TestSession_Create(t *testing.T) {
+	testRecordInit(t)
+	affected, err := NewSession().Create(user3)
+	if err != nil || affected != 1 {
+		t.Fatal("failed to create record")
 	}
 }
 
 func TestSession_Find(t *testing.T) {
-	_ = NewSession().DropTable(&User{})
-	_ = NewSession().CreateTable(&User{})
-	_, _ = NewSession().Create(user1, user2)
+	testRecordInit(t)
 	users := []User{}
 	if err := NewSession().Find(&users); err != nil || len(users) != 2 {
 		t.Fatal("failed to query all")
diff --git a/gee-orm/day4-chain-operation/geeorm/clause/clause.go b/gee-orm/day4-chain-operation/geeorm/clause/clause.go
new file mode 100755
index 0000000..77d88bc
--- /dev/null
+++ b/gee-orm/day4-chain-operation/geeorm/clause/clause.go
@@ -0,0 +1,48 @@
+package clause
+
+import (
+	"strings"
+)
+
+// Clause contains SQL conditions
+type Clause struct {
+	sql     map[Type]string
+	sqlVars map[Type][]interface{}
+}
+
+// Type is the type of Clause
+type Type int
+
+// Support types for Clause
+const (
+	INSERT  Type = 0
+	VALUES  Type = 1
+	SELECT  Type = 2
+	LIMIT   Type = 3
+	WHERE   Type = 4
+	ORDERBY Type = 5
+)
+
+// Set adds a sub clause of specific type
+func (c *Clause) Set(name Type, vars ...interface{}) {
+	if c.sql == nil {
+		c.sql = make(map[Type]string)
+		c.sqlVars = make(map[Type][]interface{})
+	}
+	sql, vars := generators[name](vars...)
+	c.sql[name] = sql
+	c.sqlVars[name] = vars
+}
+
+// Build generate the final SQL and SQLVars
+func (c *Clause) Build(orders ...Type) (string, []interface{}) {
+	var sqls []string
+	var vars []interface{}
+	for _, order := range orders {
+		if sql, ok := c.sql[order]; ok {
+			sqls = append(sqls, sql)
+			vars = append(vars, c.sqlVars[order]...)
+		}
+	}
+	return strings.Join(sqls, " "), vars
+}
diff --git a/gee-orm/day4-chain-operation/geeorm/clause/clause_test.go b/gee-orm/day4-chain-operation/geeorm/clause/clause_test.go
new file mode 100755
index 0000000..3062bbd
--- /dev/null
+++ b/gee-orm/day4-chain-operation/geeorm/clause/clause_test.go
@@ -0,0 +1,33 @@
+package clause
+
+import (
+	"reflect"
+	"testing"
+)
+
+func TestClause_Set(t *testing.T) {
+	var clause Clause
+	clause.Set(INSERT, "User", []string{"Name", "Age"})
+	sql := clause.sql[INSERT]
+	vars := clause.sqlVars[INSERT]
+	t.Log(sql, vars)
+	if sql != "INSERT INTO User (Name,Age)" || len(vars) != 0 {
+		t.Fatal("failed to get clause")
+	}
+}
+
+func TestClause_Build(t *testing.T) {
+	var clause Clause
+	clause.Set(LIMIT, 3)
+	clause.Set(SELECT, "User", []string{"*"})
+	clause.Set(WHERE, "Name = ?", 18)
+	clause.Set(ORDERBY, "Age ASC")
+	sql, vars := clause.Build(SELECT, WHERE, ORDERBY, LIMIT)
+	t.Log(sql, vars)
+	if sql != "SELECT * FROM User WHERE Name = ? ORDER BY Age ASC LIMIT ?" {
+		t.Fatal("failed to build SQL")
+	}
+	if !reflect.DeepEqual(vars, []interface{}{18, 3}) {
+		t.Fatal("failed to build SQLVars")
+	}
+}
diff --git a/gee-orm/day4-chain-operation/geeorm/clause/generator.go b/gee-orm/day4-chain-operation/geeorm/clause/generator.go
new file mode 100755
index 0000000..0ac29ee
--- /dev/null
+++ b/gee-orm/day4-chain-operation/geeorm/clause/generator.go
@@ -0,0 +1,78 @@
+package clause
+
+import (
+	"fmt"
+	"strings"
+)
+
+type generator func(values ...interface{}) (string, []interface{})
+
+var generators map[Type]generator
+
+func init() {
+	generators = make(map[Type]generator)
+	generators[INSERT] = _insert
+	generators[VALUES] = _values
+	generators[SELECT] = _select
+	generators[LIMIT] = _limit
+	generators[WHERE] = _where
+	generators[ORDERBY] = _orderby
+}
+
+func genBindVars(num int) string {
+	var vars []string
+	for i := 0; i < num; i++ {
+		vars = append(vars, "?")
+	}
+	return strings.Join(vars, ", ")
+}
+
+func _insert(values ...interface{}) (string, []interface{}) {
+	// INSERT INTO $tableName ($fields)
+	tableName := values[0]
+	fields := strings.Join(values[1].([]string), ",")
+	return fmt.Sprintf("INSERT INTO %s (%v)", tableName, fields), []interface{}{}
+}
+
+func _values(values ...interface{}) (string, []interface{}) {
+	// VALUES ($v1), (&v2), ...
+	var bindStr string
+	var sql strings.Builder
+	var vars []interface{}
+	sql.WriteString("VALUES ")
+	for i, value := range values {
+		v := value.([]interface{})
+		if bindStr == "" {
+			bindStr = genBindVars(len(v))
+		}
+		sql.WriteString(fmt.Sprintf("(%v)", bindStr))
+		if i+1 != len(values) {
+			sql.WriteString(", ")
+		}
+		vars = append(vars, v...)
+	}
+	return sql.String(), vars
+
+}
+
+func _select(values ...interface{}) (string, []interface{}) {
+	// SELECT $fields FROM $tableName
+	tableName := values[0]
+	fields := strings.Join(values[1].([]string), ",")
+	return fmt.Sprintf("SELECT %v FROM %s", fields, tableName), []interface{}{}
+}
+
+func _limit(values ...interface{}) (string, []interface{}) {
+	// LIMIT $num
+	return "LIMIT ?", values
+}
+
+func _where(values ...interface{}) (string, []interface{}) {
+	// WHERE $desc
+	desc, vars := values[0], values[1:]
+	return fmt.Sprintf("WHERE %s", desc), vars
+}
+
+func _orderby(values ...interface{}) (string, []interface{}) {
+	return fmt.Sprintf("ORDER BY %s", values[0]), []interface{}{}
+}
diff --git a/gee-orm/day4-chain-operation/geeorm/dialect/dialect.go b/gee-orm/day4-chain-operation/geeorm/dialect/dialect.go
new file mode 100644
index 0000000..4696314
--- /dev/null
+++ b/gee-orm/day4-chain-operation/geeorm/dialect/dialect.go
@@ -0,0 +1,22 @@
+package dialect
+
+import "reflect"
+
+var dialectsMap = map[string]Dialect{}
+
+// Dialect is an interface contains methods that a dialect has to implement
+type Dialect interface {
+	DataTypeOf(typ reflect.Value) string
+	TableExistSQL(tableName string) (string, []interface{})
+}
+
+// RegisterDialect register a dialect to the global variable
+func RegisterDialect(name string, dialect Dialect) {
+	dialectsMap[name] = dialect
+}
+
+// Get the dialect from global variable if it exists
+func GetDialect(name string) (dialect Dialect, ok bool) {
+	dialect, ok = dialectsMap[name]
+	return
+}
diff --git a/gee-orm/day4-chain-operation/geeorm/dialect/sqlite3.go b/gee-orm/day4-chain-operation/geeorm/dialect/sqlite3.go
new file mode 100644
index 0000000..f3c3897
--- /dev/null
+++ b/gee-orm/day4-chain-operation/geeorm/dialect/sqlite3.go
@@ -0,0 +1,45 @@
+package dialect
+
+import (
+	"fmt"
+	"reflect"
+	"time"
+)
+
+type sqlite3 struct{}
+
+var _ Dialect = (*sqlite3)(nil)
+
+func init() {
+	RegisterDialect("sqlite3", &sqlite3{})
+}
+
+// Get Data Type for sqlite3 Dialect
+func (s *sqlite3) DataTypeOf(typ reflect.Value) string {
+	switch typ.Kind() {
+	case reflect.Bool:
+		return "bool"
+	case reflect.Int, reflect.Int8, reflect.Int16, reflect.Int32,
+		reflect.Uint, reflect.Uint8, reflect.Uint16, reflect.Uint32, reflect.Uintptr:
+		return "integer"
+	case reflect.Int64, reflect.Uint64:
+		return "bigint"
+	case reflect.Float32, reflect.Float64:
+		return "real"
+	case reflect.String:
+		return "text"
+	case reflect.Array, reflect.Slice:
+		return "blob"
+	case reflect.Struct:
+		if _, ok := typ.Interface().(time.Time); ok {
+			return "datetime"
+		}
+	}
+	panic(fmt.Sprintf("invalid sql type %s (%s)", typ.Type().Name(), typ.Kind()))
+}
+
+// TableExistSQL returns SQL that judge whether the table exists in database
+func (s *sqlite3) TableExistSQL(tableName string) (string, []interface{}) {
+	args := []interface{}{tableName}
+	return "SELECT name FROM sqlite_master WHERE type='table' and name = ?", args
+}
diff --git a/gee-orm/day4-chain-operation/geeorm/dialect/sqlite3_test.go b/gee-orm/day4-chain-operation/geeorm/dialect/sqlite3_test.go
new file mode 100644
index 0000000..3df5f07
--- /dev/null
+++ b/gee-orm/day4-chain-operation/geeorm/dialect/sqlite3_test.go
@@ -0,0 +1,25 @@
+package dialect
+
+import (
+	"reflect"
+	"testing"
+)
+
+func TestDataTypeOf(t *testing.T) {
+	dial := &sqlite3{}
+	cases := []struct {
+		Value interface{}
+		Type  string
+	}{
+		{"Tom", "text"},
+		{123, "integer"},
+		{1.2, "real"},
+		{[]int{1, 2, 3}, "blob"},
+	}
+
+	for _, c := range cases {
+		if typ := dial.DataTypeOf(reflect.ValueOf(c.Value)); typ != c.Type {
+			t.Fatalf("expect %s, but got %s", c.Type, typ)
+		}
+	}
+}
diff --git a/gee-orm/day4-chain-operation/geeorm/geeorm.go b/gee-orm/day4-chain-operation/geeorm/geeorm.go
new file mode 100644
index 0000000..61ee9e0
--- /dev/null
+++ b/gee-orm/day4-chain-operation/geeorm/geeorm.go
@@ -0,0 +1,51 @@
+package geeorm
+
+import (
+	"database/sql"
+	"geeorm/dialect"
+	"geeorm/log"
+	"geeorm/session"
+)
+
+// Engine is the main struct of geeorm, manages all db sessions and transactions.
+type Engine struct {
+	db      *sql.DB
+	dialect dialect.Dialect
+}
+
+// NewEngine create a instance of Engine
+// connect database and ping it to test whether it's alive
+func NewEngine(driver, source string) (e *Engine, err error) {
+	db, err := sql.Open(driver, source)
+	if err != nil {
+		log.Error(err)
+		return
+	}
+	// Send a ping to make sure the database connection is alive.
+	if err = db.Ping(); err != nil {
+		log.Error(err)
+		return
+	}
+	// make sure the specific dialect exists
+	dial, ok := dialect.GetDialect(driver)
+	if !ok {
+		log.Errorf("dialect %s Not Found", driver)
+		return
+	}
+	e = &Engine{db: db, dialect: dial}
+	log.Info("Connect database success")
+	return
+}
+
+// Close database connection
+func (e *Engine) Close() (err error) {
+	if err = e.db.Close(); err == nil {
+		log.Info("Close database success")
+	}
+	return
+}
+
+// NewSession creates a new session for next operations
+func (e *Engine) NewSession() *session.Session {
+	return session.New(e.db, e.dialect)
+}
diff --git a/gee-orm/day4-chain-operation/geeorm/geeorm_test.go b/gee-orm/day4-chain-operation/geeorm/geeorm_test.go
new file mode 100644
index 0000000..35628be
--- /dev/null
+++ b/gee-orm/day4-chain-operation/geeorm/geeorm_test.go
@@ -0,0 +1,20 @@
+package geeorm
+
+import (
+	_ "github.com/mattn/go-sqlite3"
+	"testing"
+)
+
+func OpenDB(t *testing.T) *Engine {
+	t.Helper()
+	engine, err := NewEngine("sqlite3", "gee.db")
+	if err != nil {
+		t.Fatal("failed to connect", err)
+	}
+	return engine
+}
+
+func TestNewEngine(t *testing.T) {
+	engine := OpenDB(t)
+	_ = engine.Close()
+}
diff --git a/gee-orm/day4-chain-operation/geeorm/go.mod b/gee-orm/day4-chain-operation/geeorm/go.mod
new file mode 100644
index 0000000..043b1c6
--- /dev/null
+++ b/gee-orm/day4-chain-operation/geeorm/go.mod
@@ -0,0 +1,5 @@
+module geeorm
+
+go 1.13
+
+require github.com/mattn/go-sqlite3 v2.0.3+incompatible
diff --git a/gee-orm/day4-chain-operation/geeorm/log/log.go b/gee-orm/day4-chain-operation/geeorm/log/log.go
new file mode 100644
index 0000000..684a718
--- /dev/null
+++ b/gee-orm/day4-chain-operation/geeorm/log/log.go
@@ -0,0 +1,47 @@
+package log
+
+import (
+	"io/ioutil"
+	"log"
+	"os"
+	"sync"
+)
+
+var (
+	errorLog = log.New(os.Stdout, "\033[31m[error]\033[0m ", log.LstdFlags|log.Lshortfile)
+	infoLog  = log.New(os.Stdout, "\033[34m[info ]\033[0m ", log.LstdFlags|log.Lshortfile)
+	loggers  = []*log.Logger{errorLog, infoLog}
+	mu       sync.Mutex
+)
+
+// log methods
+var (
+	Error  = errorLog.Println
+	Errorf = errorLog.Printf
+	Info   = infoLog.Println
+	Infof  = infoLog.Printf
+)
+
+// log levels
+const (
+	InfoLevel  = 0
+	ErrorLevel = 1
+	Disabled   = 9999
+)
+
+// SetLevel controls log level
+func SetLevel(level int) {
+	mu.Lock()
+	defer mu.Unlock()
+
+	for _, logger := range loggers {
+		logger.SetOutput(os.Stdout)
+	}
+
+	if ErrorLevel < level {
+		errorLog.SetOutput(ioutil.Discard)
+	}
+	if InfoLevel < level {
+		infoLog.SetOutput(ioutil.Discard)
+	}
+}
diff --git a/gee-orm/day4-chain-operation/geeorm/log/log_test.go b/gee-orm/day4-chain-operation/geeorm/log/log_test.go
new file mode 100644
index 0000000..8cd403c
--- /dev/null
+++ b/gee-orm/day4-chain-operation/geeorm/log/log_test.go
@@ -0,0 +1,17 @@
+package log
+
+import (
+	"os"
+	"testing"
+)
+
+func TestSetLevel(t *testing.T) {
+	SetLevel(ErrorLevel)
+	if infoLog.Writer() == os.Stdout || errorLog.Writer() != os.Stdout {
+		t.Fatal("failed to set log level")
+	}
+	SetLevel(Disabled)
+	if infoLog.Writer() == os.Stdout || errorLog.Writer() == os.Stdout {
+		t.Fatal("failed to set log level")
+	}
+}
\ No newline at end of file
diff --git a/gee-orm/day4-chain-operation/geeorm/schema/schema.go b/gee-orm/day4-chain-operation/geeorm/schema/schema.go
new file mode 100644
index 0000000..8519fd4
--- /dev/null
+++ b/gee-orm/day4-chain-operation/geeorm/schema/schema.go
@@ -0,0 +1,67 @@
+package schema
+
+import (
+	"fmt"
+	"geeorm/dialect"
+	"go/ast"
+	"reflect"
+)
+
+// Field represents a column of database
+type Field struct {
+	Name string
+	Tag  string
+}
+
+// Schema represents a table of database
+type Schema struct {
+	TableName    string
+	PrimaryField *Field
+	Fields       []*Field
+	FieldNames   []string
+}
+
+// Values return the values of dest's member variables
+func (schema *Schema) Values(dest interface{}) []interface{} {
+	destValue := reflect.Indirect(reflect.ValueOf(dest))
+	var fieldValues []interface{}
+	for _, field := range schema.Fields {
+		fieldValues = append(fieldValues, destValue.FieldByName(field.Name).Interface())
+	}
+	return fieldValues
+}
+
+// Parse a struct to a Schema instance
+func Parse(dest interface{}, d dialect.Dialect) *Schema {
+	modelType := reflect.Indirect(reflect.ValueOf(dest)).Type()
+	schema := &Schema{
+		TableName:    modelType.Name(),
+		PrimaryField: &Field{Name: "ID", Tag: ""},
+	}
+
+	for i := 0; i < modelType.NumField(); i++ {
+		p := modelType.Field(i)
+		if !p.Anonymous && ast.IsExported(p.Name) {
+			field := &Field{
+				Name: p.Name,
+				Tag:  d.DataTypeOf(reflect.Indirect(reflect.New(p.Type))),
+			}
+			if v, ok := p.Tag.Lookup("geeorm"); ok && v == "primary_key" {
+				schema.PrimaryField = field
+			}
+			schema.Fields = append(schema.Fields, field)
+			schema.FieldNames = append(schema.FieldNames, p.Name)
+		}
+	}
+	return schema
+}
+
+// String returns readable string
+func (field *Field) String() string {
+	return fmt.Sprintf("(%s %s)", field.Name, field.Tag)
+}
+
+// String returns readable string
+func (schema *Schema) String() string {
+	return fmt.Sprintf("TABLE %s %v", schema.TableName, schema.Fields)
+}
diff --git a/gee-orm/day4-chain-operation/geeorm/schema/schema_test.go b/gee-orm/day4-chain-operation/geeorm/schema/schema_test.go
new file mode 100644
index 0000000..aba3e0b
--- /dev/null
+++ b/gee-orm/day4-chain-operation/geeorm/schema/schema_test.go
@@ -0,0 +1,36 @@
+package schema
+
+import (
+	"geeorm/dialect"
+	"testing"
+)
+
+type User struct {
+	Name string `geeorm:"primary_key"`
+	Age  int
+}
+
+var TestDial, _ = dialect.GetDialect("sqlite3")
+
+func TestParse(t *testing.T) {
+	schema := Parse(&User{}, TestDial)
+	if schema.TableName != "User" || len(schema.Fields) != 2 {
+		t.Fatal("failed to parse User struct")
+	}
+	if schema.PrimaryField.Name != "Name" {
+		t.Fatal("failed to parse primary key")
+	}
+	t.Log(schema)
+}
+
+func TestSchema_Values(t *testing.T) {
+	schema := Parse(&User{}, TestDial)
+	values := schema.Values(&User{"Tom", 18})
+
+	name := values[0].(string)
+	age := values[1].(int)
+
+	if name != "Tom" || age != 18 {
+		t.Fatal("failed to get values")
+	}
+}
diff --git a/gee-orm/day4-chain-operation/geeorm/session/raw.go b/gee-orm/day4-chain-operation/geeorm/session/raw.go
new file mode 100644
index 0000000..6cb72c9
--- /dev/null
+++ b/gee-orm/day4-chain-operation/geeorm/session/raw.go
@@ -0,0 +1,59 @@
+package session
+
+import (
+	"database/sql"
+	"geeorm/clause"
+	"geeorm/dialect"
+	"geeorm/log"
+	"geeorm/schema"
+)
+
+// Session keep a pointer to sql.DB and provides all execution of all
+// kind of database operations.
+type Session struct {
+	db       *sql.DB
+	dialect  dialect.Dialect
+	refTable *schema.Schema
+	clause   clause.Clause
+	sql      string
+	sqlVars  []interface{}
+}
+
+// New creates a instance of Session
+func New(db *sql.DB, dialect dialect.Dialect) *Session {
+	return &Session{
+		db:      db,
+		dialect: dialect,
+	}
+}
+
+// Exec raw sql with sqlVars
+func (s *Session) Exec() (result sql.Result, err error) {
+	log.Info(s.sql, s.sqlVars)
+	if result, err = s.db.Exec(s.sql, s.sqlVars...); err != nil {
+		log.Error(err)
+	}
+	return
+}
+
+// QueryRow gets a record from db
+func (s *Session) QueryRow() *sql.Row {
+	log.Info(s.sql, s.sqlVars)
+	return s.db.QueryRow(s.sql, s.sqlVars...)
+}
+
+// QueryRows gets a list of records from db
+func (s *Session) QueryRows() (rows *sql.Rows, err error) {
+	log.Info(s.sql, s.sqlVars)
+	if rows, err = s.db.Query(s.sql, s.sqlVars...); err != nil {
+		log.Error(err)
+	}
+	return
+}
+
+// Raw appends sql and sqlVars
+func (s *Session) Raw(sql string, values ...interface{}) *Session {
+	s.sql += sql
+	s.sqlVars = append(s.sqlVars, values...)
+	return s
+}
diff --git a/gee-orm/day4-chain-operation/geeorm/session/raw_test.go b/gee-orm/day4-chain-operation/geeorm/session/raw_test.go
new file mode 100644
index 0000000..ce1e75b
--- /dev/null
+++ b/gee-orm/day4-chain-operation/geeorm/session/raw_test.go
@@ -0,0 +1,46 @@
+package session
+
+import (
+	"database/sql"
+	"os"
+	"testing"
+
+	"geeorm/dialect"
+
+	_ "github.com/mattn/go-sqlite3"
+)
+
+var (
+	TestDB      *sql.DB
+	TestDial, _ = dialect.GetDialect("sqlite3")
+)
+
+func TestMain(m *testing.M) {
+	TestDB, _ = sql.Open("sqlite3", "gee.db")
+	code := m.Run()
+	_ = TestDB.Close()
+	os.Exit(code)
+}
+
+func NewSession() *Session {
+	return &Session{db: TestDB, dialect: TestDial}
+}
+
+func TestSession_Exec(t *testing.T) {
+	_, _ = NewSession().Raw("DROP TABLE IF EXISTS User;").Exec()
+	_, _ = NewSession().Raw("CREATE TABLE User(name text);").Exec()
+	result, _ := NewSession().Raw("INSERT INTO User(`name`) values (?), (?)", "Tom", "Sam").Exec()
+	if count, err := result.RowsAffected(); err != nil || count != 2 {
+		t.Fatal("expect 2, but got", count)
+	}
+}
+
+func TestSession_QueryRows(t *testing.T) {
+	_, _ = NewSession().Raw("DROP TABLE IF EXISTS User;").Exec()
+	_, _ = NewSession().Raw("CREATE TABLE User(name text);").Exec()
+	row := NewSession().Raw("SELECT count(*) FROM User").QueryRow()
+	var count int
+	if err := row.Scan(&count); err != nil || count != 0 {
+		t.Fatal("failed to query db", err)
+	}
+}
diff --git a/gee-orm/day4-chain-operation/geeorm/session/record.go b/gee-orm/day4-chain-operation/geeorm/session/record.go
new file mode 100644
index 0000000..c9902d0
--- /dev/null
+++ b/gee-orm/day4-chain-operation/geeorm/session/record.go
@@ -0,0 +1,80 @@
+package session
+
+import (
+	"geeorm/clause"
+	"reflect"
+)
+
+// Create one or more records in database
+func (s *Session) Create(values ...interface{}) (int64, error) {
+	recordValues := make([]interface{}, 0)
+	for _, value := range values {
+		table := s.RefTable(value)
+		s.clause.Set(clause.INSERT, table.TableName, table.FieldNames)
+		recordValues = append(recordValues, table.Values(value))
+	}
+
+	s.clause.Set(clause.VALUES, recordValues...)
+	sql, vars := s.clause.Build(clause.INSERT, clause.VALUES)
+	result, err := s.Raw(sql, vars...).Exec()
+	if err != nil {
+		return 0, err
+	}
+
+	return result.RowsAffected()
+}
+
+// Find gets all eligible records
+func (s *Session) Find(values interface{}) error {
+	destSlice := reflect.Indirect(reflect.ValueOf(values))
+	destType := destSlice.Type().Elem()
+	table := s.RefTable(reflect.New(destType).Elem().Interface())
+
+	s.clause.Set(clause.SELECT, table.TableName, table.FieldNames)
+	sql, vars := s.clause.Build(clause.SELECT, clause.WHERE, clause.ORDERBY, clause.LIMIT)
+	rows, err := s.Raw(sql, vars...).QueryRows()
+	if err != nil {
+		return err
+	}
+
+	for rows.Next() {
+		dest := reflect.New(destType).Elem()
+		var values []interface{}
+		for _, name := range table.FieldNames {
+			values = append(values, dest.FieldByName(name).Addr().Interface())
+		}
+		if err := rows.Scan(values...); err != nil {
+			return err
+		}
+		destSlice.Set(reflect.Append(destSlice, dest))
+	}
+	return rows.Close()
+}
+
+// First gets the 1st row
+func (s *Session) First(value interface{}) error {
+	dest := reflect.Indirect(reflect.ValueOf(value))
+	destSlice := reflect.New(reflect.SliceOf(dest.Type())).Elem()
+	err := s.Limit(1).Find(destSlice.Addr().Interface())
+	dest.Set(destSlice.Index(0))
+	return err
+}
+
+// Limit adds limit condition to clause
+func (s *Session) Limit(num int) *Session {
+	s.clause.Set(clause.LIMIT, num)
+	return s
+}
+
+// Where adds limit condition to clause
+func (s *Session) Where(desc string, args ...interface{}) *Session {
+	var vars []interface{}
+	s.clause.Set(clause.WHERE, append(append(vars, desc), args...)...)
+	return s
+}
+
+// OrderBy adds order by condition to clause
+func (s *Session) OrderBy(desc string) *Session {
+	s.clause.Set(clause.ORDERBY, desc)
+	return s
+}
diff --git a/gee-orm/day4-chain-operation/geeorm/session/record_test.go b/gee-orm/day4-chain-operation/geeorm/session/record_test.go
new file mode 100644
index 0000000..5879cfb
--- /dev/null
+++ b/gee-orm/day4-chain-operation/geeorm/session/record_test.go
@@ -0,0 +1,76 @@
+package session
+
+import "testing"
+
+var (
+	user1 = &User{"Tom", 18}
+	user2 = &User{"Sam", 25}
+	user3 = &User{"Jack", 25}
+)
+
+func testRecordInit(t *testing.T) {
+	t.Helper()
+	err1 := NewSession().DropTable(&User{})
+	err2 := NewSession().CreateTable(&User{})
+	_, err3 := NewSession().Create(user1, user2)
+	if err1 != nil || err2 != nil || err3 != nil {
+		t.Fatal("failed init test records")
+	}
+
+}
+
+func TestSession_Create(t *testing.T) {
+	testRecordInit(t)
+	affected, err := NewSession().Create(user3)
+	if err != nil || affected != 1 {
+		t.Fatal("failed to create record")
+	}
+}
+
+func TestSession_Find(t *testing.T) {
+	testRecordInit(t)
+	users := []User{}
+	if err := NewSession().Find(&users); err != nil || len(users) != 2 {
+		t.Fatal("failed to query all")
+	}
+}
+
+func TestSession_First(t *testing.T) {
+	testRecordInit(t)
+	u := &User{}
+	err := NewSession().First(u)
+	if err != nil || u.Name != "Tom" || u.Age != 18 {
+		t.Fatal("failed to query first")
+	}
+}
+
+func TestSession_Limit(t *testing.T) {
+	testRecordInit(t)
+	var users []User
+	err := NewSession().Limit(1).Find(&users)
+	if err != nil || len(users) != 1 {
+		t.Fatal("failed to query with limit condition")
+	}
+}
+
+func TestSession_Where(t *testing.T) {
+	testRecordInit(t)
+	var users []User
+	_, err1 := NewSession().Create(user3)
+	err2 := NewSession().Where("Age = ?", 25).Find(&users)
+
+	if err1 != nil || err2 != nil || len(users) != 2 {
+		t.Fatal("failed to query with where condition")
+	}
+}
+
+func TestSession_OrderBy(t *testing.T) {
+	testRecordInit(t)
+	u := &User{}
+	err := NewSession().OrderBy("Age DESC").First(u)
+
+	if err != nil || u.Age != 25 {
+		t.Fatal("failed to query with order by condition")
+	}
+
+}
diff --git a/gee-orm/day4-chain-operation/geeorm/session/schema.go b/gee-orm/day4-chain-operation/geeorm/session/schema.go
new file mode 100644
index 0000000..11ff63b
--- /dev/null
+++ b/gee-orm/day4-chain-operation/geeorm/session/schema.go
@@ -0,0 +1,56 @@
+package session
+
+import (
+	"fmt"
+	"strings"
+
+	"geeorm/schema"
+)
+
+// RefTable returns a Schema instance that contains all parsed fields
+func (s *Session) RefTable(value interface{}) *schema.Schema {
+	if value == nil {
+		panic("value is nil")
+	}
+	if s.refTable == nil {
+		s.refTable = schema.Parse(value, s.dialect)
+	}
+	return s.refTable
+}
+
+// CreateTable create a table in database with a model
+func (s *Session) CreateTable(value interface{}) error {
+	table := s.RefTable(value)
+	var columns []string
+	for _, field := range table.Fields {
+		tag := field.Tag
+		if field.Name == table.PrimaryField.Name {
+			tag += " PRIMARY KEY"
+		}
+		columns = append(columns, fmt.Sprintf("%s %s", field.Name, tag))
+	}
+	desc := strings.Join(columns, ",")
+	_, err := s.Raw(fmt.Sprintf("CREATE TABLE %s (%s);", table.TableName, desc)).Exec()
+	return err
+}
+
+// DropTable drops a table with the name of model
+func (s *Session) DropTable(value interface{}) error {
+	table := s.RefTable(value)
+	_, err := s.Raw(fmt.Sprintf("DROP TABLE IF EXISTS %s", table.TableName)).Exec()
+	return err
+}
+
+// HasTable returns true of the table exists
+func (s *Session) HasTable(value interface{}) bool {
+	tableName, ok := value.(string)
+	if !ok {
+		tableName = s.RefTable(value).TableName
+	}
+
+	sql, values := s.dialect.TableExistSQL(tableName)
+	row := s.Raw(sql, values...).QueryRow()
+	var tmp string
+	_ = row.Scan(&tmp)
+	return tmp == tableName
+}
diff --git a/gee-orm/day4-chain-operation/geeorm/session/schema_test.go b/gee-orm/day4-chain-operation/geeorm/session/schema_test.go
new file mode 100644
index 0000000..5c934fa
--- /dev/null
+++ b/gee-orm/day4-chain-operation/geeorm/session/schema_test.go
@@ -0,0 +1,18 @@
+package session
+
+import (
+	"testing"
+)
+
+type User struct {
+	Name string `geeorm:"primary_key"`
+	Age  int
+}
+
+func TestSession_CreateTable(t *testing.T) {
+	_ = NewSession().DropTable(&User{})
+	_ = NewSession().CreateTable(&User{})
+	if !NewSession().HasTable("User") {
+		t.Fatal("failed to create table User")
+	}
+}

From 394ea2ec27d445f657de6e82b363f7f172d4ab53 Mon Sep 17 00:00:00 2001
From: gzdaijie <gzdaijie@163.com>
Date: Wed, 26 Feb 2020 20:25:39 +0800
Subject: [PATCH 045/122] remove geeorm directory

---
 gee-orm/day1-database-sql/{geeorm => }/geeorm.go     |  0
 .../day1-database-sql/{geeorm => }/geeorm_test.go    |  0
 gee-orm/day1-database-sql/{geeorm => }/go.mod        |  0
 gee-orm/day1-database-sql/{geeorm => }/log/log.go    |  6 +++---
 .../day1-database-sql/{geeorm => }/log/log_test.go   |  0
 .../day1-database-sql/{geeorm => }/session/raw.go    |  0
 .../{geeorm => }/session/raw_test.go                 |  0
 .../{geeorm => }/dialect/dialect.go                  |  0
 .../{geeorm => }/dialect/sqlite3.go                  |  0
 .../{geeorm => }/dialect/sqlite3_test.go             |  0
 gee-orm/day2-reflect-schema/{geeorm => }/geeorm.go   |  0
 .../day2-reflect-schema/{geeorm => }/geeorm_test.go  |  0
 gee-orm/day2-reflect-schema/{geeorm => }/go.mod      |  0
 gee-orm/day2-reflect-schema/{geeorm => }/log/log.go  |  6 +++---
 .../day2-reflect-schema/{geeorm => }/log/log_test.go |  0
 .../{geeorm => }/schema/schema.go                    |  0
 .../{geeorm => }/schema/schema_test.go               |  0
 .../day2-reflect-schema/{geeorm => }/session/raw.go  |  0
 .../{geeorm => }/session/raw_test.go                 |  0
 .../{geeorm/session/schema.go => session/table.go}   |  0
 .../session/schema_test.go => session/table_test.go} |  0
 .../geeorm => day3-save-query}/clause/clause.go      | 12 ++++++------
 .../{geeorm => }/clause/clause_test.go               |  0
 .../day3-save-query/{geeorm => }/clause/generator.go |  0
 .../day3-save-query/{geeorm => }/dialect/dialect.go  |  0
 .../day3-save-query/{geeorm => }/dialect/sqlite3.go  |  0
 .../{geeorm => }/dialect/sqlite3_test.go             |  0
 gee-orm/day3-save-query/{geeorm => }/geeorm.go       |  0
 gee-orm/day3-save-query/{geeorm => }/geeorm_test.go  |  0
 gee-orm/day3-save-query/{geeorm => }/go.mod          |  0
 .../geeorm => day3-save-query}/log/log.go            |  6 +++---
 gee-orm/day3-save-query/{geeorm => }/log/log_test.go |  0
 .../day3-save-query/{geeorm => }/schema/schema.go    |  0
 .../{geeorm => }/schema/schema_test.go               |  0
 gee-orm/day3-save-query/{geeorm => }/session/raw.go  |  0
 .../day3-save-query/{geeorm => }/session/raw_test.go |  0
 .../day3-save-query/{geeorm => }/session/record.go   |  0
 .../{geeorm => }/session/record_test.go              |  0
 .../{geeorm/session/schema.go => session/table.go}   |  0
 .../session/schema_test.go => session/table_test.go} |  0
 .../geeorm => day4-chain-operation}/clause/clause.go | 12 ++++++------
 .../{geeorm => }/clause/clause_test.go               |  0
 .../{geeorm => }/clause/generator.go                 |  0
 .../{geeorm => }/dialect/dialect.go                  |  0
 .../{geeorm => }/dialect/sqlite3.go                  |  0
 .../{geeorm => }/dialect/sqlite3_test.go             |  0
 gee-orm/day4-chain-operation/{geeorm => }/geeorm.go  |  0
 .../day4-chain-operation/{geeorm => }/geeorm_test.go |  0
 gee-orm/day4-chain-operation/{geeorm => }/go.mod     |  0
 .../geeorm => day4-chain-operation}/log/log.go       |  6 +++---
 .../{geeorm => }/log/log_test.go                     |  0
 .../{geeorm => }/schema/schema.go                    |  0
 .../{geeorm => }/schema/schema_test.go               |  0
 .../day4-chain-operation/{geeorm => }/session/raw.go |  0
 .../{geeorm => }/session/raw_test.go                 |  0
 .../{geeorm => }/session/record.go                   |  0
 .../{geeorm => }/session/record_test.go              |  0
 .../{geeorm/session/schema.go => session/table.go}   |  0
 .../session/schema_test.go => session/table_test.go} |  0
 59 files changed, 24 insertions(+), 24 deletions(-)
 rename gee-orm/day1-database-sql/{geeorm => }/geeorm.go (100%)
 rename gee-orm/day1-database-sql/{geeorm => }/geeorm_test.go (100%)
 rename gee-orm/day1-database-sql/{geeorm => }/go.mod (100%)
 rename gee-orm/day1-database-sql/{geeorm => }/log/log.go (93%)
 rename gee-orm/day1-database-sql/{geeorm => }/log/log_test.go (100%)
 rename gee-orm/day1-database-sql/{geeorm => }/session/raw.go (100%)
 rename gee-orm/day1-database-sql/{geeorm => }/session/raw_test.go (100%)
 rename gee-orm/day2-reflect-schema/{geeorm => }/dialect/dialect.go (100%)
 rename gee-orm/day2-reflect-schema/{geeorm => }/dialect/sqlite3.go (100%)
 rename gee-orm/day2-reflect-schema/{geeorm => }/dialect/sqlite3_test.go (100%)
 rename gee-orm/day2-reflect-schema/{geeorm => }/geeorm.go (100%)
 rename gee-orm/day2-reflect-schema/{geeorm => }/geeorm_test.go (100%)
 rename gee-orm/day2-reflect-schema/{geeorm => }/go.mod (100%)
 rename gee-orm/day2-reflect-schema/{geeorm => }/log/log.go (93%)
 rename gee-orm/day2-reflect-schema/{geeorm => }/log/log_test.go (100%)
 rename gee-orm/day2-reflect-schema/{geeorm => }/schema/schema.go (100%)
 rename gee-orm/day2-reflect-schema/{geeorm => }/schema/schema_test.go (100%)
 rename gee-orm/day2-reflect-schema/{geeorm => }/session/raw.go (100%)
 rename gee-orm/day2-reflect-schema/{geeorm => }/session/raw_test.go (100%)
 rename gee-orm/day2-reflect-schema/{geeorm/session/schema.go => session/table.go} (100%)
 rename gee-orm/day2-reflect-schema/{geeorm/session/schema_test.go => session/table_test.go} (100%)
 rename gee-orm/{day4-chain-operation/geeorm => day3-save-query}/clause/clause.go (88%)
 rename gee-orm/day3-save-query/{geeorm => }/clause/clause_test.go (100%)
 rename gee-orm/day3-save-query/{geeorm => }/clause/generator.go (100%)
 rename gee-orm/day3-save-query/{geeorm => }/dialect/dialect.go (100%)
 rename gee-orm/day3-save-query/{geeorm => }/dialect/sqlite3.go (100%)
 rename gee-orm/day3-save-query/{geeorm => }/dialect/sqlite3_test.go (100%)
 rename gee-orm/day3-save-query/{geeorm => }/geeorm.go (100%)
 rename gee-orm/day3-save-query/{geeorm => }/geeorm_test.go (100%)
 rename gee-orm/day3-save-query/{geeorm => }/go.mod (100%)
 rename gee-orm/{day4-chain-operation/geeorm => day3-save-query}/log/log.go (93%)
 rename gee-orm/day3-save-query/{geeorm => }/log/log_test.go (100%)
 rename gee-orm/day3-save-query/{geeorm => }/schema/schema.go (100%)
 rename gee-orm/day3-save-query/{geeorm => }/schema/schema_test.go (100%)
 rename gee-orm/day3-save-query/{geeorm => }/session/raw.go (100%)
 rename gee-orm/day3-save-query/{geeorm => }/session/raw_test.go (100%)
 rename gee-orm/day3-save-query/{geeorm => }/session/record.go (100%)
 rename gee-orm/day3-save-query/{geeorm => }/session/record_test.go (100%)
 rename gee-orm/day3-save-query/{geeorm/session/schema.go => session/table.go} (100%)
 rename gee-orm/day3-save-query/{geeorm/session/schema_test.go => session/table_test.go} (100%)
 rename gee-orm/{day3-save-query/geeorm => day4-chain-operation}/clause/clause.go (88%)
 rename gee-orm/day4-chain-operation/{geeorm => }/clause/clause_test.go (100%)
 rename gee-orm/day4-chain-operation/{geeorm => }/clause/generator.go (100%)
 rename gee-orm/day4-chain-operation/{geeorm => }/dialect/dialect.go (100%)
 rename gee-orm/day4-chain-operation/{geeorm => }/dialect/sqlite3.go (100%)
 rename gee-orm/day4-chain-operation/{geeorm => }/dialect/sqlite3_test.go (100%)
 rename gee-orm/day4-chain-operation/{geeorm => }/geeorm.go (100%)
 rename gee-orm/day4-chain-operation/{geeorm => }/geeorm_test.go (100%)
 rename gee-orm/day4-chain-operation/{geeorm => }/go.mod (100%)
 rename gee-orm/{day3-save-query/geeorm => day4-chain-operation}/log/log.go (93%)
 rename gee-orm/day4-chain-operation/{geeorm => }/log/log_test.go (100%)
 rename gee-orm/day4-chain-operation/{geeorm => }/schema/schema.go (100%)
 rename gee-orm/day4-chain-operation/{geeorm => }/schema/schema_test.go (100%)
 rename gee-orm/day4-chain-operation/{geeorm => }/session/raw.go (100%)
 rename gee-orm/day4-chain-operation/{geeorm => }/session/raw_test.go (100%)
 rename gee-orm/day4-chain-operation/{geeorm => }/session/record.go (100%)
 rename gee-orm/day4-chain-operation/{geeorm => }/session/record_test.go (100%)
 rename gee-orm/day4-chain-operation/{geeorm/session/schema.go => session/table.go} (100%)
 rename gee-orm/day4-chain-operation/{geeorm/session/schema_test.go => session/table_test.go} (100%)

diff --git a/gee-orm/day1-database-sql/geeorm/geeorm.go b/gee-orm/day1-database-sql/geeorm.go
similarity index 100%
rename from gee-orm/day1-database-sql/geeorm/geeorm.go
rename to gee-orm/day1-database-sql/geeorm.go
diff --git a/gee-orm/day1-database-sql/geeorm/geeorm_test.go b/gee-orm/day1-database-sql/geeorm_test.go
similarity index 100%
rename from gee-orm/day1-database-sql/geeorm/geeorm_test.go
rename to gee-orm/day1-database-sql/geeorm_test.go
diff --git a/gee-orm/day1-database-sql/geeorm/go.mod b/gee-orm/day1-database-sql/go.mod
similarity index 100%
rename from gee-orm/day1-database-sql/geeorm/go.mod
rename to gee-orm/day1-database-sql/go.mod
diff --git a/gee-orm/day1-database-sql/geeorm/log/log.go b/gee-orm/day1-database-sql/log/log.go
similarity index 93%
rename from gee-orm/day1-database-sql/geeorm/log/log.go
rename to gee-orm/day1-database-sql/log/log.go
index 684a718..eacc0c6 100644
--- a/gee-orm/day1-database-sql/geeorm/log/log.go
+++ b/gee-orm/day1-database-sql/log/log.go
@@ -24,9 +24,9 @@ var (
 
 // log levels
 const (
-	InfoLevel  = 0
-	ErrorLevel = 1
-	Disabled   = 9999
+	InfoLevel = iota
+	ErrorLevel
+	Disabled
 )
 
 // SetLevel controls log level
diff --git a/gee-orm/day1-database-sql/geeorm/log/log_test.go b/gee-orm/day1-database-sql/log/log_test.go
similarity index 100%
rename from gee-orm/day1-database-sql/geeorm/log/log_test.go
rename to gee-orm/day1-database-sql/log/log_test.go
diff --git a/gee-orm/day1-database-sql/geeorm/session/raw.go b/gee-orm/day1-database-sql/session/raw.go
similarity index 100%
rename from gee-orm/day1-database-sql/geeorm/session/raw.go
rename to gee-orm/day1-database-sql/session/raw.go
diff --git a/gee-orm/day1-database-sql/geeorm/session/raw_test.go b/gee-orm/day1-database-sql/session/raw_test.go
similarity index 100%
rename from gee-orm/day1-database-sql/geeorm/session/raw_test.go
rename to gee-orm/day1-database-sql/session/raw_test.go
diff --git a/gee-orm/day2-reflect-schema/geeorm/dialect/dialect.go b/gee-orm/day2-reflect-schema/dialect/dialect.go
similarity index 100%
rename from gee-orm/day2-reflect-schema/geeorm/dialect/dialect.go
rename to gee-orm/day2-reflect-schema/dialect/dialect.go
diff --git a/gee-orm/day2-reflect-schema/geeorm/dialect/sqlite3.go b/gee-orm/day2-reflect-schema/dialect/sqlite3.go
similarity index 100%
rename from gee-orm/day2-reflect-schema/geeorm/dialect/sqlite3.go
rename to gee-orm/day2-reflect-schema/dialect/sqlite3.go
diff --git a/gee-orm/day2-reflect-schema/geeorm/dialect/sqlite3_test.go b/gee-orm/day2-reflect-schema/dialect/sqlite3_test.go
similarity index 100%
rename from gee-orm/day2-reflect-schema/geeorm/dialect/sqlite3_test.go
rename to gee-orm/day2-reflect-schema/dialect/sqlite3_test.go
diff --git a/gee-orm/day2-reflect-schema/geeorm/geeorm.go b/gee-orm/day2-reflect-schema/geeorm.go
similarity index 100%
rename from gee-orm/day2-reflect-schema/geeorm/geeorm.go
rename to gee-orm/day2-reflect-schema/geeorm.go
diff --git a/gee-orm/day2-reflect-schema/geeorm/geeorm_test.go b/gee-orm/day2-reflect-schema/geeorm_test.go
similarity index 100%
rename from gee-orm/day2-reflect-schema/geeorm/geeorm_test.go
rename to gee-orm/day2-reflect-schema/geeorm_test.go
diff --git a/gee-orm/day2-reflect-schema/geeorm/go.mod b/gee-orm/day2-reflect-schema/go.mod
similarity index 100%
rename from gee-orm/day2-reflect-schema/geeorm/go.mod
rename to gee-orm/day2-reflect-schema/go.mod
diff --git a/gee-orm/day2-reflect-schema/geeorm/log/log.go b/gee-orm/day2-reflect-schema/log/log.go
similarity index 93%
rename from gee-orm/day2-reflect-schema/geeorm/log/log.go
rename to gee-orm/day2-reflect-schema/log/log.go
index 684a718..eacc0c6 100644
--- a/gee-orm/day2-reflect-schema/geeorm/log/log.go
+++ b/gee-orm/day2-reflect-schema/log/log.go
@@ -24,9 +24,9 @@ var (
 
 // log levels
 const (
-	InfoLevel  = 0
-	ErrorLevel = 1
-	Disabled   = 9999
+	InfoLevel = iota
+	ErrorLevel
+	Disabled
 )
 
 // SetLevel controls log level
diff --git a/gee-orm/day2-reflect-schema/geeorm/log/log_test.go b/gee-orm/day2-reflect-schema/log/log_test.go
similarity index 100%
rename from gee-orm/day2-reflect-schema/geeorm/log/log_test.go
rename to gee-orm/day2-reflect-schema/log/log_test.go
diff --git a/gee-orm/day2-reflect-schema/geeorm/schema/schema.go b/gee-orm/day2-reflect-schema/schema/schema.go
similarity index 100%
rename from gee-orm/day2-reflect-schema/geeorm/schema/schema.go
rename to gee-orm/day2-reflect-schema/schema/schema.go
diff --git a/gee-orm/day2-reflect-schema/geeorm/schema/schema_test.go b/gee-orm/day2-reflect-schema/schema/schema_test.go
similarity index 100%
rename from gee-orm/day2-reflect-schema/geeorm/schema/schema_test.go
rename to gee-orm/day2-reflect-schema/schema/schema_test.go
diff --git a/gee-orm/day2-reflect-schema/geeorm/session/raw.go b/gee-orm/day2-reflect-schema/session/raw.go
similarity index 100%
rename from gee-orm/day2-reflect-schema/geeorm/session/raw.go
rename to gee-orm/day2-reflect-schema/session/raw.go
diff --git a/gee-orm/day2-reflect-schema/geeorm/session/raw_test.go b/gee-orm/day2-reflect-schema/session/raw_test.go
similarity index 100%
rename from gee-orm/day2-reflect-schema/geeorm/session/raw_test.go
rename to gee-orm/day2-reflect-schema/session/raw_test.go
diff --git a/gee-orm/day2-reflect-schema/geeorm/session/schema.go b/gee-orm/day2-reflect-schema/session/table.go
similarity index 100%
rename from gee-orm/day2-reflect-schema/geeorm/session/schema.go
rename to gee-orm/day2-reflect-schema/session/table.go
diff --git a/gee-orm/day2-reflect-schema/geeorm/session/schema_test.go b/gee-orm/day2-reflect-schema/session/table_test.go
similarity index 100%
rename from gee-orm/day2-reflect-schema/geeorm/session/schema_test.go
rename to gee-orm/day2-reflect-schema/session/table_test.go
diff --git a/gee-orm/day4-chain-operation/geeorm/clause/clause.go b/gee-orm/day3-save-query/clause/clause.go
similarity index 88%
rename from gee-orm/day4-chain-operation/geeorm/clause/clause.go
rename to gee-orm/day3-save-query/clause/clause.go
index 77d88bc..daa930d 100755
--- a/gee-orm/day4-chain-operation/geeorm/clause/clause.go
+++ b/gee-orm/day3-save-query/clause/clause.go
@@ -15,12 +15,12 @@ type Type int
 
 // Support types for Clause
 const (
-	INSERT  Type = 0
-	VALUES  Type = 1
-	SELECT  Type = 2
-	LIMIT   Type = 3
-	WHERE   Type = 4
-	ORDERBY Type = 5
+	INSERT Type = iota
+	VALUES
+	SELECT
+	LIMIT
+	WHERE
+	ORDERBY
 )
 
 // Set adds a sub clause of specific type
diff --git a/gee-orm/day3-save-query/geeorm/clause/clause_test.go b/gee-orm/day3-save-query/clause/clause_test.go
similarity index 100%
rename from gee-orm/day3-save-query/geeorm/clause/clause_test.go
rename to gee-orm/day3-save-query/clause/clause_test.go
diff --git a/gee-orm/day3-save-query/geeorm/clause/generator.go b/gee-orm/day3-save-query/clause/generator.go
similarity index 100%
rename from gee-orm/day3-save-query/geeorm/clause/generator.go
rename to gee-orm/day3-save-query/clause/generator.go
diff --git a/gee-orm/day3-save-query/geeorm/dialect/dialect.go b/gee-orm/day3-save-query/dialect/dialect.go
similarity index 100%
rename from gee-orm/day3-save-query/geeorm/dialect/dialect.go
rename to gee-orm/day3-save-query/dialect/dialect.go
diff --git a/gee-orm/day3-save-query/geeorm/dialect/sqlite3.go b/gee-orm/day3-save-query/dialect/sqlite3.go
similarity index 100%
rename from gee-orm/day3-save-query/geeorm/dialect/sqlite3.go
rename to gee-orm/day3-save-query/dialect/sqlite3.go
diff --git a/gee-orm/day3-save-query/geeorm/dialect/sqlite3_test.go b/gee-orm/day3-save-query/dialect/sqlite3_test.go
similarity index 100%
rename from gee-orm/day3-save-query/geeorm/dialect/sqlite3_test.go
rename to gee-orm/day3-save-query/dialect/sqlite3_test.go
diff --git a/gee-orm/day3-save-query/geeorm/geeorm.go b/gee-orm/day3-save-query/geeorm.go
similarity index 100%
rename from gee-orm/day3-save-query/geeorm/geeorm.go
rename to gee-orm/day3-save-query/geeorm.go
diff --git a/gee-orm/day3-save-query/geeorm/geeorm_test.go b/gee-orm/day3-save-query/geeorm_test.go
similarity index 100%
rename from gee-orm/day3-save-query/geeorm/geeorm_test.go
rename to gee-orm/day3-save-query/geeorm_test.go
diff --git a/gee-orm/day3-save-query/geeorm/go.mod b/gee-orm/day3-save-query/go.mod
similarity index 100%
rename from gee-orm/day3-save-query/geeorm/go.mod
rename to gee-orm/day3-save-query/go.mod
diff --git a/gee-orm/day4-chain-operation/geeorm/log/log.go b/gee-orm/day3-save-query/log/log.go
similarity index 93%
rename from gee-orm/day4-chain-operation/geeorm/log/log.go
rename to gee-orm/day3-save-query/log/log.go
index 684a718..eacc0c6 100644
--- a/gee-orm/day4-chain-operation/geeorm/log/log.go
+++ b/gee-orm/day3-save-query/log/log.go
@@ -24,9 +24,9 @@ var (
 
 // log levels
 const (
-	InfoLevel  = 0
-	ErrorLevel = 1
-	Disabled   = 9999
+	InfoLevel = iota
+	ErrorLevel
+	Disabled
 )
 
 // SetLevel controls log level
diff --git a/gee-orm/day3-save-query/geeorm/log/log_test.go b/gee-orm/day3-save-query/log/log_test.go
similarity index 100%
rename from gee-orm/day3-save-query/geeorm/log/log_test.go
rename to gee-orm/day3-save-query/log/log_test.go
diff --git a/gee-orm/day3-save-query/geeorm/schema/schema.go b/gee-orm/day3-save-query/schema/schema.go
similarity index 100%
rename from gee-orm/day3-save-query/geeorm/schema/schema.go
rename to gee-orm/day3-save-query/schema/schema.go
diff --git a/gee-orm/day3-save-query/geeorm/schema/schema_test.go b/gee-orm/day3-save-query/schema/schema_test.go
similarity index 100%
rename from gee-orm/day3-save-query/geeorm/schema/schema_test.go
rename to gee-orm/day3-save-query/schema/schema_test.go
diff --git a/gee-orm/day3-save-query/geeorm/session/raw.go b/gee-orm/day3-save-query/session/raw.go
similarity index 100%
rename from gee-orm/day3-save-query/geeorm/session/raw.go
rename to gee-orm/day3-save-query/session/raw.go
diff --git a/gee-orm/day3-save-query/geeorm/session/raw_test.go b/gee-orm/day3-save-query/session/raw_test.go
similarity index 100%
rename from gee-orm/day3-save-query/geeorm/session/raw_test.go
rename to gee-orm/day3-save-query/session/raw_test.go
diff --git a/gee-orm/day3-save-query/geeorm/session/record.go b/gee-orm/day3-save-query/session/record.go
similarity index 100%
rename from gee-orm/day3-save-query/geeorm/session/record.go
rename to gee-orm/day3-save-query/session/record.go
diff --git a/gee-orm/day3-save-query/geeorm/session/record_test.go b/gee-orm/day3-save-query/session/record_test.go
similarity index 100%
rename from gee-orm/day3-save-query/geeorm/session/record_test.go
rename to gee-orm/day3-save-query/session/record_test.go
diff --git a/gee-orm/day3-save-query/geeorm/session/schema.go b/gee-orm/day3-save-query/session/table.go
similarity index 100%
rename from gee-orm/day3-save-query/geeorm/session/schema.go
rename to gee-orm/day3-save-query/session/table.go
diff --git a/gee-orm/day3-save-query/geeorm/session/schema_test.go b/gee-orm/day3-save-query/session/table_test.go
similarity index 100%
rename from gee-orm/day3-save-query/geeorm/session/schema_test.go
rename to gee-orm/day3-save-query/session/table_test.go
diff --git a/gee-orm/day3-save-query/geeorm/clause/clause.go b/gee-orm/day4-chain-operation/clause/clause.go
similarity index 88%
rename from gee-orm/day3-save-query/geeorm/clause/clause.go
rename to gee-orm/day4-chain-operation/clause/clause.go
index 77d88bc..daa930d 100755
--- a/gee-orm/day3-save-query/geeorm/clause/clause.go
+++ b/gee-orm/day4-chain-operation/clause/clause.go
@@ -15,12 +15,12 @@ type Type int
 
 // Support types for Clause
 const (
-	INSERT  Type = 0
-	VALUES  Type = 1
-	SELECT  Type = 2
-	LIMIT   Type = 3
-	WHERE   Type = 4
-	ORDERBY Type = 5
+	INSERT Type = iota
+	VALUES
+	SELECT
+	LIMIT
+	WHERE
+	ORDERBY
 )
 
 // Set adds a sub clause of specific type
diff --git a/gee-orm/day4-chain-operation/geeorm/clause/clause_test.go b/gee-orm/day4-chain-operation/clause/clause_test.go
similarity index 100%
rename from gee-orm/day4-chain-operation/geeorm/clause/clause_test.go
rename to gee-orm/day4-chain-operation/clause/clause_test.go
diff --git a/gee-orm/day4-chain-operation/geeorm/clause/generator.go b/gee-orm/day4-chain-operation/clause/generator.go
similarity index 100%
rename from gee-orm/day4-chain-operation/geeorm/clause/generator.go
rename to gee-orm/day4-chain-operation/clause/generator.go
diff --git a/gee-orm/day4-chain-operation/geeorm/dialect/dialect.go b/gee-orm/day4-chain-operation/dialect/dialect.go
similarity index 100%
rename from gee-orm/day4-chain-operation/geeorm/dialect/dialect.go
rename to gee-orm/day4-chain-operation/dialect/dialect.go
diff --git a/gee-orm/day4-chain-operation/geeorm/dialect/sqlite3.go b/gee-orm/day4-chain-operation/dialect/sqlite3.go
similarity index 100%
rename from gee-orm/day4-chain-operation/geeorm/dialect/sqlite3.go
rename to gee-orm/day4-chain-operation/dialect/sqlite3.go
diff --git a/gee-orm/day4-chain-operation/geeorm/dialect/sqlite3_test.go b/gee-orm/day4-chain-operation/dialect/sqlite3_test.go
similarity index 100%
rename from gee-orm/day4-chain-operation/geeorm/dialect/sqlite3_test.go
rename to gee-orm/day4-chain-operation/dialect/sqlite3_test.go
diff --git a/gee-orm/day4-chain-operation/geeorm/geeorm.go b/gee-orm/day4-chain-operation/geeorm.go
similarity index 100%
rename from gee-orm/day4-chain-operation/geeorm/geeorm.go
rename to gee-orm/day4-chain-operation/geeorm.go
diff --git a/gee-orm/day4-chain-operation/geeorm/geeorm_test.go b/gee-orm/day4-chain-operation/geeorm_test.go
similarity index 100%
rename from gee-orm/day4-chain-operation/geeorm/geeorm_test.go
rename to gee-orm/day4-chain-operation/geeorm_test.go
diff --git a/gee-orm/day4-chain-operation/geeorm/go.mod b/gee-orm/day4-chain-operation/go.mod
similarity index 100%
rename from gee-orm/day4-chain-operation/geeorm/go.mod
rename to gee-orm/day4-chain-operation/go.mod
diff --git a/gee-orm/day3-save-query/geeorm/log/log.go b/gee-orm/day4-chain-operation/log/log.go
similarity index 93%
rename from gee-orm/day3-save-query/geeorm/log/log.go
rename to gee-orm/day4-chain-operation/log/log.go
index 684a718..eacc0c6 100644
--- a/gee-orm/day3-save-query/geeorm/log/log.go
+++ b/gee-orm/day4-chain-operation/log/log.go
@@ -24,9 +24,9 @@ var (
 
 // log levels
 const (
-	InfoLevel  = 0
-	ErrorLevel = 1
-	Disabled   = 9999
+	InfoLevel = iota
+	ErrorLevel
+	Disabled
 )
 
 // SetLevel controls log level
diff --git a/gee-orm/day4-chain-operation/geeorm/log/log_test.go b/gee-orm/day4-chain-operation/log/log_test.go
similarity index 100%
rename from gee-orm/day4-chain-operation/geeorm/log/log_test.go
rename to gee-orm/day4-chain-operation/log/log_test.go
diff --git a/gee-orm/day4-chain-operation/geeorm/schema/schema.go b/gee-orm/day4-chain-operation/schema/schema.go
similarity index 100%
rename from gee-orm/day4-chain-operation/geeorm/schema/schema.go
rename to gee-orm/day4-chain-operation/schema/schema.go
diff --git a/gee-orm/day4-chain-operation/geeorm/schema/schema_test.go b/gee-orm/day4-chain-operation/schema/schema_test.go
similarity index 100%
rename from gee-orm/day4-chain-operation/geeorm/schema/schema_test.go
rename to gee-orm/day4-chain-operation/schema/schema_test.go
diff --git a/gee-orm/day4-chain-operation/geeorm/session/raw.go b/gee-orm/day4-chain-operation/session/raw.go
similarity index 100%
rename from gee-orm/day4-chain-operation/geeorm/session/raw.go
rename to gee-orm/day4-chain-operation/session/raw.go
diff --git a/gee-orm/day4-chain-operation/geeorm/session/raw_test.go b/gee-orm/day4-chain-operation/session/raw_test.go
similarity index 100%
rename from gee-orm/day4-chain-operation/geeorm/session/raw_test.go
rename to gee-orm/day4-chain-operation/session/raw_test.go
diff --git a/gee-orm/day4-chain-operation/geeorm/session/record.go b/gee-orm/day4-chain-operation/session/record.go
similarity index 100%
rename from gee-orm/day4-chain-operation/geeorm/session/record.go
rename to gee-orm/day4-chain-operation/session/record.go
diff --git a/gee-orm/day4-chain-operation/geeorm/session/record_test.go b/gee-orm/day4-chain-operation/session/record_test.go
similarity index 100%
rename from gee-orm/day4-chain-operation/geeorm/session/record_test.go
rename to gee-orm/day4-chain-operation/session/record_test.go
diff --git a/gee-orm/day4-chain-operation/geeorm/session/schema.go b/gee-orm/day4-chain-operation/session/table.go
similarity index 100%
rename from gee-orm/day4-chain-operation/geeorm/session/schema.go
rename to gee-orm/day4-chain-operation/session/table.go
diff --git a/gee-orm/day4-chain-operation/geeorm/session/schema_test.go b/gee-orm/day4-chain-operation/session/table_test.go
similarity index 100%
rename from gee-orm/day4-chain-operation/geeorm/session/schema_test.go
rename to gee-orm/day4-chain-operation/session/table_test.go

From 8ba70f262675cac2c34a15bd150ed17a7f3e94fe Mon Sep 17 00:00:00 2001
From: gzdaijie <gzdaijie@163.com>
Date: Wed, 26 Feb 2020 21:44:27 +0800
Subject: [PATCH 046/122] add day5 update delete & count

---
 gee-orm/day2-reflect-schema/session/table.go  |  13 +-
 gee-orm/day3-save-query/clause/clause.go      |   0
 gee-orm/day3-save-query/clause/clause_test.go |  12 +-
 gee-orm/day3-save-query/clause/generator.go   |   0
 gee-orm/day3-save-query/session/table.go      |  13 +-
 gee-orm/day4-chain-operation/clause/clause.go |   0
 .../clause/clause_test.go                     |  12 +-
 .../day4-chain-operation/clause/generator.go  |   0
 gee-orm/day4-chain-operation/session/table.go |  13 +-
 gee-orm/day5-update-delete/clause/clause.go   |  52 +++++++
 .../day5-update-delete/clause/clause_test.go  |  76 ++++++++++
 .../day5-update-delete/clause/generator.go    | 106 ++++++++++++++
 gee-orm/day5-update-delete/dialect/dialect.go |  22 +++
 gee-orm/day5-update-delete/dialect/sqlite3.go |  45 ++++++
 .../dialect/sqlite3_test.go                   |  25 ++++
 gee-orm/day5-update-delete/geeorm.go          |  51 +++++++
 gee-orm/day5-update-delete/geeorm_test.go     |  20 +++
 gee-orm/day5-update-delete/go.mod             |   5 +
 gee-orm/day5-update-delete/log/log.go         |  47 +++++++
 gee-orm/day5-update-delete/log/log_test.go    |  17 +++
 gee-orm/day5-update-delete/schema/schema.go   |  67 +++++++++
 .../day5-update-delete/schema/schema_test.go  |  36 +++++
 gee-orm/day5-update-delete/session/raw.go     |  59 ++++++++
 .../day5-update-delete/session/raw_test.go    |  46 +++++++
 gee-orm/day5-update-delete/session/record.go  | 130 ++++++++++++++++++
 .../day5-update-delete/session/record_test.go |  96 +++++++++++++
 gee-orm/day5-update-delete/session/table.go   |  59 ++++++++
 .../day5-update-delete/session/table_test.go  |  18 +++
 28 files changed, 1019 insertions(+), 21 deletions(-)
 mode change 100755 => 100644 gee-orm/day3-save-query/clause/clause.go
 mode change 100755 => 100644 gee-orm/day3-save-query/clause/clause_test.go
 mode change 100755 => 100644 gee-orm/day3-save-query/clause/generator.go
 mode change 100755 => 100644 gee-orm/day4-chain-operation/clause/clause.go
 mode change 100755 => 100644 gee-orm/day4-chain-operation/clause/clause_test.go
 mode change 100755 => 100644 gee-orm/day4-chain-operation/clause/generator.go
 create mode 100644 gee-orm/day5-update-delete/clause/clause.go
 create mode 100644 gee-orm/day5-update-delete/clause/clause_test.go
 create mode 100644 gee-orm/day5-update-delete/clause/generator.go
 create mode 100644 gee-orm/day5-update-delete/dialect/dialect.go
 create mode 100644 gee-orm/day5-update-delete/dialect/sqlite3.go
 create mode 100644 gee-orm/day5-update-delete/dialect/sqlite3_test.go
 create mode 100644 gee-orm/day5-update-delete/geeorm.go
 create mode 100644 gee-orm/day5-update-delete/geeorm_test.go
 create mode 100644 gee-orm/day5-update-delete/go.mod
 create mode 100644 gee-orm/day5-update-delete/log/log.go
 create mode 100644 gee-orm/day5-update-delete/log/log_test.go
 create mode 100644 gee-orm/day5-update-delete/schema/schema.go
 create mode 100644 gee-orm/day5-update-delete/schema/schema_test.go
 create mode 100644 gee-orm/day5-update-delete/session/raw.go
 create mode 100644 gee-orm/day5-update-delete/session/raw_test.go
 create mode 100644 gee-orm/day5-update-delete/session/record.go
 create mode 100644 gee-orm/day5-update-delete/session/record_test.go
 create mode 100644 gee-orm/day5-update-delete/session/table.go
 create mode 100644 gee-orm/day5-update-delete/session/table_test.go

diff --git a/gee-orm/day2-reflect-schema/session/table.go b/gee-orm/day2-reflect-schema/session/table.go
index 35c5a68..525e249 100644
--- a/gee-orm/day2-reflect-schema/session/table.go
+++ b/gee-orm/day2-reflect-schema/session/table.go
@@ -41,13 +41,16 @@ func (s *Session) DropTable(value interface{}) error {
 	return err
 }
 
-// HasTable returns true of the table exists
-func (s *Session) HasTable(value interface{}) bool {
-	tableName, ok := value.(string)
-	if !ok {
-		tableName = s.RefTable(value).TableName
+func (s *Session) guessTableName(value interface{}) string {
+	if tableName, ok := value.(string); ok {
+		return tableName
 	}
+	return s.RefTable(value).TableName
+}
 
+// HasTable returns true of the table exists
+func (s *Session) HasTable(value interface{}) bool {
+	tableName := s.guessTableName(value)
 	sql, values := s.dialect.TableExistSQL(tableName)
 	row := s.Raw(sql, values...).QueryRow()
 	var tmp string
diff --git a/gee-orm/day3-save-query/clause/clause.go b/gee-orm/day3-save-query/clause/clause.go
old mode 100755
new mode 100644
diff --git a/gee-orm/day3-save-query/clause/clause_test.go b/gee-orm/day3-save-query/clause/clause_test.go
old mode 100755
new mode 100644
index 3062bbd..f5267ca
--- a/gee-orm/day3-save-query/clause/clause_test.go
+++ b/gee-orm/day3-save-query/clause/clause_test.go
@@ -16,18 +16,24 @@ func TestClause_Set(t *testing.T) {
 	}
 }
 
-func TestClause_Build(t *testing.T) {
+func testSelect(t *testing.T) {
 	var clause Clause
 	clause.Set(LIMIT, 3)
 	clause.Set(SELECT, "User", []string{"*"})
-	clause.Set(WHERE, "Name = ?", 18)
+	clause.Set(WHERE, "Name = ?", "Tom")
 	clause.Set(ORDERBY, "Age ASC")
 	sql, vars := clause.Build(SELECT, WHERE, ORDERBY, LIMIT)
 	t.Log(sql, vars)
 	if sql != "SELECT * FROM User WHERE Name = ? ORDER BY Age ASC LIMIT ?" {
 		t.Fatal("failed to build SQL")
 	}
-	if !reflect.DeepEqual(vars, []interface{}{18, 3}) {
+	if !reflect.DeepEqual(vars, []interface{}{"Tom", 3}) {
 		t.Fatal("failed to build SQLVars")
 	}
 }
+
+func TestClause_Build(t *testing.T) {
+	t.Run("select", func(t *testing.T) {
+		testSelect(t)
+	})
+}
diff --git a/gee-orm/day3-save-query/clause/generator.go b/gee-orm/day3-save-query/clause/generator.go
old mode 100755
new mode 100644
diff --git a/gee-orm/day3-save-query/session/table.go b/gee-orm/day3-save-query/session/table.go
index 11ff63b..b644d3a 100644
--- a/gee-orm/day3-save-query/session/table.go
+++ b/gee-orm/day3-save-query/session/table.go
@@ -41,13 +41,16 @@ func (s *Session) DropTable(value interface{}) error {
 	return err
 }
 
-// HasTable returns true of the table exists
-func (s *Session) HasTable(value interface{}) bool {
-	tableName, ok := value.(string)
-	if !ok {
-		tableName = s.RefTable(value).TableName
+func (s *Session) guessTableName(value interface{}) string {
+	if tableName, ok := value.(string); ok {
+		return tableName
 	}
+	return s.RefTable(value).TableName
+}
 
+// HasTable returns true of the table exists
+func (s *Session) HasTable(value interface{}) bool {
+	tableName := s.guessTableName(value)
 	sql, values := s.dialect.TableExistSQL(tableName)
 	row := s.Raw(sql, values...).QueryRow()
 	var tmp string
diff --git a/gee-orm/day4-chain-operation/clause/clause.go b/gee-orm/day4-chain-operation/clause/clause.go
old mode 100755
new mode 100644
diff --git a/gee-orm/day4-chain-operation/clause/clause_test.go b/gee-orm/day4-chain-operation/clause/clause_test.go
old mode 100755
new mode 100644
index 3062bbd..f5267ca
--- a/gee-orm/day4-chain-operation/clause/clause_test.go
+++ b/gee-orm/day4-chain-operation/clause/clause_test.go
@@ -16,18 +16,24 @@ func TestClause_Set(t *testing.T) {
 	}
 }
 
-func TestClause_Build(t *testing.T) {
+func testSelect(t *testing.T) {
 	var clause Clause
 	clause.Set(LIMIT, 3)
 	clause.Set(SELECT, "User", []string{"*"})
-	clause.Set(WHERE, "Name = ?", 18)
+	clause.Set(WHERE, "Name = ?", "Tom")
 	clause.Set(ORDERBY, "Age ASC")
 	sql, vars := clause.Build(SELECT, WHERE, ORDERBY, LIMIT)
 	t.Log(sql, vars)
 	if sql != "SELECT * FROM User WHERE Name = ? ORDER BY Age ASC LIMIT ?" {
 		t.Fatal("failed to build SQL")
 	}
-	if !reflect.DeepEqual(vars, []interface{}{18, 3}) {
+	if !reflect.DeepEqual(vars, []interface{}{"Tom", 3}) {
 		t.Fatal("failed to build SQLVars")
 	}
 }
+
+func TestClause_Build(t *testing.T) {
+	t.Run("select", func(t *testing.T) {
+		testSelect(t)
+	})
+}
diff --git a/gee-orm/day4-chain-operation/clause/generator.go b/gee-orm/day4-chain-operation/clause/generator.go
old mode 100755
new mode 100644
diff --git a/gee-orm/day4-chain-operation/session/table.go b/gee-orm/day4-chain-operation/session/table.go
index 11ff63b..b644d3a 100644
--- a/gee-orm/day4-chain-operation/session/table.go
+++ b/gee-orm/day4-chain-operation/session/table.go
@@ -41,13 +41,16 @@ func (s *Session) DropTable(value interface{}) error {
 	return err
 }
 
-// HasTable returns true of the table exists
-func (s *Session) HasTable(value interface{}) bool {
-	tableName, ok := value.(string)
-	if !ok {
-		tableName = s.RefTable(value).TableName
+func (s *Session) guessTableName(value interface{}) string {
+	if tableName, ok := value.(string); ok {
+		return tableName
 	}
+	return s.RefTable(value).TableName
+}
 
+// HasTable returns true of the table exists
+func (s *Session) HasTable(value interface{}) bool {
+	tableName := s.guessTableName(value)
 	sql, values := s.dialect.TableExistSQL(tableName)
 	row := s.Raw(sql, values...).QueryRow()
 	var tmp string
diff --git a/gee-orm/day5-update-delete/clause/clause.go b/gee-orm/day5-update-delete/clause/clause.go
new file mode 100644
index 0000000..2195c86
--- /dev/null
+++ b/gee-orm/day5-update-delete/clause/clause.go
@@ -0,0 +1,52 @@
+package clause
+
+import (
+	"strings"
+)
+
+// Clause contains SQL conditions
+type Clause struct {
+	sql     map[Type]string
+	sqlVars map[Type][]interface{}
+}
+
+// Type is the type of Clause
+type Type int
+
+// Support types for Clause
+const (
+	INSERT Type = iota
+	VALUES
+	SELECT
+	LIMIT
+	WHERE
+	ORDERBY
+	UPDATE
+	SET
+	DELETE
+	COUNT
+)
+
+// Set adds a sub clause of specific type
+func (c *Clause) Set(name Type, vars ...interface{}) {
+	if c.sql == nil {
+		c.sql = make(map[Type]string)
+		c.sqlVars = make(map[Type][]interface{})
+	}
+	sql, vars := generators[name](vars...)
+	c.sql[name] = sql
+	c.sqlVars[name] = vars
+}
+
+// Build generate the final SQL and SQLVars
+func (c *Clause) Build(orders ...Type) (string, []interface{}) {
+	var sqls []string
+	var vars []interface{}
+	for _, order := range orders {
+		if sql, ok := c.sql[order]; ok {
+			sqls = append(sqls, sql)
+			vars = append(vars, c.sqlVars[order]...)
+		}
+	}
+	return strings.Join(sqls, " "), vars
+}
diff --git a/gee-orm/day5-update-delete/clause/clause_test.go b/gee-orm/day5-update-delete/clause/clause_test.go
new file mode 100644
index 0000000..8769c40
--- /dev/null
+++ b/gee-orm/day5-update-delete/clause/clause_test.go
@@ -0,0 +1,76 @@
+package clause
+
+import (
+	"reflect"
+	"testing"
+)
+
+func TestClause_Set(t *testing.T) {
+	var clause Clause
+	clause.Set(INSERT, "User", []string{"Name", "Age"})
+	sql := clause.sql[INSERT]
+	vars := clause.sqlVars[INSERT]
+	t.Log(sql, vars)
+	if sql != "INSERT INTO User (Name,Age)" || len(vars) != 0 {
+		t.Fatal("failed to get clause")
+	}
+}
+
+func testSelect(t *testing.T) {
+	var clause Clause
+	clause.Set(LIMIT, 3)
+	clause.Set(SELECT, "User", []string{"*"})
+	clause.Set(WHERE, "Name = ?", "Tom")
+	clause.Set(ORDERBY, "Age ASC")
+	sql, vars := clause.Build(SELECT, WHERE, ORDERBY, LIMIT)
+	t.Log(sql, vars)
+	if sql != "SELECT * FROM User WHERE Name = ? ORDER BY Age ASC LIMIT ?" {
+		t.Fatal("failed to build SQL")
+	}
+	if !reflect.DeepEqual(vars, []interface{}{"Tom", 3}) {
+		t.Fatal("failed to build SQLVars")
+	}
+}
+
+func testUpdate(t *testing.T) {
+	var clause Clause
+	clause.Set(UPDATE, "User")
+	clause.Set(WHERE, "Name = ?", "Tom")
+	clause.Set(SET, map[string]interface{}{"Age": 30, "Name": "Tommy"})
+
+	sql, vars := clause.Build(UPDATE, SET, WHERE)
+	t.Log(sql, vars)
+	if sql != "UPDATE User SET Age = ?, Name = ? WHERE Name = ?" {
+		t.Fatal("failed to build SQL")
+	}
+	if !reflect.DeepEqual(vars, []interface{}{30, "Tommy", "Tom"}) {
+		t.Fatal("failed to build SQLVars")
+	}
+}
+
+func testDelete(t *testing.T) {
+	var clause Clause
+	clause.Set(DELETE, "User")
+	clause.Set(WHERE, "Name = ?", "Tom")
+
+	sql, vars := clause.Build(DELETE, WHERE)
+	t.Log(sql, vars)
+	if sql != "DELETE FROM User WHERE Name = ?" {
+		t.Fatal("failed to build SQL")
+	}
+	if !reflect.DeepEqual(vars, []interface{}{"Tom"}) {
+		t.Fatal("failed to build SQLVars")
+	}
+}
+
+func TestClause_Build(t *testing.T) {
+	t.Run("select", func(t *testing.T) {
+		testSelect(t)
+	})
+	t.Run("update", func(t *testing.T) {
+		testUpdate(t)
+	})
+	t.Run("delete", func(t *testing.T) {
+		testDelete(t)
+	})
+}
diff --git a/gee-orm/day5-update-delete/clause/generator.go b/gee-orm/day5-update-delete/clause/generator.go
new file mode 100644
index 0000000..1cf5aec
--- /dev/null
+++ b/gee-orm/day5-update-delete/clause/generator.go
@@ -0,0 +1,106 @@
+package clause
+
+import (
+	"fmt"
+	"strings"
+)
+
+type generator func(values ...interface{}) (string, []interface{})
+
+var generators map[Type]generator
+
+func init() {
+	generators = make(map[Type]generator)
+	generators[INSERT] = _insert
+	generators[VALUES] = _values
+	generators[SELECT] = _select
+	generators[LIMIT] = _limit
+	generators[WHERE] = _where
+	generators[ORDERBY] = _orderby
+	generators[UPDATE] = _update
+	generators[SET] = _set
+	generators[DELETE] = _delete
+	generators[COUNT] = _count
+}
+
+func genBindVars(num int) string {
+	var vars []string
+	for i := 0; i < num; i++ {
+		vars = append(vars, "?")
+	}
+	return strings.Join(vars, ", ")
+}
+
+func _insert(values ...interface{}) (string, []interface{}) {
+	// INSERT INTO $tableName ($fields)
+	tableName := values[0]
+	fields := strings.Join(values[1].([]string), ",")
+	return fmt.Sprintf("INSERT INTO %s (%v)", tableName, fields), []interface{}{}
+}
+
+func _values(values ...interface{}) (string, []interface{}) {
+	// VALUES ($v1), (&v2), ...
+	var bindStr string
+	var sql strings.Builder
+	var vars []interface{}
+	sql.WriteString("VALUES ")
+	for i, value := range values {
+		v := value.([]interface{})
+		if bindStr == "" {
+			bindStr = genBindVars(len(v))
+		}
+		sql.WriteString(fmt.Sprintf("(%v)", bindStr))
+		if i+1 != len(values) {
+			sql.WriteString(", ")
+		}
+		vars = append(vars, v...)
+	}
+	return sql.String(), vars
+
+}
+
+func _select(values ...interface{}) (string, []interface{}) {
+	// SELECT $fields FROM $tableName
+	tableName := values[0]
+	fields := strings.Join(values[1].([]string), ",")
+	return fmt.Sprintf("SELECT %v FROM %s", fields, tableName), []interface{}{}
+}
+
+func _limit(values ...interface{}) (string, []interface{}) {
+	// LIMIT $num
+	return "LIMIT ?", values
+}
+
+func _where(values ...interface{}) (string, []interface{}) {
+	// WHERE $desc
+	desc, vars := values[0], values[1:]
+	return fmt.Sprintf("WHERE %s", desc), vars
+}
+
+func _orderby(values ...interface{}) (string, []interface{}) {
+	return fmt.Sprintf("ORDER BY %s", values[0]), []interface{}{}
+}
+
+func _update(values ...interface{}) (string, []interface{}) {
+	return fmt.Sprintf("UPDATE %s", values[0]), []interface{}{}
+}
+
+func _set(values ...interface{}) (string, []interface{}) {
+	m := values[0].(map[string]interface{})
+	var keys []string
+	var vars []interface{}
+	for k, v := range m {
+		keys = append(keys, k+" = ?")
+		vars = append(vars, v)
+	}
+
+	return fmt.Sprintf("SET %s", strings.Join(keys, ", ")), vars
+}
+
+func _delete(values ...interface{}) (string, []interface{}) {
+	return fmt.Sprintf("DELETE FROM %s", values[0]), []interface{}{}
+}
+
+func _count(values ...interface{}) (string, []interface{}) {
+	return _select(values[0], []string{"count(*)"})
+}
diff --git a/gee-orm/day5-update-delete/dialect/dialect.go b/gee-orm/day5-update-delete/dialect/dialect.go
new file mode 100644
index 0000000..4696314
--- /dev/null
+++ b/gee-orm/day5-update-delete/dialect/dialect.go
@@ -0,0 +1,22 @@
+package dialect
+
+import "reflect"
+
+var dialectsMap = map[string]Dialect{}
+
+// Dialect is an interface contains methods that a dialect has to implement
+type Dialect interface {
+	DataTypeOf(typ reflect.Value) string
+	TableExistSQL(tableName string) (string, []interface{})
+}
+
+// RegisterDialect register a dialect to the global variable
+func RegisterDialect(name string, dialect Dialect) {
+	dialectsMap[name] = dialect
+}
+
+// Get the dialect from global variable if it exists
+func GetDialect(name string) (dialect Dialect, ok bool) {
+	dialect, ok = dialectsMap[name]
+	return
+}
diff --git a/gee-orm/day5-update-delete/dialect/sqlite3.go b/gee-orm/day5-update-delete/dialect/sqlite3.go
new file mode 100644
index 0000000..f3c3897
--- /dev/null
+++ b/gee-orm/day5-update-delete/dialect/sqlite3.go
@@ -0,0 +1,45 @@
+package dialect
+
+import (
+	"fmt"
+	"reflect"
+	"time"
+)
+
+type sqlite3 struct{}
+
+var _ Dialect = (*sqlite3)(nil)
+
+func init() {
+	RegisterDialect("sqlite3", &sqlite3{})
+}
+
+// Get Data Type for sqlite3 Dialect
+func (s *sqlite3) DataTypeOf(typ reflect.Value) string {
+	switch typ.Kind() {
+	case reflect.Bool:
+		return "bool"
+	case reflect.Int, reflect.Int8, reflect.Int16, reflect.Int32,
+		reflect.Uint, reflect.Uint8, reflect.Uint16, reflect.Uint32, reflect.Uintptr:
+		return "integer"
+	case reflect.Int64, reflect.Uint64:
+		return "bigint"
+	case reflect.Float32, reflect.Float64:
+		return "real"
+	case reflect.String:
+		return "text"
+	case reflect.Array, reflect.Slice:
+		return "blob"
+	case reflect.Struct:
+		if _, ok := typ.Interface().(time.Time); ok {
+			return "datetime"
+		}
+	}
+	panic(fmt.Sprintf("invalid sql type %s (%s)", typ.Type().Name(), typ.Kind()))
+}
+
+// TableExistSQL returns SQL that judge whether the table exists in database
+func (s *sqlite3) TableExistSQL(tableName string) (string, []interface{}) {
+	args := []interface{}{tableName}
+	return "SELECT name FROM sqlite_master WHERE type='table' and name = ?", args
+}
diff --git a/gee-orm/day5-update-delete/dialect/sqlite3_test.go b/gee-orm/day5-update-delete/dialect/sqlite3_test.go
new file mode 100644
index 0000000..3df5f07
--- /dev/null
+++ b/gee-orm/day5-update-delete/dialect/sqlite3_test.go
@@ -0,0 +1,25 @@
+package dialect
+
+import (
+	"reflect"
+	"testing"
+)
+
+func TestDataTypeOf(t *testing.T) {
+	dial := &sqlite3{}
+	cases := []struct {
+		Value interface{}
+		Type  string
+	}{
+		{"Tom", "text"},
+		{123, "integer"},
+		{1.2, "real"},
+		{[]int{1, 2, 3}, "blob"},
+	}
+
+	for _, c := range cases {
+		if typ := dial.DataTypeOf(reflect.ValueOf(c.Value)); typ != c.Type {
+			t.Fatalf("expect %s, but got %s", c.Type, typ)
+		}
+	}
+}
diff --git a/gee-orm/day5-update-delete/geeorm.go b/gee-orm/day5-update-delete/geeorm.go
new file mode 100644
index 0000000..61ee9e0
--- /dev/null
+++ b/gee-orm/day5-update-delete/geeorm.go
@@ -0,0 +1,51 @@
+package geeorm
+
+import (
+	"database/sql"
+	"geeorm/dialect"
+	"geeorm/log"
+	"geeorm/session"
+)
+
+// Engine is the main struct of geeorm, manages all db sessions and transactions.
+type Engine struct {
+	db      *sql.DB
+	dialect dialect.Dialect
+}
+
+// NewEngine create a instance of Engine
+// connect database and ping it to test whether it's alive
+func NewEngine(driver, source string) (e *Engine, err error) {
+	db, err := sql.Open(driver, source)
+	if err != nil {
+		log.Error(err)
+		return
+	}
+	// Send a ping to make sure the database connection is alive.
+	if err = db.Ping(); err != nil {
+		log.Error(err)
+		return
+	}
+	// make sure the specific dialect exists
+	dial, ok := dialect.GetDialect(driver)
+	if !ok {
+		log.Errorf("dialect %s Not Found", driver)
+		return
+	}
+	e = &Engine{db: db, dialect: dial}
+	log.Info("Connect database success")
+	return
+}
+
+// Close database connection
+func (e *Engine) Close() (err error) {
+	if err = e.db.Close(); err == nil {
+		log.Info("Close database success")
+	}
+	return
+}
+
+// NewSession creates a new session for next operations
+func (e *Engine) NewSession() *session.Session {
+	return session.New(e.db, e.dialect)
+}
diff --git a/gee-orm/day5-update-delete/geeorm_test.go b/gee-orm/day5-update-delete/geeorm_test.go
new file mode 100644
index 0000000..35628be
--- /dev/null
+++ b/gee-orm/day5-update-delete/geeorm_test.go
@@ -0,0 +1,20 @@
+package geeorm
+
+import (
+	_ "github.com/mattn/go-sqlite3"
+	"testing"
+)
+
+func OpenDB(t *testing.T) *Engine {
+	t.Helper()
+	engine, err := NewEngine("sqlite3", "gee.db")
+	if err != nil {
+		t.Fatal("failed to connect", err)
+	}
+	return engine
+}
+
+func TestNewEngine(t *testing.T) {
+	engine := OpenDB(t)
+	_ = engine.Close()
+}
diff --git a/gee-orm/day5-update-delete/go.mod b/gee-orm/day5-update-delete/go.mod
new file mode 100644
index 0000000..043b1c6
--- /dev/null
+++ b/gee-orm/day5-update-delete/go.mod
@@ -0,0 +1,5 @@
+module geeorm
+
+go 1.13
+
+require github.com/mattn/go-sqlite3 v2.0.3+incompatible
diff --git a/gee-orm/day5-update-delete/log/log.go b/gee-orm/day5-update-delete/log/log.go
new file mode 100644
index 0000000..eacc0c6
--- /dev/null
+++ b/gee-orm/day5-update-delete/log/log.go
@@ -0,0 +1,47 @@
+package log
+
+import (
+	"io/ioutil"
+	"log"
+	"os"
+	"sync"
+)
+
+var (
+	errorLog = log.New(os.Stdout, "\033[31m[error]\033[0m ", log.LstdFlags|log.Lshortfile)
+	infoLog  = log.New(os.Stdout, "\033[34m[info ]\033[0m ", log.LstdFlags|log.Lshortfile)
+	loggers  = []*log.Logger{errorLog, infoLog}
+	mu       sync.Mutex
+)
+
+// log methods
+var (
+	Error  = errorLog.Println
+	Errorf = errorLog.Printf
+	Info   = infoLog.Println
+	Infof  = infoLog.Printf
+)
+
+// log levels
+const (
+	InfoLevel = iota
+	ErrorLevel
+	Disabled
+)
+
+// SetLevel controls log level
+func SetLevel(level int) {
+	mu.Lock()
+	defer mu.Unlock()
+
+	for _, logger := range loggers {
+		logger.SetOutput(os.Stdout)
+	}
+
+	if ErrorLevel < level {
+		errorLog.SetOutput(ioutil.Discard)
+	}
+	if InfoLevel < level {
+		infoLog.SetOutput(ioutil.Discard)
+	}
+}
diff --git a/gee-orm/day5-update-delete/log/log_test.go b/gee-orm/day5-update-delete/log/log_test.go
new file mode 100644
index 0000000..8cd403c
--- /dev/null
+++ b/gee-orm/day5-update-delete/log/log_test.go
@@ -0,0 +1,17 @@
+package log
+
+import (
+	"os"
+	"testing"
+)
+
+func TestSetLevel(t *testing.T) {
+	SetLevel(ErrorLevel)
+	if infoLog.Writer() == os.Stdout || errorLog.Writer() != os.Stdout {
+		t.Fatal("failed to set log level")
+	}
+	SetLevel(Disabled)
+	if infoLog.Writer() == os.Stdout || errorLog.Writer() == os.Stdout {
+		t.Fatal("failed to set log level")
+	}
+}
\ No newline at end of file
diff --git a/gee-orm/day5-update-delete/schema/schema.go b/gee-orm/day5-update-delete/schema/schema.go
new file mode 100644
index 0000000..8519fd4
--- /dev/null
+++ b/gee-orm/day5-update-delete/schema/schema.go
@@ -0,0 +1,67 @@
+package schema
+
+import (
+	"fmt"
+	"geeorm/dialect"
+	"go/ast"
+	"reflect"
+)
+
+// Field represents a column of database
+type Field struct {
+	Name string
+	Tag  string
+}
+
+// Schema represents a table of database
+type Schema struct {
+	TableName    string
+	PrimaryField *Field
+	Fields       []*Field
+	FieldNames   []string
+}
+
+// Values return the values of dest's member variables
+func (schema *Schema) Values(dest interface{}) []interface{} {
+	destValue := reflect.Indirect(reflect.ValueOf(dest))
+	var fieldValues []interface{}
+	for _, field := range schema.Fields {
+		fieldValues = append(fieldValues, destValue.FieldByName(field.Name).Interface())
+	}
+	return fieldValues
+}
+
+// Parse a struct to a Schema instance
+func Parse(dest interface{}, d dialect.Dialect) *Schema {
+	modelType := reflect.Indirect(reflect.ValueOf(dest)).Type()
+	schema := &Schema{
+		TableName:    modelType.Name(),
+		PrimaryField: &Field{Name: "ID", Tag: ""},
+	}
+
+	for i := 0; i < modelType.NumField(); i++ {
+		p := modelType.Field(i)
+		if !p.Anonymous && ast.IsExported(p.Name) {
+			field := &Field{
+				Name: p.Name,
+				Tag:  d.DataTypeOf(reflect.Indirect(reflect.New(p.Type))),
+			}
+			if v, ok := p.Tag.Lookup("geeorm"); ok && v == "primary_key" {
+				schema.PrimaryField = field
+			}
+			schema.Fields = append(schema.Fields, field)
+			schema.FieldNames = append(schema.FieldNames, p.Name)
+		}
+	}
+	return schema
+}
+
+// String returns readable string
+func (field *Field) String() string {
+	return fmt.Sprintf("(%s %s)", field.Name, field.Tag)
+}
+
+// String returns readable string
+func (schema *Schema) String() string {
+	return fmt.Sprintf("TABLE %s %v", schema.TableName, schema.Fields)
+}
diff --git a/gee-orm/day5-update-delete/schema/schema_test.go b/gee-orm/day5-update-delete/schema/schema_test.go
new file mode 100644
index 0000000..aba3e0b
--- /dev/null
+++ b/gee-orm/day5-update-delete/schema/schema_test.go
@@ -0,0 +1,36 @@
+package schema
+
+import (
+	"geeorm/dialect"
+	"testing"
+)
+
+type User struct {
+	Name string `geeorm:"primary_key"`
+	Age  int
+}
+
+var TestDial, _ = dialect.GetDialect("sqlite3")
+
+func TestParse(t *testing.T) {
+	schema := Parse(&User{}, TestDial)
+	if schema.TableName != "User" || len(schema.Fields) != 2 {
+		t.Fatal("failed to parse User struct")
+	}
+	if schema.PrimaryField.Name != "Name" {
+		t.Fatal("failed to parse primary key")
+	}
+	t.Log(schema)
+}
+
+func TestSchema_Values(t *testing.T) {
+	schema := Parse(&User{}, TestDial)
+	values := schema.Values(&User{"Tom", 18})
+
+	name := values[0].(string)
+	age := values[1].(int)
+
+	if name != "Tom" || age != 18 {
+		t.Fatal("failed to get values")
+	}
+}
diff --git a/gee-orm/day5-update-delete/session/raw.go b/gee-orm/day5-update-delete/session/raw.go
new file mode 100644
index 0000000..6cb72c9
--- /dev/null
+++ b/gee-orm/day5-update-delete/session/raw.go
@@ -0,0 +1,59 @@
+package session
+
+import (
+	"database/sql"
+	"geeorm/clause"
+	"geeorm/dialect"
+	"geeorm/log"
+	"geeorm/schema"
+)
+
+// Session keep a pointer to sql.DB and provides all execution of all
+// kind of database operations.
+type Session struct {
+	db       *sql.DB
+	dialect  dialect.Dialect
+	refTable *schema.Schema
+	clause   clause.Clause
+	sql      string
+	sqlVars  []interface{}
+}
+
+// New creates a instance of Session
+func New(db *sql.DB, dialect dialect.Dialect) *Session {
+	return &Session{
+		db:      db,
+		dialect: dialect,
+	}
+}
+
+// Exec raw sql with sqlVars
+func (s *Session) Exec() (result sql.Result, err error) {
+	log.Info(s.sql, s.sqlVars)
+	if result, err = s.db.Exec(s.sql, s.sqlVars...); err != nil {
+		log.Error(err)
+	}
+	return
+}
+
+// QueryRow gets a record from db
+func (s *Session) QueryRow() *sql.Row {
+	log.Info(s.sql, s.sqlVars)
+	return s.db.QueryRow(s.sql, s.sqlVars...)
+}
+
+// QueryRows gets a list of records from db
+func (s *Session) QueryRows() (rows *sql.Rows, err error) {
+	log.Info(s.sql, s.sqlVars)
+	if rows, err = s.db.Query(s.sql, s.sqlVars...); err != nil {
+		log.Error(err)
+	}
+	return
+}
+
+// Raw appends sql and sqlVars
+func (s *Session) Raw(sql string, values ...interface{}) *Session {
+	s.sql += sql
+	s.sqlVars = append(s.sqlVars, values...)
+	return s
+}
diff --git a/gee-orm/day5-update-delete/session/raw_test.go b/gee-orm/day5-update-delete/session/raw_test.go
new file mode 100644
index 0000000..ce1e75b
--- /dev/null
+++ b/gee-orm/day5-update-delete/session/raw_test.go
@@ -0,0 +1,46 @@
+package session
+
+import (
+	"database/sql"
+	"os"
+	"testing"
+
+	"geeorm/dialect"
+
+	_ "github.com/mattn/go-sqlite3"
+)
+
+var (
+	TestDB      *sql.DB
+	TestDial, _ = dialect.GetDialect("sqlite3")
+)
+
+func TestMain(m *testing.M) {
+	TestDB, _ = sql.Open("sqlite3", "gee.db")
+	code := m.Run()
+	_ = TestDB.Close()
+	os.Exit(code)
+}
+
+func NewSession() *Session {
+	return &Session{db: TestDB, dialect: TestDial}
+}
+
+func TestSession_Exec(t *testing.T) {
+	_, _ = NewSession().Raw("DROP TABLE IF EXISTS User;").Exec()
+	_, _ = NewSession().Raw("CREATE TABLE User(name text);").Exec()
+	result, _ := NewSession().Raw("INSERT INTO User(`name`) values (?), (?)", "Tom", "Sam").Exec()
+	if count, err := result.RowsAffected(); err != nil || count != 2 {
+		t.Fatal("expect 2, but got", count)
+	}
+}
+
+func TestSession_QueryRows(t *testing.T) {
+	_, _ = NewSession().Raw("DROP TABLE IF EXISTS User;").Exec()
+	_, _ = NewSession().Raw("CREATE TABLE User(name text);").Exec()
+	row := NewSession().Raw("SELECT count(*) FROM User").QueryRow()
+	var count int
+	if err := row.Scan(&count); err != nil || count != 0 {
+		t.Fatal("failed to query db", err)
+	}
+}
diff --git a/gee-orm/day5-update-delete/session/record.go b/gee-orm/day5-update-delete/session/record.go
new file mode 100644
index 0000000..bc6d1fe
--- /dev/null
+++ b/gee-orm/day5-update-delete/session/record.go
@@ -0,0 +1,130 @@
+package session
+
+import (
+	"geeorm/clause"
+	"reflect"
+)
+
+// Create one or more records in database
+func (s *Session) Create(values ...interface{}) (int64, error) {
+	recordValues := make([]interface{}, 0)
+	for _, value := range values {
+		table := s.RefTable(value)
+		s.clause.Set(clause.INSERT, table.TableName, table.FieldNames)
+		recordValues = append(recordValues, table.Values(value))
+	}
+
+	s.clause.Set(clause.VALUES, recordValues...)
+	sql, vars := s.clause.Build(clause.INSERT, clause.VALUES)
+	result, err := s.Raw(sql, vars...).Exec()
+	if err != nil {
+		return 0, err
+	}
+
+	return result.RowsAffected()
+}
+
+// Find gets all eligible records
+func (s *Session) Find(values interface{}) error {
+	destSlice := reflect.Indirect(reflect.ValueOf(values))
+	destType := destSlice.Type().Elem()
+	table := s.RefTable(reflect.New(destType).Elem().Interface())
+
+	s.clause.Set(clause.SELECT, table.TableName, table.FieldNames)
+	sql, vars := s.clause.Build(clause.SELECT, clause.WHERE, clause.ORDERBY, clause.LIMIT)
+	rows, err := s.Raw(sql, vars...).QueryRows()
+	if err != nil {
+		return err
+	}
+
+	for rows.Next() {
+		dest := reflect.New(destType).Elem()
+		var values []interface{}
+		for _, name := range table.FieldNames {
+			values = append(values, dest.FieldByName(name).Addr().Interface())
+		}
+		if err := rows.Scan(values...); err != nil {
+			return err
+		}
+		destSlice.Set(reflect.Append(destSlice, dest))
+	}
+	return rows.Close()
+}
+
+// First gets the 1st row
+func (s *Session) First(value interface{}) error {
+	dest := reflect.Indirect(reflect.ValueOf(value))
+	destSlice := reflect.New(reflect.SliceOf(dest.Type())).Elem()
+	err := s.Limit(1).Find(destSlice.Addr().Interface())
+	dest.Set(destSlice.Index(0))
+	return err
+}
+
+// Limit adds limit condition to clause
+func (s *Session) Limit(num int) *Session {
+	s.clause.Set(clause.LIMIT, num)
+	return s
+}
+
+// Where adds limit condition to clause
+func (s *Session) Where(desc string, args ...interface{}) *Session {
+	var vars []interface{}
+	s.clause.Set(clause.WHERE, append(append(vars, desc), args...)...)
+	return s
+}
+
+// OrderBy adds order by condition to clause
+func (s *Session) OrderBy(desc string) *Session {
+	s.clause.Set(clause.ORDERBY, desc)
+	return s
+}
+
+// Set adds Assignment by condition to clause
+// support map[string]interface{}
+// also support "Name", "Tom", "Age", 18, etc
+func (s *Session) Set(values ...interface{}) *Session {
+	m, ok := values[0].(map[string]interface{})
+	if !ok {
+		m = make(map[string]interface{})
+		for i := 0; i < len(values); i += 2 {
+			m[values[i].(string)] = values[i+1]
+		}
+	}
+	s.clause.Set(clause.SET, m)
+	return s
+}
+
+// Update records with where clause
+func (s *Session) Update(value interface{}) (int64, error) {
+	s.clause.Set(clause.UPDATE, s.guessTableName(value))
+	sql, vars := s.clause.Build(clause.UPDATE, clause.SET, clause.WHERE)
+	result, err := s.Raw(sql, vars...).Exec()
+	if err != nil {
+		return 0, err
+	}
+	return result.RowsAffected()
+}
+
+// Delete records with where clause
+func (s *Session) Delete(value interface{}) (int64, error) {
+	s.clause.Set(clause.DELETE, s.guessTableName(value))
+	sql, vars := s.clause.Build(clause.DELETE, clause.WHERE)
+	result, err := s.Raw(sql, vars...).Exec()
+	if err != nil {
+		return 0, err
+	}
+	return result.RowsAffected()
+}
+
+// Count records with where clause
+func (s *Session) Count(value interface{}) (int64, error) {
+	s.clause.Set(clause.COUNT, s.guessTableName(value))
+	sql, vars := s.clause.Build(clause.COUNT, clause.WHERE)
+	row := s.Raw(sql, vars...).QueryRow()
+	var tmp int64
+
+	if err := row.Scan(&tmp); err != nil {
+		return 0, err
+	}
+	return tmp, nil
+}
diff --git a/gee-orm/day5-update-delete/session/record_test.go b/gee-orm/day5-update-delete/session/record_test.go
new file mode 100644
index 0000000..3489287
--- /dev/null
+++ b/gee-orm/day5-update-delete/session/record_test.go
@@ -0,0 +1,96 @@
+package session
+
+import "testing"
+
+var (
+	user1 = &User{"Tom", 18}
+	user2 = &User{"Sam", 25}
+	user3 = &User{"Jack", 25}
+)
+
+func testRecordInit(t *testing.T) {
+	t.Helper()
+	err1 := NewSession().DropTable(&User{})
+	err2 := NewSession().CreateTable(&User{})
+	_, err3 := NewSession().Create(user1, user2)
+	if err1 != nil || err2 != nil || err3 != nil {
+		t.Fatal("failed init test records")
+	}
+
+}
+
+func TestSession_Create(t *testing.T) {
+	testRecordInit(t)
+	affected, err := NewSession().Create(user3)
+	if err != nil || affected != 1 {
+		t.Fatal("failed to create record")
+	}
+}
+
+func TestSession_Find(t *testing.T) {
+	testRecordInit(t)
+	users := []User{}
+	if err := NewSession().Find(&users); err != nil || len(users) != 2 {
+		t.Fatal("failed to query all")
+	}
+}
+
+func TestSession_First(t *testing.T) {
+	testRecordInit(t)
+	u := &User{}
+	err := NewSession().First(u)
+	if err != nil || u.Name != "Tom" || u.Age != 18 {
+		t.Fatal("failed to query first")
+	}
+}
+
+func TestSession_Limit(t *testing.T) {
+	testRecordInit(t)
+	var users []User
+	err := NewSession().Limit(1).Find(&users)
+	if err != nil || len(users) != 1 {
+		t.Fatal("failed to query with limit condition")
+	}
+}
+
+func TestSession_Where(t *testing.T) {
+	testRecordInit(t)
+	var users []User
+	_, err1 := NewSession().Create(user3)
+	err2 := NewSession().Where("Age = ?", 25).Find(&users)
+
+	if err1 != nil || err2 != nil || len(users) != 2 {
+		t.Fatal("failed to query with where condition")
+	}
+}
+
+func TestSession_OrderBy(t *testing.T) {
+	testRecordInit(t)
+	u := &User{}
+	err := NewSession().OrderBy("Age DESC").First(u)
+
+	if err != nil || u.Age != 25 {
+		t.Fatal("failed to query with order by condition")
+	}
+}
+
+func TestSession_Update(t *testing.T) {
+	testRecordInit(t)
+	affected, _ := NewSession().Where("Name = ?", "Tom").Set("Age", 30).Update(&User{})
+	u := &User{}
+	_ = NewSession().OrderBy("Age DESC").First(u)
+
+	if affected != 1 || u.Age != 30 {
+		t.Fatal("failed to update")
+	}
+}
+
+func TestSession_DeleteAndCount(t *testing.T) {
+	testRecordInit(t)
+	affected, _ := NewSession().Where("Name = ?", "Tom").Delete("User")
+	count, _ := NewSession().Count("User")
+
+	if affected != 1 || count != 1 {
+		t.Fatal("failed to delete or count")
+	}
+}
diff --git a/gee-orm/day5-update-delete/session/table.go b/gee-orm/day5-update-delete/session/table.go
new file mode 100644
index 0000000..b644d3a
--- /dev/null
+++ b/gee-orm/day5-update-delete/session/table.go
@@ -0,0 +1,59 @@
+package session
+
+import (
+	"fmt"
+	"strings"
+
+	"geeorm/schema"
+)
+
+// RefTable returns a Schema instance that contains all parsed fields
+func (s *Session) RefTable(value interface{}) *schema.Schema {
+	if value == nil {
+		panic("value is nil")
+	}
+	if s.refTable == nil {
+		s.refTable = schema.Parse(value, s.dialect)
+	}
+	return s.refTable
+}
+
+// CreateTable create a table in database with a model
+func (s *Session) CreateTable(value interface{}) error {
+	table := s.RefTable(value)
+	var columns []string
+	for _, field := range table.Fields {
+		tag := field.Tag
+		if field.Name == table.PrimaryField.Name {
+			tag += " PRIMARY KEY"
+		}
+		columns = append(columns, fmt.Sprintf("%s %s", field.Name, tag))
+	}
+	desc := strings.Join(columns, ",")
+	_, err := s.Raw(fmt.Sprintf("CREATE TABLE %s (%s);", table.TableName, desc)).Exec()
+	return err
+}
+
+// DropTable drops a table with the name of model
+func (s *Session) DropTable(value interface{}) error {
+	table := s.RefTable(value)
+	_, err := s.Raw(fmt.Sprintf("DROP TABLE IF EXISTS %s", table.TableName)).Exec()
+	return err
+}
+
+func (s *Session) guessTableName(value interface{}) string {
+	if tableName, ok := value.(string); ok {
+		return tableName
+	}
+	return s.RefTable(value).TableName
+}
+
+// HasTable returns true of the table exists
+func (s *Session) HasTable(value interface{}) bool {
+	tableName := s.guessTableName(value)
+	sql, values := s.dialect.TableExistSQL(tableName)
+	row := s.Raw(sql, values...).QueryRow()
+	var tmp string
+	_ = row.Scan(&tmp)
+	return tmp == tableName
+}
diff --git a/gee-orm/day5-update-delete/session/table_test.go b/gee-orm/day5-update-delete/session/table_test.go
new file mode 100644
index 0000000..5c934fa
--- /dev/null
+++ b/gee-orm/day5-update-delete/session/table_test.go
@@ -0,0 +1,18 @@
+package session
+
+import (
+	"testing"
+)
+
+type User struct {
+	Name string `geeorm:"primary_key"`
+	Age  int
+}
+
+func TestSession_CreateTable(t *testing.T) {
+	_ = NewSession().DropTable(&User{})
+	_ = NewSession().CreateTable(&User{})
+	if !NewSession().HasTable("User") {
+		t.Fatal("failed to create table User")
+	}
+}

From 53190e5d6a9f1de06d8e80663c6cf429d6959920 Mon Sep 17 00:00:00 2001
From: gzdaijie <gzdaijie@163.com>
Date: Wed, 26 Feb 2020 22:16:13 +0800
Subject: [PATCH 047/122] add day6 transaction

---
 gee-orm/day6-transaction/clause/clause.go     |  52 +++++++
 .../day6-transaction/clause/clause_test.go    |  76 ++++++++++
 gee-orm/day6-transaction/clause/generator.go  | 106 ++++++++++++++
 gee-orm/day6-transaction/dialect/dialect.go   |  22 +++
 gee-orm/day6-transaction/dialect/sqlite3.go   |  45 ++++++
 .../day6-transaction/dialect/sqlite3_test.go  |  25 ++++
 gee-orm/day6-transaction/geeorm.go            |  75 ++++++++++
 gee-orm/day6-transaction/geeorm_test.go       |  71 ++++++++++
 gee-orm/day6-transaction/go.mod               |   5 +
 gee-orm/day6-transaction/log/log.go           |  47 +++++++
 gee-orm/day6-transaction/log/log_test.go      |  17 +++
 gee-orm/day6-transaction/schema/schema.go     |  67 +++++++++
 .../day6-transaction/schema/schema_test.go    |  36 +++++
 gee-orm/day6-transaction/session/raw.go       |  88 ++++++++++++
 gee-orm/day6-transaction/session/raw_test.go  |  46 +++++++
 gee-orm/day6-transaction/session/record.go    | 130 ++++++++++++++++++
 .../day6-transaction/session/record_test.go   |  96 +++++++++++++
 gee-orm/day6-transaction/session/table.go     |  59 ++++++++
 .../day6-transaction/session/table_test.go    |  18 +++
 .../day6-transaction/session/transaction.go   |  31 +++++
 20 files changed, 1112 insertions(+)
 create mode 100644 gee-orm/day6-transaction/clause/clause.go
 create mode 100644 gee-orm/day6-transaction/clause/clause_test.go
 create mode 100644 gee-orm/day6-transaction/clause/generator.go
 create mode 100644 gee-orm/day6-transaction/dialect/dialect.go
 create mode 100644 gee-orm/day6-transaction/dialect/sqlite3.go
 create mode 100644 gee-orm/day6-transaction/dialect/sqlite3_test.go
 create mode 100644 gee-orm/day6-transaction/geeorm.go
 create mode 100644 gee-orm/day6-transaction/geeorm_test.go
 create mode 100644 gee-orm/day6-transaction/go.mod
 create mode 100644 gee-orm/day6-transaction/log/log.go
 create mode 100644 gee-orm/day6-transaction/log/log_test.go
 create mode 100644 gee-orm/day6-transaction/schema/schema.go
 create mode 100644 gee-orm/day6-transaction/schema/schema_test.go
 create mode 100644 gee-orm/day6-transaction/session/raw.go
 create mode 100644 gee-orm/day6-transaction/session/raw_test.go
 create mode 100644 gee-orm/day6-transaction/session/record.go
 create mode 100644 gee-orm/day6-transaction/session/record_test.go
 create mode 100644 gee-orm/day6-transaction/session/table.go
 create mode 100644 gee-orm/day6-transaction/session/table_test.go
 create mode 100644 gee-orm/day6-transaction/session/transaction.go

diff --git a/gee-orm/day6-transaction/clause/clause.go b/gee-orm/day6-transaction/clause/clause.go
new file mode 100644
index 0000000..2195c86
--- /dev/null
+++ b/gee-orm/day6-transaction/clause/clause.go
@@ -0,0 +1,52 @@
+package clause
+
+import (
+	"strings"
+)
+
+// Clause contains SQL conditions
+type Clause struct {
+	sql     map[Type]string
+	sqlVars map[Type][]interface{}
+}
+
+// Type is the type of Clause
+type Type int
+
+// Support types for Clause
+const (
+	INSERT Type = iota
+	VALUES
+	SELECT
+	LIMIT
+	WHERE
+	ORDERBY
+	UPDATE
+	SET
+	DELETE
+	COUNT
+)
+
+// Set adds a sub clause of specific type
+func (c *Clause) Set(name Type, vars ...interface{}) {
+	if c.sql == nil {
+		c.sql = make(map[Type]string)
+		c.sqlVars = make(map[Type][]interface{})
+	}
+	sql, vars := generators[name](vars...)
+	c.sql[name] = sql
+	c.sqlVars[name] = vars
+}
+
+// Build generate the final SQL and SQLVars
+func (c *Clause) Build(orders ...Type) (string, []interface{}) {
+	var sqls []string
+	var vars []interface{}
+	for _, order := range orders {
+		if sql, ok := c.sql[order]; ok {
+			sqls = append(sqls, sql)
+			vars = append(vars, c.sqlVars[order]...)
+		}
+	}
+	return strings.Join(sqls, " "), vars
+}
diff --git a/gee-orm/day6-transaction/clause/clause_test.go b/gee-orm/day6-transaction/clause/clause_test.go
new file mode 100644
index 0000000..8769c40
--- /dev/null
+++ b/gee-orm/day6-transaction/clause/clause_test.go
@@ -0,0 +1,76 @@
+package clause
+
+import (
+	"reflect"
+	"testing"
+)
+
+func TestClause_Set(t *testing.T) {
+	var clause Clause
+	clause.Set(INSERT, "User", []string{"Name", "Age"})
+	sql := clause.sql[INSERT]
+	vars := clause.sqlVars[INSERT]
+	t.Log(sql, vars)
+	if sql != "INSERT INTO User (Name,Age)" || len(vars) != 0 {
+		t.Fatal("failed to get clause")
+	}
+}
+
+func testSelect(t *testing.T) {
+	var clause Clause
+	clause.Set(LIMIT, 3)
+	clause.Set(SELECT, "User", []string{"*"})
+	clause.Set(WHERE, "Name = ?", "Tom")
+	clause.Set(ORDERBY, "Age ASC")
+	sql, vars := clause.Build(SELECT, WHERE, ORDERBY, LIMIT)
+	t.Log(sql, vars)
+	if sql != "SELECT * FROM User WHERE Name = ? ORDER BY Age ASC LIMIT ?" {
+		t.Fatal("failed to build SQL")
+	}
+	if !reflect.DeepEqual(vars, []interface{}{"Tom", 3}) {
+		t.Fatal("failed to build SQLVars")
+	}
+}
+
+func testUpdate(t *testing.T) {
+	var clause Clause
+	clause.Set(UPDATE, "User")
+	clause.Set(WHERE, "Name = ?", "Tom")
+	clause.Set(SET, map[string]interface{}{"Age": 30, "Name": "Tommy"})
+
+	sql, vars := clause.Build(UPDATE, SET, WHERE)
+	t.Log(sql, vars)
+	if sql != "UPDATE User SET Age = ?, Name = ? WHERE Name = ?" {
+		t.Fatal("failed to build SQL")
+	}
+	if !reflect.DeepEqual(vars, []interface{}{30, "Tommy", "Tom"}) {
+		t.Fatal("failed to build SQLVars")
+	}
+}
+
+func testDelete(t *testing.T) {
+	var clause Clause
+	clause.Set(DELETE, "User")
+	clause.Set(WHERE, "Name = ?", "Tom")
+
+	sql, vars := clause.Build(DELETE, WHERE)
+	t.Log(sql, vars)
+	if sql != "DELETE FROM User WHERE Name = ?" {
+		t.Fatal("failed to build SQL")
+	}
+	if !reflect.DeepEqual(vars, []interface{}{"Tom"}) {
+		t.Fatal("failed to build SQLVars")
+	}
+}
+
+func TestClause_Build(t *testing.T) {
+	t.Run("select", func(t *testing.T) {
+		testSelect(t)
+	})
+	t.Run("update", func(t *testing.T) {
+		testUpdate(t)
+	})
+	t.Run("delete", func(t *testing.T) {
+		testDelete(t)
+	})
+}
diff --git a/gee-orm/day6-transaction/clause/generator.go b/gee-orm/day6-transaction/clause/generator.go
new file mode 100644
index 0000000..1cf5aec
--- /dev/null
+++ b/gee-orm/day6-transaction/clause/generator.go
@@ -0,0 +1,106 @@
+package clause
+
+import (
+	"fmt"
+	"strings"
+)
+
+type generator func(values ...interface{}) (string, []interface{})
+
+var generators map[Type]generator
+
+func init() {
+	generators = make(map[Type]generator)
+	generators[INSERT] = _insert
+	generators[VALUES] = _values
+	generators[SELECT] = _select
+	generators[LIMIT] = _limit
+	generators[WHERE] = _where
+	generators[ORDERBY] = _orderby
+	generators[UPDATE] = _update
+	generators[SET] = _set
+	generators[DELETE] = _delete
+	generators[COUNT] = _count
+}
+
+func genBindVars(num int) string {
+	var vars []string
+	for i := 0; i < num; i++ {
+		vars = append(vars, "?")
+	}
+	return strings.Join(vars, ", ")
+}
+
+func _insert(values ...interface{}) (string, []interface{}) {
+	// INSERT INTO $tableName ($fields)
+	tableName := values[0]
+	fields := strings.Join(values[1].([]string), ",")
+	return fmt.Sprintf("INSERT INTO %s (%v)", tableName, fields), []interface{}{}
+}
+
+func _values(values ...interface{}) (string, []interface{}) {
+	// VALUES ($v1), (&v2), ...
+	var bindStr string
+	var sql strings.Builder
+	var vars []interface{}
+	sql.WriteString("VALUES ")
+	for i, value := range values {
+		v := value.([]interface{})
+		if bindStr == "" {
+			bindStr = genBindVars(len(v))
+		}
+		sql.WriteString(fmt.Sprintf("(%v)", bindStr))
+		if i+1 != len(values) {
+			sql.WriteString(", ")
+		}
+		vars = append(vars, v...)
+	}
+	return sql.String(), vars
+
+}
+
+func _select(values ...interface{}) (string, []interface{}) {
+	// SELECT $fields FROM $tableName
+	tableName := values[0]
+	fields := strings.Join(values[1].([]string), ",")
+	return fmt.Sprintf("SELECT %v FROM %s", fields, tableName), []interface{}{}
+}
+
+func _limit(values ...interface{}) (string, []interface{}) {
+	// LIMIT $num
+	return "LIMIT ?", values
+}
+
+func _where(values ...interface{}) (string, []interface{}) {
+	// WHERE $desc
+	desc, vars := values[0], values[1:]
+	return fmt.Sprintf("WHERE %s", desc), vars
+}
+
+func _orderby(values ...interface{}) (string, []interface{}) {
+	return fmt.Sprintf("ORDER BY %s", values[0]), []interface{}{}
+}
+
+func _update(values ...interface{}) (string, []interface{}) {
+	return fmt.Sprintf("UPDATE %s", values[0]), []interface{}{}
+}
+
+func _set(values ...interface{}) (string, []interface{}) {
+	m := values[0].(map[string]interface{})
+	var keys []string
+	var vars []interface{}
+	for k, v := range m {
+		keys = append(keys, k+" = ?")
+		vars = append(vars, v)
+	}
+
+	return fmt.Sprintf("SET %s", strings.Join(keys, ", ")), vars
+}
+
+func _delete(values ...interface{}) (string, []interface{}) {
+	return fmt.Sprintf("DELETE FROM %s", values[0]), []interface{}{}
+}
+
+func _count(values ...interface{}) (string, []interface{}) {
+	return _select(values[0], []string{"count(*)"})
+}
diff --git a/gee-orm/day6-transaction/dialect/dialect.go b/gee-orm/day6-transaction/dialect/dialect.go
new file mode 100644
index 0000000..4696314
--- /dev/null
+++ b/gee-orm/day6-transaction/dialect/dialect.go
@@ -0,0 +1,22 @@
+package dialect
+
+import "reflect"
+
+var dialectsMap = map[string]Dialect{}
+
+// Dialect is an interface contains methods that a dialect has to implement
+type Dialect interface {
+	DataTypeOf(typ reflect.Value) string
+	TableExistSQL(tableName string) (string, []interface{})
+}
+
+// RegisterDialect register a dialect to the global variable
+func RegisterDialect(name string, dialect Dialect) {
+	dialectsMap[name] = dialect
+}
+
+// Get the dialect from global variable if it exists
+func GetDialect(name string) (dialect Dialect, ok bool) {
+	dialect, ok = dialectsMap[name]
+	return
+}
diff --git a/gee-orm/day6-transaction/dialect/sqlite3.go b/gee-orm/day6-transaction/dialect/sqlite3.go
new file mode 100644
index 0000000..f3c3897
--- /dev/null
+++ b/gee-orm/day6-transaction/dialect/sqlite3.go
@@ -0,0 +1,45 @@
+package dialect
+
+import (
+	"fmt"
+	"reflect"
+	"time"
+)
+
+type sqlite3 struct{}
+
+var _ Dialect = (*sqlite3)(nil)
+
+func init() {
+	RegisterDialect("sqlite3", &sqlite3{})
+}
+
+// Get Data Type for sqlite3 Dialect
+func (s *sqlite3) DataTypeOf(typ reflect.Value) string {
+	switch typ.Kind() {
+	case reflect.Bool:
+		return "bool"
+	case reflect.Int, reflect.Int8, reflect.Int16, reflect.Int32,
+		reflect.Uint, reflect.Uint8, reflect.Uint16, reflect.Uint32, reflect.Uintptr:
+		return "integer"
+	case reflect.Int64, reflect.Uint64:
+		return "bigint"
+	case reflect.Float32, reflect.Float64:
+		return "real"
+	case reflect.String:
+		return "text"
+	case reflect.Array, reflect.Slice:
+		return "blob"
+	case reflect.Struct:
+		if _, ok := typ.Interface().(time.Time); ok {
+			return "datetime"
+		}
+	}
+	panic(fmt.Sprintf("invalid sql type %s (%s)", typ.Type().Name(), typ.Kind()))
+}
+
+// TableExistSQL returns SQL that judge whether the table exists in database
+func (s *sqlite3) TableExistSQL(tableName string) (string, []interface{}) {
+	args := []interface{}{tableName}
+	return "SELECT name FROM sqlite_master WHERE type='table' and name = ?", args
+}
diff --git a/gee-orm/day6-transaction/dialect/sqlite3_test.go b/gee-orm/day6-transaction/dialect/sqlite3_test.go
new file mode 100644
index 0000000..3df5f07
--- /dev/null
+++ b/gee-orm/day6-transaction/dialect/sqlite3_test.go
@@ -0,0 +1,25 @@
+package dialect
+
+import (
+	"reflect"
+	"testing"
+)
+
+func TestDataTypeOf(t *testing.T) {
+	dial := &sqlite3{}
+	cases := []struct {
+		Value interface{}
+		Type  string
+	}{
+		{"Tom", "text"},
+		{123, "integer"},
+		{1.2, "real"},
+		{[]int{1, 2, 3}, "blob"},
+	}
+
+	for _, c := range cases {
+		if typ := dial.DataTypeOf(reflect.ValueOf(c.Value)); typ != c.Type {
+			t.Fatalf("expect %s, but got %s", c.Type, typ)
+		}
+	}
+}
diff --git a/gee-orm/day6-transaction/geeorm.go b/gee-orm/day6-transaction/geeorm.go
new file mode 100644
index 0000000..b8cbb42
--- /dev/null
+++ b/gee-orm/day6-transaction/geeorm.go
@@ -0,0 +1,75 @@
+package geeorm
+
+import (
+	"database/sql"
+	"geeorm/dialect"
+	"geeorm/log"
+	"geeorm/session"
+)
+
+// Engine is the main struct of geeorm, manages all db sessions and transactions.
+type Engine struct {
+	db      *sql.DB
+	dialect dialect.Dialect
+}
+
+// NewEngine create a instance of Engine
+// connect database and ping it to test whether it's alive
+func NewEngine(driver, source string) (e *Engine, err error) {
+	db, err := sql.Open(driver, source)
+	if err != nil {
+		log.Error(err)
+		return
+	}
+	// Send a ping to make sure the database connection is alive.
+	if err = db.Ping(); err != nil {
+		log.Error(err)
+		return
+	}
+	// make sure the specific dialect exists
+	dial, ok := dialect.GetDialect(driver)
+	if !ok {
+		log.Errorf("dialect %s Not Found", driver)
+		return
+	}
+	e = &Engine{db: db, dialect: dial}
+	log.Info("Connect database success")
+	return
+}
+
+// Close database connection
+func (e *Engine) Close() (err error) {
+	if err = e.db.Close(); err == nil {
+		log.Info("Close database success")
+	}
+	return
+}
+
+// NewSession creates a new session for next operations
+func (e *Engine) NewSession() *session.Session {
+	return session.New(e.db, e.dialect)
+}
+
+// TxFunc will be called between tx.Begin() and tx.Commit()
+// https://stackoverflow.com/questions/16184238/database-sql-tx-detecting-commit-or-rollback
+type TxFunc func(*session.Session) (interface{}, error)
+
+// Transaction executes sql wrapped in a transaction, then automatically commit if no error occurs
+func (e *Engine) Transaction(f TxFunc) (result interface{}, err error) {
+	s := e.NewSession()
+	if err := s.Begin(); err != nil {
+		return nil, err
+	}
+	defer func() {
+		if p := recover(); p != nil {
+			_ = s.Rollback()
+			panic(p) // re-throw panic after Rollback
+		} else if err != nil {
+			_ = s.Rollback() // err is non-nil; don't change it
+		} else {
+			err = s.Commit() // err is nil; if Commit returns error update err
+		}
+	}()
+
+	return f(s)
+}
diff --git a/gee-orm/day6-transaction/geeorm_test.go b/gee-orm/day6-transaction/geeorm_test.go
new file mode 100644
index 0000000..7b15616
--- /dev/null
+++ b/gee-orm/day6-transaction/geeorm_test.go
@@ -0,0 +1,71 @@
+package geeorm
+
+import (
+	"errors"
+	"geeorm/session"
+	"testing"
+
+	_ "github.com/mattn/go-sqlite3"
+)
+
+func OpenDB(t *testing.T) *Engine {
+	t.Helper()
+	engine, err := NewEngine("sqlite3", "gee.db")
+	if err != nil {
+		t.Fatal("failed to connect", err)
+	}
+	return engine
+}
+
+func CloseDB(engine *Engine) {
+	_ = engine.Close()
+}
+
+func TestNewEngine(t *testing.T) {
+	engine := OpenDB(t)
+	_ = engine.Close()
+}
+
+type User struct {
+	Name string `geeorm:"primary_key"`
+	Age  int
+}
+
+func transactionRollback(t *testing.T) {
+	engine := OpenDB(t)
+	defer CloseDB(engine)
+	_ = engine.NewSession().DropTable(&User{})
+	_, err := engine.Transaction(func(s *session.Session) (result interface{}, err error) {
+		_ = s.CreateTable(&User{})
+		_, err = s.Create(&User{"Tom", 18})
+		return nil, errors.New("Error")
+	})
+	if err == nil || engine.NewSession().HasTable("User") {
+		t.Fatal("failed to rollback")
+	}
+}
+
+func transactionCommit(t *testing.T) {
+	engine := OpenDB(t)
+	defer CloseDB(engine)
+	_ = engine.NewSession().DropTable(&User{})
+	_, err := engine.Transaction(func(s *session.Session) (result interface{}, err error) {
+		err = s.CreateTable(&User{})
+		_, err = s.Create(&User{"Tom", 18})
+		return
+	})
+	u := &User{}
+	_ = engine.NewSession().First(u)
+	if err != nil || u.Name != "Tom" {
+		t.Fatal("failed to commit")
+	}
+}
+
+func TestEngine_Transaction(t *testing.T) {
+	t.Run("rollback", func(t *testing.T) {
+		transactionRollback(t)
+	})
+	t.Run("commit", func(t *testing.T) {
+		transactionCommit(t)
+	})
+}
diff --git a/gee-orm/day6-transaction/go.mod b/gee-orm/day6-transaction/go.mod
new file mode 100644
index 0000000..043b1c6
--- /dev/null
+++ b/gee-orm/day6-transaction/go.mod
@@ -0,0 +1,5 @@
+module geeorm
+
+go 1.13
+
+require github.com/mattn/go-sqlite3 v2.0.3+incompatible
diff --git a/gee-orm/day6-transaction/log/log.go b/gee-orm/day6-transaction/log/log.go
new file mode 100644
index 0000000..eacc0c6
--- /dev/null
+++ b/gee-orm/day6-transaction/log/log.go
@@ -0,0 +1,47 @@
+package log
+
+import (
+	"io/ioutil"
+	"log"
+	"os"
+	"sync"
+)
+
+var (
+	errorLog = log.New(os.Stdout, "\033[31m[error]\033[0m ", log.LstdFlags|log.Lshortfile)
+	infoLog  = log.New(os.Stdout, "\033[34m[info ]\033[0m ", log.LstdFlags|log.Lshortfile)
+	loggers  = []*log.Logger{errorLog, infoLog}
+	mu       sync.Mutex
+)
+
+// log methods
+var (
+	Error  = errorLog.Println
+	Errorf = errorLog.Printf
+	Info   = infoLog.Println
+	Infof  = infoLog.Printf
+)
+
+// log levels
+const (
+	InfoLevel = iota
+	ErrorLevel
+	Disabled
+)
+
+// SetLevel controls log level
+func SetLevel(level int) {
+	mu.Lock()
+	defer mu.Unlock()
+
+	for _, logger := range loggers {
+		logger.SetOutput(os.Stdout)
+	}
+
+	if ErrorLevel < level {
+		errorLog.SetOutput(ioutil.Discard)
+	}
+	if InfoLevel < level {
+		infoLog.SetOutput(ioutil.Discard)
+	}
+}
diff --git a/gee-orm/day6-transaction/log/log_test.go b/gee-orm/day6-transaction/log/log_test.go
new file mode 100644
index 0000000..8cd403c
--- /dev/null
+++ b/gee-orm/day6-transaction/log/log_test.go
@@ -0,0 +1,17 @@
+package log
+
+import (
+	"os"
+	"testing"
+)
+
+func TestSetLevel(t *testing.T) {
+	SetLevel(ErrorLevel)
+	if infoLog.Writer() == os.Stdout || errorLog.Writer() != os.Stdout {
+		t.Fatal("failed to set log level")
+	}
+	SetLevel(Disabled)
+	if infoLog.Writer() == os.Stdout || errorLog.Writer() == os.Stdout {
+		t.Fatal("failed to set log level")
+	}
+}
\ No newline at end of file
diff --git a/gee-orm/day6-transaction/schema/schema.go b/gee-orm/day6-transaction/schema/schema.go
new file mode 100644
index 0000000..8519fd4
--- /dev/null
+++ b/gee-orm/day6-transaction/schema/schema.go
@@ -0,0 +1,67 @@
+package schema
+
+import (
+	"fmt"
+	"geeorm/dialect"
+	"go/ast"
+	"reflect"
+)
+
+// Field represents a column of database
+type Field struct {
+	Name string
+	Tag  string
+}
+
+// Schema represents a table of database
+type Schema struct {
+	TableName    string
+	PrimaryField *Field
+	Fields       []*Field
+	FieldNames   []string
+}
+
+// Values return the values of dest's member variables
+func (schema *Schema) Values(dest interface{}) []interface{} {
+	destValue := reflect.Indirect(reflect.ValueOf(dest))
+	var fieldValues []interface{}
+	for _, field := range schema.Fields {
+		fieldValues = append(fieldValues, destValue.FieldByName(field.Name).Interface())
+	}
+	return fieldValues
+}
+
+// Parse a struct to a Schema instance
+func Parse(dest interface{}, d dialect.Dialect) *Schema {
+	modelType := reflect.Indirect(reflect.ValueOf(dest)).Type()
+	schema := &Schema{
+		TableName:    modelType.Name(),
+		PrimaryField: &Field{Name: "ID", Tag: ""},
+	}
+
+	for i := 0; i < modelType.NumField(); i++ {
+		p := modelType.Field(i)
+		if !p.Anonymous && ast.IsExported(p.Name) {
+			field := &Field{
+				Name: p.Name,
+				Tag:  d.DataTypeOf(reflect.Indirect(reflect.New(p.Type))),
+			}
+			if v, ok := p.Tag.Lookup("geeorm"); ok && v == "primary_key" {
+				schema.PrimaryField = field
+			}
+			schema.Fields = append(schema.Fields, field)
+			schema.FieldNames = append(schema.FieldNames, p.Name)
+		}
+	}
+	return schema
+}
+
+// String returns readable string
+func (field *Field) String() string {
+	return fmt.Sprintf("(%s %s)", field.Name, field.Tag)
+}
+
+// String returns readable string
+func (schema *Schema) String() string {
+	return fmt.Sprintf("TABLE %s %v", schema.TableName, schema.Fields)
+}
diff --git a/gee-orm/day6-transaction/schema/schema_test.go b/gee-orm/day6-transaction/schema/schema_test.go
new file mode 100644
index 0000000..aba3e0b
--- /dev/null
+++ b/gee-orm/day6-transaction/schema/schema_test.go
@@ -0,0 +1,36 @@
+package schema
+
+import (
+	"geeorm/dialect"
+	"testing"
+)
+
+type User struct {
+	Name string `geeorm:"primary_key"`
+	Age  int
+}
+
+var TestDial, _ = dialect.GetDialect("sqlite3")
+
+func TestParse(t *testing.T) {
+	schema := Parse(&User{}, TestDial)
+	if schema.TableName != "User" || len(schema.Fields) != 2 {
+		t.Fatal("failed to parse User struct")
+	}
+	if schema.PrimaryField.Name != "Name" {
+		t.Fatal("failed to parse primary key")
+	}
+	t.Log(schema)
+}
+
+func TestSchema_Values(t *testing.T) {
+	schema := Parse(&User{}, TestDial)
+	values := schema.Values(&User{"Tom", 18})
+
+	name := values[0].(string)
+	age := values[1].(int)
+
+	if name != "Tom" || age != 18 {
+		t.Fatal("failed to get values")
+	}
+}
diff --git a/gee-orm/day6-transaction/session/raw.go b/gee-orm/day6-transaction/session/raw.go
new file mode 100644
index 0000000..d99f631
--- /dev/null
+++ b/gee-orm/day6-transaction/session/raw.go
@@ -0,0 +1,88 @@
+package session
+
+import (
+	"database/sql"
+	"geeorm/clause"
+	"geeorm/dialect"
+	"geeorm/log"
+	"geeorm/schema"
+)
+
+// Session keep a pointer to sql.DB and provides all execution of all
+// kind of database operations.
+type Session struct {
+	db       *sql.DB
+	dialect  dialect.Dialect
+	tx       *sql.Tx
+	refTable *schema.Schema
+	clause   clause.Clause
+	sql      string
+	sqlVars  []interface{}
+}
+
+// New creates a instance of Session
+func New(db *sql.DB, dialect dialect.Dialect) *Session {
+	return &Session{
+		db:      db,
+		dialect: dialect,
+	}
+}
+
+// Clear initialize the state of a session, except for isAutoCommit
+func (s *Session) Clear() {
+	s.refTable, s.sqlVars = nil, nil
+	s.clause = clause.Clause{}
+	s.sql = ""
+}
+
+// CommonDB is a minimal function set of db
+type CommonDB interface {
+	Query(query string, args ...interface{}) (*sql.Rows, error)
+	QueryRow(query string, args ...interface{}) *sql.Row
+	Exec(query string, args ...interface{}) (sql.Result, error)
+}
+
+var _ CommonDB = (*sql.DB)(nil)
+var _ CommonDB = (*sql.Tx)(nil)
+
+// DB returns tx if a tx begins. otherwise return *sql.DB
+func (s *Session) DB() CommonDB {
+	if s.tx != nil {
+		return s.tx
+	}
+	return s.db
+}
+
+// Exec raw sql with sqlVars
+func (s *Session) Exec() (result sql.Result, err error) {
+	defer s.Clear()
+	log.Info(s.sql, s.sqlVars)
+	if result, err = s.DB().Exec(s.sql, s.sqlVars...); err != nil {
+		log.Error(err)
+	}
+	return
+}
+
+// QueryRow gets a record from db
+func (s *Session) QueryRow() *sql.Row {
+	defer s.Clear()
+	log.Info(s.sql, s.sqlVars)
+	return s.DB().QueryRow(s.sql, s.sqlVars...)
+}
+
+// QueryRows gets a list of records from db
+func (s *Session) QueryRows() (rows *sql.Rows, err error) {
+	defer s.Clear()
+	log.Info(s.sql, s.sqlVars)
+	if rows, err = s.DB().Query(s.sql, s.sqlVars...); err != nil {
+		log.Error(err)
+	}
+	return
+}
+
+// Raw appends sql and sqlVars
+func (s *Session) Raw(sql string, values ...interface{}) *Session {
+	s.sql += sql
+	s.sqlVars = append(s.sqlVars, values...)
+	return s
+}
diff --git a/gee-orm/day6-transaction/session/raw_test.go b/gee-orm/day6-transaction/session/raw_test.go
new file mode 100644
index 0000000..ce1e75b
--- /dev/null
+++ b/gee-orm/day6-transaction/session/raw_test.go
@@ -0,0 +1,46 @@
+package session
+
+import (
+	"database/sql"
+	"os"
+	"testing"
+
+	"geeorm/dialect"
+
+	_ "github.com/mattn/go-sqlite3"
+)
+
+var (
+	TestDB      *sql.DB
+	TestDial, _ = dialect.GetDialect("sqlite3")
+)
+
+func TestMain(m *testing.M) {
+	TestDB, _ = sql.Open("sqlite3", "gee.db")
+	code := m.Run()
+	_ = TestDB.Close()
+	os.Exit(code)
+}
+
+func NewSession() *Session {
+	return &Session{db: TestDB, dialect: TestDial}
+}
+
+func TestSession_Exec(t *testing.T) {
+	_, _ = NewSession().Raw("DROP TABLE IF EXISTS User;").Exec()
+	_, _ = NewSession().Raw("CREATE TABLE User(name text);").Exec()
+	result, _ := NewSession().Raw("INSERT INTO User(`name`) values (?), (?)", "Tom", "Sam").Exec()
+	if count, err := result.RowsAffected(); err != nil || count != 2 {
+		t.Fatal("expect 2, but got", count)
+	}
+}
+
+func TestSession_QueryRows(t *testing.T) {
+	_, _ = NewSession().Raw("DROP TABLE IF EXISTS User;").Exec()
+	_, _ = NewSession().Raw("CREATE TABLE User(name text);").Exec()
+	row := NewSession().Raw("SELECT count(*) FROM User").QueryRow()
+	var count int
+	if err := row.Scan(&count); err != nil || count != 0 {
+		t.Fatal("failed to query db", err)
+	}
+}
diff --git a/gee-orm/day6-transaction/session/record.go b/gee-orm/day6-transaction/session/record.go
new file mode 100644
index 0000000..bc6d1fe
--- /dev/null
+++ b/gee-orm/day6-transaction/session/record.go
@@ -0,0 +1,130 @@
+package session
+
+import (
+	"geeorm/clause"
+	"reflect"
+)
+
+// Create one or more records in database
+func (s *Session) Create(values ...interface{}) (int64, error) {
+	recordValues := make([]interface{}, 0)
+	for _, value := range values {
+		table := s.RefTable(value)
+		s.clause.Set(clause.INSERT, table.TableName, table.FieldNames)
+		recordValues = append(recordValues, table.Values(value))
+	}
+
+	s.clause.Set(clause.VALUES, recordValues...)
+	sql, vars := s.clause.Build(clause.INSERT, clause.VALUES)
+	result, err := s.Raw(sql, vars...).Exec()
+	if err != nil {
+		return 0, err
+	}
+
+	return result.RowsAffected()
+}
+
+// Find gets all eligible records
+func (s *Session) Find(values interface{}) error {
+	destSlice := reflect.Indirect(reflect.ValueOf(values))
+	destType := destSlice.Type().Elem()
+	table := s.RefTable(reflect.New(destType).Elem().Interface())
+
+	s.clause.Set(clause.SELECT, table.TableName, table.FieldNames)
+	sql, vars := s.clause.Build(clause.SELECT, clause.WHERE, clause.ORDERBY, clause.LIMIT)
+	rows, err := s.Raw(sql, vars...).QueryRows()
+	if err != nil {
+		return err
+	}
+
+	for rows.Next() {
+		dest := reflect.New(destType).Elem()
+		var values []interface{}
+		for _, name := range table.FieldNames {
+			values = append(values, dest.FieldByName(name).Addr().Interface())
+		}
+		if err := rows.Scan(values...); err != nil {
+			return err
+		}
+		destSlice.Set(reflect.Append(destSlice, dest))
+	}
+	return rows.Close()
+}
+
+// First gets the 1st row
+func (s *Session) First(value interface{}) error {
+	dest := reflect.Indirect(reflect.ValueOf(value))
+	destSlice := reflect.New(reflect.SliceOf(dest.Type())).Elem()
+	err := s.Limit(1).Find(destSlice.Addr().Interface())
+	dest.Set(destSlice.Index(0))
+	return err
+}
+
+// Limit adds limit condition to clause
+func (s *Session) Limit(num int) *Session {
+	s.clause.Set(clause.LIMIT, num)
+	return s
+}
+
+// Where adds limit condition to clause
+func (s *Session) Where(desc string, args ...interface{}) *Session {
+	var vars []interface{}
+	s.clause.Set(clause.WHERE, append(append(vars, desc), args...)...)
+	return s
+}
+
+// OrderBy adds order by condition to clause
+func (s *Session) OrderBy(desc string) *Session {
+	s.clause.Set(clause.ORDERBY, desc)
+	return s
+}
+
+// Set adds Assignment by condition to clause
+// support map[string]interface{}
+// also support "Name", "Tom", "Age", 18, etc
+func (s *Session) Set(values ...interface{}) *Session {
+	m, ok := values[0].(map[string]interface{})
+	if !ok {
+		m = make(map[string]interface{})
+		for i := 0; i < len(values); i += 2 {
+			m[values[i].(string)] = values[i+1]
+		}
+	}
+	s.clause.Set(clause.SET, m)
+	return s
+}
+
+// Update records with where clause
+func (s *Session) Update(value interface{}) (int64, error) {
+	s.clause.Set(clause.UPDATE, s.guessTableName(value))
+	sql, vars := s.clause.Build(clause.UPDATE, clause.SET, clause.WHERE)
+	result, err := s.Raw(sql, vars...).Exec()
+	if err != nil {
+		return 0, err
+	}
+	return result.RowsAffected()
+}
+
+// Delete records with where clause
+func (s *Session) Delete(value interface{}) (int64, error) {
+	s.clause.Set(clause.DELETE, s.guessTableName(value))
+	sql, vars := s.clause.Build(clause.DELETE, clause.WHERE)
+	result, err := s.Raw(sql, vars...).Exec()
+	if err != nil {
+		return 0, err
+	}
+	return result.RowsAffected()
+}
+
+// Count records with where clause
+func (s *Session) Count(value interface{}) (int64, error) {
+	s.clause.Set(clause.COUNT, s.guessTableName(value))
+	sql, vars := s.clause.Build(clause.COUNT, clause.WHERE)
+	row := s.Raw(sql, vars...).QueryRow()
+	var tmp int64
+
+	if err := row.Scan(&tmp); err != nil {
+		return 0, err
+	}
+	return tmp, nil
+}
diff --git a/gee-orm/day6-transaction/session/record_test.go b/gee-orm/day6-transaction/session/record_test.go
new file mode 100644
index 0000000..3489287
--- /dev/null
+++ b/gee-orm/day6-transaction/session/record_test.go
@@ -0,0 +1,96 @@
+package session
+
+import "testing"
+
+var (
+	user1 = &User{"Tom", 18}
+	user2 = &User{"Sam", 25}
+	user3 = &User{"Jack", 25}
+)
+
+func testRecordInit(t *testing.T) {
+	t.Helper()
+	err1 := NewSession().DropTable(&User{})
+	err2 := NewSession().CreateTable(&User{})
+	_, err3 := NewSession().Create(user1, user2)
+	if err1 != nil || err2 != nil || err3 != nil {
+		t.Fatal("failed init test records")
+	}
+
+}
+
+func TestSession_Create(t *testing.T) {
+	testRecordInit(t)
+	affected, err := NewSession().Create(user3)
+	if err != nil || affected != 1 {
+		t.Fatal("failed to create record")
+	}
+}
+
+func TestSession_Find(t *testing.T) {
+	testRecordInit(t)
+	users := []User{}
+	if err := NewSession().Find(&users); err != nil || len(users) != 2 {
+		t.Fatal("failed to query all")
+	}
+}
+
+func TestSession_First(t *testing.T) {
+	testRecordInit(t)
+	u := &User{}
+	err := NewSession().First(u)
+	if err != nil || u.Name != "Tom" || u.Age != 18 {
+		t.Fatal("failed to query first")
+	}
+}
+
+func TestSession_Limit(t *testing.T) {
+	testRecordInit(t)
+	var users []User
+	err := NewSession().Limit(1).Find(&users)
+	if err != nil || len(users) != 1 {
+		t.Fatal("failed to query with limit condition")
+	}
+}
+
+func TestSession_Where(t *testing.T) {
+	testRecordInit(t)
+	var users []User
+	_, err1 := NewSession().Create(user3)
+	err2 := NewSession().Where("Age = ?", 25).Find(&users)
+
+	if err1 != nil || err2 != nil || len(users) != 2 {
+		t.Fatal("failed to query with where condition")
+	}
+}
+
+func TestSession_OrderBy(t *testing.T) {
+	testRecordInit(t)
+	u := &User{}
+	err := NewSession().OrderBy("Age DESC").First(u)
+
+	if err != nil || u.Age != 25 {
+		t.Fatal("failed to query with order by condition")
+	}
+}
+
+func TestSession_Update(t *testing.T) {
+	testRecordInit(t)
+	affected, _ := NewSession().Where("Name = ?", "Tom").Set("Age", 30).Update(&User{})
+	u := &User{}
+	_ = NewSession().OrderBy("Age DESC").First(u)
+
+	if affected != 1 || u.Age != 30 {
+		t.Fatal("failed to update")
+	}
+}
+
+func TestSession_DeleteAndCount(t *testing.T) {
+	testRecordInit(t)
+	affected, _ := NewSession().Where("Name = ?", "Tom").Delete("User")
+	count, _ := NewSession().Count("User")
+
+	if affected != 1 || count != 1 {
+		t.Fatal("failed to delete or count")
+	}
+}
diff --git a/gee-orm/day6-transaction/session/table.go b/gee-orm/day6-transaction/session/table.go
new file mode 100644
index 0000000..b644d3a
--- /dev/null
+++ b/gee-orm/day6-transaction/session/table.go
@@ -0,0 +1,59 @@
+package session
+
+import (
+	"fmt"
+	"strings"
+
+	"geeorm/schema"
+)
+
+// RefTable returns a Schema instance that contains all parsed fields
+func (s *Session) RefTable(value interface{}) *schema.Schema {
+	if value == nil {
+		panic("value is nil")
+	}
+	if s.refTable == nil {
+		s.refTable = schema.Parse(value, s.dialect)
+	}
+	return s.refTable
+}
+
+// CreateTable create a table in database with a model
+func (s *Session) CreateTable(value interface{}) error {
+	table := s.RefTable(value)
+	var columns []string
+	for _, field := range table.Fields {
+		tag := field.Tag
+		if field.Name == table.PrimaryField.Name {
+			tag += " PRIMARY KEY"
+		}
+		columns = append(columns, fmt.Sprintf("%s %s", field.Name, tag))
+	}
+	desc := strings.Join(columns, ",")
+	_, err := s.Raw(fmt.Sprintf("CREATE TABLE %s (%s);", table.TableName, desc)).Exec()
+	return err
+}
+
+// DropTable drops a table with the name of model
+func (s *Session) DropTable(value interface{}) error {
+	table := s.RefTable(value)
+	_, err := s.Raw(fmt.Sprintf("DROP TABLE IF EXISTS %s", table.TableName)).Exec()
+	return err
+}
+
+func (s *Session) guessTableName(value interface{}) string {
+	if tableName, ok := value.(string); ok {
+		return tableName
+	}
+	return s.RefTable(value).TableName
+}
+
+// HasTable returns true of the table exists
+func (s *Session) HasTable(value interface{}) bool {
+	tableName := s.guessTableName(value)
+	sql, values := s.dialect.TableExistSQL(tableName)
+	row := s.Raw(sql, values...).QueryRow()
+	var tmp string
+	_ = row.Scan(&tmp)
+	return tmp == tableName
+}
diff --git a/gee-orm/day6-transaction/session/table_test.go b/gee-orm/day6-transaction/session/table_test.go
new file mode 100644
index 0000000..5c934fa
--- /dev/null
+++ b/gee-orm/day6-transaction/session/table_test.go
@@ -0,0 +1,18 @@
+package session
+
+import (
+	"testing"
+)
+
+type User struct {
+	Name string `geeorm:"primary_key"`
+	Age  int
+}
+
+func TestSession_CreateTable(t *testing.T) {
+	_ = NewSession().DropTable(&User{})
+	_ = NewSession().CreateTable(&User{})
+	if !NewSession().HasTable("User") {
+		t.Fatal("failed to create table User")
+	}
+}
diff --git a/gee-orm/day6-transaction/session/transaction.go b/gee-orm/day6-transaction/session/transaction.go
new file mode 100644
index 0000000..3cdb451
--- /dev/null
+++ b/gee-orm/day6-transaction/session/transaction.go
@@ -0,0 +1,31 @@
+package session
+
+import "geeorm/log"
+
+// Begin a transaction
+func (s *Session) Begin() (err error) {
+	log.Info("transaction begin")
+	if s.tx, err = s.db.Begin(); err != nil {
+		log.Error(err)
+		return
+	}
+	return
+}
+
+// Commit a transaction
+func (s *Session) Commit() (err error) {
+	log.Info("transaction commit")
+	if err = s.tx.Commit(); err != nil {
+		log.Error(err)
+	}
+	return
+}
+
+// Rollback a transaction
+func (s *Session) Rollback() (err error) {
+	log.Info("transaction rollback")
+	if err = s.tx.Rollback(); err != nil {
+		log.Error(err)
+	}
+	return
+}

From a5ca58d95fc58d08121ba4d5629beaf3bdb9d4c8 Mon Sep 17 00:00:00 2001
From: gzdaijie <gzdaijie@163.com>
Date: Wed, 26 Feb 2020 22:51:36 +0800
Subject: [PATCH 048/122] clear session for every exec or query

---
 gee-orm/day1-database-sql/session/raw.go      |  9 ++++
 gee-orm/day1-database-sql/session/raw_test.go | 14 +++---
 gee-orm/day2-reflect-schema/session/raw.go    |  9 ++++
 .../day2-reflect-schema/session/raw_test.go   | 14 +++---
 .../day2-reflect-schema/session/table_test.go |  7 +--
 gee-orm/day3-save-query/session/raw.go        | 10 ++++
 gee-orm/day3-save-query/session/raw_test.go   | 14 +++---
 .../day3-save-query/session/record_test.go    | 19 +++----
 gee-orm/day3-save-query/session/table_test.go |  7 +--
 gee-orm/day4-chain-operation/session/raw.go   | 10 ++++
 .../day4-chain-operation/session/raw_test.go  | 14 +++---
 .../session/record_test.go                    | 36 +++++++-------
 .../session/table_test.go                     |  7 +--
 gee-orm/day5-update-delete/session/raw.go     | 10 ++++
 .../day5-update-delete/session/raw_test.go    | 14 +++---
 .../day5-update-delete/session/record_test.go | 49 ++++++++++---------
 .../day5-update-delete/session/table_test.go  |  7 +--
 gee-orm/day6-transaction/geeorm_test.go       | 10 ++--
 gee-orm/day6-transaction/session/raw.go       |  2 +-
 gee-orm/day6-transaction/session/raw_test.go  | 14 +++---
 .../day6-transaction/session/record_test.go   | 49 ++++++++++---------
 .../day6-transaction/session/table_test.go    |  7 +--
 gee-orm/run_test.sh                           | 10 ++++
 23 files changed, 212 insertions(+), 130 deletions(-)
 create mode 100755 gee-orm/run_test.sh

diff --git a/gee-orm/day1-database-sql/session/raw.go b/gee-orm/day1-database-sql/session/raw.go
index aecc158..a0e84cd 100644
--- a/gee-orm/day1-database-sql/session/raw.go
+++ b/gee-orm/day1-database-sql/session/raw.go
@@ -18,8 +18,15 @@ func New(db *sql.DB) *Session {
 	return &Session{db: db}
 }
 
+// Clear initialize the state of a session
+func (s *Session) Clear() {
+	s.sqlVars = nil
+	s.sql = ""
+}
+
 // Exec raw sql with sqlVars
 func (s *Session) Exec() (result sql.Result, err error) {
+	defer s.Clear()
 	log.Info(s.sql, s.sqlVars)
 	if result, err = s.db.Exec(s.sql, s.sqlVars...); err != nil {
 		log.Error(err)
@@ -29,12 +36,14 @@ func (s *Session) Exec() (result sql.Result, err error) {
 
 // QueryRow gets a record from db
 func (s *Session) QueryRow() *sql.Row {
+	defer s.Clear()
 	log.Info(s.sql, s.sqlVars)
 	return s.db.QueryRow(s.sql, s.sqlVars...)
 }
 
 // QueryRows gets a list of records from db
 func (s *Session) QueryRows() (rows *sql.Rows, err error) {
+	defer s.Clear()
 	log.Info(s.sql, s.sqlVars)
 	if rows, err = s.db.Query(s.sql, s.sqlVars...); err != nil {
 		log.Error(err)
diff --git a/gee-orm/day1-database-sql/session/raw_test.go b/gee-orm/day1-database-sql/session/raw_test.go
index 1cd7712..fbb1f1b 100644
--- a/gee-orm/day1-database-sql/session/raw_test.go
+++ b/gee-orm/day1-database-sql/session/raw_test.go
@@ -22,18 +22,20 @@ func NewSession() *Session {
 }
 
 func TestSession_Exec(t *testing.T) {
-	_, _ = NewSession().Raw("DROP TABLE IF EXISTS User;").Exec()
-	_, _ = NewSession().Raw("CREATE TABLE User(name text);").Exec()
-	result, _ := NewSession().Raw("INSERT INTO User(`name`) values (?), (?)", "Tom", "Sam").Exec()
+	s := NewSession()
+	_, _ = s.Raw("DROP TABLE IF EXISTS User;").Exec()
+	_, _ = s.Raw("CREATE TABLE User(name text);").Exec()
+	result, _ := s.Raw("INSERT INTO User(`name`) values (?), (?)", "Tom", "Sam").Exec()
 	if count, err := result.RowsAffected(); err != nil || count != 2 {
 		t.Fatal("expect 2, but got", count)
 	}
 }
 
 func TestSession_QueryRows(t *testing.T) {
-	_, _ = NewSession().Raw("DROP TABLE IF EXISTS User;").Exec()
-	_, _ = NewSession().Raw("CREATE TABLE User(name text);").Exec()
-	row := NewSession().Raw("SELECT count(*) FROM User").QueryRow()
+	s := NewSession()
+	_, _ = s.Raw("DROP TABLE IF EXISTS User;").Exec()
+	_, _ = s.Raw("CREATE TABLE User(name text);").Exec()
+	row := s.Raw("SELECT count(*) FROM User").QueryRow()
 	var count int
 	if err := row.Scan(&count); err != nil || count != 0 {
 		t.Fatal("failed to query db", err)
diff --git a/gee-orm/day2-reflect-schema/session/raw.go b/gee-orm/day2-reflect-schema/session/raw.go
index 6892e0c..abaaeb7 100644
--- a/gee-orm/day2-reflect-schema/session/raw.go
+++ b/gee-orm/day2-reflect-schema/session/raw.go
@@ -25,8 +25,15 @@ func New(db *sql.DB, dialect dialect.Dialect) *Session {
 	}
 }
 
+// Clear initialize the state of a session
+func (s *Session) Clear() {
+	s.sqlVars = nil
+	s.sql = ""
+}
+
 // Exec raw sql with sqlVars
 func (s *Session) Exec() (result sql.Result, err error) {
+	defer s.Clear()
 	log.Info(s.sql, s.sqlVars)
 	if result, err = s.db.Exec(s.sql, s.sqlVars...); err != nil {
 		log.Error(err)
@@ -36,12 +43,14 @@ func (s *Session) Exec() (result sql.Result, err error) {
 
 // QueryRow gets a record from db
 func (s *Session) QueryRow() *sql.Row {
+	defer s.Clear()
 	log.Info(s.sql, s.sqlVars)
 	return s.db.QueryRow(s.sql, s.sqlVars...)
 }
 
 // QueryRows gets a list of records from db
 func (s *Session) QueryRows() (rows *sql.Rows, err error) {
+	defer s.Clear()
 	log.Info(s.sql, s.sqlVars)
 	if rows, err = s.db.Query(s.sql, s.sqlVars...); err != nil {
 		log.Error(err)
diff --git a/gee-orm/day2-reflect-schema/session/raw_test.go b/gee-orm/day2-reflect-schema/session/raw_test.go
index ce1e75b..ed447a5 100644
--- a/gee-orm/day2-reflect-schema/session/raw_test.go
+++ b/gee-orm/day2-reflect-schema/session/raw_test.go
@@ -27,18 +27,20 @@ func NewSession() *Session {
 }
 
 func TestSession_Exec(t *testing.T) {
-	_, _ = NewSession().Raw("DROP TABLE IF EXISTS User;").Exec()
-	_, _ = NewSession().Raw("CREATE TABLE User(name text);").Exec()
-	result, _ := NewSession().Raw("INSERT INTO User(`name`) values (?), (?)", "Tom", "Sam").Exec()
+	s := NewSession()
+	_, _ = s.Raw("DROP TABLE IF EXISTS User;").Exec()
+	_, _ = s.Raw("CREATE TABLE User(name text);").Exec()
+	result, _ := s.Raw("INSERT INTO User(`name`) values (?), (?)", "Tom", "Sam").Exec()
 	if count, err := result.RowsAffected(); err != nil || count != 2 {
 		t.Fatal("expect 2, but got", count)
 	}
 }
 
 func TestSession_QueryRows(t *testing.T) {
-	_, _ = NewSession().Raw("DROP TABLE IF EXISTS User;").Exec()
-	_, _ = NewSession().Raw("CREATE TABLE User(name text);").Exec()
-	row := NewSession().Raw("SELECT count(*) FROM User").QueryRow()
+	s := NewSession()
+	_, _ = s.Raw("DROP TABLE IF EXISTS User;").Exec()
+	_, _ = s.Raw("CREATE TABLE User(name text);").Exec()
+	row := s.Raw("SELECT count(*) FROM User").QueryRow()
 	var count int
 	if err := row.Scan(&count); err != nil || count != 0 {
 		t.Fatal("failed to query db", err)
diff --git a/gee-orm/day2-reflect-schema/session/table_test.go b/gee-orm/day2-reflect-schema/session/table_test.go
index 8405886..7ed38ac 100644
--- a/gee-orm/day2-reflect-schema/session/table_test.go
+++ b/gee-orm/day2-reflect-schema/session/table_test.go
@@ -10,9 +10,10 @@ type User struct {
 }
 
 func TestSession_CreateTable(t *testing.T) {
-	_ = NewSession().DropTable(&User{})
-	_ = NewSession().CreateTable(&User{})
-	if !NewSession().HasTable("User") {
+	s := NewSession()
+	_ = s.DropTable(&User{})
+	_ = s.CreateTable(&User{})
+	if !s.HasTable("User") {
 		t.Fatal("failed to create table User")
 	}
 }
diff --git a/gee-orm/day3-save-query/session/raw.go b/gee-orm/day3-save-query/session/raw.go
index 6cb72c9..a47edcc 100644
--- a/gee-orm/day3-save-query/session/raw.go
+++ b/gee-orm/day3-save-query/session/raw.go
@@ -27,8 +27,16 @@ func New(db *sql.DB, dialect dialect.Dialect) *Session {
 	}
 }
 
+// Clear initialize the state of a session
+func (s *Session) Clear() {
+	s.refTable, s.sqlVars = nil, nil
+	s.clause = clause.Clause{}
+	s.sql = ""
+}
+
 // Exec raw sql with sqlVars
 func (s *Session) Exec() (result sql.Result, err error) {
+	defer s.Clear()
 	log.Info(s.sql, s.sqlVars)
 	if result, err = s.db.Exec(s.sql, s.sqlVars...); err != nil {
 		log.Error(err)
@@ -38,12 +46,14 @@ func (s *Session) Exec() (result sql.Result, err error) {
 
 // QueryRow gets a record from db
 func (s *Session) QueryRow() *sql.Row {
+	defer s.Clear()
 	log.Info(s.sql, s.sqlVars)
 	return s.db.QueryRow(s.sql, s.sqlVars...)
 }
 
 // QueryRows gets a list of records from db
 func (s *Session) QueryRows() (rows *sql.Rows, err error) {
+	defer s.Clear()
 	log.Info(s.sql, s.sqlVars)
 	if rows, err = s.db.Query(s.sql, s.sqlVars...); err != nil {
 		log.Error(err)
diff --git a/gee-orm/day3-save-query/session/raw_test.go b/gee-orm/day3-save-query/session/raw_test.go
index ce1e75b..ed447a5 100644
--- a/gee-orm/day3-save-query/session/raw_test.go
+++ b/gee-orm/day3-save-query/session/raw_test.go
@@ -27,18 +27,20 @@ func NewSession() *Session {
 }
 
 func TestSession_Exec(t *testing.T) {
-	_, _ = NewSession().Raw("DROP TABLE IF EXISTS User;").Exec()
-	_, _ = NewSession().Raw("CREATE TABLE User(name text);").Exec()
-	result, _ := NewSession().Raw("INSERT INTO User(`name`) values (?), (?)", "Tom", "Sam").Exec()
+	s := NewSession()
+	_, _ = s.Raw("DROP TABLE IF EXISTS User;").Exec()
+	_, _ = s.Raw("CREATE TABLE User(name text);").Exec()
+	result, _ := s.Raw("INSERT INTO User(`name`) values (?), (?)", "Tom", "Sam").Exec()
 	if count, err := result.RowsAffected(); err != nil || count != 2 {
 		t.Fatal("expect 2, but got", count)
 	}
 }
 
 func TestSession_QueryRows(t *testing.T) {
-	_, _ = NewSession().Raw("DROP TABLE IF EXISTS User;").Exec()
-	_, _ = NewSession().Raw("CREATE TABLE User(name text);").Exec()
-	row := NewSession().Raw("SELECT count(*) FROM User").QueryRow()
+	s := NewSession()
+	_, _ = s.Raw("DROP TABLE IF EXISTS User;").Exec()
+	_, _ = s.Raw("CREATE TABLE User(name text);").Exec()
+	row := s.Raw("SELECT count(*) FROM User").QueryRow()
 	var count int
 	if err := row.Scan(&count); err != nil || count != 0 {
 		t.Fatal("failed to query db", err)
diff --git a/gee-orm/day3-save-query/session/record_test.go b/gee-orm/day3-save-query/session/record_test.go
index 27b6d77..08881fa 100644
--- a/gee-orm/day3-save-query/session/record_test.go
+++ b/gee-orm/day3-save-query/session/record_test.go
@@ -8,29 +8,30 @@ var (
 	user3 = &User{"Jack", 25}
 )
 
-func testRecordInit(t *testing.T) {
+func testRecordInit(t *testing.T) *Session {
 	t.Helper()
-	err1 := NewSession().DropTable(&User{})
-	err2 := NewSession().CreateTable(&User{})
-	_, err3 := NewSession().Create(user1, user2)
+	s := NewSession()
+	err1 := s.DropTable(&User{})
+	err2 := s.CreateTable(&User{})
+	_, err3 := s.Create(user1, user2)
 	if err1 != nil || err2 != nil || err3 != nil {
 		t.Fatal("failed init test records")
 	}
-
+	return s
 }
 
 func TestSession_Create(t *testing.T) {
-	testRecordInit(t)
-	affected, err := NewSession().Create(user3)
+	s := testRecordInit(t)
+	affected, err := s.Create(user3)
 	if err != nil || affected != 1 {
 		t.Fatal("failed to create record")
 	}
 }
 
 func TestSession_Find(t *testing.T) {
-	testRecordInit(t)
+	s := testRecordInit(t)
 	users := []User{}
-	if err := NewSession().Find(&users); err != nil || len(users) != 2 {
+	if err := s.Find(&users); err != nil || len(users) != 2 {
 		t.Fatal("failed to query all")
 	}
 }
diff --git a/gee-orm/day3-save-query/session/table_test.go b/gee-orm/day3-save-query/session/table_test.go
index 5c934fa..91eb519 100644
--- a/gee-orm/day3-save-query/session/table_test.go
+++ b/gee-orm/day3-save-query/session/table_test.go
@@ -10,9 +10,10 @@ type User struct {
 }
 
 func TestSession_CreateTable(t *testing.T) {
-	_ = NewSession().DropTable(&User{})
-	_ = NewSession().CreateTable(&User{})
-	if !NewSession().HasTable("User") {
+	s := NewSession()
+	_ = s.DropTable(&User{})
+	_ = s.CreateTable(&User{})
+	if !s.HasTable("User") {
 		t.Fatal("failed to create table User")
 	}
 }
diff --git a/gee-orm/day4-chain-operation/session/raw.go b/gee-orm/day4-chain-operation/session/raw.go
index 6cb72c9..a47edcc 100644
--- a/gee-orm/day4-chain-operation/session/raw.go
+++ b/gee-orm/day4-chain-operation/session/raw.go
@@ -27,8 +27,16 @@ func New(db *sql.DB, dialect dialect.Dialect) *Session {
 	}
 }
 
+// Clear initialize the state of a session
+func (s *Session) Clear() {
+	s.refTable, s.sqlVars = nil, nil
+	s.clause = clause.Clause{}
+	s.sql = ""
+}
+
 // Exec raw sql with sqlVars
 func (s *Session) Exec() (result sql.Result, err error) {
+	defer s.Clear()
 	log.Info(s.sql, s.sqlVars)
 	if result, err = s.db.Exec(s.sql, s.sqlVars...); err != nil {
 		log.Error(err)
@@ -38,12 +46,14 @@ func (s *Session) Exec() (result sql.Result, err error) {
 
 // QueryRow gets a record from db
 func (s *Session) QueryRow() *sql.Row {
+	defer s.Clear()
 	log.Info(s.sql, s.sqlVars)
 	return s.db.QueryRow(s.sql, s.sqlVars...)
 }
 
 // QueryRows gets a list of records from db
 func (s *Session) QueryRows() (rows *sql.Rows, err error) {
+	defer s.Clear()
 	log.Info(s.sql, s.sqlVars)
 	if rows, err = s.db.Query(s.sql, s.sqlVars...); err != nil {
 		log.Error(err)
diff --git a/gee-orm/day4-chain-operation/session/raw_test.go b/gee-orm/day4-chain-operation/session/raw_test.go
index ce1e75b..ed447a5 100644
--- a/gee-orm/day4-chain-operation/session/raw_test.go
+++ b/gee-orm/day4-chain-operation/session/raw_test.go
@@ -27,18 +27,20 @@ func NewSession() *Session {
 }
 
 func TestSession_Exec(t *testing.T) {
-	_, _ = NewSession().Raw("DROP TABLE IF EXISTS User;").Exec()
-	_, _ = NewSession().Raw("CREATE TABLE User(name text);").Exec()
-	result, _ := NewSession().Raw("INSERT INTO User(`name`) values (?), (?)", "Tom", "Sam").Exec()
+	s := NewSession()
+	_, _ = s.Raw("DROP TABLE IF EXISTS User;").Exec()
+	_, _ = s.Raw("CREATE TABLE User(name text);").Exec()
+	result, _ := s.Raw("INSERT INTO User(`name`) values (?), (?)", "Tom", "Sam").Exec()
 	if count, err := result.RowsAffected(); err != nil || count != 2 {
 		t.Fatal("expect 2, but got", count)
 	}
 }
 
 func TestSession_QueryRows(t *testing.T) {
-	_, _ = NewSession().Raw("DROP TABLE IF EXISTS User;").Exec()
-	_, _ = NewSession().Raw("CREATE TABLE User(name text);").Exec()
-	row := NewSession().Raw("SELECT count(*) FROM User").QueryRow()
+	s := NewSession()
+	_, _ = s.Raw("DROP TABLE IF EXISTS User;").Exec()
+	_, _ = s.Raw("CREATE TABLE User(name text);").Exec()
+	row := s.Raw("SELECT count(*) FROM User").QueryRow()
 	var count int
 	if err := row.Scan(&count); err != nil || count != 0 {
 		t.Fatal("failed to query db", err)
diff --git a/gee-orm/day4-chain-operation/session/record_test.go b/gee-orm/day4-chain-operation/session/record_test.go
index 5879cfb..822201b 100644
--- a/gee-orm/day4-chain-operation/session/record_test.go
+++ b/gee-orm/day4-chain-operation/session/record_test.go
@@ -8,56 +8,58 @@ var (
 	user3 = &User{"Jack", 25}
 )
 
-func testRecordInit(t *testing.T) {
+func testRecordInit(t *testing.T) *Session {
 	t.Helper()
-	err1 := NewSession().DropTable(&User{})
-	err2 := NewSession().CreateTable(&User{})
-	_, err3 := NewSession().Create(user1, user2)
+	s := NewSession()
+	err1 := s.DropTable(&User{})
+	err2 := s.CreateTable(&User{})
+	_, err3 := s.Create(user1, user2)
 	if err1 != nil || err2 != nil || err3 != nil {
 		t.Fatal("failed init test records")
 	}
+	return s
 
 }
 
 func TestSession_Create(t *testing.T) {
-	testRecordInit(t)
-	affected, err := NewSession().Create(user3)
+	s := testRecordInit(t)
+	affected, err := s.Create(user3)
 	if err != nil || affected != 1 {
 		t.Fatal("failed to create record")
 	}
 }
 
 func TestSession_Find(t *testing.T) {
-	testRecordInit(t)
+	s := testRecordInit(t)
 	users := []User{}
-	if err := NewSession().Find(&users); err != nil || len(users) != 2 {
+	if err := s.Find(&users); err != nil || len(users) != 2 {
 		t.Fatal("failed to query all")
 	}
 }
 
 func TestSession_First(t *testing.T) {
-	testRecordInit(t)
+	s := testRecordInit(t)
 	u := &User{}
-	err := NewSession().First(u)
+	err := s.First(u)
 	if err != nil || u.Name != "Tom" || u.Age != 18 {
 		t.Fatal("failed to query first")
 	}
 }
 
 func TestSession_Limit(t *testing.T) {
-	testRecordInit(t)
+	s := testRecordInit(t)
 	var users []User
-	err := NewSession().Limit(1).Find(&users)
+	err := s.Limit(1).Find(&users)
 	if err != nil || len(users) != 1 {
 		t.Fatal("failed to query with limit condition")
 	}
 }
 
 func TestSession_Where(t *testing.T) {
-	testRecordInit(t)
+	s := testRecordInit(t)
 	var users []User
-	_, err1 := NewSession().Create(user3)
-	err2 := NewSession().Where("Age = ?", 25).Find(&users)
+	_, err1 := s.Create(user3)
+	err2 := s.Where("Age = ?", 25).Find(&users)
 
 	if err1 != nil || err2 != nil || len(users) != 2 {
 		t.Fatal("failed to query with where condition")
@@ -65,9 +67,9 @@ func TestSession_Where(t *testing.T) {
 }
 
 func TestSession_OrderBy(t *testing.T) {
-	testRecordInit(t)
+	s := testRecordInit(t)
 	u := &User{}
-	err := NewSession().OrderBy("Age DESC").First(u)
+	err := s.OrderBy("Age DESC").First(u)
 
 	if err != nil || u.Age != 25 {
 		t.Fatal("failed to query with order by condition")
diff --git a/gee-orm/day4-chain-operation/session/table_test.go b/gee-orm/day4-chain-operation/session/table_test.go
index 5c934fa..91eb519 100644
--- a/gee-orm/day4-chain-operation/session/table_test.go
+++ b/gee-orm/day4-chain-operation/session/table_test.go
@@ -10,9 +10,10 @@ type User struct {
 }
 
 func TestSession_CreateTable(t *testing.T) {
-	_ = NewSession().DropTable(&User{})
-	_ = NewSession().CreateTable(&User{})
-	if !NewSession().HasTable("User") {
+	s := NewSession()
+	_ = s.DropTable(&User{})
+	_ = s.CreateTable(&User{})
+	if !s.HasTable("User") {
 		t.Fatal("failed to create table User")
 	}
 }
diff --git a/gee-orm/day5-update-delete/session/raw.go b/gee-orm/day5-update-delete/session/raw.go
index 6cb72c9..a47edcc 100644
--- a/gee-orm/day5-update-delete/session/raw.go
+++ b/gee-orm/day5-update-delete/session/raw.go
@@ -27,8 +27,16 @@ func New(db *sql.DB, dialect dialect.Dialect) *Session {
 	}
 }
 
+// Clear initialize the state of a session
+func (s *Session) Clear() {
+	s.refTable, s.sqlVars = nil, nil
+	s.clause = clause.Clause{}
+	s.sql = ""
+}
+
 // Exec raw sql with sqlVars
 func (s *Session) Exec() (result sql.Result, err error) {
+	defer s.Clear()
 	log.Info(s.sql, s.sqlVars)
 	if result, err = s.db.Exec(s.sql, s.sqlVars...); err != nil {
 		log.Error(err)
@@ -38,12 +46,14 @@ func (s *Session) Exec() (result sql.Result, err error) {
 
 // QueryRow gets a record from db
 func (s *Session) QueryRow() *sql.Row {
+	defer s.Clear()
 	log.Info(s.sql, s.sqlVars)
 	return s.db.QueryRow(s.sql, s.sqlVars...)
 }
 
 // QueryRows gets a list of records from db
 func (s *Session) QueryRows() (rows *sql.Rows, err error) {
+	defer s.Clear()
 	log.Info(s.sql, s.sqlVars)
 	if rows, err = s.db.Query(s.sql, s.sqlVars...); err != nil {
 		log.Error(err)
diff --git a/gee-orm/day5-update-delete/session/raw_test.go b/gee-orm/day5-update-delete/session/raw_test.go
index ce1e75b..ed447a5 100644
--- a/gee-orm/day5-update-delete/session/raw_test.go
+++ b/gee-orm/day5-update-delete/session/raw_test.go
@@ -27,18 +27,20 @@ func NewSession() *Session {
 }
 
 func TestSession_Exec(t *testing.T) {
-	_, _ = NewSession().Raw("DROP TABLE IF EXISTS User;").Exec()
-	_, _ = NewSession().Raw("CREATE TABLE User(name text);").Exec()
-	result, _ := NewSession().Raw("INSERT INTO User(`name`) values (?), (?)", "Tom", "Sam").Exec()
+	s := NewSession()
+	_, _ = s.Raw("DROP TABLE IF EXISTS User;").Exec()
+	_, _ = s.Raw("CREATE TABLE User(name text);").Exec()
+	result, _ := s.Raw("INSERT INTO User(`name`) values (?), (?)", "Tom", "Sam").Exec()
 	if count, err := result.RowsAffected(); err != nil || count != 2 {
 		t.Fatal("expect 2, but got", count)
 	}
 }
 
 func TestSession_QueryRows(t *testing.T) {
-	_, _ = NewSession().Raw("DROP TABLE IF EXISTS User;").Exec()
-	_, _ = NewSession().Raw("CREATE TABLE User(name text);").Exec()
-	row := NewSession().Raw("SELECT count(*) FROM User").QueryRow()
+	s := NewSession()
+	_, _ = s.Raw("DROP TABLE IF EXISTS User;").Exec()
+	_, _ = s.Raw("CREATE TABLE User(name text);").Exec()
+	row := s.Raw("SELECT count(*) FROM User").QueryRow()
 	var count int
 	if err := row.Scan(&count); err != nil || count != 0 {
 		t.Fatal("failed to query db", err)
diff --git a/gee-orm/day5-update-delete/session/record_test.go b/gee-orm/day5-update-delete/session/record_test.go
index 3489287..faf8535 100644
--- a/gee-orm/day5-update-delete/session/record_test.go
+++ b/gee-orm/day5-update-delete/session/record_test.go
@@ -8,56 +8,57 @@ var (
 	user3 = &User{"Jack", 25}
 )
 
-func testRecordInit(t *testing.T) {
+func testRecordInit(t *testing.T) *Session {
 	t.Helper()
-	err1 := NewSession().DropTable(&User{})
-	err2 := NewSession().CreateTable(&User{})
-	_, err3 := NewSession().Create(user1, user2)
+	s := NewSession()
+	err1 := s.DropTable(&User{})
+	err2 := s.CreateTable(&User{})
+	_, err3 := s.Create(user1, user2)
 	if err1 != nil || err2 != nil || err3 != nil {
 		t.Fatal("failed init test records")
 	}
-
+	return s
 }
 
 func TestSession_Create(t *testing.T) {
-	testRecordInit(t)
-	affected, err := NewSession().Create(user3)
+	s := testRecordInit(t)
+	affected, err := s.Create(user3)
 	if err != nil || affected != 1 {
 		t.Fatal("failed to create record")
 	}
 }
 
 func TestSession_Find(t *testing.T) {
-	testRecordInit(t)
+	s := testRecordInit(t)
 	users := []User{}
-	if err := NewSession().Find(&users); err != nil || len(users) != 2 {
+	if err := s.Find(&users); err != nil || len(users) != 2 {
 		t.Fatal("failed to query all")
 	}
 }
 
 func TestSession_First(t *testing.T) {
-	testRecordInit(t)
+	s := testRecordInit(t)
 	u := &User{}
-	err := NewSession().First(u)
+	err := s.First(u)
 	if err != nil || u.Name != "Tom" || u.Age != 18 {
 		t.Fatal("failed to query first")
 	}
 }
 
 func TestSession_Limit(t *testing.T) {
-	testRecordInit(t)
+	s := testRecordInit(t)
 	var users []User
-	err := NewSession().Limit(1).Find(&users)
+	err := s.Limit(1).Find(&users)
 	if err != nil || len(users) != 1 {
 		t.Fatal("failed to query with limit condition")
 	}
 }
 
 func TestSession_Where(t *testing.T) {
-	testRecordInit(t)
+	s := testRecordInit(t)
 	var users []User
-	_, err1 := NewSession().Create(user3)
-	err2 := NewSession().Where("Age = ?", 25).Find(&users)
+	_, err1 := s.Create(user3)
+	err2 := s.Where("Age = ?", 25).Find(&users)
 
 	if err1 != nil || err2 != nil || len(users) != 2 {
 		t.Fatal("failed to query with where condition")
@@ -65,9 +66,9 @@ func TestSession_Where(t *testing.T) {
 }
 
 func TestSession_OrderBy(t *testing.T) {
-	testRecordInit(t)
+	s := testRecordInit(t)
 	u := &User{}
-	err := NewSession().OrderBy("Age DESC").First(u)
+	err := s.OrderBy("Age DESC").First(u)
 
 	if err != nil || u.Age != 25 {
 		t.Fatal("failed to query with order by condition")
@@ -75,10 +76,10 @@ func TestSession_OrderBy(t *testing.T) {
 }
 
 func TestSession_Update(t *testing.T) {
-	testRecordInit(t)
-	affected, _ := NewSession().Where("Name = ?", "Tom").Set("Age", 30).Update(&User{})
+	s := testRecordInit(t)
+	affected, _ := s.Where("Name = ?", "Tom").Set("Age", 30).Update(&User{})
 	u := &User{}
-	_ = NewSession().OrderBy("Age DESC").First(u)
+	_ = s.OrderBy("Age DESC").First(u)
 
 	if affected != 1 || u.Age != 30 {
 		t.Fatal("failed to update")
@@ -86,9 +87,9 @@ func TestSession_Update(t *testing.T) {
 }
 
 func TestSession_DeleteAndCount(t *testing.T) {
-	testRecordInit(t)
-	affected, _ := NewSession().Where("Name = ?", "Tom").Delete("User")
-	count, _ := NewSession().Count("User")
+	s := testRecordInit(t)
+	affected, _ := s.Where("Name = ?", "Tom").Delete("User")
+	count, _ := s.Count("User")
 
 	if affected != 1 || count != 1 {
 		t.Fatal("failed to delete or count")
diff --git a/gee-orm/day5-update-delete/session/table_test.go b/gee-orm/day5-update-delete/session/table_test.go
index 5c934fa..91eb519 100644
--- a/gee-orm/day5-update-delete/session/table_test.go
+++ b/gee-orm/day5-update-delete/session/table_test.go
@@ -10,9 +10,10 @@ type User struct {
 }
 
 func TestSession_CreateTable(t *testing.T) {
-	_ = NewSession().DropTable(&User{})
-	_ = NewSession().CreateTable(&User{})
-	if !NewSession().HasTable("User") {
+	s := NewSession()
+	_ = s.DropTable(&User{})
+	_ = s.CreateTable(&User{})
+	if !s.HasTable("User") {
 		t.Fatal("failed to create table User")
 	}
 }
diff --git a/gee-orm/day6-transaction/geeorm_test.go b/gee-orm/day6-transaction/geeorm_test.go
index 7b15616..17a1d2b 100644
--- a/gee-orm/day6-transaction/geeorm_test.go
+++ b/gee-orm/day6-transaction/geeorm_test.go
@@ -34,13 +34,14 @@ type User struct {
 func transactionRollback(t *testing.T) {
 	engine := OpenDB(t)
 	defer CloseDB(engine)
-	_ = engine.NewSession().DropTable(&User{})
+	s := engine.NewSession()
+	_ = s.DropTable(&User{})
 	_, err := engine.Transaction(func(s *session.Session) (result interface{}, err error) {
 		_ = s.CreateTable(&User{})
 		_, err = s.Create(&User{"Tom", 18})
 		return nil, errors.New("Error")
 	})
-	if err == nil || engine.NewSession().HasTable("User") {
+	if err == nil || s.HasTable("User") {
 		t.Fatal("failed to rollback")
 	}
 }
@@ -48,14 +49,15 @@ func transactionRollback(t *testing.T) {
 func transactionCommit(t *testing.T) {
 	engine := OpenDB(t)
 	defer CloseDB(engine)
-	_ = engine.NewSession().DropTable(&User{})
+	s := engine.NewSession()
+	_ = s.DropTable(&User{})
 	_, err := engine.Transaction(func(s *session.Session) (result interface{}, err error) {
 		err = s.CreateTable(&User{})
 		_, err = s.Create(&User{"Tom", 18})
 		return
 	})
 	u := &User{}
-	_ = engine.NewSession().First(u)
+	_ = s.First(u)
 	if err != nil || u.Name != "Tom" {
 		t.Fatal("failed to commit")
 	}
diff --git a/gee-orm/day6-transaction/session/raw.go b/gee-orm/day6-transaction/session/raw.go
index d99f631..c30f1c3 100644
--- a/gee-orm/day6-transaction/session/raw.go
+++ b/gee-orm/day6-transaction/session/raw.go
@@ -28,7 +28,7 @@ func New(db *sql.DB, dialect dialect.Dialect) *Session {
 	}
 }
 
-// Clear initialize the state of a session, except for isAutoCommit
+// Clear initialize the state of a session
 func (s *Session) Clear() {
 	s.refTable, s.sqlVars = nil, nil
 	s.clause = clause.Clause{}
diff --git a/gee-orm/day6-transaction/session/raw_test.go b/gee-orm/day6-transaction/session/raw_test.go
index ce1e75b..ed447a5 100644
--- a/gee-orm/day6-transaction/session/raw_test.go
+++ b/gee-orm/day6-transaction/session/raw_test.go
@@ -27,18 +27,20 @@ func NewSession() *Session {
 }
 
 func TestSession_Exec(t *testing.T) {
-	_, _ = NewSession().Raw("DROP TABLE IF EXISTS User;").Exec()
-	_, _ = NewSession().Raw("CREATE TABLE User(name text);").Exec()
-	result, _ := NewSession().Raw("INSERT INTO User(`name`) values (?), (?)", "Tom", "Sam").Exec()
+	s := NewSession()
+	_, _ = s.Raw("DROP TABLE IF EXISTS User;").Exec()
+	_, _ = s.Raw("CREATE TABLE User(name text);").Exec()
+	result, _ := s.Raw("INSERT INTO User(`name`) values (?), (?)", "Tom", "Sam").Exec()
 	if count, err := result.RowsAffected(); err != nil || count != 2 {
 		t.Fatal("expect 2, but got", count)
 	}
 }
 
 func TestSession_QueryRows(t *testing.T) {
-	_, _ = NewSession().Raw("DROP TABLE IF EXISTS User;").Exec()
-	_, _ = NewSession().Raw("CREATE TABLE User(name text);").Exec()
-	row := NewSession().Raw("SELECT count(*) FROM User").QueryRow()
+	s := NewSession()
+	_, _ = s.Raw("DROP TABLE IF EXISTS User;").Exec()
+	_, _ = s.Raw("CREATE TABLE User(name text);").Exec()
+	row := s.Raw("SELECT count(*) FROM User").QueryRow()
 	var count int
 	if err := row.Scan(&count); err != nil || count != 0 {
 		t.Fatal("failed to query db", err)
diff --git a/gee-orm/day6-transaction/session/record_test.go b/gee-orm/day6-transaction/session/record_test.go
index 3489287..faf8535 100644
--- a/gee-orm/day6-transaction/session/record_test.go
+++ b/gee-orm/day6-transaction/session/record_test.go
@@ -8,56 +8,57 @@ var (
 	user3 = &User{"Jack", 25}
 )
 
-func testRecordInit(t *testing.T) {
+func testRecordInit(t *testing.T) *Session {
 	t.Helper()
-	err1 := NewSession().DropTable(&User{})
-	err2 := NewSession().CreateTable(&User{})
-	_, err3 := NewSession().Create(user1, user2)
+	s := NewSession()
+	err1 := s.DropTable(&User{})
+	err2 := s.CreateTable(&User{})
+	_, err3 := s.Create(user1, user2)
 	if err1 != nil || err2 != nil || err3 != nil {
 		t.Fatal("failed init test records")
 	}
-
+	return s
 }
 
 func TestSession_Create(t *testing.T) {
-	testRecordInit(t)
-	affected, err := NewSession().Create(user3)
+	s := testRecordInit(t)
+	affected, err := s.Create(user3)
 	if err != nil || affected != 1 {
 		t.Fatal("failed to create record")
 	}
 }
 
 func TestSession_Find(t *testing.T) {
-	testRecordInit(t)
+	s := testRecordInit(t)
 	users := []User{}
-	if err := NewSession().Find(&users); err != nil || len(users) != 2 {
+	if err := s.Find(&users); err != nil || len(users) != 2 {
 		t.Fatal("failed to query all")
 	}
 }
 
 func TestSession_First(t *testing.T) {
-	testRecordInit(t)
+	s := testRecordInit(t)
 	u := &User{}
-	err := NewSession().First(u)
+	err := s.First(u)
 	if err != nil || u.Name != "Tom" || u.Age != 18 {
 		t.Fatal("failed to query first")
 	}
 }
 
 func TestSession_Limit(t *testing.T) {
-	testRecordInit(t)
+	s := testRecordInit(t)
 	var users []User
-	err := NewSession().Limit(1).Find(&users)
+	err := s.Limit(1).Find(&users)
 	if err != nil || len(users) != 1 {
 		t.Fatal("failed to query with limit condition")
 	}
 }
 
 func TestSession_Where(t *testing.T) {
-	testRecordInit(t)
+	s := testRecordInit(t)
 	var users []User
-	_, err1 := NewSession().Create(user3)
-	err2 := NewSession().Where("Age = ?", 25).Find(&users)
+	_, err1 := s.Create(user3)
+	err2 := s.Where("Age = ?", 25).Find(&users)
 
 	if err1 != nil || err2 != nil || len(users) != 2 {
 		t.Fatal("failed to query with where condition")
@@ -65,9 +66,9 @@ func TestSession_Where(t *testing.T) {
 }
 
 func TestSession_OrderBy(t *testing.T) {
-	testRecordInit(t)
+	s := testRecordInit(t)
 	u := &User{}
-	err := NewSession().OrderBy("Age DESC").First(u)
+	err := s.OrderBy("Age DESC").First(u)
 
 	if err != nil || u.Age != 25 {
 		t.Fatal("failed to query with order by condition")
@@ -75,10 +76,10 @@ func TestSession_OrderBy(t *testing.T) {
 }
 
 func TestSession_Update(t *testing.T) {
-	testRecordInit(t)
-	affected, _ := NewSession().Where("Name = ?", "Tom").Set("Age", 30).Update(&User{})
+	s := testRecordInit(t)
+	affected, _ := s.Where("Name = ?", "Tom").Set("Age", 30).Update(&User{})
 	u := &User{}
-	_ = NewSession().OrderBy("Age DESC").First(u)
+	_ = s.OrderBy("Age DESC").First(u)
 
 	if affected != 1 || u.Age != 30 {
 		t.Fatal("failed to update")
@@ -86,9 +87,9 @@ func TestSession_Update(t *testing.T) {
 }
 
 func TestSession_DeleteAndCount(t *testing.T) {
-	testRecordInit(t)
-	affected, _ := NewSession().Where("Name = ?", "Tom").Delete("User")
-	count, _ := NewSession().Count("User")
+	s := testRecordInit(t)
+	affected, _ := s.Where("Name = ?", "Tom").Delete("User")
+	count, _ := s.Count("User")
 
 	if affected != 1 || count != 1 {
 		t.Fatal("failed to delete or count")
diff --git a/gee-orm/day6-transaction/session/table_test.go b/gee-orm/day6-transaction/session/table_test.go
index 5c934fa..91eb519 100644
--- a/gee-orm/day6-transaction/session/table_test.go
+++ b/gee-orm/day6-transaction/session/table_test.go
@@ -10,9 +10,10 @@ type User struct {
 }
 
 func TestSession_CreateTable(t *testing.T) {
-	_ = NewSession().DropTable(&User{})
-	_ = NewSession().CreateTable(&User{})
-	if !NewSession().HasTable("User") {
+	s := NewSession()
+	_ = s.DropTable(&User{})
+	_ = s.CreateTable(&User{})
+	if !s.HasTable("User") {
 		t.Fatal("failed to create table User")
 	}
 }
diff --git a/gee-orm/run_test.sh b/gee-orm/run_test.sh
new file mode 100755
index 0000000..d5c5e7f
--- /dev/null
+++ b/gee-orm/run_test.sh
@@ -0,0 +1,10 @@
+#!/bin/bash
+set -eou pipefail
+
+cur=$PWD
+for item in $(ls -d $cur/day*/)
+do
+    echo $item
+    cd $item
+    go test geeorm/... 2>&1 | grep -v warning
+done
\ No newline at end of file

From 09b6c3bf34af13d458e93ad5efd3d5a34d71b63c Mon Sep 17 00:00:00 2001
From: gzdaijie <gzdaijie@gmail.com>
Date: Fri, 28 Feb 2020 20:20:51 +0800
Subject: [PATCH 049/122] combine chain opertion & delete & update

---
 gee-orm/day1-database-sql/geeorm.go           |  8 +--
 gee-orm/day1-database-sql/geeorm_test.go      |  2 +-
 gee-orm/day1-database-sql/session/raw.go      | 25 ++++---
 gee-orm/day1-database-sql/session/raw_test.go |  4 +-
 gee-orm/day2-reflect-schema/geeorm.go         | 12 ++--
 gee-orm/day2-reflect-schema/geeorm_test.go    |  2 +-
 gee-orm/day2-reflect-schema/schema/schema.go  | 42 ++++++------
 .../day2-reflect-schema/schema/schema_test.go | 10 +--
 gee-orm/day2-reflect-schema/session/raw.go    | 25 ++++---
 .../day2-reflect-schema/session/raw_test.go   |  4 +-
 gee-orm/day2-reflect-schema/session/table.go  | 49 +++++++-------
 .../day2-reflect-schema/session/table_test.go | 22 +++++--
 gee-orm/day3-save-query/clause/generator.go   |  4 +-
 gee-orm/day3-save-query/geeorm.go             | 12 ++--
 gee-orm/day3-save-query/geeorm_test.go        |  2 +-
 gee-orm/day3-save-query/schema/schema.go      | 40 ++++++------
 gee-orm/day3-save-query/schema/schema_test.go | 11 ++--
 gee-orm/day3-save-query/session/raw.go        | 29 +++++----
 gee-orm/day3-save-query/session/raw_test.go   |  4 +-
 gee-orm/day3-save-query/session/record.go     | 12 ++--
 .../day3-save-query/session/record_test.go    | 14 ++--
 gee-orm/day3-save-query/session/table.go      | 49 +++++++-------
 gee-orm/day3-save-query/session/table_test.go | 21 ++++--
 gee-orm/day4-chain-operation/clause/clause.go |  3 +
 .../clause/clause_test.go                     | 35 ++++++++++
 .../day4-chain-operation/clause/generator.go  | 27 +++++++-
 gee-orm/day4-chain-operation/geeorm.go        | 12 ++--
 gee-orm/day4-chain-operation/geeorm_test.go   |  2 +-
 gee-orm/day4-chain-operation/schema/schema.go | 40 ++++++------
 .../schema/schema_test.go                     | 11 ++--
 gee-orm/day4-chain-operation/session/raw.go   | 29 +++++----
 .../day4-chain-operation/session/raw_test.go  |  4 +-
 .../day4-chain-operation/session/record.go    | 65 ++++++++++++++++---
 .../session/record_test.go                    | 37 ++++++++---
 gee-orm/day4-chain-operation/session/table.go | 49 +++++++-------
 .../session/table_test.go                     | 21 ++++--
 .../clause/clause.go                          |  1 -
 .../clause/clause_test.go                     |  6 +-
 .../clause/generator.go                       | 15 ++---
 .../dialect/dialect.go                        |  0
 .../dialect/sqlite3.go                        |  0
 .../dialect/sqlite3_test.go                   |  0
 .../geeorm.go                                 | 12 ++--
 .../geeorm_test.go                            |  2 +-
 .../{day5-update-delete => day5-hooks}/go.mod |  0
 .../log/log.go                                |  0
 .../log/log_test.go                           |  0
 .../schema/schema.go                          | 40 ++++++------
 .../schema/schema_test.go                     | 11 ++--
 .../session/raw.go                            | 29 +++++----
 .../session/raw_test.go                       |  4 +-
 .../session/record.go                         | 65 +++++++++++--------
 .../session/record_test.go                    | 22 +++----
 gee-orm/day5-hooks/session/table.go           | 54 +++++++++++++++
 gee-orm/day5-hooks/session/table_test.go      | 28 ++++++++
 gee-orm/day5-update-delete/session/table.go   | 59 -----------------
 .../day5-update-delete/session/table_test.go  | 19 ------
 gee-orm/day6-transaction/clause/clause.go     |  1 -
 .../day6-transaction/clause/clause_test.go    |  6 +-
 gee-orm/day6-transaction/clause/generator.go  | 15 ++---
 gee-orm/day6-transaction/geeorm.go            | 16 ++---
 gee-orm/day6-transaction/geeorm_test.go       | 26 ++++----
 gee-orm/day6-transaction/schema/schema.go     | 40 ++++++------
 .../day6-transaction/schema/schema_test.go    | 11 ++--
 gee-orm/day6-transaction/session/raw.go       | 24 +++----
 gee-orm/day6-transaction/session/raw_test.go  |  4 +-
 gee-orm/day6-transaction/session/record.go    | 53 ++++++++-------
 .../day6-transaction/session/record_test.go   | 22 +++----
 gee-orm/day6-transaction/session/table.go     | 49 +++++++-------
 .../day6-transaction/session/table_test.go    | 21 ++++--
 gee-orm/run_test.sh                           |  6 +-
 71 files changed, 779 insertions(+), 620 deletions(-)
 rename gee-orm/{day5-update-delete => day5-hooks}/clause/clause.go (99%)
 rename gee-orm/{day5-update-delete => day5-hooks}/clause/clause_test.go (92%)
 rename gee-orm/{day5-update-delete => day5-hooks}/clause/generator.go (87%)
 rename gee-orm/{day5-update-delete => day5-hooks}/dialect/dialect.go (100%)
 rename gee-orm/{day5-update-delete => day5-hooks}/dialect/sqlite3.go (100%)
 rename gee-orm/{day5-update-delete => day5-hooks}/dialect/sqlite3_test.go (100%)
 rename gee-orm/{day5-update-delete => day5-hooks}/geeorm.go (78%)
 rename gee-orm/{day5-update-delete => day5-hooks}/geeorm_test.go (93%)
 rename gee-orm/{day5-update-delete => day5-hooks}/go.mod (100%)
 rename gee-orm/{day5-update-delete => day5-hooks}/log/log.go (100%)
 rename gee-orm/{day5-update-delete => day5-hooks}/log/log_test.go (100%)
 rename gee-orm/{day5-update-delete => day5-hooks}/schema/schema.go (59%)
 rename gee-orm/{day5-update-delete => day5-hooks}/schema/schema_test.go (65%)
 rename gee-orm/{day5-update-delete => day5-hooks}/session/raw.go (69%)
 rename gee-orm/{day5-update-delete => day5-hooks}/session/raw_test.go (89%)
 rename gee-orm/{day5-update-delete => day5-hooks}/session/record.go (64%)
 rename gee-orm/{day5-update-delete => day5-hooks}/session/record_test.go (81%)
 create mode 100644 gee-orm/day5-hooks/session/table.go
 create mode 100644 gee-orm/day5-hooks/session/table_test.go
 delete mode 100644 gee-orm/day5-update-delete/session/table.go
 delete mode 100644 gee-orm/day5-update-delete/session/table_test.go

diff --git a/gee-orm/day1-database-sql/geeorm.go b/gee-orm/day1-database-sql/geeorm.go
index ae2ef44..3611b94 100644
--- a/gee-orm/day1-database-sql/geeorm.go
+++ b/gee-orm/day1-database-sql/geeorm.go
@@ -31,11 +31,11 @@ func NewEngine(driver, source string) (e *Engine, err error) {
 }
 
 // Close database connection
-func (engine *Engine) Close() (err error) {
-	if err = engine.db.Close(); err == nil {
-		log.Info("Close database success")
+func (engine *Engine) Close() {
+	if err := engine.db.Close(); err != nil {
+		log.Error("Failed to close database")
 	}
-	return
+	log.Info("Close database success")
 }
 
 // NewSession creates a new session for next operations
diff --git a/gee-orm/day1-database-sql/geeorm_test.go b/gee-orm/day1-database-sql/geeorm_test.go
index 35628be..c6da191 100644
--- a/gee-orm/day1-database-sql/geeorm_test.go
+++ b/gee-orm/day1-database-sql/geeorm_test.go
@@ -16,5 +16,5 @@ func OpenDB(t *testing.T) *Engine {
 
 func TestNewEngine(t *testing.T) {
 	engine := OpenDB(t)
-	_ = engine.Close()
+	defer engine.Close()
 }
diff --git a/gee-orm/day1-database-sql/session/raw.go b/gee-orm/day1-database-sql/session/raw.go
index a0e84cd..f9f4f87 100644
--- a/gee-orm/day1-database-sql/session/raw.go
+++ b/gee-orm/day1-database-sql/session/raw.go
@@ -3,13 +3,14 @@ package session
 import (
 	"database/sql"
 	"geeorm/log"
+	"strings"
 )
 
 // Session keep a pointer to sql.DB and provides all execution of all
 // kind of database operations.
 type Session struct {
 	db      *sql.DB
-	sql     string
+	sql     strings.Builder
 	sqlVars []interface{}
 }
 
@@ -20,15 +21,20 @@ func New(db *sql.DB) *Session {
 
 // Clear initialize the state of a session
 func (s *Session) Clear() {
+	s.sql.Reset()
 	s.sqlVars = nil
-	s.sql = ""
+}
+
+// DB returns *sql.DB
+func (s *Session) DB() *sql.DB {
+	return s.db
 }
 
 // Exec raw sql with sqlVars
 func (s *Session) Exec() (result sql.Result, err error) {
 	defer s.Clear()
-	log.Info(s.sql, s.sqlVars)
-	if result, err = s.db.Exec(s.sql, s.sqlVars...); err != nil {
+	log.Info(s.sql.String(), s.sqlVars)
+	if result, err = s.DB().Exec(s.sql.String(), s.sqlVars...); err != nil {
 		log.Error(err)
 	}
 	return
@@ -37,15 +43,15 @@ func (s *Session) Exec() (result sql.Result, err error) {
 // QueryRow gets a record from db
 func (s *Session) QueryRow() *sql.Row {
 	defer s.Clear()
-	log.Info(s.sql, s.sqlVars)
-	return s.db.QueryRow(s.sql, s.sqlVars...)
+	log.Info(s.sql.String(), s.sqlVars)
+	return s.DB().QueryRow(s.sql.String(), s.sqlVars...)
 }
 
 // QueryRows gets a list of records from db
 func (s *Session) QueryRows() (rows *sql.Rows, err error) {
 	defer s.Clear()
-	log.Info(s.sql, s.sqlVars)
-	if rows, err = s.db.Query(s.sql, s.sqlVars...); err != nil {
+	log.Info(s.sql.String(), s.sqlVars)
+	if rows, err = s.DB().Query(s.sql.String(), s.sqlVars...); err != nil {
 		log.Error(err)
 	}
 	return
@@ -53,7 +59,8 @@ func (s *Session) QueryRows() (rows *sql.Rows, err error) {
 
 // Raw appends sql and sqlVars
 func (s *Session) Raw(sql string, values ...interface{}) *Session {
-	s.sql += sql
+	s.sql.WriteString(sql)
+	s.sql.WriteString(" ")
 	s.sqlVars = append(s.sqlVars, values...)
 	return s
 }
diff --git a/gee-orm/day1-database-sql/session/raw_test.go b/gee-orm/day1-database-sql/session/raw_test.go
index fbb1f1b..8a18162 100644
--- a/gee-orm/day1-database-sql/session/raw_test.go
+++ b/gee-orm/day1-database-sql/session/raw_test.go
@@ -25,7 +25,7 @@ func TestSession_Exec(t *testing.T) {
 	s := NewSession()
 	_, _ = s.Raw("DROP TABLE IF EXISTS User;").Exec()
 	_, _ = s.Raw("CREATE TABLE User(name text);").Exec()
-	result, _ := s.Raw("INSERT INTO User(`name`) values (?), (?)", "Tom", "Sam").Exec()
+	result, _ := s.Raw("INSERT INTO User(`Name`) values (?), (?)", "Tom", "Sam").Exec()
 	if count, err := result.RowsAffected(); err != nil || count != 2 {
 		t.Fatal("expect 2, but got", count)
 	}
@@ -34,7 +34,7 @@ func TestSession_Exec(t *testing.T) {
 func TestSession_QueryRows(t *testing.T) {
 	s := NewSession()
 	_, _ = s.Raw("DROP TABLE IF EXISTS User;").Exec()
-	_, _ = s.Raw("CREATE TABLE User(name text);").Exec()
+	_, _ = s.Raw("CREATE TABLE User(Name text);").Exec()
 	row := s.Raw("SELECT count(*) FROM User").QueryRow()
 	var count int
 	if err := row.Scan(&count); err != nil || count != 0 {
diff --git a/gee-orm/day2-reflect-schema/geeorm.go b/gee-orm/day2-reflect-schema/geeorm.go
index 61ee9e0..b1881ce 100644
--- a/gee-orm/day2-reflect-schema/geeorm.go
+++ b/gee-orm/day2-reflect-schema/geeorm.go
@@ -38,14 +38,14 @@ func NewEngine(driver, source string) (e *Engine, err error) {
 }
 
 // Close database connection
-func (e *Engine) Close() (err error) {
-	if err = e.db.Close(); err == nil {
-		log.Info("Close database success")
+func (engine *Engine) Close() {
+	if err := engine.db.Close(); err != nil {
+		log.Error("Failed to close database")
 	}
-	return
+	log.Info("Close database success")
 }
 
 // NewSession creates a new session for next operations
-func (e *Engine) NewSession() *session.Session {
-	return session.New(e.db, e.dialect)
+func (engine *Engine) NewSession() *session.Session {
+	return session.New(engine.db, engine.dialect)
 }
diff --git a/gee-orm/day2-reflect-schema/geeorm_test.go b/gee-orm/day2-reflect-schema/geeorm_test.go
index 35628be..c6da191 100644
--- a/gee-orm/day2-reflect-schema/geeorm_test.go
+++ b/gee-orm/day2-reflect-schema/geeorm_test.go
@@ -16,5 +16,5 @@ func OpenDB(t *testing.T) *Engine {
 
 func TestNewEngine(t *testing.T) {
 	engine := OpenDB(t)
-	_ = engine.Close()
+	defer engine.Close()
 }
diff --git a/gee-orm/day2-reflect-schema/schema/schema.go b/gee-orm/day2-reflect-schema/schema/schema.go
index f942aa0..ff76283 100644
--- a/gee-orm/day2-reflect-schema/schema/schema.go
+++ b/gee-orm/day2-reflect-schema/schema/schema.go
@@ -1,7 +1,6 @@
 package schema
 
 import (
-	"fmt"
 	"geeorm/dialect"
 	"go/ast"
 	"reflect"
@@ -10,20 +9,26 @@ import (
 // Field represents a column of database
 type Field struct {
 	Name string
+	Type string
 	Tag  string
 }
 
 // Schema represents a table of database
 type Schema struct {
-	TableName    string
-	PrimaryField *Field
-	Fields       []*Field
-	FieldNames   []string
-	BindVars     []string
+	Model      interface{}
+	Name       string
+	Fields     []*Field
+	FieldNames []string
+	fieldMap   map[string]*Field
+}
+
+// GetField returns field by name
+func (schema *Schema) GetField(name string) *Field {
+	return schema.fieldMap[name]
 }
 
 // Values return the values of dest's member variables
-func (schema *Schema) Values(dest interface{}) []interface{} {
+func (schema *Schema) RecordValues(dest interface{}) []interface{} {
 	destValue := reflect.Indirect(reflect.ValueOf(dest))
 	var fieldValues []interface{}
 	for _, field := range schema.Fields {
@@ -36,8 +41,9 @@ func (schema *Schema) Values(dest interface{}) []interface{} {
 func Parse(dest interface{}, d dialect.Dialect) *Schema {
 	modelType := reflect.Indirect(reflect.ValueOf(dest)).Type()
 	schema := &Schema{
-		TableName:    modelType.Name(),
-		PrimaryField: &Field{Name: "ID", Tag: ""},
+		Model:    dest,
+		Name:     modelType.Name(),
+		fieldMap: make(map[string]*Field),
 	}
 
 	for i := 0; i < modelType.NumField(); i++ {
@@ -45,25 +51,15 @@ func Parse(dest interface{}, d dialect.Dialect) *Schema {
 		if !p.Anonymous && ast.IsExported(p.Name) {
 			field := &Field{
 				Name: p.Name,
-				Tag:  d.DataTypeOf(reflect.Indirect(reflect.New(p.Type))),
+				Type: d.DataTypeOf(reflect.Indirect(reflect.New(p.Type))),
 			}
-			if v, ok := p.Tag.Lookup("geeorm"); ok && v == "primary_key" {
-				schema.PrimaryField = field
+			if v, ok := p.Tag.Lookup("geeorm"); ok {
+				field.Tag = v
 			}
 			schema.Fields = append(schema.Fields, field)
 			schema.FieldNames = append(schema.FieldNames, p.Name)
-			schema.BindVars = append(schema.BindVars, "?")
+			schema.fieldMap[p.Name] = field
 		}
 	}
 	return schema
 }
-
-// String returns readable string
-func (field *Field) String() string {
-	return fmt.Sprintf("(%s %s)", field.Name, field.Tag)
-}
-
-// String returns readable string
-func (schema *Schema) String() string {
-	return fmt.Sprintf("TABLE %s %v", schema.TableName, schema.Fields)
-}
\ No newline at end of file
diff --git a/gee-orm/day2-reflect-schema/schema/schema_test.go b/gee-orm/day2-reflect-schema/schema/schema_test.go
index 34725b7..47ae9fc 100644
--- a/gee-orm/day2-reflect-schema/schema/schema_test.go
+++ b/gee-orm/day2-reflect-schema/schema/schema_test.go
@@ -6,7 +6,7 @@ import (
 )
 
 type User struct {
-	Name string `geeorm:"primary_key"`
+	Name string `geeorm:"PRIMARY KEY"`
 	Age  int
 }
 
@@ -14,17 +14,17 @@ var TestDial, _ = dialect.GetDialect("sqlite3")
 
 func TestParse(t *testing.T) {
 	schema := Parse(&User{}, TestDial)
-	if schema.TableName != "User" || len(schema.Fields) != 2 {
+	if schema.Name != "User" || len(schema.Fields) != 2 {
 		t.Fatal("failed to parse User struct")
 	}
-	if schema.PrimaryField.Name != "Name" {
+	if schema.GetField("Name").Tag != "PRIMARY KEY" {
 		t.Fatal("failed to parse primary key")
 	}
 }
 
-func TestSchema_Values(t *testing.T) {
+func TestSchema_RecordValues(t *testing.T) {
 	schema := Parse(&User{}, TestDial)
-	values := schema.Values(&User{"Tom", 18})
+	values := schema.RecordValues(&User{"Tom", 18})
 
 	name := values[0].(string)
 	age := values[1].(int)
diff --git a/gee-orm/day2-reflect-schema/session/raw.go b/gee-orm/day2-reflect-schema/session/raw.go
index abaaeb7..862c501 100644
--- a/gee-orm/day2-reflect-schema/session/raw.go
+++ b/gee-orm/day2-reflect-schema/session/raw.go
@@ -5,6 +5,7 @@ import (
 	"geeorm/dialect"
 	"geeorm/log"
 	"geeorm/schema"
+	"strings"
 )
 
 // Session keep a pointer to sql.DB and provides all execution of all
@@ -13,7 +14,7 @@ type Session struct {
 	db       *sql.DB
 	dialect  dialect.Dialect
 	refTable *schema.Schema
-	sql      string
+	sql      strings.Builder
 	sqlVars  []interface{}
 }
 
@@ -27,15 +28,20 @@ func New(db *sql.DB, dialect dialect.Dialect) *Session {
 
 // Clear initialize the state of a session
 func (s *Session) Clear() {
+	s.sql.Reset()
 	s.sqlVars = nil
-	s.sql = ""
+}
+
+// DB returns *sql.DB
+func (s *Session) DB() *sql.DB {
+	return s.db
 }
 
 // Exec raw sql with sqlVars
 func (s *Session) Exec() (result sql.Result, err error) {
 	defer s.Clear()
-	log.Info(s.sql, s.sqlVars)
-	if result, err = s.db.Exec(s.sql, s.sqlVars...); err != nil {
+	log.Info(s.sql.String(), s.sqlVars)
+	if result, err = s.DB().Exec(s.sql.String(), s.sqlVars...); err != nil {
 		log.Error(err)
 	}
 	return
@@ -44,15 +50,15 @@ func (s *Session) Exec() (result sql.Result, err error) {
 // QueryRow gets a record from db
 func (s *Session) QueryRow() *sql.Row {
 	defer s.Clear()
-	log.Info(s.sql, s.sqlVars)
-	return s.db.QueryRow(s.sql, s.sqlVars...)
+	log.Info(s.sql.String(), s.sqlVars)
+	return s.DB().QueryRow(s.sql.String(), s.sqlVars...)
 }
 
 // QueryRows gets a list of records from db
 func (s *Session) QueryRows() (rows *sql.Rows, err error) {
 	defer s.Clear()
-	log.Info(s.sql, s.sqlVars)
-	if rows, err = s.db.Query(s.sql, s.sqlVars...); err != nil {
+	log.Info(s.sql.String(), s.sqlVars)
+	if rows, err = s.DB().Query(s.sql.String(), s.sqlVars...); err != nil {
 		log.Error(err)
 	}
 	return
@@ -60,7 +66,8 @@ func (s *Session) QueryRows() (rows *sql.Rows, err error) {
 
 // Raw appends sql and sqlVars
 func (s *Session) Raw(sql string, values ...interface{}) *Session {
-	s.sql += sql
+	s.sql.WriteString(sql)
+	s.sql.WriteString(" ")
 	s.sqlVars = append(s.sqlVars, values...)
 	return s
 }
diff --git a/gee-orm/day2-reflect-schema/session/raw_test.go b/gee-orm/day2-reflect-schema/session/raw_test.go
index ed447a5..a96770b 100644
--- a/gee-orm/day2-reflect-schema/session/raw_test.go
+++ b/gee-orm/day2-reflect-schema/session/raw_test.go
@@ -30,7 +30,7 @@ func TestSession_Exec(t *testing.T) {
 	s := NewSession()
 	_, _ = s.Raw("DROP TABLE IF EXISTS User;").Exec()
 	_, _ = s.Raw("CREATE TABLE User(name text);").Exec()
-	result, _ := s.Raw("INSERT INTO User(`name`) values (?), (?)", "Tom", "Sam").Exec()
+	result, _ := s.Raw("INSERT INTO User(`Name`) values (?), (?)", "Tom", "Sam").Exec()
 	if count, err := result.RowsAffected(); err != nil || count != 2 {
 		t.Fatal("expect 2, but got", count)
 	}
@@ -39,7 +39,7 @@ func TestSession_Exec(t *testing.T) {
 func TestSession_QueryRows(t *testing.T) {
 	s := NewSession()
 	_, _ = s.Raw("DROP TABLE IF EXISTS User;").Exec()
-	_, _ = s.Raw("CREATE TABLE User(name text);").Exec()
+	_, _ = s.Raw("CREATE TABLE User(Name text);").Exec()
 	row := s.Raw("SELECT count(*) FROM User").QueryRow()
 	var count int
 	if err := row.Scan(&count); err != nil || count != 0 {
diff --git a/gee-orm/day2-reflect-schema/session/table.go b/gee-orm/day2-reflect-schema/session/table.go
index 525e249..58e7b0f 100644
--- a/gee-orm/day2-reflect-schema/session/table.go
+++ b/gee-orm/day2-reflect-schema/session/table.go
@@ -2,58 +2,53 @@ package session
 
 import (
 	"fmt"
+	"geeorm/log"
+	"reflect"
 	"strings"
 
 	"geeorm/schema"
 )
 
-// RefTable returns a Schema instance that contains all parsed fields
-func (s *Session) RefTable(value interface{}) *schema.Schema {
-	if value == nil {
-		panic("value is nil")
+// Model assigns refTable
+func (s *Session) Model(value interface{}) *Session {
+	// nil or different model, update refTable
+	if s.refTable == nil || reflect.TypeOf(value) != reflect.TypeOf(s.refTable.Model) {
+		s.refTable = schema.Parse(value, s.dialect)
 	}
+	return s
+}
+
+// RefTable returns a Schema instance that contains all parsed fields
+func (s *Session) RefTable() *schema.Schema {
 	if s.refTable == nil {
-		s.refTable = schema.Parse(value, s.dialect)
+		log.Error("Model is not set")
 	}
 	return s.refTable
 }
 
 // CreateTable create a table in database with a model
-func (s *Session) CreateTable(value interface{}) error {
-	table := s.RefTable(value)
+func (s *Session) CreateTable() error {
+	table := s.RefTable()
 	var columns []string
 	for _, field := range table.Fields {
-		tag := field.Tag
-		if field.Name == table.PrimaryField.Name {
-			tag = table.PrimaryField.Tag
-		}
-		columns = append(columns, fmt.Sprintf("%s %s", field.Name, tag))
+		columns = append(columns, fmt.Sprintf("%s %s %s", field.Name, field.Type, field.Tag))
 	}
 	desc := strings.Join(columns, ",")
-	_, err := s.Raw(fmt.Sprintf("CREATE TABLE %s (%s);", table.TableName, desc)).Exec()
+	_, err := s.Raw(fmt.Sprintf("CREATE TABLE %s (%s);", table.Name, desc)).Exec()
 	return err
 }
 
 // DropTable drops a table with the name of model
-func (s *Session) DropTable(value interface{}) error {
-	table := s.RefTable(value)
-	_, err := s.Raw(fmt.Sprintf("DROP TABLE IF EXISTS %s", table.TableName)).Exec()
+func (s *Session) DropTable() error {
+	_, err := s.Raw(fmt.Sprintf("DROP TABLE IF EXISTS %s", s.RefTable().Name)).Exec()
 	return err
 }
 
-func (s *Session) guessTableName(value interface{}) string {
-	if tableName, ok := value.(string); ok {
-		return tableName
-	}
-	return s.RefTable(value).TableName
-}
-
 // HasTable returns true of the table exists
-func (s *Session) HasTable(value interface{}) bool {
-	tableName := s.guessTableName(value)
-	sql, values := s.dialect.TableExistSQL(tableName)
+func (s *Session) HasTable() bool {
+	sql, values := s.dialect.TableExistSQL(s.RefTable().Name)
 	row := s.Raw(sql, values...).QueryRow()
 	var tmp string
 	_ = row.Scan(&tmp)
-	return tmp == tableName
+	return tmp == s.RefTable().Name
 }
diff --git a/gee-orm/day2-reflect-schema/session/table_test.go b/gee-orm/day2-reflect-schema/session/table_test.go
index 7ed38ac..c070c7b 100644
--- a/gee-orm/day2-reflect-schema/session/table_test.go
+++ b/gee-orm/day2-reflect-schema/session/table_test.go
@@ -5,15 +5,23 @@ import (
 )
 
 type User struct {
-	Name string
+	Name string `geeorm:"PRIMARY KEY"`
 	Age  int
 }
-
 func TestSession_CreateTable(t *testing.T) {
-	s := NewSession()
-	_ = s.DropTable(&User{})
-	_ = s.CreateTable(&User{})
-	if !s.HasTable("User") {
-		t.Fatal("failed to create table User")
+	s := NewSession().Model(&User{})
+	_ = s.DropTable()
+	_ = s.CreateTable()
+	if !s.HasTable() {
+		t.Fatal("Failed to create table User")
+	}
+}
+
+func TestSession_Model(t *testing.T) {
+	s := NewSession().Model(&User{})
+	table := s.RefTable()
+	s.Model(&Session{})
+	if table.Name != "User" || s.RefTable().Name != "Session" {
+		t.Fatal("Failed to change model")
 	}
 }
diff --git a/gee-orm/day3-save-query/clause/generator.go b/gee-orm/day3-save-query/clause/generator.go
index 0ac29ee..b257469 100644
--- a/gee-orm/day3-save-query/clause/generator.go
+++ b/gee-orm/day3-save-query/clause/generator.go
@@ -16,7 +16,7 @@ func init() {
 	generators[SELECT] = _select
 	generators[LIMIT] = _limit
 	generators[WHERE] = _where
-	generators[ORDERBY] = _orderby
+	generators[ORDERBY] = _orderBy
 }
 
 func genBindVars(num int) string {
@@ -73,6 +73,6 @@ func _where(values ...interface{}) (string, []interface{}) {
 	return fmt.Sprintf("WHERE %s", desc), vars
 }
 
-func _orderby(values ...interface{}) (string, []interface{}) {
+func _orderBy(values ...interface{}) (string, []interface{}) {
 	return fmt.Sprintf("ORDER BY %s", values[0]), []interface{}{}
 }
diff --git a/gee-orm/day3-save-query/geeorm.go b/gee-orm/day3-save-query/geeorm.go
index 61ee9e0..b1881ce 100644
--- a/gee-orm/day3-save-query/geeorm.go
+++ b/gee-orm/day3-save-query/geeorm.go
@@ -38,14 +38,14 @@ func NewEngine(driver, source string) (e *Engine, err error) {
 }
 
 // Close database connection
-func (e *Engine) Close() (err error) {
-	if err = e.db.Close(); err == nil {
-		log.Info("Close database success")
+func (engine *Engine) Close() {
+	if err := engine.db.Close(); err != nil {
+		log.Error("Failed to close database")
 	}
-	return
+	log.Info("Close database success")
 }
 
 // NewSession creates a new session for next operations
-func (e *Engine) NewSession() *session.Session {
-	return session.New(e.db, e.dialect)
+func (engine *Engine) NewSession() *session.Session {
+	return session.New(engine.db, engine.dialect)
 }
diff --git a/gee-orm/day3-save-query/geeorm_test.go b/gee-orm/day3-save-query/geeorm_test.go
index 35628be..c6da191 100644
--- a/gee-orm/day3-save-query/geeorm_test.go
+++ b/gee-orm/day3-save-query/geeorm_test.go
@@ -16,5 +16,5 @@ func OpenDB(t *testing.T) *Engine {
 
 func TestNewEngine(t *testing.T) {
 	engine := OpenDB(t)
-	_ = engine.Close()
+	defer engine.Close()
 }
diff --git a/gee-orm/day3-save-query/schema/schema.go b/gee-orm/day3-save-query/schema/schema.go
index 8519fd4..ff76283 100644
--- a/gee-orm/day3-save-query/schema/schema.go
+++ b/gee-orm/day3-save-query/schema/schema.go
@@ -1,7 +1,6 @@
 package schema
 
 import (
-	"fmt"
 	"geeorm/dialect"
 	"go/ast"
 	"reflect"
@@ -10,19 +9,26 @@ import (
 // Field represents a column of database
 type Field struct {
 	Name string
+	Type string
 	Tag  string
 }
 
 // Schema represents a table of database
 type Schema struct {
-	TableName    string
-	PrimaryField *Field
-	Fields       []*Field
-	FieldNames   []string
+	Model      interface{}
+	Name       string
+	Fields     []*Field
+	FieldNames []string
+	fieldMap   map[string]*Field
+}
+
+// GetField returns field by name
+func (schema *Schema) GetField(name string) *Field {
+	return schema.fieldMap[name]
 }
 
 // Values return the values of dest's member variables
-func (schema *Schema) Values(dest interface{}) []interface{} {
+func (schema *Schema) RecordValues(dest interface{}) []interface{} {
 	destValue := reflect.Indirect(reflect.ValueOf(dest))
 	var fieldValues []interface{}
 	for _, field := range schema.Fields {
@@ -35,8 +41,9 @@ func (schema *Schema) Values(dest interface{}) []interface{} {
 func Parse(dest interface{}, d dialect.Dialect) *Schema {
 	modelType := reflect.Indirect(reflect.ValueOf(dest)).Type()
 	schema := &Schema{
-		TableName:    modelType.Name(),
-		PrimaryField: &Field{Name: "ID", Tag: ""},
+		Model:    dest,
+		Name:     modelType.Name(),
+		fieldMap: make(map[string]*Field),
 	}
 
 	for i := 0; i < modelType.NumField(); i++ {
@@ -44,24 +51,15 @@ func Parse(dest interface{}, d dialect.Dialect) *Schema {
 		if !p.Anonymous && ast.IsExported(p.Name) {
 			field := &Field{
 				Name: p.Name,
-				Tag:  d.DataTypeOf(reflect.Indirect(reflect.New(p.Type))),
+				Type: d.DataTypeOf(reflect.Indirect(reflect.New(p.Type))),
 			}
-			if v, ok := p.Tag.Lookup("geeorm"); ok && v == "primary_key" {
-				schema.PrimaryField = field
+			if v, ok := p.Tag.Lookup("geeorm"); ok {
+				field.Tag = v
 			}
 			schema.Fields = append(schema.Fields, field)
 			schema.FieldNames = append(schema.FieldNames, p.Name)
+			schema.fieldMap[p.Name] = field
 		}
 	}
 	return schema
 }
-
-// String returns readable string
-func (field *Field) String() string {
-	return fmt.Sprintf("(%s %s)", field.Name, field.Tag)
-}
-
-// String returns readable string
-func (schema *Schema) String() string {
-	return fmt.Sprintf("TABLE %s %v", schema.TableName, schema.Fields)
-}
diff --git a/gee-orm/day3-save-query/schema/schema_test.go b/gee-orm/day3-save-query/schema/schema_test.go
index aba3e0b..47ae9fc 100644
--- a/gee-orm/day3-save-query/schema/schema_test.go
+++ b/gee-orm/day3-save-query/schema/schema_test.go
@@ -6,7 +6,7 @@ import (
 )
 
 type User struct {
-	Name string `geeorm:"primary_key"`
+	Name string `geeorm:"PRIMARY KEY"`
 	Age  int
 }
 
@@ -14,18 +14,17 @@ var TestDial, _ = dialect.GetDialect("sqlite3")
 
 func TestParse(t *testing.T) {
 	schema := Parse(&User{}, TestDial)
-	if schema.TableName != "User" || len(schema.Fields) != 2 {
+	if schema.Name != "User" || len(schema.Fields) != 2 {
 		t.Fatal("failed to parse User struct")
 	}
-	if schema.PrimaryField.Name != "Name" {
+	if schema.GetField("Name").Tag != "PRIMARY KEY" {
 		t.Fatal("failed to parse primary key")
 	}
-	t.Log(schema)
 }
 
-func TestSchema_Values(t *testing.T) {
+func TestSchema_RecordValues(t *testing.T) {
 	schema := Parse(&User{}, TestDial)
-	values := schema.Values(&User{"Tom", 18})
+	values := schema.RecordValues(&User{"Tom", 18})
 
 	name := values[0].(string)
 	age := values[1].(int)
diff --git a/gee-orm/day3-save-query/session/raw.go b/gee-orm/day3-save-query/session/raw.go
index a47edcc..161fcb4 100644
--- a/gee-orm/day3-save-query/session/raw.go
+++ b/gee-orm/day3-save-query/session/raw.go
@@ -6,6 +6,7 @@ import (
 	"geeorm/dialect"
 	"geeorm/log"
 	"geeorm/schema"
+	"strings"
 )
 
 // Session keep a pointer to sql.DB and provides all execution of all
@@ -15,7 +16,7 @@ type Session struct {
 	dialect  dialect.Dialect
 	refTable *schema.Schema
 	clause   clause.Clause
-	sql      string
+	sql      strings.Builder
 	sqlVars  []interface{}
 }
 
@@ -29,16 +30,21 @@ func New(db *sql.DB, dialect dialect.Dialect) *Session {
 
 // Clear initialize the state of a session
 func (s *Session) Clear() {
-	s.refTable, s.sqlVars = nil, nil
+	s.sql.Reset()
+	s.sqlVars = nil
 	s.clause = clause.Clause{}
-	s.sql = ""
+}
+
+// DB returns *sql.DB
+func (s *Session) DB() *sql.DB {
+	return s.db
 }
 
 // Exec raw sql with sqlVars
 func (s *Session) Exec() (result sql.Result, err error) {
 	defer s.Clear()
-	log.Info(s.sql, s.sqlVars)
-	if result, err = s.db.Exec(s.sql, s.sqlVars...); err != nil {
+	log.Info(s.sql.String(), s.sqlVars)
+	if result, err = s.DB().Exec(s.sql.String(), s.sqlVars...); err != nil {
 		log.Error(err)
 	}
 	return
@@ -47,15 +53,15 @@ func (s *Session) Exec() (result sql.Result, err error) {
 // QueryRow gets a record from db
 func (s *Session) QueryRow() *sql.Row {
 	defer s.Clear()
-	log.Info(s.sql, s.sqlVars)
-	return s.db.QueryRow(s.sql, s.sqlVars...)
+	log.Info(s.sql.String(), s.sqlVars)
+	return s.DB().QueryRow(s.sql.String(), s.sqlVars...)
 }
 
 // QueryRows gets a list of records from db
 func (s *Session) QueryRows() (rows *sql.Rows, err error) {
 	defer s.Clear()
-	log.Info(s.sql, s.sqlVars)
-	if rows, err = s.db.Query(s.sql, s.sqlVars...); err != nil {
+	log.Info(s.sql.String(), s.sqlVars)
+	if rows, err = s.DB().Query(s.sql.String(), s.sqlVars...); err != nil {
 		log.Error(err)
 	}
 	return
@@ -63,7 +69,8 @@ func (s *Session) QueryRows() (rows *sql.Rows, err error) {
 
 // Raw appends sql and sqlVars
 func (s *Session) Raw(sql string, values ...interface{}) *Session {
-	s.sql += sql
+	s.sql.WriteString(sql)
+	s.sql.WriteString(" ")
 	s.sqlVars = append(s.sqlVars, values...)
 	return s
-}
+}
\ No newline at end of file
diff --git a/gee-orm/day3-save-query/session/raw_test.go b/gee-orm/day3-save-query/session/raw_test.go
index ed447a5..a96770b 100644
--- a/gee-orm/day3-save-query/session/raw_test.go
+++ b/gee-orm/day3-save-query/session/raw_test.go
@@ -30,7 +30,7 @@ func TestSession_Exec(t *testing.T) {
 	s := NewSession()
 	_, _ = s.Raw("DROP TABLE IF EXISTS User;").Exec()
 	_, _ = s.Raw("CREATE TABLE User(name text);").Exec()
-	result, _ := s.Raw("INSERT INTO User(`name`) values (?), (?)", "Tom", "Sam").Exec()
+	result, _ := s.Raw("INSERT INTO User(`Name`) values (?), (?)", "Tom", "Sam").Exec()
 	if count, err := result.RowsAffected(); err != nil || count != 2 {
 		t.Fatal("expect 2, but got", count)
 	}
@@ -39,7 +39,7 @@ func TestSession_Exec(t *testing.T) {
 func TestSession_QueryRows(t *testing.T) {
 	s := NewSession()
 	_, _ = s.Raw("DROP TABLE IF EXISTS User;").Exec()
-	_, _ = s.Raw("CREATE TABLE User(name text);").Exec()
+	_, _ = s.Raw("CREATE TABLE User(Name text);").Exec()
 	row := s.Raw("SELECT count(*) FROM User").QueryRow()
 	var count int
 	if err := row.Scan(&count); err != nil || count != 0 {
diff --git a/gee-orm/day3-save-query/session/record.go b/gee-orm/day3-save-query/session/record.go
index 1a0672a..69fd50d 100644
--- a/gee-orm/day3-save-query/session/record.go
+++ b/gee-orm/day3-save-query/session/record.go
@@ -6,12 +6,12 @@ import (
 )
 
 // Create one or more records in database
-func (s *Session) Create(values ...interface{}) (int64, error) {
+func (s *Session) Insert(values ...interface{}) (int64, error) {
 	recordValues := make([]interface{}, 0)
 	for _, value := range values {
-		table := s.RefTable(value)
-		s.clause.Set(clause.INSERT, table.TableName, table.FieldNames)
-		recordValues = append(recordValues, table.Values(value))
+		table := s.Model(value).RefTable()
+		s.clause.Set(clause.INSERT, table.Name, table.FieldNames)
+		recordValues = append(recordValues, table.RecordValues(value))
 	}
 
 	s.clause.Set(clause.VALUES, recordValues...)
@@ -28,9 +28,9 @@ func (s *Session) Create(values ...interface{}) (int64, error) {
 func (s *Session) Find(values interface{}) error {
 	destSlice := reflect.Indirect(reflect.ValueOf(values))
 	destType := destSlice.Type().Elem()
-	table := s.RefTable(reflect.New(destType).Elem().Interface())
+	table := s.Model(reflect.New(destType).Elem().Interface()).RefTable()
 
-	s.clause.Set(clause.SELECT, table.TableName, table.FieldNames)
+	s.clause.Set(clause.SELECT, table.Name, table.FieldNames)
 	sql, vars := s.clause.Build(clause.SELECT, clause.WHERE, clause.ORDERBY, clause.LIMIT)
 	rows, err := s.Raw(sql, vars...).QueryRows()
 	if err != nil {
diff --git a/gee-orm/day3-save-query/session/record_test.go b/gee-orm/day3-save-query/session/record_test.go
index 08881fa..67bfb2a 100644
--- a/gee-orm/day3-save-query/session/record_test.go
+++ b/gee-orm/day3-save-query/session/record_test.go
@@ -10,19 +10,19 @@ var (
 
 func testRecordInit(t *testing.T) *Session {
 	t.Helper()
-	s := NewSession()
-	err1 := s.DropTable(&User{})
-	err2 := s.CreateTable(&User{})
-	_, err3 := s.Create(user1, user2)
+	s := NewSession().Model(&User{})
+	err1 := s.DropTable()
+	err2 := s.CreateTable()
+	_, err3 := s.Insert(user1, user2)
 	if err1 != nil || err2 != nil || err3 != nil {
 		t.Fatal("failed init test records")
 	}
 	return s
 }
 
-func TestSession_Create(t *testing.T) {
+func TestSession_Insert(t *testing.T) {
 	s := testRecordInit(t)
-	affected, err := s.Create(user3)
+	affected, err := s.Insert(user3)
 	if err != nil || affected != 1 {
 		t.Fatal("failed to create record")
 	}
@@ -30,7 +30,7 @@ func TestSession_Create(t *testing.T) {
 
 func TestSession_Find(t *testing.T) {
 	s := testRecordInit(t)
-	users := []User{}
+	var users []User
 	if err := s.Find(&users); err != nil || len(users) != 2 {
 		t.Fatal("failed to query all")
 	}
diff --git a/gee-orm/day3-save-query/session/table.go b/gee-orm/day3-save-query/session/table.go
index b644d3a..58e7b0f 100644
--- a/gee-orm/day3-save-query/session/table.go
+++ b/gee-orm/day3-save-query/session/table.go
@@ -2,58 +2,53 @@ package session
 
 import (
 	"fmt"
+	"geeorm/log"
+	"reflect"
 	"strings"
 
 	"geeorm/schema"
 )
 
-// RefTable returns a Schema instance that contains all parsed fields
-func (s *Session) RefTable(value interface{}) *schema.Schema {
-	if value == nil {
-		panic("value is nil")
+// Model assigns refTable
+func (s *Session) Model(value interface{}) *Session {
+	// nil or different model, update refTable
+	if s.refTable == nil || reflect.TypeOf(value) != reflect.TypeOf(s.refTable.Model) {
+		s.refTable = schema.Parse(value, s.dialect)
 	}
+	return s
+}
+
+// RefTable returns a Schema instance that contains all parsed fields
+func (s *Session) RefTable() *schema.Schema {
 	if s.refTable == nil {
-		s.refTable = schema.Parse(value, s.dialect)
+		log.Error("Model is not set")
 	}
 	return s.refTable
 }
 
 // CreateTable create a table in database with a model
-func (s *Session) CreateTable(value interface{}) error {
-	table := s.RefTable(value)
+func (s *Session) CreateTable() error {
+	table := s.RefTable()
 	var columns []string
 	for _, field := range table.Fields {
-		tag := field.Tag
-		if field.Name == table.PrimaryField.Name {
-			tag += " PRIMARY KEY"
-		}
-		columns = append(columns, fmt.Sprintf("%s %s", field.Name, tag))
+		columns = append(columns, fmt.Sprintf("%s %s %s", field.Name, field.Type, field.Tag))
 	}
 	desc := strings.Join(columns, ",")
-	_, err := s.Raw(fmt.Sprintf("CREATE TABLE %s (%s);", table.TableName, desc)).Exec()
+	_, err := s.Raw(fmt.Sprintf("CREATE TABLE %s (%s);", table.Name, desc)).Exec()
 	return err
 }
 
 // DropTable drops a table with the name of model
-func (s *Session) DropTable(value interface{}) error {
-	table := s.RefTable(value)
-	_, err := s.Raw(fmt.Sprintf("DROP TABLE IF EXISTS %s", table.TableName)).Exec()
+func (s *Session) DropTable() error {
+	_, err := s.Raw(fmt.Sprintf("DROP TABLE IF EXISTS %s", s.RefTable().Name)).Exec()
 	return err
 }
 
-func (s *Session) guessTableName(value interface{}) string {
-	if tableName, ok := value.(string); ok {
-		return tableName
-	}
-	return s.RefTable(value).TableName
-}
-
 // HasTable returns true of the table exists
-func (s *Session) HasTable(value interface{}) bool {
-	tableName := s.guessTableName(value)
-	sql, values := s.dialect.TableExistSQL(tableName)
+func (s *Session) HasTable() bool {
+	sql, values := s.dialect.TableExistSQL(s.RefTable().Name)
 	row := s.Raw(sql, values...).QueryRow()
 	var tmp string
 	_ = row.Scan(&tmp)
-	return tmp == tableName
+	return tmp == s.RefTable().Name
 }
diff --git a/gee-orm/day3-save-query/session/table_test.go b/gee-orm/day3-save-query/session/table_test.go
index 91eb519..3bb7554 100644
--- a/gee-orm/day3-save-query/session/table_test.go
+++ b/gee-orm/day3-save-query/session/table_test.go
@@ -5,15 +5,24 @@ import (
 )
 
 type User struct {
-	Name string `geeorm:"primary_key"`
+	Name string `geeorm:"PRIMARY KEY"`
 	Age  int
 }
 
 func TestSession_CreateTable(t *testing.T) {
-	s := NewSession()
-	_ = s.DropTable(&User{})
-	_ = s.CreateTable(&User{})
-	if !s.HasTable("User") {
-		t.Fatal("failed to create table User")
+	s := NewSession().Model(&User{})
+	_ = s.DropTable()
+	_ = s.CreateTable()
+	if !s.HasTable() {
+		t.Fatal("Failed to create table User")
+	}
+}
+
+func TestSession_Model(t *testing.T) {
+	s := NewSession().Model(&User{})
+	table := s.RefTable()
+	s.Model(&Session{})
+	if table.Name != "User" || s.RefTable().Name != "Session" {
+		t.Fatal("Failed to change model")
 	}
 }
diff --git a/gee-orm/day4-chain-operation/clause/clause.go b/gee-orm/day4-chain-operation/clause/clause.go
index daa930d..02fcf93 100644
--- a/gee-orm/day4-chain-operation/clause/clause.go
+++ b/gee-orm/day4-chain-operation/clause/clause.go
@@ -21,6 +21,9 @@ const (
 	LIMIT
 	WHERE
 	ORDERBY
+	UPDATE
+	DELETE
+	COUNT
 )
 
 // Set adds a sub clause of specific type
diff --git a/gee-orm/day4-chain-operation/clause/clause_test.go b/gee-orm/day4-chain-operation/clause/clause_test.go
index f5267ca..b54c6e0 100644
--- a/gee-orm/day4-chain-operation/clause/clause_test.go
+++ b/gee-orm/day4-chain-operation/clause/clause_test.go
@@ -32,8 +32,43 @@ func testSelect(t *testing.T) {
 	}
 }
 
+func testUpdate(t *testing.T) {
+	var clause Clause
+	clause.Set(UPDATE, "User", map[string]interface{}{"Age": 30, "Name": "Tommy"})
+	clause.Set(WHERE, "Name = ?", "Tom")
+	sql, vars := clause.Build(UPDATE, WHERE)
+	t.Log(sql, vars)
+	if sql != "UPDATE User SET Age = ?, Name = ? WHERE Name = ?" {
+		t.Fatal("failed to build SQL")
+	}
+	if !reflect.DeepEqual(vars, []interface{}{30, "Tommy", "Tom"}) {
+		t.Fatal("failed to build SQLVars")
+	}
+}
+
+func testDelete(t *testing.T) {
+	var clause Clause
+	clause.Set(DELETE, "User")
+	clause.Set(WHERE, "Name = ?", "Tom")
+
+	sql, vars := clause.Build(DELETE, WHERE)
+	t.Log(sql, vars)
+	if sql != "DELETE FROM User WHERE Name = ?" {
+		t.Fatal("failed to build SQL")
+	}
+	if !reflect.DeepEqual(vars, []interface{}{"Tom"}) {
+		t.Fatal("failed to build SQLVars")
+	}
+}
+
 func TestClause_Build(t *testing.T) {
 	t.Run("select", func(t *testing.T) {
 		testSelect(t)
 	})
+	t.Run("update", func(t *testing.T) {
+		testUpdate(t)
+	})
+	t.Run("delete", func(t *testing.T) {
+		testDelete(t)
+	})
 }
diff --git a/gee-orm/day4-chain-operation/clause/generator.go b/gee-orm/day4-chain-operation/clause/generator.go
index 0ac29ee..127fc43 100644
--- a/gee-orm/day4-chain-operation/clause/generator.go
+++ b/gee-orm/day4-chain-operation/clause/generator.go
@@ -16,7 +16,10 @@ func init() {
 	generators[SELECT] = _select
 	generators[LIMIT] = _limit
 	generators[WHERE] = _where
-	generators[ORDERBY] = _orderby
+	generators[ORDERBY] = _orderBy
+	generators[UPDATE] = _update
+	generators[DELETE] = _delete
+	generators[COUNT] = _count
 }
 
 func genBindVars(num int) string {
@@ -73,6 +76,26 @@ func _where(values ...interface{}) (string, []interface{}) {
 	return fmt.Sprintf("WHERE %s", desc), vars
 }
 
-func _orderby(values ...interface{}) (string, []interface{}) {
+func _orderBy(values ...interface{}) (string, []interface{}) {
 	return fmt.Sprintf("ORDER BY %s", values[0]), []interface{}{}
 }
+
+func _update(values ...interface{}) (string, []interface{}) {
+	tableName := values[0]
+	m := values[1].(map[string]interface{})
+	var keys []string
+	var vars []interface{}
+	for k, v := range m {
+		keys = append(keys, k+" = ?")
+		vars = append(vars, v)
+	}
+	return fmt.Sprintf("UPDATE %s SET %s", tableName, strings.Join(keys, ", ")), vars
+}
+
+func _delete(values ...interface{}) (string, []interface{}) {
+	return fmt.Sprintf("DELETE FROM %s", values[0]), []interface{}{}
+}
+
+func _count(values ...interface{}) (string, []interface{}) {
+	return _select(values[0], []string{"count(*)"})
+}
diff --git a/gee-orm/day4-chain-operation/geeorm.go b/gee-orm/day4-chain-operation/geeorm.go
index 61ee9e0..b1881ce 100644
--- a/gee-orm/day4-chain-operation/geeorm.go
+++ b/gee-orm/day4-chain-operation/geeorm.go
@@ -38,14 +38,14 @@ func NewEngine(driver, source string) (e *Engine, err error) {
 }
 
 // Close database connection
-func (e *Engine) Close() (err error) {
-	if err = e.db.Close(); err == nil {
-		log.Info("Close database success")
+func (engine *Engine) Close() {
+	if err := engine.db.Close(); err != nil {
+		log.Error("Failed to close database")
 	}
-	return
+	log.Info("Close database success")
 }
 
 // NewSession creates a new session for next operations
-func (e *Engine) NewSession() *session.Session {
-	return session.New(e.db, e.dialect)
+func (engine *Engine) NewSession() *session.Session {
+	return session.New(engine.db, engine.dialect)
 }
diff --git a/gee-orm/day4-chain-operation/geeorm_test.go b/gee-orm/day4-chain-operation/geeorm_test.go
index 35628be..c6da191 100644
--- a/gee-orm/day4-chain-operation/geeorm_test.go
+++ b/gee-orm/day4-chain-operation/geeorm_test.go
@@ -16,5 +16,5 @@ func OpenDB(t *testing.T) *Engine {
 
 func TestNewEngine(t *testing.T) {
 	engine := OpenDB(t)
-	_ = engine.Close()
+	defer engine.Close()
 }
diff --git a/gee-orm/day4-chain-operation/schema/schema.go b/gee-orm/day4-chain-operation/schema/schema.go
index 8519fd4..ff76283 100644
--- a/gee-orm/day4-chain-operation/schema/schema.go
+++ b/gee-orm/day4-chain-operation/schema/schema.go
@@ -1,7 +1,6 @@
 package schema
 
 import (
-	"fmt"
 	"geeorm/dialect"
 	"go/ast"
 	"reflect"
@@ -10,19 +9,26 @@ import (
 // Field represents a column of database
 type Field struct {
 	Name string
+	Type string
 	Tag  string
 }
 
 // Schema represents a table of database
 type Schema struct {
-	TableName    string
-	PrimaryField *Field
-	Fields       []*Field
-	FieldNames   []string
+	Model      interface{}
+	Name       string
+	Fields     []*Field
+	FieldNames []string
+	fieldMap   map[string]*Field
+}
+
+// GetField returns field by name
+func (schema *Schema) GetField(name string) *Field {
+	return schema.fieldMap[name]
 }
 
 // Values return the values of dest's member variables
-func (schema *Schema) Values(dest interface{}) []interface{} {
+func (schema *Schema) RecordValues(dest interface{}) []interface{} {
 	destValue := reflect.Indirect(reflect.ValueOf(dest))
 	var fieldValues []interface{}
 	for _, field := range schema.Fields {
@@ -35,8 +41,9 @@ func (schema *Schema) Values(dest interface{}) []interface{} {
 func Parse(dest interface{}, d dialect.Dialect) *Schema {
 	modelType := reflect.Indirect(reflect.ValueOf(dest)).Type()
 	schema := &Schema{
-		TableName:    modelType.Name(),
-		PrimaryField: &Field{Name: "ID", Tag: ""},
+		Model:    dest,
+		Name:     modelType.Name(),
+		fieldMap: make(map[string]*Field),
 	}
 
 	for i := 0; i < modelType.NumField(); i++ {
@@ -44,24 +51,15 @@ func Parse(dest interface{}, d dialect.Dialect) *Schema {
 		if !p.Anonymous && ast.IsExported(p.Name) {
 			field := &Field{
 				Name: p.Name,
-				Tag:  d.DataTypeOf(reflect.Indirect(reflect.New(p.Type))),
+				Type: d.DataTypeOf(reflect.Indirect(reflect.New(p.Type))),
 			}
-			if v, ok := p.Tag.Lookup("geeorm"); ok && v == "primary_key" {
-				schema.PrimaryField = field
+			if v, ok := p.Tag.Lookup("geeorm"); ok {
+				field.Tag = v
 			}
 			schema.Fields = append(schema.Fields, field)
 			schema.FieldNames = append(schema.FieldNames, p.Name)
+			schema.fieldMap[p.Name] = field
 		}
 	}
 	return schema
 }
-
-// String returns readable string
-func (field *Field) String() string {
-	return fmt.Sprintf("(%s %s)", field.Name, field.Tag)
-}
-
-// String returns readable string
-func (schema *Schema) String() string {
-	return fmt.Sprintf("TABLE %s %v", schema.TableName, schema.Fields)
-}
diff --git a/gee-orm/day4-chain-operation/schema/schema_test.go b/gee-orm/day4-chain-operation/schema/schema_test.go
index aba3e0b..47ae9fc 100644
--- a/gee-orm/day4-chain-operation/schema/schema_test.go
+++ b/gee-orm/day4-chain-operation/schema/schema_test.go
@@ -6,7 +6,7 @@ import (
 )
 
 type User struct {
-	Name string `geeorm:"primary_key"`
+	Name string `geeorm:"PRIMARY KEY"`
 	Age  int
 }
 
@@ -14,18 +14,17 @@ var TestDial, _ = dialect.GetDialect("sqlite3")
 
 func TestParse(t *testing.T) {
 	schema := Parse(&User{}, TestDial)
-	if schema.TableName != "User" || len(schema.Fields) != 2 {
+	if schema.Name != "User" || len(schema.Fields) != 2 {
 		t.Fatal("failed to parse User struct")
 	}
-	if schema.PrimaryField.Name != "Name" {
+	if schema.GetField("Name").Tag != "PRIMARY KEY" {
 		t.Fatal("failed to parse primary key")
 	}
-	t.Log(schema)
 }
 
-func TestSchema_Values(t *testing.T) {
+func TestSchema_RecordValues(t *testing.T) {
 	schema := Parse(&User{}, TestDial)
-	values := schema.Values(&User{"Tom", 18})
+	values := schema.RecordValues(&User{"Tom", 18})
 
 	name := values[0].(string)
 	age := values[1].(int)
diff --git a/gee-orm/day4-chain-operation/session/raw.go b/gee-orm/day4-chain-operation/session/raw.go
index a47edcc..161fcb4 100644
--- a/gee-orm/day4-chain-operation/session/raw.go
+++ b/gee-orm/day4-chain-operation/session/raw.go
@@ -6,6 +6,7 @@ import (
 	"geeorm/dialect"
 	"geeorm/log"
 	"geeorm/schema"
+	"strings"
 )
 
 // Session keep a pointer to sql.DB and provides all execution of all
@@ -15,7 +16,7 @@ type Session struct {
 	dialect  dialect.Dialect
 	refTable *schema.Schema
 	clause   clause.Clause
-	sql      string
+	sql      strings.Builder
 	sqlVars  []interface{}
 }
 
@@ -29,16 +30,21 @@ func New(db *sql.DB, dialect dialect.Dialect) *Session {
 
 // Clear initialize the state of a session
 func (s *Session) Clear() {
-	s.refTable, s.sqlVars = nil, nil
+	s.sql.Reset()
+	s.sqlVars = nil
 	s.clause = clause.Clause{}
-	s.sql = ""
+}
+
+// DB returns *sql.DB
+func (s *Session) DB() *sql.DB {
+	return s.db
 }
 
 // Exec raw sql with sqlVars
 func (s *Session) Exec() (result sql.Result, err error) {
 	defer s.Clear()
-	log.Info(s.sql, s.sqlVars)
-	if result, err = s.db.Exec(s.sql, s.sqlVars...); err != nil {
+	log.Info(s.sql.String(), s.sqlVars)
+	if result, err = s.DB().Exec(s.sql.String(), s.sqlVars...); err != nil {
 		log.Error(err)
 	}
 	return
@@ -47,15 +53,15 @@ func (s *Session) Exec() (result sql.Result, err error) {
 // QueryRow gets a record from db
 func (s *Session) QueryRow() *sql.Row {
 	defer s.Clear()
-	log.Info(s.sql, s.sqlVars)
-	return s.db.QueryRow(s.sql, s.sqlVars...)
+	log.Info(s.sql.String(), s.sqlVars)
+	return s.DB().QueryRow(s.sql.String(), s.sqlVars...)
 }
 
 // QueryRows gets a list of records from db
 func (s *Session) QueryRows() (rows *sql.Rows, err error) {
 	defer s.Clear()
-	log.Info(s.sql, s.sqlVars)
-	if rows, err = s.db.Query(s.sql, s.sqlVars...); err != nil {
+	log.Info(s.sql.String(), s.sqlVars)
+	if rows, err = s.DB().Query(s.sql.String(), s.sqlVars...); err != nil {
 		log.Error(err)
 	}
 	return
@@ -63,7 +69,8 @@ func (s *Session) QueryRows() (rows *sql.Rows, err error) {
 
 // Raw appends sql and sqlVars
 func (s *Session) Raw(sql string, values ...interface{}) *Session {
-	s.sql += sql
+	s.sql.WriteString(sql)
+	s.sql.WriteString(" ")
 	s.sqlVars = append(s.sqlVars, values...)
 	return s
-}
+}
\ No newline at end of file
diff --git a/gee-orm/day4-chain-operation/session/raw_test.go b/gee-orm/day4-chain-operation/session/raw_test.go
index ed447a5..a96770b 100644
--- a/gee-orm/day4-chain-operation/session/raw_test.go
+++ b/gee-orm/day4-chain-operation/session/raw_test.go
@@ -30,7 +30,7 @@ func TestSession_Exec(t *testing.T) {
 	s := NewSession()
 	_, _ = s.Raw("DROP TABLE IF EXISTS User;").Exec()
 	_, _ = s.Raw("CREATE TABLE User(name text);").Exec()
-	result, _ := s.Raw("INSERT INTO User(`name`) values (?), (?)", "Tom", "Sam").Exec()
+	result, _ := s.Raw("INSERT INTO User(`Name`) values (?), (?)", "Tom", "Sam").Exec()
 	if count, err := result.RowsAffected(); err != nil || count != 2 {
 		t.Fatal("expect 2, but got", count)
 	}
@@ -39,7 +39,7 @@ func TestSession_Exec(t *testing.T) {
 func TestSession_QueryRows(t *testing.T) {
 	s := NewSession()
 	_, _ = s.Raw("DROP TABLE IF EXISTS User;").Exec()
-	_, _ = s.Raw("CREATE TABLE User(name text);").Exec()
+	_, _ = s.Raw("CREATE TABLE User(Name text);").Exec()
 	row := s.Raw("SELECT count(*) FROM User").QueryRow()
 	var count int
 	if err := row.Scan(&count); err != nil || count != 0 {
diff --git a/gee-orm/day4-chain-operation/session/record.go b/gee-orm/day4-chain-operation/session/record.go
index c9902d0..b2850cf 100644
--- a/gee-orm/day4-chain-operation/session/record.go
+++ b/gee-orm/day4-chain-operation/session/record.go
@@ -1,17 +1,18 @@
 package session
 
 import (
+	"errors"
 	"geeorm/clause"
 	"reflect"
 )
 
 // Create one or more records in database
-func (s *Session) Create(values ...interface{}) (int64, error) {
+func (s *Session) Insert(values ...interface{}) (int64, error) {
 	recordValues := make([]interface{}, 0)
 	for _, value := range values {
-		table := s.RefTable(value)
-		s.clause.Set(clause.INSERT, table.TableName, table.FieldNames)
-		recordValues = append(recordValues, table.Values(value))
+		table := s.Model(value).RefTable()
+		s.clause.Set(clause.INSERT, table.Name, table.FieldNames)
+		recordValues = append(recordValues, table.RecordValues(value))
 	}
 
 	s.clause.Set(clause.VALUES, recordValues...)
@@ -28,9 +29,9 @@ func (s *Session) Create(values ...interface{}) (int64, error) {
 func (s *Session) Find(values interface{}) error {
 	destSlice := reflect.Indirect(reflect.ValueOf(values))
 	destType := destSlice.Type().Elem()
-	table := s.RefTable(reflect.New(destType).Elem().Interface())
+	table := s.Model(reflect.New(destType).Elem().Interface()).RefTable()
 
-	s.clause.Set(clause.SELECT, table.TableName, table.FieldNames)
+	s.clause.Set(clause.SELECT, table.Name, table.FieldNames)
 	sql, vars := s.clause.Build(clause.SELECT, clause.WHERE, clause.ORDERBY, clause.LIMIT)
 	rows, err := s.Raw(sql, vars...).QueryRows()
 	if err != nil {
@@ -55,9 +56,14 @@ func (s *Session) Find(values interface{}) error {
 func (s *Session) First(value interface{}) error {
 	dest := reflect.Indirect(reflect.ValueOf(value))
 	destSlice := reflect.New(reflect.SliceOf(dest.Type())).Elem()
-	err := s.Limit(1).Find(destSlice.Addr().Interface())
+	if err := s.Limit(1).Find(destSlice.Addr().Interface()); err != nil {
+		return err
+	}
+	if destSlice.Len() == 0 {
+		return errors.New("NOT FOUND")
+	}
 	dest.Set(destSlice.Index(0))
-	return err
+	return nil
 }
 
 // Limit adds limit condition to clause
@@ -78,3 +84,46 @@ func (s *Session) OrderBy(desc string) *Session {
 	s.clause.Set(clause.ORDERBY, desc)
 	return s
 }
+
+// Update records with where clause
+// support map[string]interface{}
+// also support kv list: "Name", "Tom", "Age", 18, ....
+func (s *Session) Update(kv ...interface{}) (int64, error) {
+	m, ok := kv[0].(map[string]interface{})
+	if !ok {
+		m = make(map[string]interface{})
+		for i := 0; i < len(kv); i += 2 {
+			m[kv[i].(string)] = kv[i+1]
+		}
+	}
+	s.clause.Set(clause.UPDATE, s.RefTable().Name, m)
+	sql, vars := s.clause.Build(clause.UPDATE, clause.WHERE)
+	result, err := s.Raw(sql, vars...).Exec()
+	if err != nil {
+		return 0, err
+	}
+	return result.RowsAffected()
+}
+
+// Delete records with where clause
+func (s *Session) Delete() (int64, error) {
+	s.clause.Set(clause.DELETE, s.RefTable().Name)
+	sql, vars := s.clause.Build(clause.DELETE, clause.WHERE)
+	result, err := s.Raw(sql, vars...).Exec()
+	if err != nil {
+		return 0, err
+	}
+	return result.RowsAffected()
+}
+
+// Count records with where clause
+func (s *Session) Count() (int64, error) {
+	s.clause.Set(clause.COUNT, s.RefTable().Name)
+	sql, vars := s.clause.Build(clause.COUNT, clause.WHERE)
+	row := s.Raw(sql, vars...).QueryRow()
+	var tmp int64
+	if err := row.Scan(&tmp); err != nil {
+		return 0, err
+	}
+	return tmp, nil
+}
diff --git a/gee-orm/day4-chain-operation/session/record_test.go b/gee-orm/day4-chain-operation/session/record_test.go
index 822201b..5d482a0 100644
--- a/gee-orm/day4-chain-operation/session/record_test.go
+++ b/gee-orm/day4-chain-operation/session/record_test.go
@@ -10,20 +10,19 @@ var (
 
 func testRecordInit(t *testing.T) *Session {
 	t.Helper()
-	s := NewSession()
-	err1 := s.DropTable(&User{})
-	err2 := s.CreateTable(&User{})
-	_, err3 := s.Create(user1, user2)
+	s := NewSession().Model(&User{})
+	err1 := s.DropTable()
+	err2 := s.CreateTable()
+	_, err3 := s.Insert(user1, user2)
 	if err1 != nil || err2 != nil || err3 != nil {
 		t.Fatal("failed init test records")
 	}
 	return s
-
 }
 
-func TestSession_Create(t *testing.T) {
+func TestSession_Insert(t *testing.T) {
 	s := testRecordInit(t)
-	affected, err := s.Create(user3)
+	affected, err := s.Insert(user3)
 	if err != nil || affected != 1 {
 		t.Fatal("failed to create record")
 	}
@@ -31,7 +30,7 @@ func TestSession_Create(t *testing.T) {
 
 func TestSession_Find(t *testing.T) {
 	s := testRecordInit(t)
-	users := []User{}
+	var users []User
 	if err := s.Find(&users); err != nil || len(users) != 2 {
 		t.Fatal("failed to query all")
 	}
@@ -58,7 +57,7 @@ func TestSession_Limit(t *testing.T) {
 func TestSession_Where(t *testing.T) {
 	s := testRecordInit(t)
 	var users []User
-	_, err1 := s.Create(user3)
+	_, err1 := s.Insert(user3)
 	err2 := s.Where("Age = ?", 25).Find(&users)
 
 	if err1 != nil || err2 != nil || len(users) != 2 {
@@ -74,5 +73,25 @@ func TestSession_OrderBy(t *testing.T) {
 	if err != nil || u.Age != 25 {
 		t.Fatal("failed to query with order by condition")
 	}
+}
+
+func TestSession_Update(t *testing.T) {
+	s := testRecordInit(t)
+	affected, _ := s.Where("Name = ?", "Tom").Update("Age", 30)
+	u := &User{}
+	_ = s.OrderBy("Age DESC").First(u)
+
+	if affected != 1 || u.Age != 30 {
+		t.Fatal("failed to update")
+	}
+}
 
+func TestSession_DeleteAndCount(t *testing.T) {
+	s := testRecordInit(t)
+	affected, _ := s.Where("Name = ?", "Tom").Delete()
+	count, _ := s.Count()
+
+	if affected != 1 || count != 1 {
+		t.Fatal("failed to delete or count")
+	}
 }
diff --git a/gee-orm/day4-chain-operation/session/table.go b/gee-orm/day4-chain-operation/session/table.go
index b644d3a..58e7b0f 100644
--- a/gee-orm/day4-chain-operation/session/table.go
+++ b/gee-orm/day4-chain-operation/session/table.go
@@ -2,58 +2,53 @@ package session
 
 import (
 	"fmt"
+	"geeorm/log"
+	"reflect"
 	"strings"
 
 	"geeorm/schema"
 )
 
-// RefTable returns a Schema instance that contains all parsed fields
-func (s *Session) RefTable(value interface{}) *schema.Schema {
-	if value == nil {
-		panic("value is nil")
+// Model assigns refTable
+func (s *Session) Model(value interface{}) *Session {
+	// nil or different model, update refTable
+	if s.refTable == nil || reflect.TypeOf(value) != reflect.TypeOf(s.refTable.Model) {
+		s.refTable = schema.Parse(value, s.dialect)
 	}
+	return s
+}
+
+// RefTable returns a Schema instance that contains all parsed fields
+func (s *Session) RefTable() *schema.Schema {
 	if s.refTable == nil {
-		s.refTable = schema.Parse(value, s.dialect)
+		log.Error("Model is not set")
 	}
 	return s.refTable
 }
 
 // CreateTable create a table in database with a model
-func (s *Session) CreateTable(value interface{}) error {
-	table := s.RefTable(value)
+func (s *Session) CreateTable() error {
+	table := s.RefTable()
 	var columns []string
 	for _, field := range table.Fields {
-		tag := field.Tag
-		if field.Name == table.PrimaryField.Name {
-			tag += " PRIMARY KEY"
-		}
-		columns = append(columns, fmt.Sprintf("%s %s", field.Name, tag))
+		columns = append(columns, fmt.Sprintf("%s %s %s", field.Name, field.Type, field.Tag))
 	}
 	desc := strings.Join(columns, ",")
-	_, err := s.Raw(fmt.Sprintf("CREATE TABLE %s (%s);", table.TableName, desc)).Exec()
+	_, err := s.Raw(fmt.Sprintf("CREATE TABLE %s (%s);", table.Name, desc)).Exec()
 	return err
 }
 
 // DropTable drops a table with the name of model
-func (s *Session) DropTable(value interface{}) error {
-	table := s.RefTable(value)
-	_, err := s.Raw(fmt.Sprintf("DROP TABLE IF EXISTS %s", table.TableName)).Exec()
+func (s *Session) DropTable() error {
+	_, err := s.Raw(fmt.Sprintf("DROP TABLE IF EXISTS %s", s.RefTable().Name)).Exec()
 	return err
 }
 
-func (s *Session) guessTableName(value interface{}) string {
-	if tableName, ok := value.(string); ok {
-		return tableName
-	}
-	return s.RefTable(value).TableName
-}
-
 // HasTable returns true of the table exists
-func (s *Session) HasTable(value interface{}) bool {
-	tableName := s.guessTableName(value)
-	sql, values := s.dialect.TableExistSQL(tableName)
+func (s *Session) HasTable() bool {
+	sql, values := s.dialect.TableExistSQL(s.RefTable().Name)
 	row := s.Raw(sql, values...).QueryRow()
 	var tmp string
 	_ = row.Scan(&tmp)
-	return tmp == tableName
+	return tmp == s.RefTable().Name
 }
diff --git a/gee-orm/day4-chain-operation/session/table_test.go b/gee-orm/day4-chain-operation/session/table_test.go
index 91eb519..3bb7554 100644
--- a/gee-orm/day4-chain-operation/session/table_test.go
+++ b/gee-orm/day4-chain-operation/session/table_test.go
@@ -5,15 +5,24 @@ import (
 )
 
 type User struct {
-	Name string `geeorm:"primary_key"`
+	Name string `geeorm:"PRIMARY KEY"`
 	Age  int
 }
 
 func TestSession_CreateTable(t *testing.T) {
-	s := NewSession()
-	_ = s.DropTable(&User{})
-	_ = s.CreateTable(&User{})
-	if !s.HasTable("User") {
-		t.Fatal("failed to create table User")
+	s := NewSession().Model(&User{})
+	_ = s.DropTable()
+	_ = s.CreateTable()
+	if !s.HasTable() {
+		t.Fatal("Failed to create table User")
+	}
+}
+
+func TestSession_Model(t *testing.T) {
+	s := NewSession().Model(&User{})
+	table := s.RefTable()
+	s.Model(&Session{})
+	if table.Name != "User" || s.RefTable().Name != "Session" {
+		t.Fatal("Failed to change model")
 	}
 }
diff --git a/gee-orm/day5-update-delete/clause/clause.go b/gee-orm/day5-hooks/clause/clause.go
similarity index 99%
rename from gee-orm/day5-update-delete/clause/clause.go
rename to gee-orm/day5-hooks/clause/clause.go
index 2195c86..02fcf93 100644
--- a/gee-orm/day5-update-delete/clause/clause.go
+++ b/gee-orm/day5-hooks/clause/clause.go
@@ -22,7 +22,6 @@ const (
 	WHERE
 	ORDERBY
 	UPDATE
-	SET
 	DELETE
 	COUNT
 )
diff --git a/gee-orm/day5-update-delete/clause/clause_test.go b/gee-orm/day5-hooks/clause/clause_test.go
similarity index 92%
rename from gee-orm/day5-update-delete/clause/clause_test.go
rename to gee-orm/day5-hooks/clause/clause_test.go
index 8769c40..b54c6e0 100644
--- a/gee-orm/day5-update-delete/clause/clause_test.go
+++ b/gee-orm/day5-hooks/clause/clause_test.go
@@ -34,11 +34,9 @@ func testSelect(t *testing.T) {
 
 func testUpdate(t *testing.T) {
 	var clause Clause
-	clause.Set(UPDATE, "User")
+	clause.Set(UPDATE, "User", map[string]interface{}{"Age": 30, "Name": "Tommy"})
 	clause.Set(WHERE, "Name = ?", "Tom")
-	clause.Set(SET, map[string]interface{}{"Age": 30, "Name": "Tommy"})
-
-	sql, vars := clause.Build(UPDATE, SET, WHERE)
+	sql, vars := clause.Build(UPDATE, WHERE)
 	t.Log(sql, vars)
 	if sql != "UPDATE User SET Age = ?, Name = ? WHERE Name = ?" {
 		t.Fatal("failed to build SQL")
diff --git a/gee-orm/day5-update-delete/clause/generator.go b/gee-orm/day5-hooks/clause/generator.go
similarity index 87%
rename from gee-orm/day5-update-delete/clause/generator.go
rename to gee-orm/day5-hooks/clause/generator.go
index 1cf5aec..127fc43 100644
--- a/gee-orm/day5-update-delete/clause/generator.go
+++ b/gee-orm/day5-hooks/clause/generator.go
@@ -16,9 +16,8 @@ func init() {
 	generators[SELECT] = _select
 	generators[LIMIT] = _limit
 	generators[WHERE] = _where
-	generators[ORDERBY] = _orderby
+	generators[ORDERBY] = _orderBy
 	generators[UPDATE] = _update
-	generators[SET] = _set
 	generators[DELETE] = _delete
 	generators[COUNT] = _count
 }
@@ -77,24 +76,20 @@ func _where(values ...interface{}) (string, []interface{}) {
 	return fmt.Sprintf("WHERE %s", desc), vars
 }
 
-func _orderby(values ...interface{}) (string, []interface{}) {
+func _orderBy(values ...interface{}) (string, []interface{}) {
 	return fmt.Sprintf("ORDER BY %s", values[0]), []interface{}{}
 }
 
 func _update(values ...interface{}) (string, []interface{}) {
-	return fmt.Sprintf("UPDATE %s", values[0]), []interface{}{}
-}
-
-func _set(values ...interface{}) (string, []interface{}) {
-	m := values[0].(map[string]interface{})
+	tableName := values[0]
+	m := values[1].(map[string]interface{})
 	var keys []string
 	var vars []interface{}
 	for k, v := range m {
 		keys = append(keys, k+" = ?")
 		vars = append(vars, v)
 	}
-
-	return fmt.Sprintf("SET %s", strings.Join(keys, ", ")), vars
+	return fmt.Sprintf("UPDATE %s SET %s", tableName, strings.Join(keys, ", ")), vars
 }
 
 func _delete(values ...interface{}) (string, []interface{}) {
diff --git a/gee-orm/day5-update-delete/dialect/dialect.go b/gee-orm/day5-hooks/dialect/dialect.go
similarity index 100%
rename from gee-orm/day5-update-delete/dialect/dialect.go
rename to gee-orm/day5-hooks/dialect/dialect.go
diff --git a/gee-orm/day5-update-delete/dialect/sqlite3.go b/gee-orm/day5-hooks/dialect/sqlite3.go
similarity index 100%
rename from gee-orm/day5-update-delete/dialect/sqlite3.go
rename to gee-orm/day5-hooks/dialect/sqlite3.go
diff --git a/gee-orm/day5-update-delete/dialect/sqlite3_test.go b/gee-orm/day5-hooks/dialect/sqlite3_test.go
similarity index 100%
rename from gee-orm/day5-update-delete/dialect/sqlite3_test.go
rename to gee-orm/day5-hooks/dialect/sqlite3_test.go
diff --git a/gee-orm/day5-update-delete/geeorm.go b/gee-orm/day5-hooks/geeorm.go
similarity index 78%
rename from gee-orm/day5-update-delete/geeorm.go
rename to gee-orm/day5-hooks/geeorm.go
index 61ee9e0..b1881ce 100644
--- a/gee-orm/day5-update-delete/geeorm.go
+++ b/gee-orm/day5-hooks/geeorm.go
@@ -38,14 +38,14 @@ func NewEngine(driver, source string) (e *Engine, err error) {
 }
 
 // Close database connection
-func (e *Engine) Close() (err error) {
-	if err = e.db.Close(); err == nil {
-		log.Info("Close database success")
+func (engine *Engine) Close() {
+	if err := engine.db.Close(); err != nil {
+		log.Error("Failed to close database")
 	}
-	return
+	log.Info("Close database success")
 }
 
 // NewSession creates a new session for next operations
-func (e *Engine) NewSession() *session.Session {
-	return session.New(e.db, e.dialect)
+func (engine *Engine) NewSession() *session.Session {
+	return session.New(engine.db, engine.dialect)
 }
diff --git a/gee-orm/day5-update-delete/geeorm_test.go b/gee-orm/day5-hooks/geeorm_test.go
similarity index 93%
rename from gee-orm/day5-update-delete/geeorm_test.go
rename to gee-orm/day5-hooks/geeorm_test.go
index 35628be..c6da191 100644
--- a/gee-orm/day5-update-delete/geeorm_test.go
+++ b/gee-orm/day5-hooks/geeorm_test.go
@@ -16,5 +16,5 @@ func OpenDB(t *testing.T) *Engine {
 
 func TestNewEngine(t *testing.T) {
 	engine := OpenDB(t)
-	_ = engine.Close()
+	defer engine.Close()
 }
diff --git a/gee-orm/day5-update-delete/go.mod b/gee-orm/day5-hooks/go.mod
similarity index 100%
rename from gee-orm/day5-update-delete/go.mod
rename to gee-orm/day5-hooks/go.mod
diff --git a/gee-orm/day5-update-delete/log/log.go b/gee-orm/day5-hooks/log/log.go
similarity index 100%
rename from gee-orm/day5-update-delete/log/log.go
rename to gee-orm/day5-hooks/log/log.go
diff --git a/gee-orm/day5-update-delete/log/log_test.go b/gee-orm/day5-hooks/log/log_test.go
similarity index 100%
rename from gee-orm/day5-update-delete/log/log_test.go
rename to gee-orm/day5-hooks/log/log_test.go
diff --git a/gee-orm/day5-update-delete/schema/schema.go b/gee-orm/day5-hooks/schema/schema.go
similarity index 59%
rename from gee-orm/day5-update-delete/schema/schema.go
rename to gee-orm/day5-hooks/schema/schema.go
index 8519fd4..ff76283 100644
--- a/gee-orm/day5-update-delete/schema/schema.go
+++ b/gee-orm/day5-hooks/schema/schema.go
@@ -1,7 +1,6 @@
 package schema
 
 import (
-	"fmt"
 	"geeorm/dialect"
 	"go/ast"
 	"reflect"
@@ -10,19 +9,26 @@ import (
 // Field represents a column of database
 type Field struct {
 	Name string
+	Type string
 	Tag  string
 }
 
 // Schema represents a table of database
 type Schema struct {
-	TableName    string
-	PrimaryField *Field
-	Fields       []*Field
-	FieldNames   []string
+	Model      interface{}
+	Name       string
+	Fields     []*Field
+	FieldNames []string
+	fieldMap   map[string]*Field
+}
+
+// GetField returns field by name
+func (schema *Schema) GetField(name string) *Field {
+	return schema.fieldMap[name]
 }
 
 // Values return the values of dest's member variables
-func (schema *Schema) Values(dest interface{}) []interface{} {
+func (schema *Schema) RecordValues(dest interface{}) []interface{} {
 	destValue := reflect.Indirect(reflect.ValueOf(dest))
 	var fieldValues []interface{}
 	for _, field := range schema.Fields {
@@ -35,8 +41,9 @@ func (schema *Schema) Values(dest interface{}) []interface{} {
 func Parse(dest interface{}, d dialect.Dialect) *Schema {
 	modelType := reflect.Indirect(reflect.ValueOf(dest)).Type()
 	schema := &Schema{
-		TableName:    modelType.Name(),
-		PrimaryField: &Field{Name: "ID", Tag: ""},
+		Model:    dest,
+		Name:     modelType.Name(),
+		fieldMap: make(map[string]*Field),
 	}
 
 	for i := 0; i < modelType.NumField(); i++ {
@@ -44,24 +51,15 @@ func Parse(dest interface{}, d dialect.Dialect) *Schema {
 		if !p.Anonymous && ast.IsExported(p.Name) {
 			field := &Field{
 				Name: p.Name,
-				Tag:  d.DataTypeOf(reflect.Indirect(reflect.New(p.Type))),
+				Type: d.DataTypeOf(reflect.Indirect(reflect.New(p.Type))),
 			}
-			if v, ok := p.Tag.Lookup("geeorm"); ok && v == "primary_key" {
-				schema.PrimaryField = field
+			if v, ok := p.Tag.Lookup("geeorm"); ok {
+				field.Tag = v
 			}
 			schema.Fields = append(schema.Fields, field)
 			schema.FieldNames = append(schema.FieldNames, p.Name)
+			schema.fieldMap[p.Name] = field
 		}
 	}
 	return schema
 }
-
-// String returns readable string
-func (field *Field) String() string {
-	return fmt.Sprintf("(%s %s)", field.Name, field.Tag)
-}
-
-// String returns readable string
-func (schema *Schema) String() string {
-	return fmt.Sprintf("TABLE %s %v", schema.TableName, schema.Fields)
-}
diff --git a/gee-orm/day5-update-delete/schema/schema_test.go b/gee-orm/day5-hooks/schema/schema_test.go
similarity index 65%
rename from gee-orm/day5-update-delete/schema/schema_test.go
rename to gee-orm/day5-hooks/schema/schema_test.go
index aba3e0b..47ae9fc 100644
--- a/gee-orm/day5-update-delete/schema/schema_test.go
+++ b/gee-orm/day5-hooks/schema/schema_test.go
@@ -6,7 +6,7 @@ import (
 )
 
 type User struct {
-	Name string `geeorm:"primary_key"`
+	Name string `geeorm:"PRIMARY KEY"`
 	Age  int
 }
 
@@ -14,18 +14,17 @@ var TestDial, _ = dialect.GetDialect("sqlite3")
 
 func TestParse(t *testing.T) {
 	schema := Parse(&User{}, TestDial)
-	if schema.TableName != "User" || len(schema.Fields) != 2 {
+	if schema.Name != "User" || len(schema.Fields) != 2 {
 		t.Fatal("failed to parse User struct")
 	}
-	if schema.PrimaryField.Name != "Name" {
+	if schema.GetField("Name").Tag != "PRIMARY KEY" {
 		t.Fatal("failed to parse primary key")
 	}
-	t.Log(schema)
 }
 
-func TestSchema_Values(t *testing.T) {
+func TestSchema_RecordValues(t *testing.T) {
 	schema := Parse(&User{}, TestDial)
-	values := schema.Values(&User{"Tom", 18})
+	values := schema.RecordValues(&User{"Tom", 18})
 
 	name := values[0].(string)
 	age := values[1].(int)
diff --git a/gee-orm/day5-update-delete/session/raw.go b/gee-orm/day5-hooks/session/raw.go
similarity index 69%
rename from gee-orm/day5-update-delete/session/raw.go
rename to gee-orm/day5-hooks/session/raw.go
index a47edcc..161fcb4 100644
--- a/gee-orm/day5-update-delete/session/raw.go
+++ b/gee-orm/day5-hooks/session/raw.go
@@ -6,6 +6,7 @@ import (
 	"geeorm/dialect"
 	"geeorm/log"
 	"geeorm/schema"
+	"strings"
 )
 
 // Session keep a pointer to sql.DB and provides all execution of all
@@ -15,7 +16,7 @@ type Session struct {
 	dialect  dialect.Dialect
 	refTable *schema.Schema
 	clause   clause.Clause
-	sql      string
+	sql      strings.Builder
 	sqlVars  []interface{}
 }
 
@@ -29,16 +30,21 @@ func New(db *sql.DB, dialect dialect.Dialect) *Session {
 
 // Clear initialize the state of a session
 func (s *Session) Clear() {
-	s.refTable, s.sqlVars = nil, nil
+	s.sql.Reset()
+	s.sqlVars = nil
 	s.clause = clause.Clause{}
-	s.sql = ""
+}
+
+// DB returns *sql.DB
+func (s *Session) DB() *sql.DB {
+	return s.db
 }
 
 // Exec raw sql with sqlVars
 func (s *Session) Exec() (result sql.Result, err error) {
 	defer s.Clear()
-	log.Info(s.sql, s.sqlVars)
-	if result, err = s.db.Exec(s.sql, s.sqlVars...); err != nil {
+	log.Info(s.sql.String(), s.sqlVars)
+	if result, err = s.DB().Exec(s.sql.String(), s.sqlVars...); err != nil {
 		log.Error(err)
 	}
 	return
@@ -47,15 +53,15 @@ func (s *Session) Exec() (result sql.Result, err error) {
 // QueryRow gets a record from db
 func (s *Session) QueryRow() *sql.Row {
 	defer s.Clear()
-	log.Info(s.sql, s.sqlVars)
-	return s.db.QueryRow(s.sql, s.sqlVars...)
+	log.Info(s.sql.String(), s.sqlVars)
+	return s.DB().QueryRow(s.sql.String(), s.sqlVars...)
 }
 
 // QueryRows gets a list of records from db
 func (s *Session) QueryRows() (rows *sql.Rows, err error) {
 	defer s.Clear()
-	log.Info(s.sql, s.sqlVars)
-	if rows, err = s.db.Query(s.sql, s.sqlVars...); err != nil {
+	log.Info(s.sql.String(), s.sqlVars)
+	if rows, err = s.DB().Query(s.sql.String(), s.sqlVars...); err != nil {
 		log.Error(err)
 	}
 	return
@@ -63,7 +69,8 @@ func (s *Session) QueryRows() (rows *sql.Rows, err error) {
 
 // Raw appends sql and sqlVars
 func (s *Session) Raw(sql string, values ...interface{}) *Session {
-	s.sql += sql
+	s.sql.WriteString(sql)
+	s.sql.WriteString(" ")
 	s.sqlVars = append(s.sqlVars, values...)
 	return s
-}
+}
\ No newline at end of file
diff --git a/gee-orm/day5-update-delete/session/raw_test.go b/gee-orm/day5-hooks/session/raw_test.go
similarity index 89%
rename from gee-orm/day5-update-delete/session/raw_test.go
rename to gee-orm/day5-hooks/session/raw_test.go
index ed447a5..a96770b 100644
--- a/gee-orm/day5-update-delete/session/raw_test.go
+++ b/gee-orm/day5-hooks/session/raw_test.go
@@ -30,7 +30,7 @@ func TestSession_Exec(t *testing.T) {
 	s := NewSession()
 	_, _ = s.Raw("DROP TABLE IF EXISTS User;").Exec()
 	_, _ = s.Raw("CREATE TABLE User(name text);").Exec()
-	result, _ := s.Raw("INSERT INTO User(`name`) values (?), (?)", "Tom", "Sam").Exec()
+	result, _ := s.Raw("INSERT INTO User(`Name`) values (?), (?)", "Tom", "Sam").Exec()
 	if count, err := result.RowsAffected(); err != nil || count != 2 {
 		t.Fatal("expect 2, but got", count)
 	}
@@ -39,7 +39,7 @@ func TestSession_Exec(t *testing.T) {
 func TestSession_QueryRows(t *testing.T) {
 	s := NewSession()
 	_, _ = s.Raw("DROP TABLE IF EXISTS User;").Exec()
-	_, _ = s.Raw("CREATE TABLE User(name text);").Exec()
+	_, _ = s.Raw("CREATE TABLE User(Name text);").Exec()
 	row := s.Raw("SELECT count(*) FROM User").QueryRow()
 	var count int
 	if err := row.Scan(&count); err != nil || count != 0 {
diff --git a/gee-orm/day5-update-delete/session/record.go b/gee-orm/day5-hooks/session/record.go
similarity index 64%
rename from gee-orm/day5-update-delete/session/record.go
rename to gee-orm/day5-hooks/session/record.go
index bc6d1fe..86b9ddd 100644
--- a/gee-orm/day5-update-delete/session/record.go
+++ b/gee-orm/day5-hooks/session/record.go
@@ -1,17 +1,30 @@
 package session
 
 import (
+	"errors"
 	"geeorm/clause"
 	"reflect"
 )
 
+// CallMethod calls the registered hooks
+func (s *Session) CallMethod(method string) error {
+	if fm := reflect.ValueOf(s.refTable.Model).MethodByName(method); fm.IsValid() {
+		if v := fm.Call([]reflect.Value{}); len(v) > 0 {
+			if err, ok := v[0].Interface().(error); ok {
+				return err
+			}
+		}
+	}
+	return nil
+}
+
 // Create one or more records in database
-func (s *Session) Create(values ...interface{}) (int64, error) {
+func (s *Session) Insert(values ...interface{}) (int64, error) {
 	recordValues := make([]interface{}, 0)
 	for _, value := range values {
-		table := s.RefTable(value)
-		s.clause.Set(clause.INSERT, table.TableName, table.FieldNames)
-		recordValues = append(recordValues, table.Values(value))
+		table := s.Model(value).RefTable()
+		s.clause.Set(clause.INSERT, table.Name, table.FieldNames)
+		recordValues = append(recordValues, table.RecordValues(value))
 	}
 
 	s.clause.Set(clause.VALUES, recordValues...)
@@ -28,9 +41,9 @@ func (s *Session) Create(values ...interface{}) (int64, error) {
 func (s *Session) Find(values interface{}) error {
 	destSlice := reflect.Indirect(reflect.ValueOf(values))
 	destType := destSlice.Type().Elem()
-	table := s.RefTable(reflect.New(destType).Elem().Interface())
+	table := s.Model(reflect.New(destType).Elem().Interface()).RefTable()
 
-	s.clause.Set(clause.SELECT, table.TableName, table.FieldNames)
+	s.clause.Set(clause.SELECT, table.Name, table.FieldNames)
 	sql, vars := s.clause.Build(clause.SELECT, clause.WHERE, clause.ORDERBY, clause.LIMIT)
 	rows, err := s.Raw(sql, vars...).QueryRows()
 	if err != nil {
@@ -55,9 +68,14 @@ func (s *Session) Find(values interface{}) error {
 func (s *Session) First(value interface{}) error {
 	dest := reflect.Indirect(reflect.ValueOf(value))
 	destSlice := reflect.New(reflect.SliceOf(dest.Type())).Elem()
-	err := s.Limit(1).Find(destSlice.Addr().Interface())
+	if err := s.Limit(1).Find(destSlice.Addr().Interface()); err != nil {
+		return err
+	}
+	if destSlice.Len() == 0 {
+		return errors.New("NOT FOUND")
+	}
 	dest.Set(destSlice.Index(0))
-	return err
+	return nil
 }
 
 // Limit adds limit condition to clause
@@ -79,25 +97,19 @@ func (s *Session) OrderBy(desc string) *Session {
 	return s
 }
 
-// Set adds Assignment by condition to clause
+// Update records with where clause
 // support map[string]interface{}
-// also support "Name", "Tom", "Age", 18, etc
-func (s *Session) Set(values ...interface{}) *Session {
-	m, ok := values[0].(map[string]interface{})
+// also support kv list: "Name", "Tom", "Age", 18, ....
+func (s *Session) Update(kv ...interface{}) (int64, error) {
+	m, ok := kv[0].(map[string]interface{})
 	if !ok {
 		m = make(map[string]interface{})
-		for i := 0; i < len(values); i += 2 {
-			m[values[i].(string)] = values[i+1]
+		for i := 0; i < len(kv); i += 2 {
+			m[kv[i].(string)] = kv[i+1]
 		}
 	}
-	s.clause.Set(clause.SET, m)
-	return s
-}
-
-// Update records with where clause
-func (s *Session) Update(value interface{}) (int64, error) {
-	s.clause.Set(clause.UPDATE, s.guessTableName(value))
-	sql, vars := s.clause.Build(clause.UPDATE, clause.SET, clause.WHERE)
+	s.clause.Set(clause.UPDATE, s.RefTable().Name, m)
+	sql, vars := s.clause.Build(clause.UPDATE, clause.WHERE)
 	result, err := s.Raw(sql, vars...).Exec()
 	if err != nil {
 		return 0, err
@@ -106,8 +118,8 @@ func (s *Session) Update(value interface{}) (int64, error) {
 }
 
 // Delete records with where clause
-func (s *Session) Delete(value interface{}) (int64, error) {
-	s.clause.Set(clause.DELETE, s.guessTableName(value))
+func (s *Session) Delete() (int64, error) {
+	s.clause.Set(clause.DELETE, s.RefTable().Name)
 	sql, vars := s.clause.Build(clause.DELETE, clause.WHERE)
 	result, err := s.Raw(sql, vars...).Exec()
 	if err != nil {
@@ -117,12 +129,11 @@ func (s *Session) Delete(value interface{}) (int64, error) {
 }
 
 // Count records with where clause
-func (s *Session) Count(value interface{}) (int64, error) {
-	s.clause.Set(clause.COUNT, s.guessTableName(value))
+func (s *Session) Count() (int64, error) {
+	s.clause.Set(clause.COUNT, s.RefTable().Name)
 	sql, vars := s.clause.Build(clause.COUNT, clause.WHERE)
 	row := s.Raw(sql, vars...).QueryRow()
 	var tmp int64
-
 	if err := row.Scan(&tmp); err != nil {
 		return 0, err
 	}
diff --git a/gee-orm/day5-update-delete/session/record_test.go b/gee-orm/day5-hooks/session/record_test.go
similarity index 81%
rename from gee-orm/day5-update-delete/session/record_test.go
rename to gee-orm/day5-hooks/session/record_test.go
index faf8535..5d482a0 100644
--- a/gee-orm/day5-update-delete/session/record_test.go
+++ b/gee-orm/day5-hooks/session/record_test.go
@@ -10,19 +10,19 @@ var (
 
 func testRecordInit(t *testing.T) *Session {
 	t.Helper()
-	s := NewSession()
-	err1 := s.DropTable(&User{})
-	err2 := s.CreateTable(&User{})
-	_, err3 := s.Create(user1, user2)
+	s := NewSession().Model(&User{})
+	err1 := s.DropTable()
+	err2 := s.CreateTable()
+	_, err3 := s.Insert(user1, user2)
 	if err1 != nil || err2 != nil || err3 != nil {
 		t.Fatal("failed init test records")
 	}
 	return s
 }
 
-func TestSession_Create(t *testing.T) {
+func TestSession_Insert(t *testing.T) {
 	s := testRecordInit(t)
-	affected, err := s.Create(user3)
+	affected, err := s.Insert(user3)
 	if err != nil || affected != 1 {
 		t.Fatal("failed to create record")
 	}
@@ -30,7 +30,7 @@ func TestSession_Create(t *testing.T) {
 
 func TestSession_Find(t *testing.T) {
 	s := testRecordInit(t)
-	users := []User{}
+	var users []User
 	if err := s.Find(&users); err != nil || len(users) != 2 {
 		t.Fatal("failed to query all")
 	}
@@ -57,7 +57,7 @@ func TestSession_Limit(t *testing.T) {
 func TestSession_Where(t *testing.T) {
 	s := testRecordInit(t)
 	var users []User
-	_, err1 := s.Create(user3)
+	_, err1 := s.Insert(user3)
 	err2 := s.Where("Age = ?", 25).Find(&users)
 
 	if err1 != nil || err2 != nil || len(users) != 2 {
@@ -77,7 +77,7 @@ func TestSession_OrderBy(t *testing.T) {
 
 func TestSession_Update(t *testing.T) {
 	s := testRecordInit(t)
-	affected, _ := s.Where("Name = ?", "Tom").Set("Age", 30).Update(&User{})
+	affected, _ := s.Where("Name = ?", "Tom").Update("Age", 30)
 	u := &User{}
 	_ = s.OrderBy("Age DESC").First(u)
 
@@ -88,8 +88,8 @@ func TestSession_Update(t *testing.T) {
 
 func TestSession_DeleteAndCount(t *testing.T) {
 	s := testRecordInit(t)
-	affected, _ := s.Where("Name = ?", "Tom").Delete("User")
-	count, _ := s.Count("User")
+	affected, _ := s.Where("Name = ?", "Tom").Delete()
+	count, _ := s.Count()
 
 	if affected != 1 || count != 1 {
 		t.Fatal("failed to delete or count")
diff --git a/gee-orm/day5-hooks/session/table.go b/gee-orm/day5-hooks/session/table.go
new file mode 100644
index 0000000..58e7b0f
--- /dev/null
+++ b/gee-orm/day5-hooks/session/table.go
@@ -0,0 +1,54 @@
+package session
+
+import (
+	"fmt"
+	"geeorm/log"
+	"reflect"
+	"strings"
+
+	"geeorm/schema"
+)
+
+// Model assigns refTable
+func (s *Session) Model(value interface{}) *Session {
+	// nil or different model, update refTable
+	if s.refTable == nil || reflect.TypeOf(value) != reflect.TypeOf(s.refTable.Model) {
+		s.refTable = schema.Parse(value, s.dialect)
+	}
+	return s
+}
+
+// RefTable returns a Schema instance that contains all parsed fields
+func (s *Session) RefTable() *schema.Schema {
+	if s.refTable == nil {
+		log.Error("Model is not set")
+	}
+	return s.refTable
+}
+
+// CreateTable create a table in database with a model
+func (s *Session) CreateTable() error {
+	table := s.RefTable()
+	var columns []string
+	for _, field := range table.Fields {
+		columns = append(columns, fmt.Sprintf("%s %s %s", field.Name, field.Type, field.Tag))
+	}
+	desc := strings.Join(columns, ",")
+	_, err := s.Raw(fmt.Sprintf("CREATE TABLE %s (%s);", table.Name, desc)).Exec()
+	return err
+}
+
+// DropTable drops a table with the name of model
+func (s *Session) DropTable() error {
+	_, err := s.Raw(fmt.Sprintf("DROP TABLE IF EXISTS %s", s.RefTable().Name)).Exec()
+	return err
+}
+
+// HasTable returns true of the table exists
+func (s *Session) HasTable() bool {
+	sql, values := s.dialect.TableExistSQL(s.RefTable().Name)
+	row := s.Raw(sql, values...).QueryRow()
+	var tmp string
+	_ = row.Scan(&tmp)
+	return tmp == s.RefTable().Name
+}
diff --git a/gee-orm/day5-hooks/session/table_test.go b/gee-orm/day5-hooks/session/table_test.go
new file mode 100644
index 0000000..3bb7554
--- /dev/null
+++ b/gee-orm/day5-hooks/session/table_test.go
@@ -0,0 +1,28 @@
+package session
+
+import (
+	"testing"
+)
+
+type User struct {
+	Name string `geeorm:"PRIMARY KEY"`
+	Age  int
+}
+
+func TestSession_CreateTable(t *testing.T) {
+	s := NewSession().Model(&User{})
+	_ = s.DropTable()
+	_ = s.CreateTable()
+	if !s.HasTable() {
+		t.Fatal("Failed to create table User")
+	}
+}
+
+func TestSession_Model(t *testing.T) {
+	s := NewSession().Model(&User{})
+	table := s.RefTable()
+	s.Model(&Session{})
+	if table.Name != "User" || s.RefTable().Name != "Session" {
+		t.Fatal("Failed to change model")
+	}
+}
diff --git a/gee-orm/day5-update-delete/session/table.go b/gee-orm/day5-update-delete/session/table.go
deleted file mode 100644
index b644d3a..0000000
--- a/gee-orm/day5-update-delete/session/table.go
+++ /dev/null
@@ -1,59 +0,0 @@
-package session
-
-import (
-	"fmt"
-	"strings"
-
-	"geeorm/schema"
-)
-
-// RefTable returns a Schema instance that contains all parsed fields
-func (s *Session) RefTable(value interface{}) *schema.Schema {
-	if value == nil {
-		panic("value is nil")
-	}
-	if s.refTable == nil {
-		s.refTable = schema.Parse(value, s.dialect)
-	}
-	return s.refTable
-}
-
-// CreateTable create a table in database with a model
-func (s *Session) CreateTable(value interface{}) error {
-	table := s.RefTable(value)
-	var columns []string
-	for _, field := range table.Fields {
-		tag := field.Tag
-		if field.Name == table.PrimaryField.Name {
-			tag += " PRIMARY KEY"
-		}
-		columns = append(columns, fmt.Sprintf("%s %s", field.Name, tag))
-	}
-	desc := strings.Join(columns, ",")
-	_, err := s.Raw(fmt.Sprintf("CREATE TABLE %s (%s);", table.TableName, desc)).Exec()
-	return err
-}
-
-// DropTable drops a table with the name of model
-func (s *Session) DropTable(value interface{}) error {
-	table := s.RefTable(value)
-	_, err := s.Raw(fmt.Sprintf("DROP TABLE IF EXISTS %s", table.TableName)).Exec()
-	return err
-}
-
-func (s *Session) guessTableName(value interface{}) string {
-	if tableName, ok := value.(string); ok {
-		return tableName
-	}
-	return s.RefTable(value).TableName
-}
-
-// HasTable returns true of the table exists
-func (s *Session) HasTable(value interface{}) bool {
-	tableName := s.guessTableName(value)
-	sql, values := s.dialect.TableExistSQL(tableName)
-	row := s.Raw(sql, values...).QueryRow()
-	var tmp string
-	_ = row.Scan(&tmp)
-	return tmp == tableName
-}
diff --git a/gee-orm/day5-update-delete/session/table_test.go b/gee-orm/day5-update-delete/session/table_test.go
deleted file mode 100644
index 91eb519..0000000
--- a/gee-orm/day5-update-delete/session/table_test.go
+++ /dev/null
@@ -1,19 +0,0 @@
-package session
-
-import (
-	"testing"
-)
-
-type User struct {
-	Name string `geeorm:"primary_key"`
-	Age  int
-}
-
-func TestSession_CreateTable(t *testing.T) {
-	s := NewSession()
-	_ = s.DropTable(&User{})
-	_ = s.CreateTable(&User{})
-	if !s.HasTable("User") {
-		t.Fatal("failed to create table User")
-	}
-}
diff --git a/gee-orm/day6-transaction/clause/clause.go b/gee-orm/day6-transaction/clause/clause.go
index 2195c86..02fcf93 100644
--- a/gee-orm/day6-transaction/clause/clause.go
+++ b/gee-orm/day6-transaction/clause/clause.go
@@ -22,7 +22,6 @@ const (
 	WHERE
 	ORDERBY
 	UPDATE
-	SET
 	DELETE
 	COUNT
 )
diff --git a/gee-orm/day6-transaction/clause/clause_test.go b/gee-orm/day6-transaction/clause/clause_test.go
index 8769c40..b54c6e0 100644
--- a/gee-orm/day6-transaction/clause/clause_test.go
+++ b/gee-orm/day6-transaction/clause/clause_test.go
@@ -34,11 +34,9 @@ func testSelect(t *testing.T) {
 
 func testUpdate(t *testing.T) {
 	var clause Clause
-	clause.Set(UPDATE, "User")
+	clause.Set(UPDATE, "User", map[string]interface{}{"Age": 30, "Name": "Tommy"})
 	clause.Set(WHERE, "Name = ?", "Tom")
-	clause.Set(SET, map[string]interface{}{"Age": 30, "Name": "Tommy"})
-
-	sql, vars := clause.Build(UPDATE, SET, WHERE)
+	sql, vars := clause.Build(UPDATE, WHERE)
 	t.Log(sql, vars)
 	if sql != "UPDATE User SET Age = ?, Name = ? WHERE Name = ?" {
 		t.Fatal("failed to build SQL")
diff --git a/gee-orm/day6-transaction/clause/generator.go b/gee-orm/day6-transaction/clause/generator.go
index 1cf5aec..127fc43 100644
--- a/gee-orm/day6-transaction/clause/generator.go
+++ b/gee-orm/day6-transaction/clause/generator.go
@@ -16,9 +16,8 @@ func init() {
 	generators[SELECT] = _select
 	generators[LIMIT] = _limit
 	generators[WHERE] = _where
-	generators[ORDERBY] = _orderby
+	generators[ORDERBY] = _orderBy
 	generators[UPDATE] = _update
-	generators[SET] = _set
 	generators[DELETE] = _delete
 	generators[COUNT] = _count
 }
@@ -77,24 +76,20 @@ func _where(values ...interface{}) (string, []interface{}) {
 	return fmt.Sprintf("WHERE %s", desc), vars
 }
 
-func _orderby(values ...interface{}) (string, []interface{}) {
+func _orderBy(values ...interface{}) (string, []interface{}) {
 	return fmt.Sprintf("ORDER BY %s", values[0]), []interface{}{}
 }
 
 func _update(values ...interface{}) (string, []interface{}) {
-	return fmt.Sprintf("UPDATE %s", values[0]), []interface{}{}
-}
-
-func _set(values ...interface{}) (string, []interface{}) {
-	m := values[0].(map[string]interface{})
+	tableName := values[0]
+	m := values[1].(map[string]interface{})
 	var keys []string
 	var vars []interface{}
 	for k, v := range m {
 		keys = append(keys, k+" = ?")
 		vars = append(vars, v)
 	}
-
-	return fmt.Sprintf("SET %s", strings.Join(keys, ", ")), vars
+	return fmt.Sprintf("UPDATE %s SET %s", tableName, strings.Join(keys, ", ")), vars
 }
 
 func _delete(values ...interface{}) (string, []interface{}) {
diff --git a/gee-orm/day6-transaction/geeorm.go b/gee-orm/day6-transaction/geeorm.go
index b8cbb42..a08fd46 100644
--- a/gee-orm/day6-transaction/geeorm.go
+++ b/gee-orm/day6-transaction/geeorm.go
@@ -38,16 +38,16 @@ func NewEngine(driver, source string) (e *Engine, err error) {
 }
 
 // Close database connection
-func (e *Engine) Close() (err error) {
-	if err = e.db.Close(); err == nil {
-		log.Info("Close database success")
+func (engine *Engine) Close() {
+	if err := engine.db.Close(); err != nil {
+		log.Error("Failed to close database")
 	}
-	return
+	log.Info("Close database success")
 }
 
 // NewSession creates a new session for next operations
-func (e *Engine) NewSession() *session.Session {
-	return session.New(e.db, e.dialect)
+func (engine *Engine) NewSession() *session.Session {
+	return session.New(engine.db, engine.dialect)
 }
 
 // TxFunc will be called between tx.Begin() and tx.Commit()
@@ -55,8 +55,8 @@ func (e *Engine) NewSession() *session.Session {
 type TxFunc func(*session.Session) (interface{}, error)
 
 // Transaction executes sql wrapped in a transaction, then automatically commit if no error occurs
-func (e *Engine) Transaction(f TxFunc) (result interface{}, err error) {
-	s := e.NewSession()
+func (engine *Engine) Transaction(f TxFunc) (result interface{}, err error) {
+	s := engine.NewSession()
 	if err := s.Begin(); err != nil {
 		return nil, err
 	}
diff --git a/gee-orm/day6-transaction/geeorm_test.go b/gee-orm/day6-transaction/geeorm_test.go
index 17a1d2b..c3cf12a 100644
--- a/gee-orm/day6-transaction/geeorm_test.go
+++ b/gee-orm/day6-transaction/geeorm_test.go
@@ -17,43 +17,39 @@ func OpenDB(t *testing.T) *Engine {
 	return engine
 }
 
-func CloseDB(engine *Engine) {
-	_ = engine.Close()
-}
-
 func TestNewEngine(t *testing.T) {
 	engine := OpenDB(t)
-	_ = engine.Close()
+	defer engine.Close()
 }
 
 type User struct {
-	Name string `geeorm:"primary_key"`
+	Name string `geeorm:"PRIMARY KEY"`
 	Age  int
 }
 
 func transactionRollback(t *testing.T) {
 	engine := OpenDB(t)
-	defer CloseDB(engine)
+	defer engine.Close()
 	s := engine.NewSession()
-	_ = s.DropTable(&User{})
+	_ = s.Model(&User{}).DropTable()
 	_, err := engine.Transaction(func(s *session.Session) (result interface{}, err error) {
-		_ = s.CreateTable(&User{})
-		_, err = s.Create(&User{"Tom", 18})
+		_ = s.Model(&User{}).CreateTable()
+		_, err = s.Insert(&User{"Tom", 18})
 		return nil, errors.New("Error")
 	})
-	if err == nil || s.HasTable("User") {
+	if err == nil || s.HasTable() {
 		t.Fatal("failed to rollback")
 	}
 }
 
 func transactionCommit(t *testing.T) {
 	engine := OpenDB(t)
-	defer CloseDB(engine)
+	defer engine.Close()
 	s := engine.NewSession()
-	_ = s.DropTable(&User{})
+	_ = s.Model(&User{}).DropTable()
 	_, err := engine.Transaction(func(s *session.Session) (result interface{}, err error) {
-		err = s.CreateTable(&User{})
-		_, err = s.Create(&User{"Tom", 18})
+		_ = s.Model(&User{}).CreateTable()
+		_, err = s.Insert(&User{"Tom", 18})
 		return
 	})
 	u := &User{}
diff --git a/gee-orm/day6-transaction/schema/schema.go b/gee-orm/day6-transaction/schema/schema.go
index 8519fd4..ff76283 100644
--- a/gee-orm/day6-transaction/schema/schema.go
+++ b/gee-orm/day6-transaction/schema/schema.go
@@ -1,7 +1,6 @@
 package schema
 
 import (
-	"fmt"
 	"geeorm/dialect"
 	"go/ast"
 	"reflect"
@@ -10,19 +9,26 @@ import (
 // Field represents a column of database
 type Field struct {
 	Name string
+	Type string
 	Tag  string
 }
 
 // Schema represents a table of database
 type Schema struct {
-	TableName    string
-	PrimaryField *Field
-	Fields       []*Field
-	FieldNames   []string
+	Model      interface{}
+	Name       string
+	Fields     []*Field
+	FieldNames []string
+	fieldMap   map[string]*Field
+}
+
+// GetField returns field by name
+func (schema *Schema) GetField(name string) *Field {
+	return schema.fieldMap[name]
 }
 
 // Values return the values of dest's member variables
-func (schema *Schema) Values(dest interface{}) []interface{} {
+func (schema *Schema) RecordValues(dest interface{}) []interface{} {
 	destValue := reflect.Indirect(reflect.ValueOf(dest))
 	var fieldValues []interface{}
 	for _, field := range schema.Fields {
@@ -35,8 +41,9 @@ func (schema *Schema) Values(dest interface{}) []interface{} {
 func Parse(dest interface{}, d dialect.Dialect) *Schema {
 	modelType := reflect.Indirect(reflect.ValueOf(dest)).Type()
 	schema := &Schema{
-		TableName:    modelType.Name(),
-		PrimaryField: &Field{Name: "ID", Tag: ""},
+		Model:    dest,
+		Name:     modelType.Name(),
+		fieldMap: make(map[string]*Field),
 	}
 
 	for i := 0; i < modelType.NumField(); i++ {
@@ -44,24 +51,15 @@ func Parse(dest interface{}, d dialect.Dialect) *Schema {
 		if !p.Anonymous && ast.IsExported(p.Name) {
 			field := &Field{
 				Name: p.Name,
-				Tag:  d.DataTypeOf(reflect.Indirect(reflect.New(p.Type))),
+				Type: d.DataTypeOf(reflect.Indirect(reflect.New(p.Type))),
 			}
-			if v, ok := p.Tag.Lookup("geeorm"); ok && v == "primary_key" {
-				schema.PrimaryField = field
+			if v, ok := p.Tag.Lookup("geeorm"); ok {
+				field.Tag = v
 			}
 			schema.Fields = append(schema.Fields, field)
 			schema.FieldNames = append(schema.FieldNames, p.Name)
+			schema.fieldMap[p.Name] = field
 		}
 	}
 	return schema
 }
-
-// String returns readable string
-func (field *Field) String() string {
-	return fmt.Sprintf("(%s %s)", field.Name, field.Tag)
-}
-
-// String returns readable string
-func (schema *Schema) String() string {
-	return fmt.Sprintf("TABLE %s %v", schema.TableName, schema.Fields)
-}
diff --git a/gee-orm/day6-transaction/schema/schema_test.go b/gee-orm/day6-transaction/schema/schema_test.go
index aba3e0b..47ae9fc 100644
--- a/gee-orm/day6-transaction/schema/schema_test.go
+++ b/gee-orm/day6-transaction/schema/schema_test.go
@@ -6,7 +6,7 @@ import (
 )
 
 type User struct {
-	Name string `geeorm:"primary_key"`
+	Name string `geeorm:"PRIMARY KEY"`
 	Age  int
 }
 
@@ -14,18 +14,17 @@ var TestDial, _ = dialect.GetDialect("sqlite3")
 
 func TestParse(t *testing.T) {
 	schema := Parse(&User{}, TestDial)
-	if schema.TableName != "User" || len(schema.Fields) != 2 {
+	if schema.Name != "User" || len(schema.Fields) != 2 {
 		t.Fatal("failed to parse User struct")
 	}
-	if schema.PrimaryField.Name != "Name" {
+	if schema.GetField("Name").Tag != "PRIMARY KEY" {
 		t.Fatal("failed to parse primary key")
 	}
-	t.Log(schema)
 }
 
-func TestSchema_Values(t *testing.T) {
+func TestSchema_RecordValues(t *testing.T) {
 	schema := Parse(&User{}, TestDial)
-	values := schema.Values(&User{"Tom", 18})
+	values := schema.RecordValues(&User{"Tom", 18})
 
 	name := values[0].(string)
 	age := values[1].(int)
diff --git a/gee-orm/day6-transaction/session/raw.go b/gee-orm/day6-transaction/session/raw.go
index c30f1c3..5bdd039 100644
--- a/gee-orm/day6-transaction/session/raw.go
+++ b/gee-orm/day6-transaction/session/raw.go
@@ -6,6 +6,7 @@ import (
 	"geeorm/dialect"
 	"geeorm/log"
 	"geeorm/schema"
+	"strings"
 )
 
 // Session keep a pointer to sql.DB and provides all execution of all
@@ -16,7 +17,7 @@ type Session struct {
 	tx       *sql.Tx
 	refTable *schema.Schema
 	clause   clause.Clause
-	sql      string
+	sql      strings.Builder
 	sqlVars  []interface{}
 }
 
@@ -30,9 +31,9 @@ func New(db *sql.DB, dialect dialect.Dialect) *Session {
 
 // Clear initialize the state of a session
 func (s *Session) Clear() {
-	s.refTable, s.sqlVars = nil, nil
+	s.sql.Reset()
+	s.sqlVars = nil
 	s.clause = clause.Clause{}
-	s.sql = ""
 }
 
 // CommonDB is a minimal function set of db
@@ -56,8 +57,8 @@ func (s *Session) DB() CommonDB {
 // Exec raw sql with sqlVars
 func (s *Session) Exec() (result sql.Result, err error) {
 	defer s.Clear()
-	log.Info(s.sql, s.sqlVars)
-	if result, err = s.DB().Exec(s.sql, s.sqlVars...); err != nil {
+	log.Info(s.sql.String(), s.sqlVars)
+	if result, err = s.DB().Exec(s.sql.String(), s.sqlVars...); err != nil {
 		log.Error(err)
 	}
 	return
@@ -66,15 +67,15 @@ func (s *Session) Exec() (result sql.Result, err error) {
 // QueryRow gets a record from db
 func (s *Session) QueryRow() *sql.Row {
 	defer s.Clear()
-	log.Info(s.sql, s.sqlVars)
-	return s.DB().QueryRow(s.sql, s.sqlVars...)
+	log.Info(s.sql.String(), s.sqlVars)
+	return s.DB().QueryRow(s.sql.String(), s.sqlVars...)
 }
 
 // QueryRows gets a list of records from db
 func (s *Session) QueryRows() (rows *sql.Rows, err error) {
 	defer s.Clear()
-	log.Info(s.sql, s.sqlVars)
-	if rows, err = s.DB().Query(s.sql, s.sqlVars...); err != nil {
+	log.Info(s.sql.String(), s.sqlVars)
+	if rows, err = s.DB().Query(s.sql.String(), s.sqlVars...); err != nil {
 		log.Error(err)
 	}
 	return
@@ -82,7 +83,8 @@ func (s *Session) QueryRows() (rows *sql.Rows, err error) {
 
 // Raw appends sql and sqlVars
 func (s *Session) Raw(sql string, values ...interface{}) *Session {
-	s.sql += sql
+	s.sql.WriteString(sql)
+	s.sql.WriteString(" ")
 	s.sqlVars = append(s.sqlVars, values...)
 	return s
-}
+}
\ No newline at end of file
diff --git a/gee-orm/day6-transaction/session/raw_test.go b/gee-orm/day6-transaction/session/raw_test.go
index ed447a5..a96770b 100644
--- a/gee-orm/day6-transaction/session/raw_test.go
+++ b/gee-orm/day6-transaction/session/raw_test.go
@@ -30,7 +30,7 @@ func TestSession_Exec(t *testing.T) {
 	s := NewSession()
 	_, _ = s.Raw("DROP TABLE IF EXISTS User;").Exec()
 	_, _ = s.Raw("CREATE TABLE User(name text);").Exec()
-	result, _ := s.Raw("INSERT INTO User(`name`) values (?), (?)", "Tom", "Sam").Exec()
+	result, _ := s.Raw("INSERT INTO User(`Name`) values (?), (?)", "Tom", "Sam").Exec()
 	if count, err := result.RowsAffected(); err != nil || count != 2 {
 		t.Fatal("expect 2, but got", count)
 	}
@@ -39,7 +39,7 @@ func TestSession_Exec(t *testing.T) {
 func TestSession_QueryRows(t *testing.T) {
 	s := NewSession()
 	_, _ = s.Raw("DROP TABLE IF EXISTS User;").Exec()
-	_, _ = s.Raw("CREATE TABLE User(name text);").Exec()
+	_, _ = s.Raw("CREATE TABLE User(Name text);").Exec()
 	row := s.Raw("SELECT count(*) FROM User").QueryRow()
 	var count int
 	if err := row.Scan(&count); err != nil || count != 0 {
diff --git a/gee-orm/day6-transaction/session/record.go b/gee-orm/day6-transaction/session/record.go
index bc6d1fe..b2850cf 100644
--- a/gee-orm/day6-transaction/session/record.go
+++ b/gee-orm/day6-transaction/session/record.go
@@ -1,17 +1,18 @@
 package session
 
 import (
+	"errors"
 	"geeorm/clause"
 	"reflect"
 )
 
 // Create one or more records in database
-func (s *Session) Create(values ...interface{}) (int64, error) {
+func (s *Session) Insert(values ...interface{}) (int64, error) {
 	recordValues := make([]interface{}, 0)
 	for _, value := range values {
-		table := s.RefTable(value)
-		s.clause.Set(clause.INSERT, table.TableName, table.FieldNames)
-		recordValues = append(recordValues, table.Values(value))
+		table := s.Model(value).RefTable()
+		s.clause.Set(clause.INSERT, table.Name, table.FieldNames)
+		recordValues = append(recordValues, table.RecordValues(value))
 	}
 
 	s.clause.Set(clause.VALUES, recordValues...)
@@ -28,9 +29,9 @@ func (s *Session) Create(values ...interface{}) (int64, error) {
 func (s *Session) Find(values interface{}) error {
 	destSlice := reflect.Indirect(reflect.ValueOf(values))
 	destType := destSlice.Type().Elem()
-	table := s.RefTable(reflect.New(destType).Elem().Interface())
+	table := s.Model(reflect.New(destType).Elem().Interface()).RefTable()
 
-	s.clause.Set(clause.SELECT, table.TableName, table.FieldNames)
+	s.clause.Set(clause.SELECT, table.Name, table.FieldNames)
 	sql, vars := s.clause.Build(clause.SELECT, clause.WHERE, clause.ORDERBY, clause.LIMIT)
 	rows, err := s.Raw(sql, vars...).QueryRows()
 	if err != nil {
@@ -55,9 +56,14 @@ func (s *Session) Find(values interface{}) error {
 func (s *Session) First(value interface{}) error {
 	dest := reflect.Indirect(reflect.ValueOf(value))
 	destSlice := reflect.New(reflect.SliceOf(dest.Type())).Elem()
-	err := s.Limit(1).Find(destSlice.Addr().Interface())
+	if err := s.Limit(1).Find(destSlice.Addr().Interface()); err != nil {
+		return err
+	}
+	if destSlice.Len() == 0 {
+		return errors.New("NOT FOUND")
+	}
 	dest.Set(destSlice.Index(0))
-	return err
+	return nil
 }
 
 // Limit adds limit condition to clause
@@ -79,25 +85,19 @@ func (s *Session) OrderBy(desc string) *Session {
 	return s
 }
 
-// Set adds Assignment by condition to clause
+// Update records with where clause
 // support map[string]interface{}
-// also support "Name", "Tom", "Age", 18, etc
-func (s *Session) Set(values ...interface{}) *Session {
-	m, ok := values[0].(map[string]interface{})
+// also support kv list: "Name", "Tom", "Age", 18, ....
+func (s *Session) Update(kv ...interface{}) (int64, error) {
+	m, ok := kv[0].(map[string]interface{})
 	if !ok {
 		m = make(map[string]interface{})
-		for i := 0; i < len(values); i += 2 {
-			m[values[i].(string)] = values[i+1]
+		for i := 0; i < len(kv); i += 2 {
+			m[kv[i].(string)] = kv[i+1]
 		}
 	}
-	s.clause.Set(clause.SET, m)
-	return s
-}
-
-// Update records with where clause
-func (s *Session) Update(value interface{}) (int64, error) {
-	s.clause.Set(clause.UPDATE, s.guessTableName(value))
-	sql, vars := s.clause.Build(clause.UPDATE, clause.SET, clause.WHERE)
+	s.clause.Set(clause.UPDATE, s.RefTable().Name, m)
+	sql, vars := s.clause.Build(clause.UPDATE, clause.WHERE)
 	result, err := s.Raw(sql, vars...).Exec()
 	if err != nil {
 		return 0, err
@@ -106,8 +106,8 @@ func (s *Session) Update(value interface{}) (int64, error) {
 }
 
 // Delete records with where clause
-func (s *Session) Delete(value interface{}) (int64, error) {
-	s.clause.Set(clause.DELETE, s.guessTableName(value))
+func (s *Session) Delete() (int64, error) {
+	s.clause.Set(clause.DELETE, s.RefTable().Name)
 	sql, vars := s.clause.Build(clause.DELETE, clause.WHERE)
 	result, err := s.Raw(sql, vars...).Exec()
 	if err != nil {
@@ -117,12 +117,11 @@ func (s *Session) Delete(value interface{}) (int64, error) {
 }
 
 // Count records with where clause
-func (s *Session) Count(value interface{}) (int64, error) {
-	s.clause.Set(clause.COUNT, s.guessTableName(value))
+func (s *Session) Count() (int64, error) {
+	s.clause.Set(clause.COUNT, s.RefTable().Name)
 	sql, vars := s.clause.Build(clause.COUNT, clause.WHERE)
 	row := s.Raw(sql, vars...).QueryRow()
 	var tmp int64
-
 	if err := row.Scan(&tmp); err != nil {
 		return 0, err
 	}
diff --git a/gee-orm/day6-transaction/session/record_test.go b/gee-orm/day6-transaction/session/record_test.go
index faf8535..5d482a0 100644
--- a/gee-orm/day6-transaction/session/record_test.go
+++ b/gee-orm/day6-transaction/session/record_test.go
@@ -10,19 +10,19 @@ var (
 
 func testRecordInit(t *testing.T) *Session {
 	t.Helper()
-	s := NewSession()
-	err1 := s.DropTable(&User{})
-	err2 := s.CreateTable(&User{})
-	_, err3 := s.Create(user1, user2)
+	s := NewSession().Model(&User{})
+	err1 := s.DropTable()
+	err2 := s.CreateTable()
+	_, err3 := s.Insert(user1, user2)
 	if err1 != nil || err2 != nil || err3 != nil {
 		t.Fatal("failed init test records")
 	}
 	return s
 }
 
-func TestSession_Create(t *testing.T) {
+func TestSession_Insert(t *testing.T) {
 	s := testRecordInit(t)
-	affected, err := s.Create(user3)
+	affected, err := s.Insert(user3)
 	if err != nil || affected != 1 {
 		t.Fatal("failed to create record")
 	}
@@ -30,7 +30,7 @@ func TestSession_Create(t *testing.T) {
 
 func TestSession_Find(t *testing.T) {
 	s := testRecordInit(t)
-	users := []User{}
+	var users []User
 	if err := s.Find(&users); err != nil || len(users) != 2 {
 		t.Fatal("failed to query all")
 	}
@@ -57,7 +57,7 @@ func TestSession_Limit(t *testing.T) {
 func TestSession_Where(t *testing.T) {
 	s := testRecordInit(t)
 	var users []User
-	_, err1 := s.Create(user3)
+	_, err1 := s.Insert(user3)
 	err2 := s.Where("Age = ?", 25).Find(&users)
 
 	if err1 != nil || err2 != nil || len(users) != 2 {
@@ -77,7 +77,7 @@ func TestSession_OrderBy(t *testing.T) {
 
 func TestSession_Update(t *testing.T) {
 	s := testRecordInit(t)
-	affected, _ := s.Where("Name = ?", "Tom").Set("Age", 30).Update(&User{})
+	affected, _ := s.Where("Name = ?", "Tom").Update("Age", 30)
 	u := &User{}
 	_ = s.OrderBy("Age DESC").First(u)
 
@@ -88,8 +88,8 @@ func TestSession_Update(t *testing.T) {
 
 func TestSession_DeleteAndCount(t *testing.T) {
 	s := testRecordInit(t)
-	affected, _ := s.Where("Name = ?", "Tom").Delete("User")
-	count, _ := s.Count("User")
+	affected, _ := s.Where("Name = ?", "Tom").Delete()
+	count, _ := s.Count()
 
 	if affected != 1 || count != 1 {
 		t.Fatal("failed to delete or count")
diff --git a/gee-orm/day6-transaction/session/table.go b/gee-orm/day6-transaction/session/table.go
index b644d3a..58e7b0f 100644
--- a/gee-orm/day6-transaction/session/table.go
+++ b/gee-orm/day6-transaction/session/table.go
@@ -2,58 +2,53 @@ package session
 
 import (
 	"fmt"
+	"geeorm/log"
+	"reflect"
 	"strings"
 
 	"geeorm/schema"
 )
 
-// RefTable returns a Schema instance that contains all parsed fields
-func (s *Session) RefTable(value interface{}) *schema.Schema {
-	if value == nil {
-		panic("value is nil")
+// Model assigns refTable
+func (s *Session) Model(value interface{}) *Session {
+	// nil or different model, update refTable
+	if s.refTable == nil || reflect.TypeOf(value) != reflect.TypeOf(s.refTable.Model) {
+		s.refTable = schema.Parse(value, s.dialect)
 	}
+	return s
+}
+
+// RefTable returns a Schema instance that contains all parsed fields
+func (s *Session) RefTable() *schema.Schema {
 	if s.refTable == nil {
-		s.refTable = schema.Parse(value, s.dialect)
+		log.Error("Model is not set")
 	}
 	return s.refTable
 }
 
 // CreateTable create a table in database with a model
-func (s *Session) CreateTable(value interface{}) error {
-	table := s.RefTable(value)
+func (s *Session) CreateTable() error {
+	table := s.RefTable()
 	var columns []string
 	for _, field := range table.Fields {
-		tag := field.Tag
-		if field.Name == table.PrimaryField.Name {
-			tag += " PRIMARY KEY"
-		}
-		columns = append(columns, fmt.Sprintf("%s %s", field.Name, tag))
+		columns = append(columns, fmt.Sprintf("%s %s %s", field.Name, field.Type, field.Tag))
 	}
 	desc := strings.Join(columns, ",")
-	_, err := s.Raw(fmt.Sprintf("CREATE TABLE %s (%s);", table.TableName, desc)).Exec()
+	_, err := s.Raw(fmt.Sprintf("CREATE TABLE %s (%s);", table.Name, desc)).Exec()
 	return err
 }
 
 // DropTable drops a table with the name of model
-func (s *Session) DropTable(value interface{}) error {
-	table := s.RefTable(value)
-	_, err := s.Raw(fmt.Sprintf("DROP TABLE IF EXISTS %s", table.TableName)).Exec()
+func (s *Session) DropTable() error {
+	_, err := s.Raw(fmt.Sprintf("DROP TABLE IF EXISTS %s", s.RefTable().Name)).Exec()
 	return err
 }
 
-func (s *Session) guessTableName(value interface{}) string {
-	if tableName, ok := value.(string); ok {
-		return tableName
-	}
-	return s.RefTable(value).TableName
-}
-
 // HasTable returns true of the table exists
-func (s *Session) HasTable(value interface{}) bool {
-	tableName := s.guessTableName(value)
-	sql, values := s.dialect.TableExistSQL(tableName)
+func (s *Session) HasTable() bool {
+	sql, values := s.dialect.TableExistSQL(s.RefTable().Name)
 	row := s.Raw(sql, values...).QueryRow()
 	var tmp string
 	_ = row.Scan(&tmp)
-	return tmp == tableName
+	return tmp == s.RefTable().Name
 }
diff --git a/gee-orm/day6-transaction/session/table_test.go b/gee-orm/day6-transaction/session/table_test.go
index 91eb519..3bb7554 100644
--- a/gee-orm/day6-transaction/session/table_test.go
+++ b/gee-orm/day6-transaction/session/table_test.go
@@ -5,15 +5,24 @@ import (
 )
 
 type User struct {
-	Name string `geeorm:"primary_key"`
+	Name string `geeorm:"PRIMARY KEY"`
 	Age  int
 }
 
 func TestSession_CreateTable(t *testing.T) {
-	s := NewSession()
-	_ = s.DropTable(&User{})
-	_ = s.CreateTable(&User{})
-	if !s.HasTable("User") {
-		t.Fatal("failed to create table User")
+	s := NewSession().Model(&User{})
+	_ = s.DropTable()
+	_ = s.CreateTable()
+	if !s.HasTable() {
+		t.Fatal("Failed to create table User")
+	}
+}
+
+func TestSession_Model(t *testing.T) {
+	s := NewSession().Model(&User{})
+	table := s.RefTable()
+	s.Model(&Session{})
+	if table.Name != "User" || s.RefTable().Name != "Session" {
+		t.Fatal("Failed to change model")
 	}
 }
diff --git a/gee-orm/run_test.sh b/gee-orm/run_test.sh
index d5c5e7f..23475a2 100755
--- a/gee-orm/run_test.sh
+++ b/gee-orm/run_test.sh
@@ -2,9 +2,9 @@
 set -eou pipefail
 
 cur=$PWD
-for item in $(ls -d $cur/day*/)
+for item in "$cur"/day*/
 do
-    echo $item
-    cd $item
+    echo "$item"
+    cd "$item"
     go test geeorm/... 2>&1 | grep -v warning
 done
\ No newline at end of file

From dd3cedd241244d0786be150d3596bb820ed1ed32 Mon Sep 17 00:00:00 2001
From: gzdaijie <gzdaijie@163.com>
Date: Fri, 28 Feb 2020 23:37:41 +0800
Subject: [PATCH 050/122] fix Insert Comment && add hooks feature

---
 gee-orm/day1-database-sql/session/raw_test.go |  2 +-
 .../day2-reflect-schema/session/raw_test.go   |  2 +-
 gee-orm/day3-save-query/session/raw_test.go   |  2 +-
 gee-orm/day3-save-query/session/record.go     |  2 +-
 .../day4-chain-operation/session/raw_test.go  |  2 +-
 .../day4-chain-operation/session/record.go    |  2 +-
 gee-orm/day5-hooks/session/hooks.go           | 32 ++++++++++++++++
 gee-orm/day5-hooks/session/hooks_test.go      | 37 +++++++++++++++++++
 gee-orm/day5-hooks/session/raw_test.go        |  2 +-
 gee-orm/day5-hooks/session/record.go          | 23 +++++-------
 gee-orm/day6-transaction/session/hooks.go     | 32 ++++++++++++++++
 .../day6-transaction/session/hooks_test.go    | 37 +++++++++++++++++++
 gee-orm/day6-transaction/session/raw_test.go  |  2 +-
 gee-orm/day6-transaction/session/record.go    | 11 +++++-
 14 files changed, 164 insertions(+), 24 deletions(-)
 create mode 100644 gee-orm/day5-hooks/session/hooks.go
 create mode 100644 gee-orm/day5-hooks/session/hooks_test.go
 create mode 100644 gee-orm/day6-transaction/session/hooks.go
 create mode 100644 gee-orm/day6-transaction/session/hooks_test.go

diff --git a/gee-orm/day1-database-sql/session/raw_test.go b/gee-orm/day1-database-sql/session/raw_test.go
index 8a18162..670420e 100644
--- a/gee-orm/day1-database-sql/session/raw_test.go
+++ b/gee-orm/day1-database-sql/session/raw_test.go
@@ -11,7 +11,7 @@ import (
 var TestDB *sql.DB
 
 func TestMain(m *testing.M) {
-	TestDB, _ = sql.Open("sqlite3", "gee.db")
+	TestDB, _ = sql.Open("sqlite3", "../gee.db")
 	code := m.Run()
 	_ = TestDB.Close()
 	os.Exit(code)
diff --git a/gee-orm/day2-reflect-schema/session/raw_test.go b/gee-orm/day2-reflect-schema/session/raw_test.go
index a96770b..c6c3f08 100644
--- a/gee-orm/day2-reflect-schema/session/raw_test.go
+++ b/gee-orm/day2-reflect-schema/session/raw_test.go
@@ -16,7 +16,7 @@ var (
 )
 
 func TestMain(m *testing.M) {
-	TestDB, _ = sql.Open("sqlite3", "gee.db")
+	TestDB, _ = sql.Open("sqlite3", "../gee.db")
 	code := m.Run()
 	_ = TestDB.Close()
 	os.Exit(code)
diff --git a/gee-orm/day3-save-query/session/raw_test.go b/gee-orm/day3-save-query/session/raw_test.go
index a96770b..c6c3f08 100644
--- a/gee-orm/day3-save-query/session/raw_test.go
+++ b/gee-orm/day3-save-query/session/raw_test.go
@@ -16,7 +16,7 @@ var (
 )
 
 func TestMain(m *testing.M) {
-	TestDB, _ = sql.Open("sqlite3", "gee.db")
+	TestDB, _ = sql.Open("sqlite3", "../gee.db")
 	code := m.Run()
 	_ = TestDB.Close()
 	os.Exit(code)
diff --git a/gee-orm/day3-save-query/session/record.go b/gee-orm/day3-save-query/session/record.go
index 69fd50d..5f033e0 100644
--- a/gee-orm/day3-save-query/session/record.go
+++ b/gee-orm/day3-save-query/session/record.go
@@ -5,7 +5,7 @@ import (
 	"reflect"
 )
 
-// Create one or more records in database
+// Insert one or more records in database
 func (s *Session) Insert(values ...interface{}) (int64, error) {
 	recordValues := make([]interface{}, 0)
 	for _, value := range values {
diff --git a/gee-orm/day4-chain-operation/session/raw_test.go b/gee-orm/day4-chain-operation/session/raw_test.go
index a96770b..c6c3f08 100644
--- a/gee-orm/day4-chain-operation/session/raw_test.go
+++ b/gee-orm/day4-chain-operation/session/raw_test.go
@@ -16,7 +16,7 @@ var (
 )
 
 func TestMain(m *testing.M) {
-	TestDB, _ = sql.Open("sqlite3", "gee.db")
+	TestDB, _ = sql.Open("sqlite3", "../gee.db")
 	code := m.Run()
 	_ = TestDB.Close()
 	os.Exit(code)
diff --git a/gee-orm/day4-chain-operation/session/record.go b/gee-orm/day4-chain-operation/session/record.go
index b2850cf..cef890b 100644
--- a/gee-orm/day4-chain-operation/session/record.go
+++ b/gee-orm/day4-chain-operation/session/record.go
@@ -6,7 +6,7 @@ import (
 	"reflect"
 )
 
-// Create one or more records in database
+// Insert one or more records in database
 func (s *Session) Insert(values ...interface{}) (int64, error) {
 	recordValues := make([]interface{}, 0)
 	for _, value := range values {
diff --git a/gee-orm/day5-hooks/session/hooks.go b/gee-orm/day5-hooks/session/hooks.go
new file mode 100644
index 0000000..12462a4
--- /dev/null
+++ b/gee-orm/day5-hooks/session/hooks.go
@@ -0,0 +1,32 @@
+package session
+
+import "reflect"
+
+// Hooks constants
+const (
+	BeforeQuery  = "BeforeQuery"
+	AfterQuery   = "AfterQuery"
+	BeforeUpdate = "BeforeUpdate"
+	AfterUpdate  = "AfterUpate"
+	BeforeDelete = "BeforeDelete"
+	AfterDelete  = "AfterDelete"
+	BeforeInsert = "BeforeInsert"
+	AfterInsert  = "AfterInsert"
+)
+
+// CallMethod calls the registered hooks
+func (s *Session) CallMethod(method string, value interface{}) error {
+	fm := reflect.ValueOf(s.RefTable().Model).MethodByName(method)
+	if value != nil {
+		fm = reflect.ValueOf(value).MethodByName(method)
+	}
+	param := []reflect.Value{reflect.ValueOf(s)}
+	if fm.IsValid() {
+		if v := fm.Call(param); len(v) > 0 {
+			if err, ok := v[0].Interface().(error); ok {
+				return err
+			}
+		}
+	}
+	return nil
+}
diff --git a/gee-orm/day5-hooks/session/hooks_test.go b/gee-orm/day5-hooks/session/hooks_test.go
new file mode 100644
index 0000000..f896d01
--- /dev/null
+++ b/gee-orm/day5-hooks/session/hooks_test.go
@@ -0,0 +1,37 @@
+package session
+
+import (
+	"geeorm/log"
+	"testing"
+)
+
+type Account struct {
+	ID       int `geeorm:"PRIMARY KEY"`
+	Password string
+}
+
+func (account *Account) BeforeInsert(s *Session) error {
+	log.Info("before inert", account)
+	account.ID += 1000
+	return nil
+}
+
+func (account *Account) AfterQuery(s *Session) error {
+	log.Info("after query", account)
+	account.Password = "******"
+	return nil
+}
+
+func TestSession_CallMethod(t *testing.T) {
+	s := NewSession().Model(&Account{})
+	_ = s.DropTable()
+	_ = s.CreateTable()
+	_, _ = s.Insert(&Account{1, "123456"}, &Account{2, "qwerty"})
+
+	u := &Account{}
+
+	err := s.First(u)
+	if err != nil || u.ID != 1001 || u.Password != "******" {
+		t.Fatal("Failed to call hooks after query, got", u)
+	}
+}
diff --git a/gee-orm/day5-hooks/session/raw_test.go b/gee-orm/day5-hooks/session/raw_test.go
index a96770b..c6c3f08 100644
--- a/gee-orm/day5-hooks/session/raw_test.go
+++ b/gee-orm/day5-hooks/session/raw_test.go
@@ -16,7 +16,7 @@ var (
 )
 
 func TestMain(m *testing.M) {
-	TestDB, _ = sql.Open("sqlite3", "gee.db")
+	TestDB, _ = sql.Open("sqlite3", "../gee.db")
 	code := m.Run()
 	_ = TestDB.Close()
 	os.Exit(code)
diff --git a/gee-orm/day5-hooks/session/record.go b/gee-orm/day5-hooks/session/record.go
index 86b9ddd..fdfca4d 100644
--- a/gee-orm/day5-hooks/session/record.go
+++ b/gee-orm/day5-hooks/session/record.go
@@ -6,22 +6,11 @@ import (
 	"reflect"
 )
 
-// CallMethod calls the registered hooks
-func (s *Session) CallMethod(method string) error {
-	if fm := reflect.ValueOf(s.refTable.Model).MethodByName(method); fm.IsValid() {
-		if v := fm.Call([]reflect.Value{}); len(v) > 0 {
-			if err, ok := v[0].Interface().(error); ok {
-				return err
-			}
-		}
-	}
-	return nil
-}
-
-// Create one or more records in database
+// Insert one or more records in database
 func (s *Session) Insert(values ...interface{}) (int64, error) {
 	recordValues := make([]interface{}, 0)
 	for _, value := range values {
+		s.CallMethod(BeforeInsert, value)
 		table := s.Model(value).RefTable()
 		s.clause.Set(clause.INSERT, table.Name, table.FieldNames)
 		recordValues = append(recordValues, table.RecordValues(value))
@@ -33,12 +22,13 @@ func (s *Session) Insert(values ...interface{}) (int64, error) {
 	if err != nil {
 		return 0, err
 	}
-
+	s.CallMethod(AfterInsert, nil)
 	return result.RowsAffected()
 }
 
 // Find gets all eligible records
 func (s *Session) Find(values interface{}) error {
+	s.CallMethod(BeforeQuery, nil)
 	destSlice := reflect.Indirect(reflect.ValueOf(values))
 	destType := destSlice.Type().Elem()
 	table := s.Model(reflect.New(destType).Elem().Interface()).RefTable()
@@ -59,6 +49,7 @@ func (s *Session) Find(values interface{}) error {
 		if err := rows.Scan(values...); err != nil {
 			return err
 		}
+		s.CallMethod(AfterQuery, dest.Addr().Interface())
 		destSlice.Set(reflect.Append(destSlice, dest))
 	}
 	return rows.Close()
@@ -101,6 +92,7 @@ func (s *Session) OrderBy(desc string) *Session {
 // support map[string]interface{}
 // also support kv list: "Name", "Tom", "Age", 18, ....
 func (s *Session) Update(kv ...interface{}) (int64, error) {
+	s.CallMethod(BeforeUpdate, nil)
 	m, ok := kv[0].(map[string]interface{})
 	if !ok {
 		m = make(map[string]interface{})
@@ -114,17 +106,20 @@ func (s *Session) Update(kv ...interface{}) (int64, error) {
 	if err != nil {
 		return 0, err
 	}
+	s.CallMethod(AfterUpdate, nil)
 	return result.RowsAffected()
 }
 
 // Delete records with where clause
 func (s *Session) Delete() (int64, error) {
+	s.CallMethod(BeforeDelete, nil)
 	s.clause.Set(clause.DELETE, s.RefTable().Name)
 	sql, vars := s.clause.Build(clause.DELETE, clause.WHERE)
 	result, err := s.Raw(sql, vars...).Exec()
 	if err != nil {
 		return 0, err
 	}
+	s.CallMethod(AfterDelete, nil)
 	return result.RowsAffected()
 }
 
diff --git a/gee-orm/day6-transaction/session/hooks.go b/gee-orm/day6-transaction/session/hooks.go
new file mode 100644
index 0000000..12462a4
--- /dev/null
+++ b/gee-orm/day6-transaction/session/hooks.go
@@ -0,0 +1,32 @@
+package session
+
+import "reflect"
+
+// Hooks constants
+const (
+	BeforeQuery  = "BeforeQuery"
+	AfterQuery   = "AfterQuery"
+	BeforeUpdate = "BeforeUpdate"
+	AfterUpdate  = "AfterUpate"
+	BeforeDelete = "BeforeDelete"
+	AfterDelete  = "AfterDelete"
+	BeforeInsert = "BeforeInsert"
+	AfterInsert  = "AfterInsert"
+)
+
+// CallMethod calls the registered hooks
+func (s *Session) CallMethod(method string, value interface{}) error {
+	fm := reflect.ValueOf(s.RefTable().Model).MethodByName(method)
+	if value != nil {
+		fm = reflect.ValueOf(value).MethodByName(method)
+	}
+	param := []reflect.Value{reflect.ValueOf(s)}
+	if fm.IsValid() {
+		if v := fm.Call(param); len(v) > 0 {
+			if err, ok := v[0].Interface().(error); ok {
+				return err
+			}
+		}
+	}
+	return nil
+}
diff --git a/gee-orm/day6-transaction/session/hooks_test.go b/gee-orm/day6-transaction/session/hooks_test.go
new file mode 100644
index 0000000..f896d01
--- /dev/null
+++ b/gee-orm/day6-transaction/session/hooks_test.go
@@ -0,0 +1,37 @@
+package session
+
+import (
+	"geeorm/log"
+	"testing"
+)
+
+type Account struct {
+	ID       int `geeorm:"PRIMARY KEY"`
+	Password string
+}
+
+func (account *Account) BeforeInsert(s *Session) error {
+	log.Info("before inert", account)
+	account.ID += 1000
+	return nil
+}
+
+func (account *Account) AfterQuery(s *Session) error {
+	log.Info("after query", account)
+	account.Password = "******"
+	return nil
+}
+
+func TestSession_CallMethod(t *testing.T) {
+	s := NewSession().Model(&Account{})
+	_ = s.DropTable()
+	_ = s.CreateTable()
+	_, _ = s.Insert(&Account{1, "123456"}, &Account{2, "qwerty"})
+
+	u := &Account{}
+
+	err := s.First(u)
+	if err != nil || u.ID != 1001 || u.Password != "******" {
+		t.Fatal("Failed to call hooks after query, got", u)
+	}
+}
diff --git a/gee-orm/day6-transaction/session/raw_test.go b/gee-orm/day6-transaction/session/raw_test.go
index a96770b..c6c3f08 100644
--- a/gee-orm/day6-transaction/session/raw_test.go
+++ b/gee-orm/day6-transaction/session/raw_test.go
@@ -16,7 +16,7 @@ var (
 )
 
 func TestMain(m *testing.M) {
-	TestDB, _ = sql.Open("sqlite3", "gee.db")
+	TestDB, _ = sql.Open("sqlite3", "../gee.db")
 	code := m.Run()
 	_ = TestDB.Close()
 	os.Exit(code)
diff --git a/gee-orm/day6-transaction/session/record.go b/gee-orm/day6-transaction/session/record.go
index b2850cf..fdfca4d 100644
--- a/gee-orm/day6-transaction/session/record.go
+++ b/gee-orm/day6-transaction/session/record.go
@@ -6,10 +6,11 @@ import (
 	"reflect"
 )
 
-// Create one or more records in database
+// Insert one or more records in database
 func (s *Session) Insert(values ...interface{}) (int64, error) {
 	recordValues := make([]interface{}, 0)
 	for _, value := range values {
+		s.CallMethod(BeforeInsert, value)
 		table := s.Model(value).RefTable()
 		s.clause.Set(clause.INSERT, table.Name, table.FieldNames)
 		recordValues = append(recordValues, table.RecordValues(value))
@@ -21,12 +22,13 @@ func (s *Session) Insert(values ...interface{}) (int64, error) {
 	if err != nil {
 		return 0, err
 	}
-
+	s.CallMethod(AfterInsert, nil)
 	return result.RowsAffected()
 }
 
 // Find gets all eligible records
 func (s *Session) Find(values interface{}) error {
+	s.CallMethod(BeforeQuery, nil)
 	destSlice := reflect.Indirect(reflect.ValueOf(values))
 	destType := destSlice.Type().Elem()
 	table := s.Model(reflect.New(destType).Elem().Interface()).RefTable()
@@ -47,6 +49,7 @@ func (s *Session) Find(values interface{}) error {
 		if err := rows.Scan(values...); err != nil {
 			return err
 		}
+		s.CallMethod(AfterQuery, dest.Addr().Interface())
 		destSlice.Set(reflect.Append(destSlice, dest))
 	}
 	return rows.Close()
@@ -89,6 +92,7 @@ func (s *Session) OrderBy(desc string) *Session {
 // support map[string]interface{}
 // also support kv list: "Name", "Tom", "Age", 18, ....
 func (s *Session) Update(kv ...interface{}) (int64, error) {
+	s.CallMethod(BeforeUpdate, nil)
 	m, ok := kv[0].(map[string]interface{})
 	if !ok {
 		m = make(map[string]interface{})
@@ -102,17 +106,20 @@ func (s *Session) Update(kv ...interface{}) (int64, error) {
 	if err != nil {
 		return 0, err
 	}
+	s.CallMethod(AfterUpdate, nil)
 	return result.RowsAffected()
 }
 
 // Delete records with where clause
 func (s *Session) Delete() (int64, error) {
+	s.CallMethod(BeforeDelete, nil)
 	s.clause.Set(clause.DELETE, s.RefTable().Name)
 	sql, vars := s.clause.Build(clause.DELETE, clause.WHERE)
 	result, err := s.Raw(sql, vars...).Exec()
 	if err != nil {
 		return 0, err
 	}
+	s.CallMethod(AfterDelete, nil)
 	return result.RowsAffected()
 }
 

From dd2f1d1d4658787329168241e949779e8886273f Mon Sep 17 00:00:00 2001
From: gzdaijie <gzdaijie@163.com>
Date: Sat, 29 Feb 2020 00:29:53 +0800
Subject: [PATCH 051/122] add day7 migrate

---
 README.md                                     |  22 ++-
 gee-orm/day1-database-sql/session/raw_test.go |   2 +-
 .../day2-reflect-schema/session/raw_test.go   |   2 +-
 gee-orm/day3-save-query/session/raw_test.go   |   2 +-
 .../clause/clause_test.go                     |   6 +-
 .../day4-chain-operation/session/raw_test.go  |   2 +-
 gee-orm/day5-hooks/clause/clause_test.go      |   6 +-
 gee-orm/day5-hooks/session/raw_test.go        |   2 +-
 .../day6-transaction/clause/clause_test.go    |   6 +-
 gee-orm/day6-transaction/session/raw_test.go  |   2 +-
 gee-orm/day7-migrate/clause/clause.go         |  51 +++++++
 gee-orm/day7-migrate/clause/clause_test.go    |  74 ++++++++++
 gee-orm/day7-migrate/clause/generator.go      | 101 +++++++++++++
 gee-orm/day7-migrate/dialect/dialect.go       |  22 +++
 gee-orm/day7-migrate/dialect/sqlite3.go       |  45 ++++++
 gee-orm/day7-migrate/dialect/sqlite3_test.go  |  25 ++++
 gee-orm/day7-migrate/geeorm.go                | 127 ++++++++++++++++
 gee-orm/day7-migrate/geeorm_test.go           |  86 +++++++++++
 gee-orm/day7-migrate/go.mod                   |   5 +
 gee-orm/day7-migrate/log/log.go               |  47 ++++++
 gee-orm/day7-migrate/log/log_test.go          |  17 +++
 gee-orm/day7-migrate/schema/schema.go         |  65 +++++++++
 gee-orm/day7-migrate/schema/schema_test.go    |  35 +++++
 gee-orm/day7-migrate/session/hooks.go         |  32 +++++
 gee-orm/day7-migrate/session/hooks_test.go    |  37 +++++
 gee-orm/day7-migrate/session/raw.go           |  90 ++++++++++++
 gee-orm/day7-migrate/session/raw_test.go      |  48 +++++++
 gee-orm/day7-migrate/session/record.go        | 136 ++++++++++++++++++
 gee-orm/day7-migrate/session/record_test.go   |  97 +++++++++++++
 gee-orm/day7-migrate/session/table.go         |  54 +++++++
 gee-orm/day7-migrate/session/table_test.go    |  28 ++++
 gee-orm/day7-migrate/session/transaction.go   |  31 ++++
 32 files changed, 1287 insertions(+), 18 deletions(-)
 create mode 100644 gee-orm/day7-migrate/clause/clause.go
 create mode 100644 gee-orm/day7-migrate/clause/clause_test.go
 create mode 100644 gee-orm/day7-migrate/clause/generator.go
 create mode 100644 gee-orm/day7-migrate/dialect/dialect.go
 create mode 100644 gee-orm/day7-migrate/dialect/sqlite3.go
 create mode 100644 gee-orm/day7-migrate/dialect/sqlite3_test.go
 create mode 100644 gee-orm/day7-migrate/geeorm.go
 create mode 100644 gee-orm/day7-migrate/geeorm_test.go
 create mode 100644 gee-orm/day7-migrate/go.mod
 create mode 100644 gee-orm/day7-migrate/log/log.go
 create mode 100644 gee-orm/day7-migrate/log/log_test.go
 create mode 100644 gee-orm/day7-migrate/schema/schema.go
 create mode 100644 gee-orm/day7-migrate/schema/schema_test.go
 create mode 100644 gee-orm/day7-migrate/session/hooks.go
 create mode 100644 gee-orm/day7-migrate/session/hooks_test.go
 create mode 100644 gee-orm/day7-migrate/session/raw.go
 create mode 100644 gee-orm/day7-migrate/session/raw_test.go
 create mode 100644 gee-orm/day7-migrate/session/record.go
 create mode 100644 gee-orm/day7-migrate/session/record_test.go
 create mode 100644 gee-orm/day7-migrate/session/table.go
 create mode 100644 gee-orm/day7-migrate/session/table_test.go
 create mode 100644 gee-orm/day7-migrate/session/transaction.go

diff --git a/README.md b/README.md
index aee281f..047f2a0 100644
--- a/README.md
+++ b/README.md
@@ -40,7 +40,15 @@
 
 [GeeORM] 是一个模仿 [gorm](https://github.com/jinzhu/gorm) 和 [xorm](https://github.com/go-xorm/xorm) 的 ORM 框架
 
-gorm 准备推出完全重写的 v2 版本(目前还在开发中)，相对 gorm-v1 来说，xorm 的设计更容易理解，所以 geeorm 接口设计上主要参考了 xorm，具体实现参考了 gorm。
+gorm 准备推出完全重写的 v2 版本(目前还在开发中)，相对 gorm-v1 来说，xorm 的设计更容易理解，所以 geeorm 接口设计上主要参考了 xorm，一些细节实现上参考了 gorm。
+
+- 第一天：database/sql 基础 | [Code](gee-cache/day1-database-sql)
+- 第二天：对象表结构映射 | [Code](gee-cache/day2-reflect-schema)
+- 第三天：插入/查询记录 | [Code](gee-cache/day3-save-query)
+- 第四天：链式操作与更新删除 | [Code](gee-cache/day4-chain-operation)
+- 第五天：实现钩子(Hooks) | [Code](gee-cache/day5-hooks)
+- 第六天：支持事务(Transaction) | [Code](gee-cache/day6-transaction)
+- 第七天：数据库迁移(Migrate) | [Code](gee-cache/day7-migrate)
 
 ### WebAssembly 使用示例
 
@@ -80,12 +88,20 @@ What can I write in 7 days? A gin-like web framework? A distributed cache like g
 - Day 6 - Cache Breakdown & Single Flight  | [Code](gee-cache/day6-single-flight)
 - Day 7 - Use Protobuf as RPC Data Exchange Type | [Code](gee-cache/day7-proto-buf)
 
-## Object Relational Mapping - GeeOrm
+## Object Relational Mapping - GeeORM
 
-[GeeOrm] is a [gorm](https://github.com/jinzhu/gorm)-like and [xorm](https://github.com/go-xorm/xorm)-like object relational mapping library
+[GeeORM] is a [gorm](https://github.com/jinzhu/gorm)-like and [xorm](https://github.com/go-xorm/xorm)-like object relational mapping library
 
 Xorm's desgin is easier to understand than gorm-v1, so the main designs references xorm and some detailed implementions references gorm-v1.
 
+- Day 1 - database/sql Basic | [Code](gee-cache/day1-database-sql)
+- Day 2 - Object Schame Mapping | [Code](gee-cache/day2-reflect-schema)
+- Day 3 - Insert and Query | [Code](gee-cache/day3-save-query)
+- Day 4 - Chain, Delete and Update | [Code](gee-cache/day4-chain-operation)
+- Day 5 - Support Hooks | [Code](gee-cache/day5-hooks)
+- Day 6 - Support Transaction | [Code](gee-cache/day6-transaction)
+- Day 7 - Migrate Database | [Code](gee-cache/day7-migrate)
+
 ## Golang WebAssembly Demo
 
 - Demo 1 - Hello World [Code](demo-wasm/hello-world)
diff --git a/gee-orm/day1-database-sql/session/raw_test.go b/gee-orm/day1-database-sql/session/raw_test.go
index 670420e..5721844 100644
--- a/gee-orm/day1-database-sql/session/raw_test.go
+++ b/gee-orm/day1-database-sql/session/raw_test.go
@@ -24,7 +24,7 @@ func NewSession() *Session {
 func TestSession_Exec(t *testing.T) {
 	s := NewSession()
 	_, _ = s.Raw("DROP TABLE IF EXISTS User;").Exec()
-	_, _ = s.Raw("CREATE TABLE User(name text);").Exec()
+	_, _ = s.Raw("CREATE TABLE User(Name text);").Exec()
 	result, _ := s.Raw("INSERT INTO User(`Name`) values (?), (?)", "Tom", "Sam").Exec()
 	if count, err := result.RowsAffected(); err != nil || count != 2 {
 		t.Fatal("expect 2, but got", count)
diff --git a/gee-orm/day2-reflect-schema/session/raw_test.go b/gee-orm/day2-reflect-schema/session/raw_test.go
index c6c3f08..d521173 100644
--- a/gee-orm/day2-reflect-schema/session/raw_test.go
+++ b/gee-orm/day2-reflect-schema/session/raw_test.go
@@ -29,7 +29,7 @@ func NewSession() *Session {
 func TestSession_Exec(t *testing.T) {
 	s := NewSession()
 	_, _ = s.Raw("DROP TABLE IF EXISTS User;").Exec()
-	_, _ = s.Raw("CREATE TABLE User(name text);").Exec()
+	_, _ = s.Raw("CREATE TABLE User(Name text);").Exec()
 	result, _ := s.Raw("INSERT INTO User(`Name`) values (?), (?)", "Tom", "Sam").Exec()
 	if count, err := result.RowsAffected(); err != nil || count != 2 {
 		t.Fatal("expect 2, but got", count)
diff --git a/gee-orm/day3-save-query/session/raw_test.go b/gee-orm/day3-save-query/session/raw_test.go
index c6c3f08..d521173 100644
--- a/gee-orm/day3-save-query/session/raw_test.go
+++ b/gee-orm/day3-save-query/session/raw_test.go
@@ -29,7 +29,7 @@ func NewSession() *Session {
 func TestSession_Exec(t *testing.T) {
 	s := NewSession()
 	_, _ = s.Raw("DROP TABLE IF EXISTS User;").Exec()
-	_, _ = s.Raw("CREATE TABLE User(name text);").Exec()
+	_, _ = s.Raw("CREATE TABLE User(Name text);").Exec()
 	result, _ := s.Raw("INSERT INTO User(`Name`) values (?), (?)", "Tom", "Sam").Exec()
 	if count, err := result.RowsAffected(); err != nil || count != 2 {
 		t.Fatal("expect 2, but got", count)
diff --git a/gee-orm/day4-chain-operation/clause/clause_test.go b/gee-orm/day4-chain-operation/clause/clause_test.go
index b54c6e0..62e0ccb 100644
--- a/gee-orm/day4-chain-operation/clause/clause_test.go
+++ b/gee-orm/day4-chain-operation/clause/clause_test.go
@@ -34,14 +34,14 @@ func testSelect(t *testing.T) {
 
 func testUpdate(t *testing.T) {
 	var clause Clause
-	clause.Set(UPDATE, "User", map[string]interface{}{"Age": 30, "Name": "Tommy"})
+	clause.Set(UPDATE, "User", map[string]interface{}{"Age": 30})
 	clause.Set(WHERE, "Name = ?", "Tom")
 	sql, vars := clause.Build(UPDATE, WHERE)
 	t.Log(sql, vars)
-	if sql != "UPDATE User SET Age = ?, Name = ? WHERE Name = ?" {
+	if sql != "UPDATE User SET Age = ? WHERE Name = ?" {
 		t.Fatal("failed to build SQL")
 	}
-	if !reflect.DeepEqual(vars, []interface{}{30, "Tommy", "Tom"}) {
+	if !reflect.DeepEqual(vars, []interface{}{30, "Tom"}) {
 		t.Fatal("failed to build SQLVars")
 	}
 }
diff --git a/gee-orm/day4-chain-operation/session/raw_test.go b/gee-orm/day4-chain-operation/session/raw_test.go
index c6c3f08..d521173 100644
--- a/gee-orm/day4-chain-operation/session/raw_test.go
+++ b/gee-orm/day4-chain-operation/session/raw_test.go
@@ -29,7 +29,7 @@ func NewSession() *Session {
 func TestSession_Exec(t *testing.T) {
 	s := NewSession()
 	_, _ = s.Raw("DROP TABLE IF EXISTS User;").Exec()
-	_, _ = s.Raw("CREATE TABLE User(name text);").Exec()
+	_, _ = s.Raw("CREATE TABLE User(Name text);").Exec()
 	result, _ := s.Raw("INSERT INTO User(`Name`) values (?), (?)", "Tom", "Sam").Exec()
 	if count, err := result.RowsAffected(); err != nil || count != 2 {
 		t.Fatal("expect 2, but got", count)
diff --git a/gee-orm/day5-hooks/clause/clause_test.go b/gee-orm/day5-hooks/clause/clause_test.go
index b54c6e0..62e0ccb 100644
--- a/gee-orm/day5-hooks/clause/clause_test.go
+++ b/gee-orm/day5-hooks/clause/clause_test.go
@@ -34,14 +34,14 @@ func testSelect(t *testing.T) {
 
 func testUpdate(t *testing.T) {
 	var clause Clause
-	clause.Set(UPDATE, "User", map[string]interface{}{"Age": 30, "Name": "Tommy"})
+	clause.Set(UPDATE, "User", map[string]interface{}{"Age": 30})
 	clause.Set(WHERE, "Name = ?", "Tom")
 	sql, vars := clause.Build(UPDATE, WHERE)
 	t.Log(sql, vars)
-	if sql != "UPDATE User SET Age = ?, Name = ? WHERE Name = ?" {
+	if sql != "UPDATE User SET Age = ? WHERE Name = ?" {
 		t.Fatal("failed to build SQL")
 	}
-	if !reflect.DeepEqual(vars, []interface{}{30, "Tommy", "Tom"}) {
+	if !reflect.DeepEqual(vars, []interface{}{30, "Tom"}) {
 		t.Fatal("failed to build SQLVars")
 	}
 }
diff --git a/gee-orm/day5-hooks/session/raw_test.go b/gee-orm/day5-hooks/session/raw_test.go
index c6c3f08..d521173 100644
--- a/gee-orm/day5-hooks/session/raw_test.go
+++ b/gee-orm/day5-hooks/session/raw_test.go
@@ -29,7 +29,7 @@ func NewSession() *Session {
 func TestSession_Exec(t *testing.T) {
 	s := NewSession()
 	_, _ = s.Raw("DROP TABLE IF EXISTS User;").Exec()
-	_, _ = s.Raw("CREATE TABLE User(name text);").Exec()
+	_, _ = s.Raw("CREATE TABLE User(Name text);").Exec()
 	result, _ := s.Raw("INSERT INTO User(`Name`) values (?), (?)", "Tom", "Sam").Exec()
 	if count, err := result.RowsAffected(); err != nil || count != 2 {
 		t.Fatal("expect 2, but got", count)
diff --git a/gee-orm/day6-transaction/clause/clause_test.go b/gee-orm/day6-transaction/clause/clause_test.go
index b54c6e0..62e0ccb 100644
--- a/gee-orm/day6-transaction/clause/clause_test.go
+++ b/gee-orm/day6-transaction/clause/clause_test.go
@@ -34,14 +34,14 @@ func testSelect(t *testing.T) {
 
 func testUpdate(t *testing.T) {
 	var clause Clause
-	clause.Set(UPDATE, "User", map[string]interface{}{"Age": 30, "Name": "Tommy"})
+	clause.Set(UPDATE, "User", map[string]interface{}{"Age": 30})
 	clause.Set(WHERE, "Name = ?", "Tom")
 	sql, vars := clause.Build(UPDATE, WHERE)
 	t.Log(sql, vars)
-	if sql != "UPDATE User SET Age = ?, Name = ? WHERE Name = ?" {
+	if sql != "UPDATE User SET Age = ? WHERE Name = ?" {
 		t.Fatal("failed to build SQL")
 	}
-	if !reflect.DeepEqual(vars, []interface{}{30, "Tommy", "Tom"}) {
+	if !reflect.DeepEqual(vars, []interface{}{30, "Tom"}) {
 		t.Fatal("failed to build SQLVars")
 	}
 }
diff --git a/gee-orm/day6-transaction/session/raw_test.go b/gee-orm/day6-transaction/session/raw_test.go
index c6c3f08..d521173 100644
--- a/gee-orm/day6-transaction/session/raw_test.go
+++ b/gee-orm/day6-transaction/session/raw_test.go
@@ -29,7 +29,7 @@ func NewSession() *Session {
 func TestSession_Exec(t *testing.T) {
 	s := NewSession()
 	_, _ = s.Raw("DROP TABLE IF EXISTS User;").Exec()
-	_, _ = s.Raw("CREATE TABLE User(name text);").Exec()
+	_, _ = s.Raw("CREATE TABLE User(Name text);").Exec()
 	result, _ := s.Raw("INSERT INTO User(`Name`) values (?), (?)", "Tom", "Sam").Exec()
 	if count, err := result.RowsAffected(); err != nil || count != 2 {
 		t.Fatal("expect 2, but got", count)
diff --git a/gee-orm/day7-migrate/clause/clause.go b/gee-orm/day7-migrate/clause/clause.go
new file mode 100644
index 0000000..02fcf93
--- /dev/null
+++ b/gee-orm/day7-migrate/clause/clause.go
@@ -0,0 +1,51 @@
+package clause
+
+import (
+	"strings"
+)
+
+// Clause contains SQL conditions
+type Clause struct {
+	sql     map[Type]string
+	sqlVars map[Type][]interface{}
+}
+
+// Type is the type of Clause
+type Type int
+
+// Support types for Clause
+const (
+	INSERT Type = iota
+	VALUES
+	SELECT
+	LIMIT
+	WHERE
+	ORDERBY
+	UPDATE
+	DELETE
+	COUNT
+)
+
+// Set adds a sub clause of specific type
+func (c *Clause) Set(name Type, vars ...interface{}) {
+	if c.sql == nil {
+		c.sql = make(map[Type]string)
+		c.sqlVars = make(map[Type][]interface{})
+	}
+	sql, vars := generators[name](vars...)
+	c.sql[name] = sql
+	c.sqlVars[name] = vars
+}
+
+// Build generate the final SQL and SQLVars
+func (c *Clause) Build(orders ...Type) (string, []interface{}) {
+	var sqls []string
+	var vars []interface{}
+	for _, order := range orders {
+		if sql, ok := c.sql[order]; ok {
+			sqls = append(sqls, sql)
+			vars = append(vars, c.sqlVars[order]...)
+		}
+	}
+	return strings.Join(sqls, " "), vars
+}
diff --git a/gee-orm/day7-migrate/clause/clause_test.go b/gee-orm/day7-migrate/clause/clause_test.go
new file mode 100644
index 0000000..62e0ccb
--- /dev/null
+++ b/gee-orm/day7-migrate/clause/clause_test.go
@@ -0,0 +1,74 @@
+package clause
+
+import (
+	"reflect"
+	"testing"
+)
+
+func TestClause_Set(t *testing.T) {
+	var clause Clause
+	clause.Set(INSERT, "User", []string{"Name", "Age"})
+	sql := clause.sql[INSERT]
+	vars := clause.sqlVars[INSERT]
+	t.Log(sql, vars)
+	if sql != "INSERT INTO User (Name,Age)" || len(vars) != 0 {
+		t.Fatal("failed to get clause")
+	}
+}
+
+func testSelect(t *testing.T) {
+	var clause Clause
+	clause.Set(LIMIT, 3)
+	clause.Set(SELECT, "User", []string{"*"})
+	clause.Set(WHERE, "Name = ?", "Tom")
+	clause.Set(ORDERBY, "Age ASC")
+	sql, vars := clause.Build(SELECT, WHERE, ORDERBY, LIMIT)
+	t.Log(sql, vars)
+	if sql != "SELECT * FROM User WHERE Name = ? ORDER BY Age ASC LIMIT ?" {
+		t.Fatal("failed to build SQL")
+	}
+	if !reflect.DeepEqual(vars, []interface{}{"Tom", 3}) {
+		t.Fatal("failed to build SQLVars")
+	}
+}
+
+func testUpdate(t *testing.T) {
+	var clause Clause
+	clause.Set(UPDATE, "User", map[string]interface{}{"Age": 30})
+	clause.Set(WHERE, "Name = ?", "Tom")
+	sql, vars := clause.Build(UPDATE, WHERE)
+	t.Log(sql, vars)
+	if sql != "UPDATE User SET Age = ? WHERE Name = ?" {
+		t.Fatal("failed to build SQL")
+	}
+	if !reflect.DeepEqual(vars, []interface{}{30, "Tom"}) {
+		t.Fatal("failed to build SQLVars")
+	}
+}
+
+func testDelete(t *testing.T) {
+	var clause Clause
+	clause.Set(DELETE, "User")
+	clause.Set(WHERE, "Name = ?", "Tom")
+
+	sql, vars := clause.Build(DELETE, WHERE)
+	t.Log(sql, vars)
+	if sql != "DELETE FROM User WHERE Name = ?" {
+		t.Fatal("failed to build SQL")
+	}
+	if !reflect.DeepEqual(vars, []interface{}{"Tom"}) {
+		t.Fatal("failed to build SQLVars")
+	}
+}
+
+func TestClause_Build(t *testing.T) {
+	t.Run("select", func(t *testing.T) {
+		testSelect(t)
+	})
+	t.Run("update", func(t *testing.T) {
+		testUpdate(t)
+	})
+	t.Run("delete", func(t *testing.T) {
+		testDelete(t)
+	})
+}
diff --git a/gee-orm/day7-migrate/clause/generator.go b/gee-orm/day7-migrate/clause/generator.go
new file mode 100644
index 0000000..127fc43
--- /dev/null
+++ b/gee-orm/day7-migrate/clause/generator.go
@@ -0,0 +1,101 @@
+package clause
+
+import (
+	"fmt"
+	"strings"
+)
+
+type generator func(values ...interface{}) (string, []interface{})
+
+var generators map[Type]generator
+
+func init() {
+	generators = make(map[Type]generator)
+	generators[INSERT] = _insert
+	generators[VALUES] = _values
+	generators[SELECT] = _select
+	generators[LIMIT] = _limit
+	generators[WHERE] = _where
+	generators[ORDERBY] = _orderBy
+	generators[UPDATE] = _update
+	generators[DELETE] = _delete
+	generators[COUNT] = _count
+}
+
+func genBindVars(num int) string {
+	var vars []string
+	for i := 0; i < num; i++ {
+		vars = append(vars, "?")
+	}
+	return strings.Join(vars, ", ")
+}
+
+func _insert(values ...interface{}) (string, []interface{}) {
+	// INSERT INTO $tableName ($fields)
+	tableName := values[0]
+	fields := strings.Join(values[1].([]string), ",")
+	return fmt.Sprintf("INSERT INTO %s (%v)", tableName, fields), []interface{}{}
+}
+
+func _values(values ...interface{}) (string, []interface{}) {
+	// VALUES ($v1), (&v2), ...
+	var bindStr string
+	var sql strings.Builder
+	var vars []interface{}
+	sql.WriteString("VALUES ")
+	for i, value := range values {
+		v := value.([]interface{})
+		if bindStr == "" {
+			bindStr = genBindVars(len(v))
+		}
+		sql.WriteString(fmt.Sprintf("(%v)", bindStr))
+		if i+1 != len(values) {
+			sql.WriteString(", ")
+		}
+		vars = append(vars, v...)
+	}
+	return sql.String(), vars
+
+}
+
+func _select(values ...interface{}) (string, []interface{}) {
+	// SELECT $fields FROM $tableName
+	tableName := values[0]
+	fields := strings.Join(values[1].([]string), ",")
+	return fmt.Sprintf("SELECT %v FROM %s", fields, tableName), []interface{}{}
+}
+
+func _limit(values ...interface{}) (string, []interface{}) {
+	// LIMIT $num
+	return "LIMIT ?", values
+}
+
+func _where(values ...interface{}) (string, []interface{}) {
+	// WHERE $desc
+	desc, vars := values[0], values[1:]
+	return fmt.Sprintf("WHERE %s", desc), vars
+}
+
+func _orderBy(values ...interface{}) (string, []interface{}) {
+	return fmt.Sprintf("ORDER BY %s", values[0]), []interface{}{}
+}
+
+func _update(values ...interface{}) (string, []interface{}) {
+	tableName := values[0]
+	m := values[1].(map[string]interface{})
+	var keys []string
+	var vars []interface{}
+	for k, v := range m {
+		keys = append(keys, k+" = ?")
+		vars = append(vars, v)
+	}
+	return fmt.Sprintf("UPDATE %s SET %s", tableName, strings.Join(keys, ", ")), vars
+}
+
+func _delete(values ...interface{}) (string, []interface{}) {
+	return fmt.Sprintf("DELETE FROM %s", values[0]), []interface{}{}
+}
+
+func _count(values ...interface{}) (string, []interface{}) {
+	return _select(values[0], []string{"count(*)"})
+}
diff --git a/gee-orm/day7-migrate/dialect/dialect.go b/gee-orm/day7-migrate/dialect/dialect.go
new file mode 100644
index 0000000..4696314
--- /dev/null
+++ b/gee-orm/day7-migrate/dialect/dialect.go
@@ -0,0 +1,22 @@
+package dialect
+
+import "reflect"
+
+var dialectsMap = map[string]Dialect{}
+
+// Dialect is an interface contains methods that a dialect has to implement
+type Dialect interface {
+	DataTypeOf(typ reflect.Value) string
+	TableExistSQL(tableName string) (string, []interface{})
+}
+
+// RegisterDialect register a dialect to the global variable
+func RegisterDialect(name string, dialect Dialect) {
+	dialectsMap[name] = dialect
+}
+
+// Get the dialect from global variable if it exists
+func GetDialect(name string) (dialect Dialect, ok bool) {
+	dialect, ok = dialectsMap[name]
+	return
+}
diff --git a/gee-orm/day7-migrate/dialect/sqlite3.go b/gee-orm/day7-migrate/dialect/sqlite3.go
new file mode 100644
index 0000000..f3c3897
--- /dev/null
+++ b/gee-orm/day7-migrate/dialect/sqlite3.go
@@ -0,0 +1,45 @@
+package dialect
+
+import (
+	"fmt"
+	"reflect"
+	"time"
+)
+
+type sqlite3 struct{}
+
+var _ Dialect = (*sqlite3)(nil)
+
+func init() {
+	RegisterDialect("sqlite3", &sqlite3{})
+}
+
+// Get Data Type for sqlite3 Dialect
+func (s *sqlite3) DataTypeOf(typ reflect.Value) string {
+	switch typ.Kind() {
+	case reflect.Bool:
+		return "bool"
+	case reflect.Int, reflect.Int8, reflect.Int16, reflect.Int32,
+		reflect.Uint, reflect.Uint8, reflect.Uint16, reflect.Uint32, reflect.Uintptr:
+		return "integer"
+	case reflect.Int64, reflect.Uint64:
+		return "bigint"
+	case reflect.Float32, reflect.Float64:
+		return "real"
+	case reflect.String:
+		return "text"
+	case reflect.Array, reflect.Slice:
+		return "blob"
+	case reflect.Struct:
+		if _, ok := typ.Interface().(time.Time); ok {
+			return "datetime"
+		}
+	}
+	panic(fmt.Sprintf("invalid sql type %s (%s)", typ.Type().Name(), typ.Kind()))
+}
+
+// TableExistSQL returns SQL that judge whether the table exists in database
+func (s *sqlite3) TableExistSQL(tableName string) (string, []interface{}) {
+	args := []interface{}{tableName}
+	return "SELECT name FROM sqlite_master WHERE type='table' and name = ?", args
+}
diff --git a/gee-orm/day7-migrate/dialect/sqlite3_test.go b/gee-orm/day7-migrate/dialect/sqlite3_test.go
new file mode 100644
index 0000000..3df5f07
--- /dev/null
+++ b/gee-orm/day7-migrate/dialect/sqlite3_test.go
@@ -0,0 +1,25 @@
+package dialect
+
+import (
+	"reflect"
+	"testing"
+)
+
+func TestDataTypeOf(t *testing.T) {
+	dial := &sqlite3{}
+	cases := []struct {
+		Value interface{}
+		Type  string
+	}{
+		{"Tom", "text"},
+		{123, "integer"},
+		{1.2, "real"},
+		{[]int{1, 2, 3}, "blob"},
+	}
+
+	for _, c := range cases {
+		if typ := dial.DataTypeOf(reflect.ValueOf(c.Value)); typ != c.Type {
+			t.Fatalf("expect %s, but got %s", c.Type, typ)
+		}
+	}
+}
diff --git a/gee-orm/day7-migrate/geeorm.go b/gee-orm/day7-migrate/geeorm.go
new file mode 100644
index 0000000..017d116
--- /dev/null
+++ b/gee-orm/day7-migrate/geeorm.go
@@ -0,0 +1,127 @@
+package geeorm
+
+import (
+	"database/sql"
+	"fmt"
+	"geeorm/dialect"
+	"geeorm/log"
+	"geeorm/session"
+	"strings"
+)
+
+// Engine is the main struct of geeorm, manages all db sessions and transactions.
+type Engine struct {
+	db      *sql.DB
+	dialect dialect.Dialect
+}
+
+// NewEngine create a instance of Engine
+// connect database and ping it to test whether it's alive
+func NewEngine(driver, source string) (e *Engine, err error) {
+	db, err := sql.Open(driver, source)
+	if err != nil {
+		log.Error(err)
+		return
+	}
+	// Send a ping to make sure the database connection is alive.
+	if err = db.Ping(); err != nil {
+		log.Error(err)
+		return
+	}
+	// make sure the specific dialect exists
+	dial, ok := dialect.GetDialect(driver)
+	if !ok {
+		log.Errorf("dialect %s Not Found", driver)
+		return
+	}
+	e = &Engine{db: db, dialect: dial}
+	log.Info("Connect database success")
+	return
+}
+
+// Close database connection
+func (engine *Engine) Close() {
+	if err := engine.db.Close(); err != nil {
+		log.Error("Failed to close database")
+	}
+	log.Info("Close database success")
+}
+
+// NewSession creates a new session for next operations
+func (engine *Engine) NewSession() *session.Session {
+	return session.New(engine.db, engine.dialect)
+}
+
+// TxFunc will be called between tx.Begin() and tx.Commit()
+// https://stackoverflow.com/questions/16184238/database-sql-tx-detecting-commit-or-rollback
+type TxFunc func(*session.Session) (interface{}, error)
+
+// Transaction executes sql wrapped in a transaction, then automatically commit if no error occurs
+func (engine *Engine) Transaction(f TxFunc) (result interface{}, err error) {
+	s := engine.NewSession()
+	if err := s.Begin(); err != nil {
+		return nil, err
+	}
+	defer func() {
+		if p := recover(); p != nil {
+			_ = s.Rollback()
+			panic(p) // re-throw panic after Rollback
+		} else if err != nil {
+			_ = s.Rollback() // err is non-nil; don't change it
+		} else {
+			err = s.Commit() // err is nil; if Commit returns error update err
+		}
+	}()
+
+	return f(s)
+}
+
+// difference returns a - b
+func difference(a []string, b []string) (diff []string) {
+	mapB := make(map[string]bool)
+	for _, v := range b {
+		mapB[v] = true
+	}
+	for _, v := range a {
+		if _, ok := mapB[v]; !ok {
+			diff = append(diff, v)
+		}
+	}
+	return
+}
+
+// Migrate table
+func (engine *Engine) Migrate(value interface{}) error {
+	_, err := engine.Transaction(func(s *session.Session) (result interface{}, err error) {
+		if !s.Model(value).HasTable() {
+			log.Infof("table %s doesn't exist", s.RefTable().Name)
+			return nil, s.CreateTable()
+		}
+		table := s.RefTable()
+		rows, _ := s.Raw(fmt.Sprintf("SELECT * FROM %s LIMIT 1", table.Name)).QueryRows()
+		columns, _ := rows.Columns()
+		addCols := difference(table.FieldNames, columns)
+		delCols := difference(columns, table.FieldNames)
+		log.Infof("added cols %v, deleted cols %v", addCols, delCols)
+
+		for _, col := range addCols {
+			f := table.GetField(col)
+			sqlStr := fmt.Sprintf("ALTER TABLE %s ADD COLUMN %s %s;", table.Name, f.Name, f.Tag)
+			if _, err = s.Raw(sqlStr).Exec(); err != nil {
+				return
+			}
+		}
+
+		if len(delCols) == 0 {
+			return
+		}
+		tmp := "tmp_" + table.Name
+		fieldStr := strings.Join(table.FieldNames, ", ")
+		s.Raw(fmt.Sprintf("CREATE TABLE %s AS SELECT %s from %s;", tmp, fieldStr, table.Name))
+		s.Raw(fmt.Sprintf("DROP TABLE %s;", table.Name))
+		s.Raw(fmt.Sprintf("ALTER TABLE %s RENAME TO %s;", tmp, table.Name))
+		_, err = s.Exec()
+		return
+	})
+	return err
+}
diff --git a/gee-orm/day7-migrate/geeorm_test.go b/gee-orm/day7-migrate/geeorm_test.go
new file mode 100644
index 0000000..b9656c5
--- /dev/null
+++ b/gee-orm/day7-migrate/geeorm_test.go
@@ -0,0 +1,86 @@
+package geeorm
+
+import (
+	"errors"
+	"geeorm/session"
+	"reflect"
+	"testing"
+
+	_ "github.com/mattn/go-sqlite3"
+)
+
+func OpenDB(t *testing.T) *Engine {
+	t.Helper()
+	engine, err := NewEngine("sqlite3", "gee.db")
+	if err != nil {
+		t.Fatal("failed to connect", err)
+	}
+	return engine
+}
+
+func TestNewEngine(t *testing.T) {
+	engine := OpenDB(t)
+	defer engine.Close()
+}
+
+type User struct {
+	Name string `geeorm:"PRIMARY KEY"`
+	Age  int
+}
+
+func transactionRollback(t *testing.T) {
+	engine := OpenDB(t)
+	defer engine.Close()
+	s := engine.NewSession()
+	_ = s.Model(&User{}).DropTable()
+	_, err := engine.Transaction(func(s *session.Session) (result interface{}, err error) {
+		_ = s.Model(&User{}).CreateTable()
+		_, err = s.Insert(&User{"Tom", 18})
+		return nil, errors.New("Error")
+	})
+	if err == nil || s.HasTable() {
+		t.Fatal("failed to rollback")
+	}
+}
+
+func transactionCommit(t *testing.T) {
+	engine := OpenDB(t)
+	defer engine.Close()
+	s := engine.NewSession()
+	_ = s.Model(&User{}).DropTable()
+	_, err := engine.Transaction(func(s *session.Session) (result interface{}, err error) {
+		_ = s.Model(&User{}).CreateTable()
+		_, err = s.Insert(&User{"Tom", 18})
+		return
+	})
+	u := &User{}
+	_ = s.First(u)
+	if err != nil || u.Name != "Tom" {
+		t.Fatal("failed to commit")
+	}
+}
+
+func TestEngine_Transaction(t *testing.T) {
+	t.Run("rollback", func(t *testing.T) {
+		transactionRollback(t)
+	})
+	t.Run("commit", func(t *testing.T) {
+		transactionCommit(t)
+	})
+}
+
+func TestEngine_Migrate(t *testing.T) {
+	engine := OpenDB(t)
+	defer engine.Close()
+	s := engine.NewSession()
+	_, _ = s.Raw("DROP TABLE IF EXISTS User;").Exec()
+	_, _ = s.Raw("CREATE TABLE User(Name text, XXX integer);").Exec()
+	_, _ = s.Raw("INSERT INTO User(`Name`) values (?), (?)", "Tom", "Sam").Exec()
+	engine.Migrate(&User{})
+
+	rows, _ := s.Raw("SELECT * FROM User").QueryRows()
+	columns, _ := rows.Columns()
+	if !reflect.DeepEqual(columns, []string{"Name", "Age"}) {
+		t.Fatal("Failed to migrate table User, got columns", columns)
+	}
+}
diff --git a/gee-orm/day7-migrate/go.mod b/gee-orm/day7-migrate/go.mod
new file mode 100644
index 0000000..043b1c6
--- /dev/null
+++ b/gee-orm/day7-migrate/go.mod
@@ -0,0 +1,5 @@
+module geeorm
+
+go 1.13
+
+require github.com/mattn/go-sqlite3 v2.0.3+incompatible
diff --git a/gee-orm/day7-migrate/log/log.go b/gee-orm/day7-migrate/log/log.go
new file mode 100644
index 0000000..eacc0c6
--- /dev/null
+++ b/gee-orm/day7-migrate/log/log.go
@@ -0,0 +1,47 @@
+package log
+
+import (
+	"io/ioutil"
+	"log"
+	"os"
+	"sync"
+)
+
+var (
+	errorLog = log.New(os.Stdout, "\033[31m[error]\033[0m ", log.LstdFlags|log.Lshortfile)
+	infoLog  = log.New(os.Stdout, "\033[34m[info ]\033[0m ", log.LstdFlags|log.Lshortfile)
+	loggers  = []*log.Logger{errorLog, infoLog}
+	mu       sync.Mutex
+)
+
+// log methods
+var (
+	Error  = errorLog.Println
+	Errorf = errorLog.Printf
+	Info   = infoLog.Println
+	Infof  = infoLog.Printf
+)
+
+// log levels
+const (
+	InfoLevel = iota
+	ErrorLevel
+	Disabled
+)
+
+// SetLevel controls log level
+func SetLevel(level int) {
+	mu.Lock()
+	defer mu.Unlock()
+
+	for _, logger := range loggers {
+		logger.SetOutput(os.Stdout)
+	}
+
+	if ErrorLevel < level {
+		errorLog.SetOutput(ioutil.Discard)
+	}
+	if InfoLevel < level {
+		infoLog.SetOutput(ioutil.Discard)
+	}
+}
diff --git a/gee-orm/day7-migrate/log/log_test.go b/gee-orm/day7-migrate/log/log_test.go
new file mode 100644
index 0000000..8cd403c
--- /dev/null
+++ b/gee-orm/day7-migrate/log/log_test.go
@@ -0,0 +1,17 @@
+package log
+
+import (
+	"os"
+	"testing"
+)
+
+func TestSetLevel(t *testing.T) {
+	SetLevel(ErrorLevel)
+	if infoLog.Writer() == os.Stdout || errorLog.Writer() != os.Stdout {
+		t.Fatal("failed to set log level")
+	}
+	SetLevel(Disabled)
+	if infoLog.Writer() == os.Stdout || errorLog.Writer() == os.Stdout {
+		t.Fatal("failed to set log level")
+	}
+}
\ No newline at end of file
diff --git a/gee-orm/day7-migrate/schema/schema.go b/gee-orm/day7-migrate/schema/schema.go
new file mode 100644
index 0000000..ff76283
--- /dev/null
+++ b/gee-orm/day7-migrate/schema/schema.go
@@ -0,0 +1,65 @@
+package schema
+
+import (
+	"geeorm/dialect"
+	"go/ast"
+	"reflect"
+)
+
+// Field represents a column of database
+type Field struct {
+	Name string
+	Type string
+	Tag  string
+}
+
+// Schema represents a table of database
+type Schema struct {
+	Model      interface{}
+	Name       string
+	Fields     []*Field
+	FieldNames []string
+	fieldMap   map[string]*Field
+}
+
+// GetField returns field by name
+func (schema *Schema) GetField(name string) *Field {
+	return schema.fieldMap[name]
+}
+
+// Values return the values of dest's member variables
+func (schema *Schema) RecordValues(dest interface{}) []interface{} {
+	destValue := reflect.Indirect(reflect.ValueOf(dest))
+	var fieldValues []interface{}
+	for _, field := range schema.Fields {
+		fieldValues = append(fieldValues, destValue.FieldByName(field.Name).Interface())
+	}
+	return fieldValues
+}
+
+// Parse a struct to a Schema instance
+func Parse(dest interface{}, d dialect.Dialect) *Schema {
+	modelType := reflect.Indirect(reflect.ValueOf(dest)).Type()
+	schema := &Schema{
+		Model:    dest,
+		Name:     modelType.Name(),
+		fieldMap: make(map[string]*Field),
+	}
+
+	for i := 0; i < modelType.NumField(); i++ {
+		p := modelType.Field(i)
+		if !p.Anonymous && ast.IsExported(p.Name) {
+			field := &Field{
+				Name: p.Name,
+				Type: d.DataTypeOf(reflect.Indirect(reflect.New(p.Type))),
+			}
+			if v, ok := p.Tag.Lookup("geeorm"); ok {
+				field.Tag = v
+			}
+			schema.Fields = append(schema.Fields, field)
+			schema.FieldNames = append(schema.FieldNames, p.Name)
+			schema.fieldMap[p.Name] = field
+		}
+	}
+	return schema
+}
diff --git a/gee-orm/day7-migrate/schema/schema_test.go b/gee-orm/day7-migrate/schema/schema_test.go
new file mode 100644
index 0000000..47ae9fc
--- /dev/null
+++ b/gee-orm/day7-migrate/schema/schema_test.go
@@ -0,0 +1,35 @@
+package schema
+
+import (
+	"geeorm/dialect"
+	"testing"
+)
+
+type User struct {
+	Name string `geeorm:"PRIMARY KEY"`
+	Age  int
+}
+
+var TestDial, _ = dialect.GetDialect("sqlite3")
+
+func TestParse(t *testing.T) {
+	schema := Parse(&User{}, TestDial)
+	if schema.Name != "User" || len(schema.Fields) != 2 {
+		t.Fatal("failed to parse User struct")
+	}
+	if schema.GetField("Name").Tag != "PRIMARY KEY" {
+		t.Fatal("failed to parse primary key")
+	}
+}
+
+func TestSchema_RecordValues(t *testing.T) {
+	schema := Parse(&User{}, TestDial)
+	values := schema.RecordValues(&User{"Tom", 18})
+
+	name := values[0].(string)
+	age := values[1].(int)
+
+	if name != "Tom" || age != 18 {
+		t.Fatal("failed to get values")
+	}
+}
diff --git a/gee-orm/day7-migrate/session/hooks.go b/gee-orm/day7-migrate/session/hooks.go
new file mode 100644
index 0000000..12462a4
--- /dev/null
+++ b/gee-orm/day7-migrate/session/hooks.go
@@ -0,0 +1,32 @@
+package session
+
+import "reflect"
+
+// Hooks constants
+const (
+	BeforeQuery  = "BeforeQuery"
+	AfterQuery   = "AfterQuery"
+	BeforeUpdate = "BeforeUpdate"
+	AfterUpdate  = "AfterUpate"
+	BeforeDelete = "BeforeDelete"
+	AfterDelete  = "AfterDelete"
+	BeforeInsert = "BeforeInsert"
+	AfterInsert  = "AfterInsert"
+)
+
+// CallMethod calls the registered hooks
+func (s *Session) CallMethod(method string, value interface{}) error {
+	fm := reflect.ValueOf(s.RefTable().Model).MethodByName(method)
+	if value != nil {
+		fm = reflect.ValueOf(value).MethodByName(method)
+	}
+	param := []reflect.Value{reflect.ValueOf(s)}
+	if fm.IsValid() {
+		if v := fm.Call(param); len(v) > 0 {
+			if err, ok := v[0].Interface().(error); ok {
+				return err
+			}
+		}
+	}
+	return nil
+}
diff --git a/gee-orm/day7-migrate/session/hooks_test.go b/gee-orm/day7-migrate/session/hooks_test.go
new file mode 100644
index 0000000..f896d01
--- /dev/null
+++ b/gee-orm/day7-migrate/session/hooks_test.go
@@ -0,0 +1,37 @@
+package session
+
+import (
+	"geeorm/log"
+	"testing"
+)
+
+type Account struct {
+	ID       int `geeorm:"PRIMARY KEY"`
+	Password string
+}
+
+func (account *Account) BeforeInsert(s *Session) error {
+	log.Info("before inert", account)
+	account.ID += 1000
+	return nil
+}
+
+func (account *Account) AfterQuery(s *Session) error {
+	log.Info("after query", account)
+	account.Password = "******"
+	return nil
+}
+
+func TestSession_CallMethod(t *testing.T) {
+	s := NewSession().Model(&Account{})
+	_ = s.DropTable()
+	_ = s.CreateTable()
+	_, _ = s.Insert(&Account{1, "123456"}, &Account{2, "qwerty"})
+
+	u := &Account{}
+
+	err := s.First(u)
+	if err != nil || u.ID != 1001 || u.Password != "******" {
+		t.Fatal("Failed to call hooks after query, got", u)
+	}
+}
diff --git a/gee-orm/day7-migrate/session/raw.go b/gee-orm/day7-migrate/session/raw.go
new file mode 100644
index 0000000..5bdd039
--- /dev/null
+++ b/gee-orm/day7-migrate/session/raw.go
@@ -0,0 +1,90 @@
+package session
+
+import (
+	"database/sql"
+	"geeorm/clause"
+	"geeorm/dialect"
+	"geeorm/log"
+	"geeorm/schema"
+	"strings"
+)
+
+// Session keep a pointer to sql.DB and provides all execution of all
+// kind of database operations.
+type Session struct {
+	db       *sql.DB
+	dialect  dialect.Dialect
+	tx       *sql.Tx
+	refTable *schema.Schema
+	clause   clause.Clause
+	sql      strings.Builder
+	sqlVars  []interface{}
+}
+
+// New creates a instance of Session
+func New(db *sql.DB, dialect dialect.Dialect) *Session {
+	return &Session{
+		db:      db,
+		dialect: dialect,
+	}
+}
+
+// Clear initialize the state of a session
+func (s *Session) Clear() {
+	s.sql.Reset()
+	s.sqlVars = nil
+	s.clause = clause.Clause{}
+}
+
+// CommonDB is a minimal function set of db
+type CommonDB interface {
+	Query(query string, args ...interface{}) (*sql.Rows, error)
+	QueryRow(query string, args ...interface{}) *sql.Row
+	Exec(query string, args ...interface{}) (sql.Result, error)
+}
+
+var _ CommonDB = (*sql.DB)(nil)
+var _ CommonDB = (*sql.Tx)(nil)
+
+// DB returns tx if a tx begins. otherwise return *sql.DB
+func (s *Session) DB() CommonDB {
+	if s.tx != nil {
+		return s.tx
+	}
+	return s.db
+}
+
+// Exec raw sql with sqlVars
+func (s *Session) Exec() (result sql.Result, err error) {
+	defer s.Clear()
+	log.Info(s.sql.String(), s.sqlVars)
+	if result, err = s.DB().Exec(s.sql.String(), s.sqlVars...); err != nil {
+		log.Error(err)
+	}
+	return
+}
+
+// QueryRow gets a record from db
+func (s *Session) QueryRow() *sql.Row {
+	defer s.Clear()
+	log.Info(s.sql.String(), s.sqlVars)
+	return s.DB().QueryRow(s.sql.String(), s.sqlVars...)
+}
+
+// QueryRows gets a list of records from db
+func (s *Session) QueryRows() (rows *sql.Rows, err error) {
+	defer s.Clear()
+	log.Info(s.sql.String(), s.sqlVars)
+	if rows, err = s.DB().Query(s.sql.String(), s.sqlVars...); err != nil {
+		log.Error(err)
+	}
+	return
+}
+
+// Raw appends sql and sqlVars
+func (s *Session) Raw(sql string, values ...interface{}) *Session {
+	s.sql.WriteString(sql)
+	s.sql.WriteString(" ")
+	s.sqlVars = append(s.sqlVars, values...)
+	return s
+}
\ No newline at end of file
diff --git a/gee-orm/day7-migrate/session/raw_test.go b/gee-orm/day7-migrate/session/raw_test.go
new file mode 100644
index 0000000..d521173
--- /dev/null
+++ b/gee-orm/day7-migrate/session/raw_test.go
@@ -0,0 +1,48 @@
+package session
+
+import (
+	"database/sql"
+	"os"
+	"testing"
+
+	"geeorm/dialect"
+
+	_ "github.com/mattn/go-sqlite3"
+)
+
+var (
+	TestDB      *sql.DB
+	TestDial, _ = dialect.GetDialect("sqlite3")
+)
+
+func TestMain(m *testing.M) {
+	TestDB, _ = sql.Open("sqlite3", "../gee.db")
+	code := m.Run()
+	_ = TestDB.Close()
+	os.Exit(code)
+}
+
+func NewSession() *Session {
+	return &Session{db: TestDB, dialect: TestDial}
+}
+
+func TestSession_Exec(t *testing.T) {
+	s := NewSession()
+	_, _ = s.Raw("DROP TABLE IF EXISTS User;").Exec()
+	_, _ = s.Raw("CREATE TABLE User(Name text);").Exec()
+	result, _ := s.Raw("INSERT INTO User(`Name`) values (?), (?)", "Tom", "Sam").Exec()
+	if count, err := result.RowsAffected(); err != nil || count != 2 {
+		t.Fatal("expect 2, but got", count)
+	}
+}
+
+func TestSession_QueryRows(t *testing.T) {
+	s := NewSession()
+	_, _ = s.Raw("DROP TABLE IF EXISTS User;").Exec()
+	_, _ = s.Raw("CREATE TABLE User(Name text);").Exec()
+	row := s.Raw("SELECT count(*) FROM User").QueryRow()
+	var count int
+	if err := row.Scan(&count); err != nil || count != 0 {
+		t.Fatal("failed to query db", err)
+	}
+}
diff --git a/gee-orm/day7-migrate/session/record.go b/gee-orm/day7-migrate/session/record.go
new file mode 100644
index 0000000..fdfca4d
--- /dev/null
+++ b/gee-orm/day7-migrate/session/record.go
@@ -0,0 +1,136 @@
+package session
+
+import (
+	"errors"
+	"geeorm/clause"
+	"reflect"
+)
+
+// Insert one or more records in database
+func (s *Session) Insert(values ...interface{}) (int64, error) {
+	recordValues := make([]interface{}, 0)
+	for _, value := range values {
+		s.CallMethod(BeforeInsert, value)
+		table := s.Model(value).RefTable()
+		s.clause.Set(clause.INSERT, table.Name, table.FieldNames)
+		recordValues = append(recordValues, table.RecordValues(value))
+	}
+
+	s.clause.Set(clause.VALUES, recordValues...)
+	sql, vars := s.clause.Build(clause.INSERT, clause.VALUES)
+	result, err := s.Raw(sql, vars...).Exec()
+	if err != nil {
+		return 0, err
+	}
+	s.CallMethod(AfterInsert, nil)
+	return result.RowsAffected()
+}
+
+// Find gets all eligible records
+func (s *Session) Find(values interface{}) error {
+	s.CallMethod(BeforeQuery, nil)
+	destSlice := reflect.Indirect(reflect.ValueOf(values))
+	destType := destSlice.Type().Elem()
+	table := s.Model(reflect.New(destType).Elem().Interface()).RefTable()
+
+	s.clause.Set(clause.SELECT, table.Name, table.FieldNames)
+	sql, vars := s.clause.Build(clause.SELECT, clause.WHERE, clause.ORDERBY, clause.LIMIT)
+	rows, err := s.Raw(sql, vars...).QueryRows()
+	if err != nil {
+		return err
+	}
+
+	for rows.Next() {
+		dest := reflect.New(destType).Elem()
+		var values []interface{}
+		for _, name := range table.FieldNames {
+			values = append(values, dest.FieldByName(name).Addr().Interface())
+		}
+		if err := rows.Scan(values...); err != nil {
+			return err
+		}
+		s.CallMethod(AfterQuery, dest.Addr().Interface())
+		destSlice.Set(reflect.Append(destSlice, dest))
+	}
+	return rows.Close()
+}
+
+// First gets the 1st row
+func (s *Session) First(value interface{}) error {
+	dest := reflect.Indirect(reflect.ValueOf(value))
+	destSlice := reflect.New(reflect.SliceOf(dest.Type())).Elem()
+	if err := s.Limit(1).Find(destSlice.Addr().Interface()); err != nil {
+		return err
+	}
+	if destSlice.Len() == 0 {
+		return errors.New("NOT FOUND")
+	}
+	dest.Set(destSlice.Index(0))
+	return nil
+}
+
+// Limit adds limit condition to clause
+func (s *Session) Limit(num int) *Session {
+	s.clause.Set(clause.LIMIT, num)
+	return s
+}
+
+// Where adds limit condition to clause
+func (s *Session) Where(desc string, args ...interface{}) *Session {
+	var vars []interface{}
+	s.clause.Set(clause.WHERE, append(append(vars, desc), args...)...)
+	return s
+}
+
+// OrderBy adds order by condition to clause
+func (s *Session) OrderBy(desc string) *Session {
+	s.clause.Set(clause.ORDERBY, desc)
+	return s
+}
+
+// Update records with where clause
+// support map[string]interface{}
+// also support kv list: "Name", "Tom", "Age", 18, ....
+func (s *Session) Update(kv ...interface{}) (int64, error) {
+	s.CallMethod(BeforeUpdate, nil)
+	m, ok := kv[0].(map[string]interface{})
+	if !ok {
+		m = make(map[string]interface{})
+		for i := 0; i < len(kv); i += 2 {
+			m[kv[i].(string)] = kv[i+1]
+		}
+	}
+	s.clause.Set(clause.UPDATE, s.RefTable().Name, m)
+	sql, vars := s.clause.Build(clause.UPDATE, clause.WHERE)
+	result, err := s.Raw(sql, vars...).Exec()
+	if err != nil {
+		return 0, err
+	}
+	s.CallMethod(AfterUpdate, nil)
+	return result.RowsAffected()
+}
+
+// Delete records with where clause
+func (s *Session) Delete() (int64, error) {
+	s.CallMethod(BeforeDelete, nil)
+	s.clause.Set(clause.DELETE, s.RefTable().Name)
+	sql, vars := s.clause.Build(clause.DELETE, clause.WHERE)
+	result, err := s.Raw(sql, vars...).Exec()
+	if err != nil {
+		return 0, err
+	}
+	s.CallMethod(AfterDelete, nil)
+	return result.RowsAffected()
+}
+
+// Count records with where clause
+func (s *Session) Count() (int64, error) {
+	s.clause.Set(clause.COUNT, s.RefTable().Name)
+	sql, vars := s.clause.Build(clause.COUNT, clause.WHERE)
+	row := s.Raw(sql, vars...).QueryRow()
+	var tmp int64
+	if err := row.Scan(&tmp); err != nil {
+		return 0, err
+	}
+	return tmp, nil
+}
diff --git a/gee-orm/day7-migrate/session/record_test.go b/gee-orm/day7-migrate/session/record_test.go
new file mode 100644
index 0000000..5d482a0
--- /dev/null
+++ b/gee-orm/day7-migrate/session/record_test.go
@@ -0,0 +1,97 @@
+package session
+
+import "testing"
+
+var (
+	user1 = &User{"Tom", 18}
+	user2 = &User{"Sam", 25}
+	user3 = &User{"Jack", 25}
+)
+
+func testRecordInit(t *testing.T) *Session {
+	t.Helper()
+	s := NewSession().Model(&User{})
+	err1 := s.DropTable()
+	err2 := s.CreateTable()
+	_, err3 := s.Insert(user1, user2)
+	if err1 != nil || err2 != nil || err3 != nil {
+		t.Fatal("failed init test records")
+	}
+	return s
+}
+
+func TestSession_Insert(t *testing.T) {
+	s := testRecordInit(t)
+	affected, err := s.Insert(user3)
+	if err != nil || affected != 1 {
+		t.Fatal("failed to create record")
+	}
+}
+
+func TestSession_Find(t *testing.T) {
+	s := testRecordInit(t)
+	var users []User
+	if err := s.Find(&users); err != nil || len(users) != 2 {
+		t.Fatal("failed to query all")
+	}
+}
+
+func TestSession_First(t *testing.T) {
+	s := testRecordInit(t)
+	u := &User{}
+	err := s.First(u)
+	if err != nil || u.Name != "Tom" || u.Age != 18 {
+		t.Fatal("failed to query first")
+	}
+}
+
+func TestSession_Limit(t *testing.T) {
+	s := testRecordInit(t)
+	var users []User
+	err := s.Limit(1).Find(&users)
+	if err != nil || len(users) != 1 {
+		t.Fatal("failed to query with limit condition")
+	}
+}
+
+func TestSession_Where(t *testing.T) {
+	s := testRecordInit(t)
+	var users []User
+	_, err1 := s.Insert(user3)
+	err2 := s.Where("Age = ?", 25).Find(&users)
+
+	if err1 != nil || err2 != nil || len(users) != 2 {
+		t.Fatal("failed to query with where condition")
+	}
+}
+
+func TestSession_OrderBy(t *testing.T) {
+	s := testRecordInit(t)
+	u := &User{}
+	err := s.OrderBy("Age DESC").First(u)
+
+	if err != nil || u.Age != 25 {
+		t.Fatal("failed to query with order by condition")
+	}
+}
+
+func TestSession_Update(t *testing.T) {
+	s := testRecordInit(t)
+	affected, _ := s.Where("Name = ?", "Tom").Update("Age", 30)
+	u := &User{}
+	_ = s.OrderBy("Age DESC").First(u)
+
+	if affected != 1 || u.Age != 30 {
+		t.Fatal("failed to update")
+	}
+}
+
+func TestSession_DeleteAndCount(t *testing.T) {
+	s := testRecordInit(t)
+	affected, _ := s.Where("Name = ?", "Tom").Delete()
+	count, _ := s.Count()
+
+	if affected != 1 || count != 1 {
+		t.Fatal("failed to delete or count")
+	}
+}
diff --git a/gee-orm/day7-migrate/session/table.go b/gee-orm/day7-migrate/session/table.go
new file mode 100644
index 0000000..58e7b0f
--- /dev/null
+++ b/gee-orm/day7-migrate/session/table.go
@@ -0,0 +1,54 @@
+package session
+
+import (
+	"fmt"
+	"geeorm/log"
+	"reflect"
+	"strings"
+
+	"geeorm/schema"
+)
+
+// Model assigns refTable
+func (s *Session) Model(value interface{}) *Session {
+	// nil or different model, update refTable
+	if s.refTable == nil || reflect.TypeOf(value) != reflect.TypeOf(s.refTable.Model) {
+		s.refTable = schema.Parse(value, s.dialect)
+	}
+	return s
+}
+
+// RefTable returns a Schema instance that contains all parsed fields
+func (s *Session) RefTable() *schema.Schema {
+	if s.refTable == nil {
+		log.Error("Model is not set")
+	}
+	return s.refTable
+}
+
+// CreateTable create a table in database with a model
+func (s *Session) CreateTable() error {
+	table := s.RefTable()
+	var columns []string
+	for _, field := range table.Fields {
+		columns = append(columns, fmt.Sprintf("%s %s %s", field.Name, field.Type, field.Tag))
+	}
+	desc := strings.Join(columns, ",")
+	_, err := s.Raw(fmt.Sprintf("CREATE TABLE %s (%s);", table.Name, desc)).Exec()
+	return err
+}
+
+// DropTable drops a table with the name of model
+func (s *Session) DropTable() error {
+	_, err := s.Raw(fmt.Sprintf("DROP TABLE IF EXISTS %s", s.RefTable().Name)).Exec()
+	return err
+}
+
+// HasTable returns true of the table exists
+func (s *Session) HasTable() bool {
+	sql, values := s.dialect.TableExistSQL(s.RefTable().Name)
+	row := s.Raw(sql, values...).QueryRow()
+	var tmp string
+	_ = row.Scan(&tmp)
+	return tmp == s.RefTable().Name
+}
diff --git a/gee-orm/day7-migrate/session/table_test.go b/gee-orm/day7-migrate/session/table_test.go
new file mode 100644
index 0000000..3bb7554
--- /dev/null
+++ b/gee-orm/day7-migrate/session/table_test.go
@@ -0,0 +1,28 @@
+package session
+
+import (
+	"testing"
+)
+
+type User struct {
+	Name string `geeorm:"PRIMARY KEY"`
+	Age  int
+}
+
+func TestSession_CreateTable(t *testing.T) {
+	s := NewSession().Model(&User{})
+	_ = s.DropTable()
+	_ = s.CreateTable()
+	if !s.HasTable() {
+		t.Fatal("Failed to create table User")
+	}
+}
+
+func TestSession_Model(t *testing.T) {
+	s := NewSession().Model(&User{})
+	table := s.RefTable()
+	s.Model(&Session{})
+	if table.Name != "User" || s.RefTable().Name != "Session" {
+		t.Fatal("Failed to change model")
+	}
+}
diff --git a/gee-orm/day7-migrate/session/transaction.go b/gee-orm/day7-migrate/session/transaction.go
new file mode 100644
index 0000000..3cdb451
--- /dev/null
+++ b/gee-orm/day7-migrate/session/transaction.go
@@ -0,0 +1,31 @@
+package session
+
+import "geeorm/log"
+
+// Begin a transaction
+func (s *Session) Begin() (err error) {
+	log.Info("transaction begin")
+	if s.tx, err = s.db.Begin(); err != nil {
+		log.Error(err)
+		return
+	}
+	return
+}
+
+// Commit a transaction
+func (s *Session) Commit() (err error) {
+	log.Info("transaction commit")
+	if err = s.tx.Commit(); err != nil {
+		log.Error(err)
+	}
+	return
+}
+
+// Rollback a transaction
+func (s *Session) Rollback() (err error) {
+	log.Info("transaction rollback")
+	if err = s.tx.Rollback(); err != nil {
+		log.Error(err)
+	}
+	return
+}

From b7fdf41baa9be2b24ad6381b49301a2e7a3afa16 Mon Sep 17 00:00:00 2001
From: gzdaijie <gzdaijie@163.com>
Date: Sun, 1 Mar 2020 00:41:03 +0800
Subject: [PATCH 052/122] add geeorm post url

---
 README.md | 32 ++++++++++++++++----------------
 1 file changed, 16 insertions(+), 16 deletions(-)

diff --git a/README.md b/README.md
index 047f2a0..5a9a75a 100644
--- a/README.md
+++ b/README.md
@@ -38,17 +38,17 @@
 
 ### 7天用Go从零实现ORM框架 GeeORM
 
-[GeeORM] 是一个模仿 [gorm](https://github.com/jinzhu/gorm) 和 [xorm](https://github.com/go-xorm/xorm) 的 ORM 框架
+[GeeORM](https://geektutu.com/post/geeorm.html) 是一个模仿 [gorm](https://github.com/jinzhu/gorm) 和 [xorm](https://github.com/go-xorm/xorm) 的 ORM 框架
 
 gorm 准备推出完全重写的 v2 版本(目前还在开发中)，相对 gorm-v1 来说，xorm 的设计更容易理解，所以 geeorm 接口设计上主要参考了 xorm，一些细节实现上参考了 gorm。
 
-- 第一天：database/sql 基础 | [Code](gee-cache/day1-database-sql)
-- 第二天：对象表结构映射 | [Code](gee-cache/day2-reflect-schema)
-- 第三天：插入/查询记录 | [Code](gee-cache/day3-save-query)
-- 第四天：链式操作与更新删除 | [Code](gee-cache/day4-chain-operation)
-- 第五天：实现钩子(Hooks) | [Code](gee-cache/day5-hooks)
-- 第六天：支持事务(Transaction) | [Code](gee-cache/day6-transaction)
-- 第七天：数据库迁移(Migrate) | [Code](gee-cache/day7-migrate)
+- 第一天：database/sql 基础 | [Code](gee-orm/day1-database-sql)
+- 第二天：对象表结构映射 | [Code](gee-orm/day2-reflect-schema)
+- 第三天：插入/查询记录 | [Code](gee-orm/day3-save-query)
+- 第四天：链式操作与更新删除 | [Code](gee-orm/day4-chain-operation)
+- 第五天：实现钩子(Hooks) | [Code](gee-orm/day5-hooks)
+- 第六天：支持事务(Transaction) | [Code](gee-orm/day6-transaction)
+- 第七天：数据库迁移(Migrate) | [Code](gee-orm/day7-migrate)
 
 ### WebAssembly 使用示例
 
@@ -90,17 +90,17 @@ What can I write in 7 days? A gin-like web framework? A distributed cache like g
 
 ## Object Relational Mapping - GeeORM
 
-[GeeORM] is a [gorm](https://github.com/jinzhu/gorm)-like and [xorm](https://github.com/go-xorm/xorm)-like object relational mapping library
+[GeeORM](https://geektutu.com/post/geeorm.html) is a [gorm](https://github.com/jinzhu/gorm)-like and [xorm](https://github.com/go-xorm/xorm)-like object relational mapping library
 
 Xorm's desgin is easier to understand than gorm-v1, so the main designs references xorm and some detailed implementions references gorm-v1.
 
-- Day 1 - database/sql Basic | [Code](gee-cache/day1-database-sql)
-- Day 2 - Object Schame Mapping | [Code](gee-cache/day2-reflect-schema)
-- Day 3 - Insert and Query | [Code](gee-cache/day3-save-query)
-- Day 4 - Chain, Delete and Update | [Code](gee-cache/day4-chain-operation)
-- Day 5 - Support Hooks | [Code](gee-cache/day5-hooks)
-- Day 6 - Support Transaction | [Code](gee-cache/day6-transaction)
-- Day 7 - Migrate Database | [Code](gee-cache/day7-migrate)
+- Day 1 - database/sql Basic | [Code](gee-orm/day1-database-sql)
+- Day 2 - Object Schame Mapping | [Code](gee-orm/day2-reflect-schema)
+- Day 3 - Insert and Query | [Code](gee-orm/day3-save-query)
+- Day 4 - Chain, Delete and Update | [Code](gee-orm/day4-chain-operation)
+- Day 5 - Support Hooks | [Code](gee-orm/day5-hooks)
+- Day 6 - Support Transaction | [Code](gee-orm/day6-transaction)
+- Day 7 - Migrate Database | [Code](gee-orm/day7-migrate)
 
 ## Golang WebAssembly Demo
 

From 7645de81c718bed1e4f956951f19f3fa4b00b5c0 Mon Sep 17 00:00:00 2001
From: gzdaijie <gzdaijie@163.com>
Date: Sun, 1 Mar 2020 02:41:53 +0800
Subject: [PATCH 053/122] add geeorm day0 intro

---
 gee-orm/doc/geeorm.md            | 137 +++++++++++++++++++++++++++++++
 gee-orm/doc/geeorm/geeorm.jpg    | Bin 0 -> 27950 bytes
 gee-orm/doc/geeorm/geeorm_sm.jpg | Bin 0 -> 7426 bytes
 3 files changed, 137 insertions(+)
 create mode 100644 gee-orm/doc/geeorm.md
 create mode 100644 gee-orm/doc/geeorm/geeorm.jpg
 create mode 100644 gee-orm/doc/geeorm/geeorm_sm.jpg

diff --git a/gee-orm/doc/geeorm.md b/gee-orm/doc/geeorm.md
new file mode 100644
index 0000000..78f4087
--- /dev/null
+++ b/gee-orm/doc/geeorm.md
@@ -0,0 +1,137 @@
+---
+title: 7天用Go从零实现ORM框架GeeORM
+date: 2020-03-01 01:00:00
+description: 7天用 Go语言/golang 从零实现 ORM 框架 GeeORM 教程(7 days implement golang object relational mapping framework from scratch tutorial)，动手写 ORM 框架，参照 gorm, xorm 的实现。功能包括对象和表结构的相互映射，表的创建删除(table)，记录的增删查改，事务支持(transaction)，数据库迁移(migrate)，钩子(hooks)等。
+tags:
+- Go
+nav: 从零实现
+categories:
+- ORM框架 - GeeORM
+keywords:
+- Go语言
+- 从零实现ORM框架
+- 动手写ORM框架
+- database/sql
+- sqlite3
+image: post/geeorm/geeorm_sm.jpg
+github: https://github.com/geektutu/7days-golang
+---
+
+![golang ORM framework](geeorm/geeorm.jpg)
+
+## 1 谈谈 ORM 框架
+
+> 对象关系映射（Object Relational Mapping，简称ORM）是通过使用描述对象和数据库之间映射的元数据，将面向对象语言程序中的对象自动持久化到关系数据库中。
+
+那对象和数据库是如何映射的呢？
+
+| 数据库 | 面向对象的编程语言 | 
+|:---:|:---:|
+| 表(table) | 类(class/struct) |
+| 记录(record, row) | 对象 (object) |
+| 字段(field, column) | 对象属性(attribute) |
+
+举一个具体的例子，来理解 ORM。
+
+```sql
+CREATE TABLE `User` (`Name` text, `Age` integer);
+INSERT INTO `User` (`Name`, `Age`) VALUES ("Tom", 18);
+SELECT * FROM `User`;
+```
+
+第一条 SQL 语句，在数据库中创建了表 `User`，并且定义了 2 个字段 `Name` 和 `Age`；第二条 SQL 语句往表中添加了一条记录；最后一条语句返回表中的所有记录。
+
+假如我们使用了 ORM 框架，可以这么写：
+
+```go
+type User struct {
+    Name string
+    Age  int
+}
+
+orm.CreateTable(&User{})
+orm.Save(&User{"Tom", 18})
+var users []User
+orm.Find(&users)
+```
+
+ORM 框架相当于对象和数据库中间的一个桥梁，借助 ORM 可以避免写繁琐的 SQL 语言，仅仅通过操作具体的对象，就能够完成对关系型数据库的操作。
+
+那如何实现一个 ORM 框架呢？
+
+- `CreateTable` 方法需要从参数 `&User{}` 得到对应的结构体的名称 User 作为表名，成员变量 Name, Age 作为列名，同时还需要知道成员变量对应的类型。
+- `Save` 方法则需要知道每个成员变量的值。
+- `Find` 方法仅从传入的空切片 `&[]User`，得到对应的结构体名也就是表名 User，并从数据库中取到所有的记录，将其转换成 User 对象，添加到切片中。
+
+如果这些方法只接受 User 类型的参数，那是很容易实现的。但是 ORM 框架是通用的，也就是说可以将任意合法的对象转换成数据库中的表和记录。例如：
+
+```go
+type Account struct {
+    Username string
+    Password string
+}
+
+orm.CreateTable(&Account{})
+```
+
+这就面临了一个很重要的问题：如何根据任意类型的指针，得到其对应的结构体的信息。这涉及到了 Go 语言的反射机制(reflect)，通过反射，可以获取到对象对应的结构体名称，成员变量、方法等信息，例如：
+
+```go
+typ := reflect.Indirect(reflect.ValueOf(&Account{})).Type()
+fmt.Println(typ.Name()) // Account
+
+for i := 0; i < typ.NumField(); i++ {
+    field := typ.Field(i)
+    fmt.Println(field.Name) // Username Password
+}
+```
+
+- `reflect.ValueOf()` 获取指针对应的反射值。
+- `reflect.Indirect()` 获取指针指向的对象的反射值。
+- `(reflect.Type).Name()` 返回类名(字符串)。
+- `(reflect.Type).Field(i)` 获取第 i 个成员变量。
+
+除了对象和表结构/记录的映射以外，设计 ORM 框架还需要关注什么问题呢？
+
+1）MySQL，PostgreSQL，SQLite 等数据库的 SQL 语句是有区别的，ORM 框架如何在开发者不感知的情况下适配多种数据库？
+
+2）如何对象的字段发生改变，数据库表结构能够自动更新，即是否支持数据库自动迁移(migrate)？
+
+3）数据库支持的功能很多，例如事务(transaction)，ORM 框架能实现哪些？
+
+4）...
+
+## 2 关于 GeeORM
+
+数据库的特性非常多，简单的增删查改使用 ORM 替代 SQL 语句是没有问题的，但是也有很多特性难以用 ORM 替代，比如复杂的多表关联查询，ORM 也可能支持，但是基于性能的考虑，开发者自己写 SQL 语句很可能更高效。
+
+因此，设计实现一个 ORM 框架，就需要给功能特性排优先级了。
+
+Go 语言中使用比较广泛 ORM 框架是 [gorm](https://github.com/jinzhu/gorm) 和 [xorm](https://github.com/go-xorm/xorm)。除了基础的功能，比如表的操作，记录的增删查改，gorm 还实现了关联关系(一对一、一对多等)，回调插件等；xorm 实现了读写分离(支持配置多个数据库)，数据同步，导入导出等。
+
+gorm 正在彻底重构 v1 版本，短期内看不到发布 v2 的可能。相比于 gorm-v1，xorm 在设计上更清晰。GeeORM 的设计主要参考了 xorm，一些细节上的实现参考了 gorm。GeeORM 的目的主要是了解 ORM 框架设计的原理，具体实现上鲁棒性做得不够，一些复杂的特性，例如 gorm 的关联关系，xorm 的读写分离没有实现。目前支持的特性有：
+
+- 表的创建、删除、迁移。
+- 记录的增删查改，查询条件的链式操作。
+- 单一主键的设置(primary key)。
+- 钩子(在创建/更新/删除/查找之前或之后)
+- 事务(transaction)。
+- ...
+
+`GeeORM` 分7天实现，每天完成的部分都是可以独立运行和测试的，就像搭积木一样，一个个独立的特性组合在一起就是最终的 ORM 框架。每天的代码在 100 行左右，同时配有较为完备的单元测试用例。
+
+## 3 目录
+
+- 第一天：database/sql 基础 | [Code](https://github.com/geektutu/7days-golang/blob/master/gee-orm/day1-database-sql)
+- 第二天：对象表结构映射 | [Code](https://github.com/geektutu/7days-golang/blob/master/gee-orm/day2-reflect-schema)
+- 第三天：插入/查询记录 | [Code](https://github.com/geektutu/7days-golang/blob/master/gee-orm/day3-save-query)
+- 第四天：链式操作与更新删除 | [Code](https://github.com/geektutu/7days-golang/blob/master/gee-orm/day4-chain-operation)
+- 第五天：实现钩子(Hooks) | [Code](https://github.com/geektutu/7days-golang/blob/master/gee-orm/day5-hooks)
+- 第六天：支持事务(Transaction) | [Code](https://github.com/geektutu/7days-golang/blob/master/gee-orm/day6-transaction)
+- 第七天：数据库迁移(Migrate) | [Code](https://github.com/geektutu/7days-golang/blob/master/gee-orm/day7-migrate)
+
+
+## 附 推荐阅读
+
+- [Go 语言简明教程](https://geektutu.com/post/quick-golang.html)
+- [Go Test 单元测试简明教程](https://geektutu.com/post/quick-go-test.html)
\ No newline at end of file
diff --git a/gee-orm/doc/geeorm/geeorm.jpg b/gee-orm/doc/geeorm/geeorm.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..6b980ac12c30b1eb84bd75193a777b24c75a1008
GIT binary patch
literal 27950
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
IKliWy*-pB?&;S4c

literal 0
HcmV?d00001

diff --git a/gee-orm/doc/geeorm/geeorm_sm.jpg b/gee-orm/doc/geeorm/geeorm_sm.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..960a985f9ffb3bdec2f06a9728c8b305e3746890
GIT binary patch
literal 7426
zcmbt(cQl;O_y4mNtFu~^#VQfK*C<g}2_ZVMdKY2!o<;Od)TklRiC!b36TL=_9z<`^
zB46+K=kxuY^E>DF-*4u5&Yfpwp1F7Cb?4l<cm96=y8@7?B2*9n2m}D2`waYD0Nw!D
z_X&ax!NGyx;ooOsA_4*;VoDO|eWqlhpr*KgnCMyPVfU{H2P-Rwh_sM^khGeDf|{w3
zslR^_=>K<sznuUS2j~THfk8|F1{4H_g8p^`uzLY9z@UF*{ojOzjRD4lfN=iK133Sw
z|AYO%ZU3R*<V+1%JNkZlxQ2rRS_R+#xZgL3l~SW_Y;*2RFSdV}-G9RZ1Ge2?IU`d}
zBicEws^73`zm_e^ZPlyT6E&~$dpCM8n>#=mRdMHNnR%!4vF`lbVQ2h;BS?67`WvqQ
zDX&MqtncKvUyVPs%L82xKP}?i{M1Tut5B73S5{c1a7#H6-(IHeVLjEG+|>{XZS1+|
zG+J-O8CB7-J@4&(77%?HGwXD+Gv|=<Eh^Es!Z%TO9kyhONipG^3KgZTd<F6UlKZE|
zA+>ar(<?J&apS{T$YC#kPTJ^r*%oy`PuQO<36ITIlP9P>@&qAwf7CSz0EVGwx5x^J
zxU*w;;Q)a3L>XIO1^_Usu@*s|*wkpM&C@N}@bqV(-x4W)IfAqgMci~G(>&WQlvFp>
z4y&hG4hw#!4+T*><d%LfeZqBza`+jUF*8|1ujJw9(KTAB&mW(q5=0^86tfpGYUMm&
zH%#h#-EJAL`?{<E;mLS9WFsG5dU|%hwBp5nVy^r3gXsHml`VhMJpoqdrv4%SC%wK$
zm*yV7{~KHYbPp~T_P^L-klc4Z?fB;p?Xk@f8PHr@7WZRcZ^j<2se@?lJ}LTGiKCs%
z3zWfy@z?3Vp#oE;Og-L~^txwgkYoW80EMcb)$9)PQjf<z*v)4ljWFVb|1%f>{(rN+
z=M4HUYw$m;>;CDBYnpVY2ar~NcZ_q`9bfjP6vy}f3{%qQw@x9e+L<l-k#(>fQ>QK6
zHJPoQ;`3lzmY@T))S1-*EKN!Qz?=|28nhs8@Xtv18?77QC%ISW`$=MAVq#(aTY1kE
z0}C5~l8}<YA><S?j7)s|0>UDiW|S-sg=GJ$<RBd2FCb=pru!GDR&R4P;xtH4j|?WU
ztV&Ph=O<$bT%KQN2U^1|It6JAZuOP46qX{7PI>D$T}$sML$%tASceQp-)@Mj6=wqT
zT{laF<h44?&z>#J>%3Eb1CI+KlSK~02rewEB4?K#;7zwb!7QufSl3@(zj_yi)OVxc
z*s(>e2dp20u<!;}>DrZQpfZ;XB;{Tr>;A;da?KfIJ-O<l2?H}4x+G#%#?9k`!rl76
zZ+!#AP(CmVyC3qB*1WNYvJ<n-J{WH^q98s3Moh=|a?`K#0s2E`JGS)8nrHHu&q+0M
zo|c-VRb{4qh8WiOc5Y?_o%>Csyfc1T`NBtOWg+S#es-Ei(ThYb=n<#d*3SHrgFk%h
z`L_k@fb82>@PItQ<k6X_sn2#{Wtr1Wd2%FWn+#$0<?*a^%zZxZmZG?IPG*dCqwTD)
zf`-DSv`X7>-oX1zg}c{68{Y;{q;xGzLp$v<DDUd5Z4x7T*JDnIMZ%KXK=^pp&mK0c
zEH%jgAhCEPPJekTNViy+!SmkfSPG!vd8Ya<x<$FuV(zhc<*4z_f`3g$!OH5HXb$-$
ztaoDb`r--2MwF{mZ0gj=0xNA#HQI%bBVD4c0#@paF~63#@hU5R&1QA&!A|oWh4m6+
zvnd^%DtfG}aP5!{JMGB%YU8R(+GyVQFQA#+7+CB6aGUGgZ&qGwS|ro(?8P+F34cUA
zy}@F)_Mt>vM}iBh_8Km${?LB7D)9r6`d@ld^zNL*Ys9Nr@rK6JLT+Swd%Z=x-XaWa
zAC!7?KG<iUX3^uDaDF(w{5C)L<ut4NK!fD&<Mi<YI0F_GOJfNkcyV1gvddp%@%ytJ
zfRQ7Ui}!L8+mygeKY{=)G3RTPIzDh=DeNDpgyVh4i>gI%B(J{It+THK75l!3dkq$x
z_!YAI2K?w-zp);pYRhC&k4~RDWv>DIc(=(}zE6(RTwgx8tC7-Dj2+sjqb4dS_Lk=d
z2kV<#nLFcfgYC-S<cgN4#?i>imuWt>X9w}d9Q9x5KR787_E9g%iRrmNievg$;0sqc
z8cRbiAXVjQ>Sm))t~28U|2c=2!P1Xlnz^nd<sBAZM|0(mVt;`g$#Ka*2${Wnz5GsB
z#PpWm`Ab@(Cw#xQxsA@%UK{=9hD0+-;d9div?jJ;;R<h_Xdm6>_J|45$X~H-8dm4M
z@5-`XH7*RA84(tBS8~{8bX`diK-J~LT7t!igoW#P?35EdLimH?araufz1!01)l-Nn
zB6pOd4<a)DwDBrG<W;$Rm1-%e%`&^Yc52#o&hHZ$NphQgjlQ$rRh0Td%yR8!SnQ{y
z#rb+2l%$t9RzgnaNN4!^H+`W1gI;}H9^&k?n6XK`_x99j)bzG|VwfXfR9CU4PaZvN
zf+kjLXlz9BCXO}KOU;$7*!^mklKS9wTrW7KUHRt=eLI6E-fbvvE881$62)OMpSZ?|
z*-v%n5MOs#`4~H%CiO1H`e#Y82uF2kUGJNALjW>y=6o%wHFF)#TK?yU;J0iO?oZjS
z%OArWcqY%p&=mwH+6#Thzv?cH&dO)FuTc*360;@g5gD1wY2`-k3$w#dXDj*e!Eu%t
z%a?!FD{&2Tr1WfyC^kgIBZwsOZgA_?M|<H@E*+zl;!w5nJ-)LoS=S3EJ?s@^n=1!L
z<kxRF!aJ<==!C0r1AlLM`cYrO52Y7n)K_U^bA2ANJ9e#AfeMn-(D5nLR~f!kZ6Pu@
zScdISOD8zd_9c}=D?eM*F6J6+@H&E<<P!}xyqM-Zh4q=Q1`YYPL{w(`=mL`Yp@Nbw
zXO<AIso#4-x~>awRB?lmPt)Wqm)R#YDNYKI`hNOHX}Ph%j>WiwA&=n5VxAF4d&Hul
zRzBM+5o<@hQ_9+WYQo<VFpz!VV_sqCw6u6wIMd?uI0N&>mx~?tTzWp~2p$2B*%xy0
zp>k;t4ABJB-$i;0*;@CHjjbt13>>)oj1o+_e1~Y}xB0p_S_Fmu{D8jgD|5Ogtk|pf
z9~b^b?m?s_Q`LI$OY*VNHTzCcRY5^b1IOAgS&)Fvu#M~~{#ztt6hX-;dwv3;^WdD|
z0=*N3x}*f#>&)#o?_6Pha!2Vj3tFmU99EvW#I<$uhw`m)l^I*e7r3xVoqi-Vz$jk%
zG+3RXm_otf{fH*}W~73Ff&=eKBv(^tpYz%6hl;ZR+_pXq3)X$z0_!0M;}Ky<a0-$(
zXYO#`4|r+Y>cGG6rl`v+yQBtjU*oNYQba`D%%mXe`<v&mXDo$q=^Nq{%g&=uq$LG?
zMXujHVu_Xtl<HrO7l||BG12AK`SJ<zUT!15pfXWfzWllR1C#8w+%FfRwSsl*<Q^=^
zim3A3E7N=HiMY3(An?7N#>Rr+LH;=t-X9kLOeiTMzwC1?GA45pa<~90ky%bFD4$Qp
z!ZoS72AhIKP*caO_UrgVA#L~I_noW%HL18y?oBET`SroCma0SHd6A7AumSa@O$7Xi
z8TG9AvjJNA-?Gc=Pe6{ln1}Y8nB%TS<_*!xN$W6So?o<7jEcyC$Il8HVVTKSmA!K1
ziHal-+;~YQT0@q?wy{h1rDub+a1N!Melk=`*OjE=vU1HdYJN<&9dC|Pj^tngyJ8Cy
zB<eA(UH*<|Nwz<C!V{pO^8sl9dD`ja8?h{@V_7oeRt}7!(EbqV1JIM)X9=C@SPLa$
z01->_C$QUdsnCLWjQ)8ZYwh7LJ0X+Hg*q~l90lOOw?X+W`@*E`E1gu!E=B$6y-N8-
zFS6j=#OKk}sPYd;&v*6F^@~9@GuvY+V_<$3)$4TVu)2JStkhz3U7{!}VneBa%B3)7
z0P`g}eJfb7WD$JOkhrGZkvpm~hJJ}{n4ZN^yfx&BQBBr~nY_62*q|WfqZrsqxQmEK
z>5aaH5mFgJ<5>8B^vf^F%*e`_+P%B66|OX<rFgbQHcnb$k%v)h;%kI4;h{&zqHyIw
z8XNwmB?Ag~^B%fqyMvzaYiiet9`0k)61;5lXMNm^#+Gqexe8STQD0Xxq%I4Q)3d8X
zF3gt7q#ibLs}QUdB3kO}qKFgeE-Xy}l@)fnKIGd#A$rMEiTLz_1aF2{I<da3SPZcy
z9sA=}S^=a?7%uoEPXdtgH;#8_U&A$BpWs>R!c@e-KeZ7X1PSH1w^9TYN~F(#tEutk
zUYBy*zNMWErbtw(Wl-`bdaDx(x^B-I&sfx1b^6Vm&8vNC*&iMG#pa`qNbr#!-k0m3
z?b^Lx-=3De3nw#fu#}ac{Pt0HrnzLP)1){GlRBZgF?JE~Cdf*%`*DHnVrLhQiIsqn
zKweWJ<V^?LC*L*0HE@;pt>7DkzLrXOJ|v3p=Sj-2fi(>+-&|!3qKTlCW{a&wYmE%|
z{zqp@pFA~j=?t5698N5|hXlW*`e-q!ia|d;f$8KQd3N+dR6TTepJ8dxipqGMsYT`#
zQE)WD+_T0A85x<hJ6c^v6V@Ddkp$h0-)q<71ZyfZI8-6wZH!ZyHeC2z)+2_7V)>Fi
z!0QhTE5bi;ABGy%eF8tq>oIOsgmZxw^m2V*gz<^_tKQGiQn=Wk7_)Ok;Fg`V^0q53
z0kofo&^70}aM15+a%{^m1r~x=m7udjr#U$)Zp|aZ!uYl%<A4e-avCKPSppKqK;AVk
zUgf^p%4{PQs0XdR%mlLIhddx4bCj9F5*wyF9>NYuX9{ZjlI-nd0dM@J?9Jq1sXh2G
z%wEraT}K-wm@sk)-%*?+(Nf`FOrJ?C({Q;2d*VoPa6rQFJ#w%GVg)2N*wrB}rTUMg
zJBEkrN>C6`TFlR98ibY{_Faks5c!SQQ*LKRhm(KUTrh7-hwjGz0uIrLU<mA|Fl)MI
z14wMnb75%meG9av-BsG((JR(~K|q9pqt>B=;QOeSeQ%P0j)*sk0c^74Lwh)Bj8*P^
z(;GlbhI-Yv)&VwMjz6NQZL$f2hX&mvCg3pD<w&n7{##e&nAE2+A%E2%MX7^?-SuLY
zOj&YPk4oFdpgl@{tBrVBv|^=Bnka`<SK5}fMdQx-<H(vH{$;|V5H!OCca=uIrqVEF
z79)qyOYdkv61Argae&XahVO7@AX9#TtgB2IT2ui8$s_NTXZPNRGK888U@VIHXfn0a
zQgKr|yJtBkAiR1WbN5+(<5V3E9<dmyW!#!XxT*_EeO{`OJY1?X8*0K?h70r%QQbT_
zkt$mr#(88{Ip*O0{KAUbSpyreE#T%OjwelSda|#@QzTc~JiszLZ@Tn!m1o5{cA&pF
zs`w9cZc8HqD-2hhIi4YuwS=NZl({pIyyfZr_FtcPn_BO3joA1ol$%hZYa8Uw_K0T8
zg>x20sFwIXCP`xjBB-qJyx&@U1DJ?5UH)<@lvkJ<g}e0_y2V~iJ5WgW)k^vo@gs^0
z$T1!@w*6N+S%>~vY6A`V^A{KDJoKAy!Ygy|I1B#*TQ@kR3fbK?mH}iho27(<jz()S
z9+-j2zSbR0iNRb)>z9A03VfKS`ciRCRx<rqkX1+be6u^DXPNzh(Yf2?hq$mj@D2@n
z5xaLq3wug*lu_Gm8)sO(3?@TkPa${I(MNMc!e2}zUxAcNUn%+vOxWw#83STEADMGY
z#dESbOwNNw<BR{C33!91GGFTxbg$}AjBb~#BJ)o8R`7x}O92&3!hxS<C8s6S?&@W5
z@VW9&HRU*XvxLh>{%s`I6yX$XW4fz<X};ubP{}9624U^97o`2J2&wf<o98fds$zOL
zF_{bj8zzyFXOHTT73l^Ea4cPA?x85DP8-ik^>Jv7Kg@YnJ@PNm?;W0a@%8M;n)8&Z
za<uV*$k#kC9KlKmd)are?@xvJP>JV{gp@C}MMs+T8Mk3yE0u)NO?^4+-p9ftO^5OA
z;h(E7^)cM!<6e{PHE?e!#GU(a@(esl75p%&#_-A;Z=s98p4K?MKUHp|BhS1&Ta5L?
zTkiSxbe4pEzUZXmw1*Af`A#7dIOnexn)*7;SQ&b*<~e(Jb;rZxISELV<kd#Fr=D61
zqEe>^@Cvgw-!ngDu+H#c$1M2@oC(`P(FjYnT?VZj#%QYspP#YJlyQPE>!m{ed~vqS
zfr%m*_HvTH*BGfdcz57xiz2^Onff?+X({JWqoY0fip$KT1A#5JQ1tVi^32dNJyp^Z
z8X8RQo;FvscdP@^Um$Un*8vC_<n$i9!3fVsbGhVYSsi!W=3{z5q(jhRlh}|T2=mcJ
za|r{#0%hDF3rk=`-^Szd(TZi{V#yy|8;jiVg8GX0A>ulI0g5_=Cv((g>6welei`mw
zGVfm+$I0YSEKCZ$7pJ3eR{8cy29MD5_8WgBy`pHLd36%bFr8~#qMa4!E5f`a%#)dR
z)=@llh+3Dhw1*x4eANOG$W&#5VoCTF-6Zpk7FwK~BOmKoIJQVeVxZ>)|JWvobxAjj
zRPn>}^w{{C>FK0F%hQt(8>+MvDZz@X>S&8M!9RkZWWN^bgg%dsd|*P|UK*7{`|d>~
zriInB{Q|cx%`J`tF=&Ov#4t&+i?U>oq@dTQ42w)5{#@KefsIMVU=`aa403j2e80le
z{`c**g4yCUXyx9IEV|{50_r&Sn6d}~TrPPMps*!~epk~fGDTuV_Z^PcB2?4!FA$i>
z*%nw$q-$#CaAzQg(3dN1RU6_fTZ6bE^9&jHRBYISfG}A!z#)jN<{lij=SoIQaALV&
zW0MoxqA_pFmXhYE10kp@tZDK1)<(5;<B3aV8Q)qG4)#26ZY{P{>ppKLW72Yga-RgE
z00M=yS$yZjZce{xn%~Mn7|_H*0!s>K;_{Ji%Qf%+5Xfw%Cy21-g|{JW>Qlx8Gg-yK
zEPh=<6c&>qEBwq{-dbWC>kie;J@ZsA-)Aas+GTv+$F#0nYh~OrK*zkzVGhnAB|1BL
zSIdHB`Tbj=m}O8ORWZ#{CA_INY`S2a`F9~@G8o-4j6@Lj#JF(zy2pc9%znB>nZ=_x
zhH)*?yGnri<ImlVcAGjIrL3EA90xBv?_NFn9K-$+Tf#etO6WvoK9Nppy}?87Sr3F!
z{#r5DaTrA@mK2VX-)8*e=;wcKHOokj(I<)1NV@w~xjMPfjrC(%Yw9(^?lP2}Hh2*G
zim9?yf4ZmbG0P;sr!`B8Gm&asSk3_D5<a8};l$;$Cj$`G+d6Wz4$1f6BhnNInmJzZ
zK%i4oOG)ElG&ij_D&zsy>#NST>C8Xt?XPj(V1m#zWJ`%bUH1@#PjO{`2x*_9JaKv`
zUt$7f_2-hEa+rDQxVev$c_D&CbtYQX;y(Gt?6xg4>daGj^2i}cVW!Yg{zIDN*9s*Q
ziM5~F;x`KCd46@H?&Pa)|CFDX?Jy_GVE9NUM*Pf1I_PI^6T?pUZOj6TVZf!%U6rdb
zHH(&VqFYPLk&x;l77h$>X<q$|eCp=u0pc`ci`mcDdC76HYv*JjDRNkdh!KMYB}ctc
zp>d+gm43ujF~j8PB05E!QGDwNir1H<*9mFY9j9K=eLYivXOr<`%`~zQgHo@9;iD)8
z6;5OUgO!i&V&ucZQFtnxJoswSVU%F@B&5!L#cWgTZW#9flRb6=F21{BMy3&3cZk9M
zJc-VI{Z$Hi=ZbVuqN&X5S^R4H{(()Cmd^8e{Uo~-=D3~D+m@W?1_V{~5dU1e+R;bn
zddDR`g^R>^ghztSE8-J4P6ou6-ex_2fdkk}B^_i-vJ8NI9|FI<<~wfcVn11gj)gQy
zmNFoNeUdm06GGFB!$GXt4U12!c$g}fg4tm#Ue8snL%3_oLsRhhB?w|!TWz|ZW_bl%
zQ;w>EGxz*%8ZfPID%aq|Qf~H`9+R2-ID5?f*Z2&D330JPA(uK(y)tTluOw0v6&$K>
zt=8#R$$x^C4RYA>Xw9vgm85=c>=kKv7VVR=-~6H<$`(LxiNETYUfbw|BOru`{8&^M
z4&>mjyC!%Q;qoxnnBaI_Z(J7B5|`Y8LdOSm$93<)aX|qL3=k%OiG>ONH~jgJ2L}Z(
z?>#sYG67jECcfw9<Zv03W>DgPV!$BK6W~smVI>DEOV8G&AX*G6Q%cRIgYv3dX*swO
zK5xOyeHkgE8PMOB^W<sXRZth-^V48Lx1>QU$5L>4%*B^IZ+rJGA2}q^zzrzv=;Y31
z7UNgIdNC=5d=nA_;ypNM|2E``BIm{aQr+xwjnh-EGMIgHe@hEsv1_gJoHd5$01P(E
z3Q$<~>w%d!pkHQoPp2A&Je0KPZyjbWI>+g*oWV4>g$39wX?2o*6*9V(CXzzL%f&Y+
zmCWZGAl*^*Tzzo@3K#-6<+*?|JpSb##$)lLUV66@AwwK$0`rIb--@`N>Nl0gu@&U%
ze}dLy>9d$xnR{=<u{iUGXG+^poxFEIYNRXbrvgl6TuR5(UNl5s*u^UuhoB`_G3ePQ
zFtyF&fwl%<k1o3H4fx|!GfRI*_!kR))3Y^djSuVhZmt<BD)fcw@It@AWgrn$As+ux
zF9bx>bDBs}Np<7O=P$3NQ5B;ysCqz?ezTDop1|hyiCEWQejqmJ5rwYFoJcmS8O(sr
z!rn5n3sL7QeQOrOHT=+3(PC!|*C5WA1ht|c$;^z#7J4zH5T|+B-yrH2cWdDi+Z26k
zRbF{fCeI|De~zv-4dgp|ZG~(+KmRfFWA0BP`+V=`W4{hr=LXSYztwGBm`PfjRPr1c
zz>WlH#GhJeZo9n&fInAV#>bKUmHf9>T9y8~xVHrQ^Q|)LpmNOfck$GpYf;0!2dAiS
zVk+WoTkCI<*CJs1QdWrw`p^|!I^vtrf8z$+|7sl=gpGyu-;1RG)w<^-WcTrQS*(BJ
z1}t)#=0RHjs@?si#J$?l=~U;xqaaV>3JU$6tDU$|!qiBRRE|P4pT4DpTZMNkeG<q2
zGuRjP6>7O^hESqXta|OA;k`6jV<=I_tv_bFD|b-+`V^g=muT$DM-qS|Zn4{QHY^=$
zLYZkVf*=Izscd75L{T&P2%V(ObH9y(TltDf>pn`=(;QL+CD~D!s%fc@4^CC+ARNz3
z*>=GPdN5f0>O!4HvF&>hqi<aQC>{t#W=T)j`?ahG&Gsu|qkX9kVor(EiNnJ1aw_B#
zeGKjZ)!W4yEDG<TgM=R<KJB26%D4?Dda@3&Vl`F7`0$+MvOwJz+-S4*{gD;H)u{fK
z3<E7M1+u9urJz7sh=1tYK_%=mVXU+l1+h9fLD-Ma;2V*rP9>9f8|gK7xIbwWt!A12
zRCklS&PI<zK7!5Y2kC07;4x;ZiL=rsJXz~X%@oSjla#`8%0?_^K@bU_^YeaTE&H+G
zHW{B$=d~KNEESehe&!kPG++vsx{>8h#%XvVt1-dN^d;*#Dk0wKSt?OnEA%X|i|)Tb
z-CrQPhTS^P@uq(|#qQle_#1}95$xErYnvOTpQEOA0c1Hcr|V|@#E$)CS39w5j?&()
VSs~Gavv8Pz`0uK|lP`bg{s*+JHLU;u

literal 0
HcmV?d00001


From a875e92d6853a3be917bc48dbe32a57db2349d12 Mon Sep 17 00:00:00 2001
From: gzdaijie <gzdaijie@gmail.com>
Date: Mon, 2 Mar 2020 19:52:45 +0800
Subject: [PATCH 054/122] fix main.go addr define code

---
 gee-cache/day5-multi-nodes/main.go   | 3 +--
 gee-cache/day6-single-flight/main.go | 3 +--
 gee-cache/day7-proto-buf/main.go     | 3 +--
 gee-cache/doc/geecache-day5.md       | 3 +--
 4 files changed, 4 insertions(+), 8 deletions(-)

diff --git a/gee-cache/day5-multi-nodes/main.go b/gee-cache/day5-multi-nodes/main.go
index a99940c..b8677f2 100644
--- a/gee-cache/day5-multi-nodes/main.go
+++ b/gee-cache/day5-multi-nodes/main.go
@@ -73,8 +73,7 @@ func main() {
 		8003: "http://localhost:8003",
 	}
 
-	addrs := make([]string, 3)
-
+	var addrs []string
 	for _, v := range addrMap {
 		addrs = append(addrs, v)
 	}
diff --git a/gee-cache/day6-single-flight/main.go b/gee-cache/day6-single-flight/main.go
index a99940c..b8677f2 100644
--- a/gee-cache/day6-single-flight/main.go
+++ b/gee-cache/day6-single-flight/main.go
@@ -73,8 +73,7 @@ func main() {
 		8003: "http://localhost:8003",
 	}
 
-	addrs := make([]string, 3)
-
+	var addrs []string
 	for _, v := range addrMap {
 		addrs = append(addrs, v)
 	}
diff --git a/gee-cache/day7-proto-buf/main.go b/gee-cache/day7-proto-buf/main.go
index a99940c..b8677f2 100644
--- a/gee-cache/day7-proto-buf/main.go
+++ b/gee-cache/day7-proto-buf/main.go
@@ -73,8 +73,7 @@ func main() {
 		8003: "http://localhost:8003",
 	}
 
-	addrs := make([]string, 3)
-
+	var addrs []string
 	for _, v := range addrMap {
 		addrs = append(addrs, v)
 	}
diff --git a/gee-cache/doc/geecache-day5.md b/gee-cache/doc/geecache-day5.md
index 28111ae..4e28083 100644
--- a/gee-cache/doc/geecache-day5.md
+++ b/gee-cache/doc/geecache-day5.md
@@ -280,8 +280,7 @@ func main() {
 		8003: "http://localhost:8003",
 	}
 
-	addrs := make([]string, 3)
-
+	var addrs []string
 	for _, v := range addrMap {
 		addrs = append(addrs, v)
 	}

From 9e1174e1cd35b467a0974a2df72eed11c71c3ee8 Mon Sep 17 00:00:00 2001
From: gzdaijie <gzdaijie@gmail.com>
Date: Tue, 3 Mar 2020 19:49:14 +0800
Subject: [PATCH 055/122] change the order of Header().Set() & WriteHeader()

---
 gee-web/day2-context/gee/context.go       | 6 +++---
 gee-web/day3-router/gee/context.go        | 6 +++---
 gee-web/day4-group/gee/context.go         | 6 +++---
 gee-web/day5-middleware/gee/context.go    | 6 +++---
 gee-web/day6-template/gee/context.go      | 8 ++++----
 gee-web/day7-panic-recover/gee/context.go | 8 ++++----
 gee-web/doc/gee-day2.md                   | 6 +++---
 gee-web/doc/gee-day6.md                   | 4 ++--
 8 files changed, 25 insertions(+), 25 deletions(-)

diff --git a/gee-web/day2-context/gee/context.go b/gee-web/day2-context/gee/context.go
index 795bf16..72a7fe7 100644
--- a/gee-web/day2-context/gee/context.go
+++ b/gee-web/day2-context/gee/context.go
@@ -46,14 +46,14 @@ func (c *Context) SetHeader(key string, value string) {
 }
 
 func (c *Context) String(code int, format string, values ...interface{}) {
-	c.Status(code)
 	c.SetHeader("Content-Type", "text/plain")
+	c.Status(code)
 	c.Writer.Write([]byte(fmt.Sprintf(format, values...)))
 }
 
 func (c *Context) JSON(code int, obj interface{}) {
-	c.Status(code)
 	c.SetHeader("Content-Type", "application/json")
+	c.Status(code)
 	encoder := json.NewEncoder(c.Writer)
 	if err := encoder.Encode(obj); err != nil {
 		http.Error(c.Writer, err.Error(), 500)
@@ -66,7 +66,7 @@ func (c *Context) Data(code int, data []byte) {
 }
 
 func (c *Context) HTML(code int, html string) {
-	c.Status(code)
 	c.SetHeader("Content-Type", "text/html")
+	c.Status(code)
 	c.Writer.Write([]byte(html))
 }
diff --git a/gee-web/day3-router/gee/context.go b/gee-web/day3-router/gee/context.go
index 2733bdb..cf79939 100644
--- a/gee-web/day3-router/gee/context.go
+++ b/gee-web/day3-router/gee/context.go
@@ -52,14 +52,14 @@ func (c *Context) SetHeader(key string, value string) {
 }
 
 func (c *Context) String(code int, format string, values ...interface{}) {
-	c.Status(code)
 	c.SetHeader("Content-Type", "text/plain")
+	c.Status(code)
 	c.Writer.Write([]byte(fmt.Sprintf(format, values...)))
 }
 
 func (c *Context) JSON(code int, obj interface{}) {
-	c.Status(code)
 	c.SetHeader("Content-Type", "application/json")
+	c.Status(code)
 	encoder := json.NewEncoder(c.Writer)
 	if err := encoder.Encode(obj); err != nil {
 		http.Error(c.Writer, err.Error(), 500)
@@ -72,7 +72,7 @@ func (c *Context) Data(code int, data []byte) {
 }
 
 func (c *Context) HTML(code int, html string) {
-	c.Status(code)
 	c.SetHeader("Content-Type", "text/html")
+	c.Status(code)
 	c.Writer.Write([]byte(html))
 }
diff --git a/gee-web/day4-group/gee/context.go b/gee-web/day4-group/gee/context.go
index 2733bdb..cf79939 100644
--- a/gee-web/day4-group/gee/context.go
+++ b/gee-web/day4-group/gee/context.go
@@ -52,14 +52,14 @@ func (c *Context) SetHeader(key string, value string) {
 }
 
 func (c *Context) String(code int, format string, values ...interface{}) {
-	c.Status(code)
 	c.SetHeader("Content-Type", "text/plain")
+	c.Status(code)
 	c.Writer.Write([]byte(fmt.Sprintf(format, values...)))
 }
 
 func (c *Context) JSON(code int, obj interface{}) {
-	c.Status(code)
 	c.SetHeader("Content-Type", "application/json")
+	c.Status(code)
 	encoder := json.NewEncoder(c.Writer)
 	if err := encoder.Encode(obj); err != nil {
 		http.Error(c.Writer, err.Error(), 500)
@@ -72,7 +72,7 @@ func (c *Context) Data(code int, data []byte) {
 }
 
 func (c *Context) HTML(code int, html string) {
-	c.Status(code)
 	c.SetHeader("Content-Type", "text/html")
+	c.Status(code)
 	c.Writer.Write([]byte(html))
 }
diff --git a/gee-web/day5-middleware/gee/context.go b/gee-web/day5-middleware/gee/context.go
index 63eca76..1885e0c 100644
--- a/gee-web/day5-middleware/gee/context.go
+++ b/gee-web/day5-middleware/gee/context.go
@@ -69,14 +69,14 @@ func (c *Context) SetHeader(key string, value string) {
 }
 
 func (c *Context) String(code int, format string, values ...interface{}) {
-	c.Status(code)
 	c.SetHeader("Content-Type", "text/plain")
+	c.Status(code)
 	c.Writer.Write([]byte(fmt.Sprintf(format, values...)))
 }
 
 func (c *Context) JSON(code int, obj interface{}) {
-	c.Status(code)
 	c.SetHeader("Content-Type", "application/json")
+	c.Status(code)
 	encoder := json.NewEncoder(c.Writer)
 	if err := encoder.Encode(obj); err != nil {
 		http.Error(c.Writer, err.Error(), 500)
@@ -89,7 +89,7 @@ func (c *Context) Data(code int, data []byte) {
 }
 
 func (c *Context) HTML(code int, html string) {
-	c.Status(code)
 	c.SetHeader("Content-Type", "text/html")
+	c.Status(code)
 	c.Writer.Write([]byte(html))
 }
diff --git a/gee-web/day6-template/gee/context.go b/gee-web/day6-template/gee/context.go
index 4e16ca2..9c47b0c 100644
--- a/gee-web/day6-template/gee/context.go
+++ b/gee-web/day6-template/gee/context.go
@@ -71,14 +71,14 @@ func (c *Context) SetHeader(key string, value string) {
 }
 
 func (c *Context) String(code int, format string, values ...interface{}) {
-	c.Status(code)
 	c.SetHeader("Content-Type", "text/plain")
+	c.Status(code)
 	c.Writer.Write([]byte(fmt.Sprintf(format, values...)))
 }
 
 func (c *Context) JSON(code int, obj interface{}) {
-	c.Status(code)
 	c.SetHeader("Content-Type", "application/json")
+	c.Status(code)
 	encoder := json.NewEncoder(c.Writer)
 	if err := encoder.Encode(obj); err != nil {
 		http.Error(c.Writer, err.Error(), 500)
@@ -93,8 +93,8 @@ func (c *Context) Data(code int, data []byte) {
 // HTML template render
 // refer https://golang.org/pkg/html/template/
 func (c *Context) HTML(code int, name string, data interface{}) {
-	c.Writer.WriteHeader(code)
-	c.Writer.Header().Set("Content-Type", "text/html")
+	c.SetHeader("Content-Type", "text/html")
+	c.Status(code)
 	if err := c.engine.htmlTemplates.ExecuteTemplate(c.Writer, name, data); err != nil {
 		c.Fail(500, err.Error())
 	}
diff --git a/gee-web/day7-panic-recover/gee/context.go b/gee-web/day7-panic-recover/gee/context.go
index 4e16ca2..9c47b0c 100644
--- a/gee-web/day7-panic-recover/gee/context.go
+++ b/gee-web/day7-panic-recover/gee/context.go
@@ -71,14 +71,14 @@ func (c *Context) SetHeader(key string, value string) {
 }
 
 func (c *Context) String(code int, format string, values ...interface{}) {
-	c.Status(code)
 	c.SetHeader("Content-Type", "text/plain")
+	c.Status(code)
 	c.Writer.Write([]byte(fmt.Sprintf(format, values...)))
 }
 
 func (c *Context) JSON(code int, obj interface{}) {
-	c.Status(code)
 	c.SetHeader("Content-Type", "application/json")
+	c.Status(code)
 	encoder := json.NewEncoder(c.Writer)
 	if err := encoder.Encode(obj); err != nil {
 		http.Error(c.Writer, err.Error(), 500)
@@ -93,8 +93,8 @@ func (c *Context) Data(code int, data []byte) {
 // HTML template render
 // refer https://golang.org/pkg/html/template/
 func (c *Context) HTML(code int, name string, data interface{}) {
-	c.Writer.WriteHeader(code)
-	c.Writer.Header().Set("Content-Type", "text/html")
+	c.SetHeader("Content-Type", "text/html")
+	c.Status(code)
 	if err := c.engine.htmlTemplates.ExecuteTemplate(c.Writer, name, data); err != nil {
 		c.Fail(500, err.Error())
 	}
diff --git a/gee-web/doc/gee-day2.md b/gee-web/doc/gee-day2.md
index 281ebcc..f63fde1 100644
--- a/gee-web/doc/gee-day2.md
+++ b/gee-web/doc/gee-day2.md
@@ -134,14 +134,14 @@ func (c *Context) SetHeader(key string, value string) {
 }
 
 func (c *Context) String(code int, format string, values ...interface{}) {
-	c.Status(code)
 	c.SetHeader("Content-Type", "text/plain")
+	c.Status(code)
 	c.Writer.Write([]byte(fmt.Sprintf(format, values...)))
 }
 
 func (c *Context) JSON(code int, obj interface{}) {
-	c.Status(code)
 	c.SetHeader("Content-Type", "application/json")
+	c.Status(code)
 	encoder := json.NewEncoder(c.Writer)
 	if err := encoder.Encode(obj); err != nil {
 		http.Error(c.Writer, err.Error(), 500)
@@ -154,8 +154,8 @@ func (c *Context) Data(code int, data []byte) {
 }
 
 func (c *Context) HTML(code int, html string) {
-	c.Status(code)
 	c.SetHeader("Content-Type", "text/html")
+	c.Status(code)
 	c.Writer.Write([]byte(html))
 }
 ```
diff --git a/gee-web/doc/gee-day6.md b/gee-web/doc/gee-day6.md
index a12ff30..be0b0fe 100644
--- a/gee-web/doc/gee-day6.md
+++ b/gee-web/doc/gee-day6.md
@@ -114,8 +114,8 @@ type Context struct {
 }
 
 func (c *Context) HTML(code int, name string, data interface{}) {
-	c.Writer.WriteHeader(code)
-	c.Writer.Header().Set("Content-Type", "text/html")
+	c.SetHeader("Content-Type", "text/html")
+	c.Status(code)
 	if err := c.engine.htmlTemplates.ExecuteTemplate(c.Writer, name, data); err != nil {
 		c.Fail(500, err.Error())
 	}

From e64de2e960e2e1fdb0d3359c9605a5886b5cb1fa Mon Sep 17 00:00:00 2001
From: gzdaijie <gzdaijie@gmail.com>
Date: Tue, 3 Mar 2020 21:49:29 +0800
Subject: [PATCH 056/122] init geeorm titles & description

---
 gee-orm/doc/geeorm-day1.md | 23 +++++++++++++++++++++++
 gee-orm/doc/geeorm-day2.md | 26 ++++++++++++++++++++++++++
 gee-orm/doc/geeorm-day3.md | 25 +++++++++++++++++++++++++
 gee-orm/doc/geeorm-day4.md | 25 +++++++++++++++++++++++++
 gee-orm/doc/geeorm-day5.md | 25 +++++++++++++++++++++++++
 gee-orm/doc/geeorm-day6.md | 24 ++++++++++++++++++++++++
 gee-orm/doc/geeorm-day7.md | 24 ++++++++++++++++++++++++
 7 files changed, 172 insertions(+)
 create mode 100644 gee-orm/doc/geeorm-day1.md
 create mode 100644 gee-orm/doc/geeorm-day2.md
 create mode 100644 gee-orm/doc/geeorm-day3.md
 create mode 100644 gee-orm/doc/geeorm-day4.md
 create mode 100644 gee-orm/doc/geeorm-day5.md
 create mode 100644 gee-orm/doc/geeorm-day6.md
 create mode 100644 gee-orm/doc/geeorm-day7.md

diff --git a/gee-orm/doc/geeorm-day1.md b/gee-orm/doc/geeorm-day1.md
new file mode 100644
index 0000000..e90353b
--- /dev/null
+++ b/gee-orm/doc/geeorm-day1.md
@@ -0,0 +1,23 @@
+---
+title: 动手写ORM框架 - GeeORM第一天 database/sql 基础
+date: 2020-03-03 23:00:00
+description: 7天用 Go语言/golang 从零实现 ORM 框架 GeeORM 教程(7 days implement golang object relational mapping framework from scratch tutorial)，动手写 ORM 框架，参照 gorm, xorm 的实现。介绍了 SQLite 的基础操作（连接数据库，创建表、增删记录等），使用 Go 标准库 database/sql 操作 SQLite 数据库，包括执行(Exec)，查询(Query, QueryRow)。
+tags:
+- Go
+nav: 从零实现
+categories:
+- ORM框架 - GeeORM
+keywords:
+- Go语言
+- 从零实现ORM框架
+- database/sql
+- sqlite
+image: post/geeorm/geeorm_sm.jpg
+github: https://github.com/geektutu/7days-golang
+published: false
+---
+
+本文是[7天用Go从零实现ORM框架GeeORM](https://geektutu.com/post/geeorm.html)的第一篇。
+
+- SQLite 的基础操作（连接数据库，创建表、增删记录等）。
+- 使用 Go 语言标准库 database/sql 连接并操作 SQLite 数据库，并简单封装。
\ No newline at end of file
diff --git a/gee-orm/doc/geeorm-day2.md b/gee-orm/doc/geeorm-day2.md
new file mode 100644
index 0000000..3e33396
--- /dev/null
+++ b/gee-orm/doc/geeorm-day2.md
@@ -0,0 +1,26 @@
+---
+title: 动手写ORM框架 - GeeORM第二天 对象表结构映射
+date: 2020-03-03 23:00:00
+description: 7天用 Go语言/golang 从零实现 ORM 框架 GeeORM 教程(7 days implement golang object relational mapping framework from scratch tutorial)，动手写 ORM 框架，参照 gorm, xorm 的实现。使用反射(reflect)获取任意 struct 对象的名称和字段，映射为数据中的表；使用 dialect 隔离不同数据库之间的差异，便于扩展；数据表的创建(create)、删除(drop)。
+tags:
+- Go
+nav: 从零实现
+categories:
+- ORM框架 - GeeORM
+keywords:
+- Go语言
+- 从零实现ORM框架
+- database/sql
+- sqlite
+- reflect
+- table mapping
+image: post/geeorm/geeorm_sm.jpg
+github: https://github.com/geektutu/7days-golang
+published: false
+---
+
+本文是[7天用Go从零实现ORM框架GeeORM](https://geektutu.com/post/geeorm.html)的第二篇。
+
+- 使用反射(reflect)获取任意 struct 对象的名称和字段，映射为数据中的表。
+- 使用 dialect 隔离不同数据库之间的差异，便于扩展。
+- 数据表的创建(create)、删除(drop)。
\ No newline at end of file
diff --git a/gee-orm/doc/geeorm-day3.md b/gee-orm/doc/geeorm-day3.md
new file mode 100644
index 0000000..ed0b47d
--- /dev/null
+++ b/gee-orm/doc/geeorm-day3.md
@@ -0,0 +1,25 @@
+---
+title: 动手写ORM框架 - GeeORM第三天 插入和查询记录
+date: 2020-03-03 23:00:00
+description: 7天用 Go语言/golang 从零实现 ORM 框架 GeeORM 教程(7 days implement golang object relational mapping framework from scratch tutorial)，动手写 ORM 框架，参照 gorm, xorm 的实现。实现新增(insert)记录的功能；使用反射(reflect)将数据库的记录转换为对应的结构体，实现查询(select)功能。
+tags:
+- Go
+nav: 从零实现
+categories:
+- ORM框架 - GeeORM
+keywords:
+- Go语言
+- 从零实现ORM框架
+- database/sql
+- sqlite
+- insert into
+- select from
+image: post/geeorm/geeorm_sm.jpg
+github: https://github.com/geektutu/7days-golang
+published: false
+---
+
+本文是[7天用Go从零实现ORM框架GeeORM](https://geektutu.com/post/geeorm.html)的第三篇。
+
+- 实现新增(insert)记录的功能。
+- 使用反射(reflect)将数据库的记录转换为对应的结构体，实现查询(select)功能。
\ No newline at end of file
diff --git a/gee-orm/doc/geeorm-day4.md b/gee-orm/doc/geeorm-day4.md
new file mode 100644
index 0000000..98cc55c
--- /dev/null
+++ b/gee-orm/doc/geeorm-day4.md
@@ -0,0 +1,25 @@
+---
+title: 动手写ORM框架 - GeeORM第四天 链式操作与更新删除
+date: 2020-03-03 23:00:00
+description: 7天用 Go语言/golang 从零实现 ORM 框架 GeeORM 教程(7 days implement golang object relational mapping framework from scratch tutorial)，动手写 ORM 框架，参照 gorm, xorm 的实现。通过链式(chain)操作，支持查询条件(where, order by, limit 等)的叠加；实现记录的更新(update)和删除(delete)功能。
+tags:
+- Go
+nav: 从零实现
+categories:
+- ORM框架 - GeeORM
+keywords:
+- Go语言
+- 从零实现ORM框架
+- database/sql
+- sqlite
+- chain operation
+- delete from
+image: post/geeorm/geeorm_sm.jpg
+github: https://github.com/geektutu/7days-golang
+published: false
+---
+
+本文是[7天用Go从零实现ORM框架GeeORM](https://geektutu.com/post/geeorm.html)的第四篇。
+
+- 通过链式(chain)操作，支持查询条件(where, order by, limit 等)的叠加。
+- 实现记录的更新(update)和删除(delete)功能。
\ No newline at end of file
diff --git a/gee-orm/doc/geeorm-day5.md b/gee-orm/doc/geeorm-day5.md
new file mode 100644
index 0000000..cbb86cd
--- /dev/null
+++ b/gee-orm/doc/geeorm-day5.md
@@ -0,0 +1,25 @@
+---
+title: 动手写ORM框架 - GeeORM第五天 实现钩子(Hooks)
+date: 2020-03-03 23:00:00
+description: 7天用 Go语言/golang 从零实现 ORM 框架 GeeORM 教程(7 days implement golang object relational mapping framework from scratch tutorial)，动手写 ORM 框架，参照 gorm, xorm 的实现。通过反射(reflect)获取结构体绑定的钩子(hooks)，并调用；支持增删查改(CRUD)前后调用钩子。
+tags:
+- Go
+nav: 从零实现
+categories:
+- ORM框架 - GeeORM
+keywords:
+- Go语言
+- 从零实现ORM框架
+- database/sql
+- sqlite
+- hooks
+- BeforeUpdate
+image: post/geeorm/geeorm_sm.jpg
+github: https://github.com/geektutu/7days-golang
+published: false
+---
+
+本文是[7天用Go从零实现ORM框架GeeORM](https://geektutu.com/post/geeorm.html)的第五篇。
+
+- 通过反射(reflect)获取结构体绑定的钩子(hooks)，并调用。
+- 支持增删查改(CRUD)前后调用钩子。
\ No newline at end of file
diff --git a/gee-orm/doc/geeorm-day6.md b/gee-orm/doc/geeorm-day6.md
new file mode 100644
index 0000000..e6f6f03
--- /dev/null
+++ b/gee-orm/doc/geeorm-day6.md
@@ -0,0 +1,24 @@
+---
+title: 动手写ORM框架 - GeeORM第六天 支持事务(Transaction) 
+date: 2020-03-03 23:00:00
+description: 7天用 Go语言/golang 从零实现 ORM 框架 GeeORM 教程(7 days implement golang object relational mapping framework from scratch tutorial)，动手写 ORM 框架，参照 gorm, xorm 的实现。介绍 SQLite 数据库中的事务(transaction)；封装事务，用户自定义回调函数实现原子操作。
+tags:
+- Go
+nav: 从零实现
+categories:
+- ORM框架 - GeeORM
+keywords:
+- Go语言
+- 从零实现ORM框架
+- database/sql
+- sqlite
+- transaction
+image: post/geeorm/geeorm_sm.jpg
+github: https://github.com/geektutu/7days-golang
+published: false
+---
+
+本文是[7天用Go从零实现ORM框架GeeORM](https://geektutu.com/post/geeorm.html)的第六篇。
+
+- 介绍 SQLite 数据库中的事务(transaction)。
+- 封装事务，用户自定义回调函数实现原子操作。
\ No newline at end of file
diff --git a/gee-orm/doc/geeorm-day7.md b/gee-orm/doc/geeorm-day7.md
new file mode 100644
index 0000000..6e2bf40
--- /dev/null
+++ b/gee-orm/doc/geeorm-day7.md
@@ -0,0 +1,24 @@
+---
+title: 动手写ORM框架 - GeeORM第七天 数据库迁移(Migrate)
+date: 2020-03-03 23:00:00
+description: 7天用 Go语言/golang 从零实现 ORM 框架 GeeORM 教程(7 days implement golang object relational mapping framework from scratch tutorial)，动手写 ORM 框架，参照 gorm, xorm 的实现。结构体(struct)变更时，数据库表的字段(field)自动迁移(migrate)；仅支持字段新增与删除，不支持字段类型变更。
+tags:
+- Go
+nav: 从零实现
+categories:
+- ORM框架 - GeeORM
+keywords:
+- Go语言
+- 从零实现ORM框架
+- database/sql
+- sqlite
+- migrate
+image: post/geeorm/geeorm_sm.jpg
+github: https://github.com/geektutu/7days-golang
+published: false
+---
+
+本文是[7天用Go从零实现ORM框架GeeORM](https://geektutu.com/post/geeorm.html)的第七篇。
+
+- 结构体(struct)变更时，数据库表的字段(field)自动迁移(migrate)。
+- 仅支持字段新增与删除，不支持字段类型变更。
\ No newline at end of file

From 32082371e8f0ac326604743e3b979079b281350c Mon Sep 17 00:00:00 2001
From: gzdaijie <gzdaijie@gmail.com>
Date: Sat, 7 Mar 2020 22:21:54 +0800
Subject: [PATCH 057/122] add geeorm day1 & cmd_test

---
 gee-orm/day1-database-sql/cmd_test/main.go    |  20 +
 gee-orm/day1-database-sql/session/raw_test.go |   2 +-
 .../day2-reflect-schema/session/raw_test.go   |   2 +-
 gee-orm/day3-save-query/session/raw_test.go   |   3 +-
 .../day4-chain-operation/session/raw_test.go  |   2 +-
 gee-orm/day5-hooks/session/raw_test.go        |   2 +-
 gee-orm/day6-transaction/session/raw_test.go  |   2 +-
 gee-orm/day7-migrate/session/raw_test.go      |   2 +-
 gee-orm/doc/geeorm-day1.md                    | 397 +++++++++++++++++-
 gee-orm/doc/geeorm-day1/geeorm_log.png        | Bin 0 -> 6745 bytes
 10 files changed, 421 insertions(+), 11 deletions(-)
 create mode 100755 gee-orm/day1-database-sql/cmd_test/main.go
 create mode 100755 gee-orm/doc/geeorm-day1/geeorm_log.png

diff --git a/gee-orm/day1-database-sql/cmd_test/main.go b/gee-orm/day1-database-sql/cmd_test/main.go
new file mode 100755
index 0000000..1048cf4
--- /dev/null
+++ b/gee-orm/day1-database-sql/cmd_test/main.go
@@ -0,0 +1,20 @@
+package main
+
+import (
+	"fmt"
+	"geeorm"
+	_ "github.com/mattn/go-sqlite3"
+)
+
+func main() {
+	engine, _ := geeorm.NewEngine("sqlite3", "gee.db")
+	defer engine.Close()
+	s := engine.NewSession()
+	_, _ = s.Raw("DROP TABLE IF EXISTS User;").Exec()
+	_, _ = s.Raw("CREATE TABLE User(Name text);").Exec()
+	_, _ = s.Raw("CREATE TABLE User(Name text);").Exec()
+	result, _ := s.Raw("INSERT INTO User(`Name`) values (?), (?)", "Tom", "Sam").Exec()
+	count, _ := result.RowsAffected()
+	fmt.Printf("Exec success, %d affected\n", count)
+
+}
diff --git a/gee-orm/day1-database-sql/session/raw_test.go b/gee-orm/day1-database-sql/session/raw_test.go
index 5721844..36e9678 100644
--- a/gee-orm/day1-database-sql/session/raw_test.go
+++ b/gee-orm/day1-database-sql/session/raw_test.go
@@ -18,7 +18,7 @@ func TestMain(m *testing.M) {
 }
 
 func NewSession() *Session {
-	return &Session{db: TestDB}
+	return New(TestDB)
 }
 
 func TestSession_Exec(t *testing.T) {
diff --git a/gee-orm/day2-reflect-schema/session/raw_test.go b/gee-orm/day2-reflect-schema/session/raw_test.go
index d521173..404bb6e 100644
--- a/gee-orm/day2-reflect-schema/session/raw_test.go
+++ b/gee-orm/day2-reflect-schema/session/raw_test.go
@@ -23,7 +23,7 @@ func TestMain(m *testing.M) {
 }
 
 func NewSession() *Session {
-	return &Session{db: TestDB, dialect: TestDial}
+	return New(TestDB, TestDial)
 }
 
 func TestSession_Exec(t *testing.T) {
diff --git a/gee-orm/day3-save-query/session/raw_test.go b/gee-orm/day3-save-query/session/raw_test.go
index d521173..d2212fe 100644
--- a/gee-orm/day3-save-query/session/raw_test.go
+++ b/gee-orm/day3-save-query/session/raw_test.go
@@ -23,9 +23,8 @@ func TestMain(m *testing.M) {
 }
 
 func NewSession() *Session {
-	return &Session{db: TestDB, dialect: TestDial}
+	return New(TestDB, TestDial)
 }
-
 func TestSession_Exec(t *testing.T) {
 	s := NewSession()
 	_, _ = s.Raw("DROP TABLE IF EXISTS User;").Exec()
diff --git a/gee-orm/day4-chain-operation/session/raw_test.go b/gee-orm/day4-chain-operation/session/raw_test.go
index d521173..404bb6e 100644
--- a/gee-orm/day4-chain-operation/session/raw_test.go
+++ b/gee-orm/day4-chain-operation/session/raw_test.go
@@ -23,7 +23,7 @@ func TestMain(m *testing.M) {
 }
 
 func NewSession() *Session {
-	return &Session{db: TestDB, dialect: TestDial}
+	return New(TestDB, TestDial)
 }
 
 func TestSession_Exec(t *testing.T) {
diff --git a/gee-orm/day5-hooks/session/raw_test.go b/gee-orm/day5-hooks/session/raw_test.go
index d521173..404bb6e 100644
--- a/gee-orm/day5-hooks/session/raw_test.go
+++ b/gee-orm/day5-hooks/session/raw_test.go
@@ -23,7 +23,7 @@ func TestMain(m *testing.M) {
 }
 
 func NewSession() *Session {
-	return &Session{db: TestDB, dialect: TestDial}
+	return New(TestDB, TestDial)
 }
 
 func TestSession_Exec(t *testing.T) {
diff --git a/gee-orm/day6-transaction/session/raw_test.go b/gee-orm/day6-transaction/session/raw_test.go
index d521173..404bb6e 100644
--- a/gee-orm/day6-transaction/session/raw_test.go
+++ b/gee-orm/day6-transaction/session/raw_test.go
@@ -23,7 +23,7 @@ func TestMain(m *testing.M) {
 }
 
 func NewSession() *Session {
-	return &Session{db: TestDB, dialect: TestDial}
+	return New(TestDB, TestDial)
 }
 
 func TestSession_Exec(t *testing.T) {
diff --git a/gee-orm/day7-migrate/session/raw_test.go b/gee-orm/day7-migrate/session/raw_test.go
index d521173..404bb6e 100644
--- a/gee-orm/day7-migrate/session/raw_test.go
+++ b/gee-orm/day7-migrate/session/raw_test.go
@@ -23,7 +23,7 @@ func TestMain(m *testing.M) {
 }
 
 func NewSession() *Session {
-	return &Session{db: TestDB, dialect: TestDial}
+	return New(TestDB, TestDial)
 }
 
 func TestSession_Exec(t *testing.T) {
diff --git a/gee-orm/doc/geeorm-day1.md b/gee-orm/doc/geeorm-day1.md
index e90353b..10a8863 100644
--- a/gee-orm/doc/geeorm-day1.md
+++ b/gee-orm/doc/geeorm-day1.md
@@ -14,10 +14,401 @@ keywords:
 - sqlite
 image: post/geeorm/geeorm_sm.jpg
 github: https://github.com/geektutu/7days-golang
-published: false
 ---
 
-本文是[7天用Go从零实现ORM框架GeeORM](https://geektutu.com/post/geeorm.html)的第一篇。
+本文是[7天用Go从零实现ORM框架GeeORM](https://geektutu.com/post/geeorm.html)的第一篇。介绍了
 
 - SQLite 的基础操作（连接数据库，创建表、增删记录等）。
-- 使用 Go 语言标准库 database/sql 连接并操作 SQLite 数据库，并简单封装。
\ No newline at end of file
+- 使用 Go 语言标准库 database/sql 连接并操作 SQLite 数据库，并简单封装。**代码约150行**
+
+## 1 初识 SQLite
+
+> SQLite is a C-language library that implements a small, fast, self-contained, high-reliability, full-featured, SQL database engine.
+> -- [SQLite 官网](https://sqlite.org/index.html)
+
+SQLite 是一款轻量级的，遵守 ACID 事务原则的关系型数据库。SQLite 可以直接嵌入到代码中，不需要像 MySQL、PostgreSQL 需要启动独立的服务才能使用。SQLite 将数据存储在单一的磁盘文件中，使用起来非常方便。也非常适合初学者用来学习关系型数据的使用。GeeORM 的所有的开发和测试均基于 SQLite。
+
+在 Ubuntu 上，安装 SQLite 只需要一行命令，无需配置即可使用。
+
+```bash
+apt-get install sqlite3
+```
+
+接下来，连接数据库(gee.db)，如若 gee.db 不存在，则会新建。如果连接成功，就进入到了 SQLite 的命令行模式，执行 `.help` 可以看到所有的帮助命令。
+
+```bash
+> sqlite3 gee.db
+SQLite version 3.22.0 2018-01-22 18:45:57
+Enter ".help" for usage hints.
+sqlite>
+```
+
+使用 SQL 语句新建一张表 `User`，包含两个字段，字符串 Name 和 整型 Age。
+
+```bash
+sqlite> CREATE TABLE User(Name text, Age integer);
+```
+
+插入两条数据
+
+```bash
+sqlite> INSERT INTO User(Name, Age) VALUES ("Tom", 18), ("Jack", 25);
+```
+
+执行简单的查询操作，在执行之前使用 `.head on` 打开显示列名的开关，这样查询结果看上去更直观。
+
+```bash
+sqlite> .head on
+
+# 查找 `Age > 20` 的记录；
+sqlite> SELECT * FROM User WHERE Age > 20;
+Name|Age
+Jack|25
+
+# 统计记录个数。
+sqlite> SELECT COUNT(*) FROM User;
+COUNT(*)
+2
+```
+
+使用 `.table` 查看当前数据库中所有的表(table)，执行 `.schema <table>` 查看建表的 SQL 语句。
+
+```bash
+sqlite> .table
+User
+
+sqlite> .schema User
+CREATE TABLE User(Name text, Age integer);
+```
+
+SQLite 的使用暂时介绍这么多，了解了以上使用方法已经足够我们完成今天的任务了。如果想了解更多用法，可参考 [SQLite 常用命令](https://geektutu.com/post/cheat-sheet-sqlite.html)。
+
+
+## 2 database/sql 标准库
+
+Go 语言提供了标准库 `database/sql` 用于和数据库的交互，接下来我们写一个 Demo，看一看这个库的用法。
+
+```go
+package main
+
+import (
+	"database/sql"
+	"log"
+	
+	_ "github.com/mattn/go-sqlite3"
+)
+
+func main() {
+	db, _ := sql.Open("sqlite3", "gee.db")
+	defer func() { _ = db.Close() }()
+	_, _ = db.Exec("DROP TABLE IF EXISTS User;")
+	_, _ = db.Exec("CREATE TABLE User(Name text);")
+	result, err := db.Exec("INSERT INTO User(`Name`) values (?), (?)", "Tom", "Sam")
+	if err == nil {
+		affected, _ := result.RowsAffected()
+		log.Println(affected)
+	}
+	row := db.QueryRow("SELECT Name FROM User LIMIT 1")
+	var name string
+	if err := row.Scan(&name); err == nil {
+		log.Println(name)
+	}
+}
+```
+
+> go-sqlite3 依赖于 gcc，如果这份代码在 Windows 上运行的话，需要安装 [mingw](http://mingw.org/) 或其他包含有 gcc 编译器的工具包。
+
+执行 `go run .`，输出如下。
+
+```bash
+> go run .
+2020/03/07 20:28:37 2
+2020/03/07 20:28:37 Tom
+```
+
+- 使用 `sql.Open()` 连接数据库，第一个参数是驱动名称，import 语句 `_ "github.com/mattn/go-sqlite3"` 包导入时会注册 sqlite3 的驱动，第二个参数是数据库的名称，对于 SQLite 来说，也就是文件名，不存在会新建。返回一个 `sql.DB` 实例的指针。
+- `Exec()` 用于执行 SQL 语句，如果是查询语句，不会返回相关的记录。所以查询语句通常使用 `Query()` 和 `QueryRow()`，前者可以返回多条记录，后者只返回一条记录。
+- `Exec()`、`Query()`、`QueryRow()` 接受1或多个入参，第一个入参是 SQL 语句，后面的入参是 SQL 语句中的占位符 `?` 对应的值，占位符一般用来防 SQL 注入。
+- `QueryRow()` 的返回值类型是 `*sql.Row`，`row.Scan()` 接受1或多个指针作为参数，可以获取对应列(column)的值，在这个示例中，只有 `Name` 一列，因此传入字符串指针 `&name` 即可获取到查询的结果。
+
+
+掌握了基础的 SQL 语句和 Go 标准库 `database/sql` 的使用，可以开始实现 ORM 框架的雏形了。
+
+## 3 实现一个简单的 log 库
+
+开发一个框架/库并不容易，详细的日志能够帮助我们快速地定位问题。因此，在写核心代码之前，我们先用几十行代码实现一个简单的 log 库。
+
+> 为什么不直接使用原生的 log 库呢？log 标准库没有日志分级，不打印文件和行号，这就意味着我们很难快速知道是哪个地方发生了错误。
+
+这个简易的 log 库具备以下特性：
+
+- 支持日志分级（Info、Error、Disabled 三级）。
+- 不同层级日志显示时使用不同的颜色区分。
+- 显示打印日志代码对应的文件名和行号。
+
+```bash
+go mod init geeorm
+```
+
+首先创建一个名为 geeorm 的 module，并新建文件 log/log.go，用于放置和日志相关的代码。GeeORM 现在长这个样子：
+
+```bash
+day1-database-sql/
+    |--log/
+        |--log.go
+    |--go.mod
+```
+
+第一步，创建 2 个日志实例分别用于打印 Info 和 Error 日志。
+
+[day1-database-sql/log/log.go](https://github.com/geektutu/7days-golang/tree/master/gee-orm/day1-database-sql/log)
+
+```go
+package log
+
+import (
+	"io/ioutil"
+	"log"
+	"os"
+	"sync"
+)
+
+var (
+	errorLog = log.New(os.Stdout, "\033[31m[error]\033[0m ", log.LstdFlags|log.Lshortfile)
+	infoLog  = log.New(os.Stdout, "\033[34m[info ]\033[0m ", log.LstdFlags|log.Lshortfile)
+	loggers  = []*log.Logger{errorLog, infoLog}
+	mu       sync.Mutex
+)
+
+// log methods
+var (
+	Error  = errorLog.Println
+	Errorf = errorLog.Printf
+	Info   = infoLog.Println
+	Infof  = infoLog.Printf
+)
+```
+
+- `[info ]` 颜色为蓝色，`[error]` 为红色。
+- 使用 `log.Lshortfile` 支持显示文件名和代码行号。
+- 暴露 `Error`，`Errorf`，`Info`，`Infof` 4个方法。
+
+第二步呢，支持设置日志的层级(InfoLevel, ErrorLevel, Disabled)。
+
+```go
+// log levels
+const (
+	InfoLevel = iota
+	ErrorLevel
+	Disabled
+)
+
+// SetLevel controls log level
+func SetLevel(level int) {
+	mu.Lock()
+	defer mu.Unlock()
+
+	for _, logger := range loggers {
+		logger.SetOutput(os.Stdout)
+	}
+
+	if ErrorLevel < level {
+		errorLog.SetOutput(ioutil.Discard)
+	}
+	if InfoLevel < level {
+		infoLog.SetOutput(ioutil.Discard)
+	}
+}
+```
+
+- 这一部分的实现非常简单，三个层级声明为三个常量，通过控制 `Output`，来控制日志是否打印。
+- 如果设置为 ErrorLevel，infoLog 的输出会被定向到 `ioutil.Discard`，即不打印该日志。
+
+至此呢，一个简单的支持分级的 log 库就实现完成了。
+
+## 4 核心结构 Session
+
+我们在根目录下新建一个文件夹 session，用于实现与数据库的交互。今天我们只实现直接调用 SQL 语句进行原生交互的部分，这部分代码实现在 `session/raw.go` 中。
+
+[day1-database-sql/session/raw.go](https://github.com/geektutu/7days-golang/tree/master/gee-orm/day1-database-sql/session)
+
+```go
+package session
+
+import (
+	"database/sql"
+	"geeorm/log"
+	"strings"
+)
+
+type Session struct {
+	db      *sql.DB
+	sql     strings.Builder
+	sqlVars []interface{}
+}
+
+func New(db *sql.DB) *Session {
+	return &Session{db: db}
+}
+
+func (s *Session) Clear() {
+	s.sql.Reset()
+	s.sqlVars = nil
+}
+
+func (s *Session) DB() *sql.DB {
+	return s.db
+}
+
+func (s *Session) Raw(sql string, values ...interface{}) *Session {
+	s.sql.WriteString(sql)
+	s.sql.WriteString(" ")
+	s.sqlVars = append(s.sqlVars, values...)
+	return s
+}
+```
+
+- Session 结构体目前只包含三个成员变量，第一个是 `db *sql.DB`，即使用 `sql.Open()` 方法连接数据库成功之后返回的指针。
+- 第二个和第三个成员变量用来拼接 SQL 语句和 SQL 语句中占位符的对应值。用户调用 `Raw()` 方法即可改变这两个变量的值。
+
+接下来呢，封装 `Exec()`、`Query()` 和 `QueryRow()` 三个原生方法。
+
+```go
+// Exec raw sql with sqlVars
+func (s *Session) Exec() (result sql.Result, err error) {
+	defer s.Clear()
+	log.Info(s.sql.String(), s.sqlVars)
+	if result, err = s.DB().Exec(s.sql.String(), s.sqlVars...); err != nil {
+		log.Error(err)
+	}
+	return
+}
+
+// QueryRow gets a record from db
+func (s *Session) QueryRow() *sql.Row {
+	defer s.Clear()
+	log.Info(s.sql.String(), s.sqlVars)
+	return s.DB().QueryRow(s.sql.String(), s.sqlVars...)
+}
+
+// QueryRows gets a list of records from db
+func (s *Session) QueryRows() (rows *sql.Rows, err error) {
+	defer s.Clear()
+	log.Info(s.sql.String(), s.sqlVars)
+	if rows, err = s.DB().Query(s.sql.String(), s.sqlVars...); err != nil {
+		log.Error(err)
+	}
+	return
+}
+```
+
+- 封装有 2 个目的，一是统一打印日志（包括 执行的SQL 语句和错误日志）。
+- 二是执行完成后，清空 `(s *Session).sql` 和 `(s *Session).sqlVars` 两个变量。这样 Session 可以复用，开启一次会话，可以执行多次 SQL。
+
+## 4 核心结构 Engine
+
+Session 负责与数据库的交互，那交互前的准备工作（比如连接/测试数据库），交互后的收尾工作（关闭连接）等就交给 Engine 来负责了。Engine 是 GeeORM 与用户交互的入口。代码位于根目录的 `geeorm.go`。
+
+[day1-database-sql/geeorm.go](https://github.com/geektutu/7days-golang/tree/master/gee-orm/day1-database-sql)
+
+```go
+package geeorm
+
+import (
+	"database/sql"
+
+	"geeorm/log"
+	"geeorm/session"
+)
+
+type Engine struct {
+	db *sql.DB
+}
+
+func NewEngine(driver, source string) (e *Engine, err error) {
+	db, err := sql.Open(driver, source)
+	if err != nil {
+		log.Error(err)
+		return
+	}
+	// Send a ping to make sure the database connection is alive.
+	if err = db.Ping(); err != nil {
+		log.Error(err)
+		return
+	}
+	e = &Engine{db: db}
+	log.Info("Connect database success")
+	return
+}
+
+func (engine *Engine) Close() {
+	if err := engine.db.Close(); err != nil {
+		log.Error("Failed to close database")
+	}
+	log.Info("Close database success")
+}
+
+func (engine *Engine) NewSession() *session.Session {
+	return session.New(engine.db)
+}
+```
+
+Engine 的逻辑非常简单，最重要的方法是 `NewEngine`，`NewEngine` 主要做了两件事。
+
+- 连接数据库，返回 `*sql.DB`。
+- 调用 `db.Ping()`，检查数据库是否能够正常连接。
+
+另外呢，提供了 Engine 提供了 `NewSession()` 方法，这样可以通过 `Engine` 实例创建会话，进而与数据库进行交互了。到这一步，整个 GeeORM 的框架雏形已经出来了。
+
+```bash
+day1-database-sql/
+    |--log/          # 日志
+        |--log.go
+    |--session/      # 数据库交互
+        |--raw.go
+    |--geeorm.go     # 用户交互
+    |--go.mod 
+```
+
+## 5 测试
+
+GeeORM 的单元测试是比较完备的，可以参考 `log_test.go`、`raw_test.go` 和 `geeorm_test.go` 等几个测试文件，在这里呢，就不一一讲解了。接下来呢，我们将 geeorm 视为第三方库来使用。
+
+在根目录下新建 cmd_test 目录放置测试代码，新建文件 main.go。
+
+[day1-database-sql/cmd_test/main.go](https://github.com/geektutu/7days-golang/tree/master/gee-orm/day1-database-sql/cmd_test)
+
+```go
+package main
+
+import (
+	"geeorm"
+	"geeorm/log"
+
+	_ "github.com/mattn/go-sqlite3"
+)
+
+func main() {
+	engine, _ := geeorm.NewEngine("sqlite3", "gee.db")
+	defer engine.Close()
+	s := engine.NewSession()
+	_, _ = s.Raw("DROP TABLE IF EXISTS User;").Exec()
+    _, _ = s.Raw("CREATE TABLE User(Name text);").Exec()
+    _, _ = s.Raw("CREATE TABLE User(Name text);").Exec()
+	result, _ := s.Raw("INSERT INTO User(`Name`) values (?), (?)", "Tom", "Sam").Exec()
+	count, _ := result.RowsAffected()
+	fmt.Printf("Exec success, %d affected\n", count)
+}
+```
+
+执行 `go run main.go`，将会看到如下的输出：
+
+![geeorm log](geeorm-day1/geeorm_log.png)
+
+日志中出现了一行报错信息，*table User already exists*，因为我们在 main 函数中执行了两次创建表 `User` 的语句。可以看到，每一行日志均标明了报错的文件和行号，而且不同层级日志的颜色是不同的。
+
+## 附 推荐阅读
+
+- [Go 语言简明教程](https://geektutu.com/post/quick-golang.html)
+- [Go Test 单元测试简明教程](https://geektutu.com/post/quick-go-test.html)
+- [SQLite 常用命令](https://geektutu.com/post/cheat-sheet-sqlite.html)
\ No newline at end of file
diff --git a/gee-orm/doc/geeorm-day1/geeorm_log.png b/gee-orm/doc/geeorm-day1/geeorm_log.png
new file mode 100755
index 0000000000000000000000000000000000000000..dc58aaf388bc55ece329d1faa0cf53349ba53fc1
GIT binary patch
literal 6745
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
QGGe%CXl78Y=M?$>01DJCb^rhX

literal 0
HcmV?d00001


From 8b48181e8f0b65fa2ae20e71c88291488f6d8919 Mon Sep 17 00:00:00 2001
From: gzdaijie <gzdaijie@163.com>
Date: Sun, 8 Mar 2020 00:35:59 +0800
Subject: [PATCH 058/122] add day2

---
 gee-orm/doc/geeorm-day1.md |   6 +-
 gee-orm/doc/geeorm-day2.md | 371 ++++++++++++++++++++++++++++++++++++-
 2 files changed, 369 insertions(+), 8 deletions(-)

diff --git a/gee-orm/doc/geeorm-day1.md b/gee-orm/doc/geeorm-day1.md
index 10a8863..f25df3b 100644
--- a/gee-orm/doc/geeorm-day1.md
+++ b/gee-orm/doc/geeorm-day1.md
@@ -1,6 +1,6 @@
 ---
 title: 动手写ORM框架 - GeeORM第一天 database/sql 基础
-date: 2020-03-03 23:00:00
+date: 2020-03-07 23:00:00
 description: 7天用 Go语言/golang 从零实现 ORM 框架 GeeORM 教程(7 days implement golang object relational mapping framework from scratch tutorial)，动手写 ORM 框架，参照 gorm, xorm 的实现。介绍了 SQLite 的基础操作（连接数据库，创建表、增删记录等），使用 Go 标准库 database/sql 操作 SQLite 数据库，包括执行(Exec)，查询(Query, QueryRow)。
 tags:
 - Go
@@ -305,7 +305,7 @@ func (s *Session) QueryRows() (rows *sql.Rows, err error) {
 - 封装有 2 个目的，一是统一打印日志（包括 执行的SQL 语句和错误日志）。
 - 二是执行完成后，清空 `(s *Session).sql` 和 `(s *Session).sqlVars` 两个变量。这样 Session 可以复用，开启一次会话，可以执行多次 SQL。
 
-## 4 核心结构 Engine
+## 5 核心结构 Engine
 
 Session 负责与数据库的交互，那交互前的准备工作（比如连接/测试数据库），交互后的收尾工作（关闭连接）等就交给 Engine 来负责了。Engine 是 GeeORM 与用户交互的入口。代码位于根目录的 `geeorm.go`。
 
@@ -370,7 +370,7 @@ day1-database-sql/
     |--go.mod 
 ```
 
-## 5 测试
+## 6 测试
 
 GeeORM 的单元测试是比较完备的，可以参考 `log_test.go`、`raw_test.go` 和 `geeorm_test.go` 等几个测试文件，在这里呢，就不一一讲解了。接下来呢，我们将 geeorm 视为第三方库来使用。
 
diff --git a/gee-orm/doc/geeorm-day2.md b/gee-orm/doc/geeorm-day2.md
index 3e33396..8546762 100644
--- a/gee-orm/doc/geeorm-day2.md
+++ b/gee-orm/doc/geeorm-day2.md
@@ -1,7 +1,7 @@
 ---
 title: 动手写ORM框架 - GeeORM第二天 对象表结构映射
-date: 2020-03-03 23:00:00
-description: 7天用 Go语言/golang 从零实现 ORM 框架 GeeORM 教程(7 days implement golang object relational mapping framework from scratch tutorial)，动手写 ORM 框架，参照 gorm, xorm 的实现。使用反射(reflect)获取任意 struct 对象的名称和字段，映射为数据中的表；使用 dialect 隔离不同数据库之间的差异，便于扩展；数据表的创建(create)、删除(drop)。
+date: 2020-03-08 00:20:00
+description: 7天用 Go语言/golang 从零实现 ORM 框架 GeeORM 教程(7 days implement golang object relational mapping framework from scratch tutorial)，动手写 ORM 框架，参照 gorm, xorm 的实现。使用反射(reflect)获取任意 struct 对象的名称和字段，映射为数据中的表；使用 dialect 隔离不同数据库之间的差异，便于扩展；数据库表的创建(create)、删除(drop)。
 tags:
 - Go
 nav: 从零实现
@@ -16,11 +16,372 @@ keywords:
 - table mapping
 image: post/geeorm/geeorm_sm.jpg
 github: https://github.com/geektutu/7days-golang
-published: false
 ---
 
 本文是[7天用Go从零实现ORM框架GeeORM](https://geektutu.com/post/geeorm.html)的第二篇。
 
-- 使用反射(reflect)获取任意 struct 对象的名称和字段，映射为数据中的表。
 - 使用 dialect 隔离不同数据库之间的差异，便于扩展。
-- 数据表的创建(create)、删除(drop)。
\ No newline at end of file
+- 使用反射(reflect)获取任意 struct 对象的名称和字段，映射为数据中的表。
+- 数据库表的创建(create)、删除(drop)。
+
+## 1 Dialect
+
+SQL 语句中的类型和 Go 语言中的类型是不同的，例如Go 语言中的 `int`、`int8`、`int16` 等类型均对应 SQLite 中的 `integer` 类型。因此实现 ORM 映射的第一步，需要思考如何将 Go 语言的类型映射为数据库中的类型。
+
+同时，不同数据库支持的数据类型也是有差异的，即使功能相同，在 SQL 语句的表达上也可能有差异。ORM 框架往往需要兼容多种数据库，因此我们需要将差异的这一部分提取出来，每一种数据库分别实现，实现最大程度的复用和解耦。这部分代码称之为 `dialect`。
+
+在根目录下新建文件夹 dialect，并在 dialect 文件夹下新建文件 `dialect.go`，抽象出各个数据库差异的部分。
+
+[day2-reflect-schema/dialect/dialect.go](https://github.com/geektutu/7days-golang/tree/master/gee-orm/day2-reflect-schema/dialect)
+
+```go
+package dialect
+
+import "reflect"
+
+var dialectsMap = map[string]Dialect{}
+
+type Dialect interface {
+	DataTypeOf(typ reflect.Value) string
+	TableExistSQL(tableName string) (string, []interface{})
+}
+
+func RegisterDialect(name string, dialect Dialect) {
+	dialectsMap[name] = dialect
+}
+
+func GetDialect(name string) (dialect Dialect, ok bool) {
+	dialect, ok = dialectsMap[name]
+	return
+}
+```
+
+`Dialect` 接口包含 2 个方法：
+
+- `DataTypeOf` 用于将 Go 语言的类型转换为该数据库的数据类型。
+- `TableExistSQL` 返回某个表是否存在的 SQL 语句，参数是表名(table)。
+
+当然，不同数据库之间的差异远远不止这两个地方，随着 ORM 框架功能的增多，dialect 的实现也会逐渐丰富起来，同时框架的其他部分不会受到影响。
+
+同时，声明了 `RegisterDialect` 和 `GetDialect` 两个方法用于注册和获取 dialect 实例。如果新增加对某个数据库的支持，那么调用 `RegisterDialect` 即可注册到全局。
+
+接下来，在`dialect` 目录下新建文件 `sqlite3.go` 增加对 SQLite 的支持。
+
+[day2-reflect-schema/dialect/sqlite3.go](https://github.com/geektutu/7days-golang/tree/master/gee-orm/day2-reflect-schema/dialect)
+
+```go
+package dialect
+
+import (
+	"fmt"
+	"reflect"
+	"time"
+)
+
+type sqlite3 struct{}
+
+var _ Dialect = (*sqlite3)(nil)
+
+func init() {
+	RegisterDialect("sqlite3", &sqlite3{})
+}
+
+func (s *sqlite3) DataTypeOf(typ reflect.Value) string {
+	switch typ.Kind() {
+	case reflect.Bool:
+		return "bool"
+	case reflect.Int, reflect.Int8, reflect.Int16, reflect.Int32,
+		reflect.Uint, reflect.Uint8, reflect.Uint16, reflect.Uint32, reflect.Uintptr:
+		return "integer"
+	case reflect.Int64, reflect.Uint64:
+		return "bigint"
+	case reflect.Float32, reflect.Float64:
+		return "real"
+	case reflect.String:
+		return "text"
+	case reflect.Array, reflect.Slice:
+		return "blob"
+	case reflect.Struct:
+		if _, ok := typ.Interface().(time.Time); ok {
+			return "datetime"
+		}
+	}
+	panic(fmt.Sprintf("invalid sql type %s (%s)", typ.Type().Name(), typ.Kind()))
+}
+
+func (s *sqlite3) TableExistSQL(tableName string) (string, []interface{}) {
+	args := []interface{}{tableName}
+	return "SELECT name FROM sqlite_master WHERE type='table' and name = ?", args
+}
+```
+
+- `sqlite3.go` 的实现虽然比较繁琐，但是整体逻辑还是非常清晰的。`DataTypeOf` 将 Go 语言的类型映射为 SQLite 的数据类型。`TableExistSQL` 返回了在 SQLite 中判断表 `tableName` 是否存在的 SQL 语句。
+- 实现了 `init()` 函数，包在第一次加载时，会将 sqlite3 的 dialect 自动注册到全局。
+
+## 2 Schema
+
+Dialect 实现了一些特定的 SQL 语句的转换，接下来我们将要实现 ORM 框架中最为核心的转换——对象(object)和表(table)的转换。给定一个任意的对象，转换为关系型数据库中的表结构。
+
+在数据库中创建一张表需要哪些要素呢？
+
+- 表名(table name) —— 结构体名(struct name)
+- 字段名和字段类型 —— 成员变量和类型。
+- 额外的约束条件(例如非空、主键等) —— 成员变量的Tag（Go 语言通过 Tag 实现，Java、Python 等语言通过注解实现）
+
+举一个实际的例子：
+
+```go
+type User struct {
+    Name string `geeorm:"PRIMARY KEY"`
+    Age  int
+}
+```
+
+期望对应的 schema 语句：
+
+```sql
+CREATE TABLE `User` (`Name` text PRIMARY KEY, `Age` integer);
+```
+
+我们将这部分代码的实现放置在一个子包 `schema/schema.go` 中。
+
+[day2-reflect-schema/schema/schema.go](https://github.com/geektutu/7days-golang/tree/master/gee-orm/day2-reflect-schema/schema)
+
+```go
+package schema
+
+import (
+	"geeorm/dialect"
+	"go/ast"
+	"reflect"
+)
+
+// Field represents a column of database
+type Field struct {
+	Name string
+	Type string
+	Tag  string
+}
+
+// Schema represents a table of database
+type Schema struct {
+	Model      interface{}
+	Name       string
+	Fields     []*Field
+	FieldNames []string
+	fieldMap   map[string]*Field
+}
+
+func (schema *Schema) GetField(name string) *Field {
+	return schema.fieldMap[name]
+}
+```
+
+- Field 包含 3 个成员变量，字段名 Name、类型 Type、和约束条件 Tag
+- Schema 主要包含被映射的对象 Model、表名 Name 和字段 Fields。
+- FieldNames 包含所有的字段名(列名)，fieldMap 记录字段名和 Field 的映射关系，方便之后直接使用，无需遍历 Fields。
+
+接下来实现 Parse 函数，将任意的对象解析为 Schema 实例。
+
+```go
+func Parse(dest interface{}, d dialect.Dialect) *Schema {
+	modelType := reflect.Indirect(reflect.ValueOf(dest)).Type()
+	schema := &Schema{
+		Model:    dest,
+		Name:     modelType.Name(),
+		fieldMap: make(map[string]*Field),
+	}
+
+	for i := 0; i < modelType.NumField(); i++ {
+		p := modelType.Field(i)
+		if !p.Anonymous && ast.IsExported(p.Name) {
+			field := &Field{
+				Name: p.Name,
+				Type: d.DataTypeOf(reflect.Indirect(reflect.New(p.Type))),
+			}
+			if v, ok := p.Tag.Lookup("geeorm"); ok {
+				field.Tag = v
+			}
+			schema.Fields = append(schema.Fields, field)
+			schema.FieldNames = append(schema.FieldNames, p.Name)
+			schema.fieldMap[p.Name] = field
+		}
+	}
+	return schema
+}
+```
+
+- `TypeOf()` 和 `ValueOf()` 是 reflect 包最为基本也是最重要的 2 个方法，分别用来返回入参的类型和值。因为设计的入参是一个对象的指针，因此需要 `reflect.Indirect()` 获取指针指向的实例。
+- `modelType.Name()` 获取到结构体的名称作为表名。
+- `NumField()` 获取实例的字段的个数，然后通过下标获取到特定字段 `p := modelType.Field(i)`。
+- `p.Name` 即字段名，`p.Type` 即字段类型，通过 `(Dialect).DataTypeOf()` 转换为数据库的字段类型，`p.Tag` 即额外的约束条件。
+
+写一个测试用例来验证 Parse 函数。
+
+```go
+// schema_test.go
+type User struct {
+	Name string `geeorm:"PRIMARY KEY"`
+	Age  int
+}
+
+var TestDial, _ = dialect.GetDialect("sqlite3")
+
+func TestParse(t *testing.T) {
+	schema := Parse(&User{}, TestDial)
+	if schema.Name != "User" || len(schema.Fields) != 2 {
+		t.Fatal("failed to parse User struct")
+	}
+	if schema.GetField("Name").Tag != "PRIMARY KEY" {
+		t.Fatal("failed to parse primary key")
+	}
+}
+```
+
+## Session
+
+Session 的核心功能是与数据库进行交互。因此，我们将数据库表的增/删操作实现在子包 session 中。在此之前，Session 的结构需要做一些调整。
+
+```go
+type Session struct {
+	db       *sql.DB
+	dialect  dialect.Dialect
+	refTable *schema.Schema
+	sql      strings.Builder
+	sqlVars  []interface{}
+}
+
+func New(db *sql.DB, dialect dialect.Dialect) *Session {
+	return &Session{
+		db:      db,
+		dialect: dialect,
+	}
+}
+```
+
+- `Session` 成员变量新增 dialect 和 refTable
+- 构造函数 `New` 的参数改为 2 个，db 和 dialect。
+
+在文件夹 `session` 下新建 `table.go` 用于放置操作数据库表相关的代码。
+
+[day2-reflect-schema/session/table.go](https://github.com/geektutu/7days-golang/tree/master/gee-orm/day2-reflect-schema/session)
+
+```go
+func (s *Session) Model(value interface{}) *Session {
+	// nil or different model, update refTable
+	if s.refTable == nil || reflect.TypeOf(value) != reflect.TypeOf(s.refTable.Model) {
+		s.refTable = schema.Parse(value, s.dialect)
+	}
+	return s
+}
+
+func (s *Session) RefTable() *schema.Schema {
+	if s.refTable == nil {
+		log.Error("Model is not set")
+	}
+	return s.refTable
+}
+```
+
+- `Model()` 方法用于给 refTable 赋值。解析操作是比较耗时的，因此将解析的结果保存在成员变量 refTable 中，即使 `Model()` 被调用多次，如果传入的结构体名称不发生变化，则不会更新 refTable 的值。
+- `RefTable()` 方法返回 refTable 的值，如果 refTable 未被赋值，则打印错误日志。
+
+接下来实现数据库表的创建、删除和判断是否存在的功能。三个方法的实现逻辑是相似的，利用 `RefTable()` 返回的数据库表和字段的信息，拼接出 SQL 语句，调用原生 SQL 接口执行。
+
+```go
+func (s *Session) CreateTable() error {
+	table := s.RefTable()
+	var columns []string
+	for _, field := range table.Fields {
+		columns = append(columns, fmt.Sprintf("%s %s %s", field.Name, field.Type, field.Tag))
+	}
+	desc := strings.Join(columns, ",")
+	_, err := s.Raw(fmt.Sprintf("CREATE TABLE %s (%s);", table.Name, desc)).Exec()
+	return err
+}
+
+func (s *Session) DropTable() error {
+	_, err := s.Raw(fmt.Sprintf("DROP TABLE IF EXISTS %s", s.RefTable().Name)).Exec()
+	return err
+}
+
+func (s *Session) HasTable() bool {
+	sql, values := s.dialect.TableExistSQL(s.RefTable().Name)
+	row := s.Raw(sql, values...).QueryRow()
+	var tmp string
+	_ = row.Scan(&tmp)
+	return tmp == s.RefTable().Name
+}
+```
+
+在 `table_test.go` 中实现对应的测试用例：
+
+```go
+type User struct {
+	Name string `geeorm:"PRIMARY KEY"`
+	Age  int
+}
+
+func TestSession_CreateTable(t *testing.T) {
+	s := NewSession().Model(&User{})
+	_ = s.DropTable()
+	_ = s.CreateTable()
+	if !s.HasTable() {
+		t.Fatal("Failed to create table User")
+	}
+}
+```
+
+## Engine
+
+因为 Session 构造函数增加了对 dialect 的依赖，Engine 需要作一些细微的调整。
+
+[day2-reflect-schema/geeorm.go](https://github.com/geektutu/7days-golang/tree/master/gee-orm/day2-reflect-schema)
+
+```go
+type Engine struct {
+	db      *sql.DB
+	dialect dialect.Dialect
+}
+
+func NewEngine(driver, source string) (e *Engine, err error) {
+	db, err := sql.Open(driver, source)
+	if err != nil {
+		log.Error(err)
+		return
+	}
+	// Send a ping to make sure the database connection is alive.
+	if err = db.Ping(); err != nil {
+		log.Error(err)
+		return
+	}
+	// make sure the specific dialect exists
+	dial, ok := dialect.GetDialect(driver)
+	if !ok {
+		log.Errorf("dialect %s Not Found", driver)
+		return
+	}
+	e = &Engine{db: db, dialect: dial}
+	log.Info("Connect database success")
+	return
+}
+
+func (engine *Engine) NewSession() *session.Session {
+	return session.New(engine.db, engine.dialect)
+}
+```
+
+- `NewEngine` 创建 Engine 实例时，获取 driver 对应的 dialect。
+- `NewSession` 创建 Session 实例时，传递 dialect 给构造函数 New。
+
+至此，第二天的内容已经完成了，总结一下今天的成果：
+
+- 1）为适配不同的数据库，映射数据类型和特定的 SQL 语句，创建 Dialect 层屏蔽数据库差异。
+- 2）设计 Schema，利用反射(reflect)完成结构体和数据库表结构的映射，包括表名、字段名、字段类型、字段 tag 等。
+- 3）构造创建(create)、删除(drop)、存在性(table exists) 的 SQL 语句完成数据库表的基本操作。
+
+## 附 推荐阅读
+
+- [Go 语言简明教程](https://geektutu.com/post/quick-golang.html)
+- [Go Test 单元测试简明教程](https://geektutu.com/post/quick-go-test.html)
+- [SQLite 常用命令](https://geektutu.com/post/cheat-sheet-sqlite.html)
\ No newline at end of file

From 9453b8b64c571fa9e5c5f61dfe97489def105f42 Mon Sep 17 00:00:00 2001
From: gzdaijie <gzdaijie@163.com>
Date: Sun, 8 Mar 2020 01:49:56 +0800
Subject: [PATCH 059/122] add day3

---
 gee-orm/day3-save-query/clause/generator.go   |   2 +-
 .../day4-chain-operation/clause/generator.go  |   2 +-
 gee-orm/day5-hooks/clause/generator.go        |   2 +-
 gee-orm/day6-transaction/clause/generator.go  |   2 +-
 gee-orm/day7-migrate/clause/generator.go      |   2 +-
 gee-orm/doc/geeorm-day1.md                    |   2 +-
 gee-orm/doc/geeorm-day2.md                    |   6 +-
 gee-orm/doc/geeorm-day3.md                    | 362 +++++++++++++++++-
 gee-orm/doc/geeorm.md                         |   3 +-
 9 files changed, 370 insertions(+), 13 deletions(-)

diff --git a/gee-orm/day3-save-query/clause/generator.go b/gee-orm/day3-save-query/clause/generator.go
index b257469..9ad8e24 100644
--- a/gee-orm/day3-save-query/clause/generator.go
+++ b/gee-orm/day3-save-query/clause/generator.go
@@ -35,7 +35,7 @@ func _insert(values ...interface{}) (string, []interface{}) {
 }
 
 func _values(values ...interface{}) (string, []interface{}) {
-	// VALUES ($v1), (&v2), ...
+	// VALUES ($v1), ($v2), ...
 	var bindStr string
 	var sql strings.Builder
 	var vars []interface{}
diff --git a/gee-orm/day4-chain-operation/clause/generator.go b/gee-orm/day4-chain-operation/clause/generator.go
index 127fc43..23635ba 100644
--- a/gee-orm/day4-chain-operation/clause/generator.go
+++ b/gee-orm/day4-chain-operation/clause/generator.go
@@ -38,7 +38,7 @@ func _insert(values ...interface{}) (string, []interface{}) {
 }
 
 func _values(values ...interface{}) (string, []interface{}) {
-	// VALUES ($v1), (&v2), ...
+	// VALUES ($v1), ($v2), ...
 	var bindStr string
 	var sql strings.Builder
 	var vars []interface{}
diff --git a/gee-orm/day5-hooks/clause/generator.go b/gee-orm/day5-hooks/clause/generator.go
index 127fc43..23635ba 100644
--- a/gee-orm/day5-hooks/clause/generator.go
+++ b/gee-orm/day5-hooks/clause/generator.go
@@ -38,7 +38,7 @@ func _insert(values ...interface{}) (string, []interface{}) {
 }
 
 func _values(values ...interface{}) (string, []interface{}) {
-	// VALUES ($v1), (&v2), ...
+	// VALUES ($v1), ($v2), ...
 	var bindStr string
 	var sql strings.Builder
 	var vars []interface{}
diff --git a/gee-orm/day6-transaction/clause/generator.go b/gee-orm/day6-transaction/clause/generator.go
index 127fc43..23635ba 100644
--- a/gee-orm/day6-transaction/clause/generator.go
+++ b/gee-orm/day6-transaction/clause/generator.go
@@ -38,7 +38,7 @@ func _insert(values ...interface{}) (string, []interface{}) {
 }
 
 func _values(values ...interface{}) (string, []interface{}) {
-	// VALUES ($v1), (&v2), ...
+	// VALUES ($v1), ($v2), ...
 	var bindStr string
 	var sql strings.Builder
 	var vars []interface{}
diff --git a/gee-orm/day7-migrate/clause/generator.go b/gee-orm/day7-migrate/clause/generator.go
index 127fc43..23635ba 100644
--- a/gee-orm/day7-migrate/clause/generator.go
+++ b/gee-orm/day7-migrate/clause/generator.go
@@ -38,7 +38,7 @@ func _insert(values ...interface{}) (string, []interface{}) {
 }
 
 func _values(values ...interface{}) (string, []interface{}) {
-	// VALUES ($v1), (&v2), ...
+	// VALUES ($v1), ($v2), ...
 	var bindStr string
 	var sql strings.Builder
 	var vars []interface{}
diff --git a/gee-orm/doc/geeorm-day1.md b/gee-orm/doc/geeorm-day1.md
index f25df3b..3ecb72c 100644
--- a/gee-orm/doc/geeorm-day1.md
+++ b/gee-orm/doc/geeorm-day1.md
@@ -411,4 +411,4 @@ func main() {
 
 - [Go 语言简明教程](https://geektutu.com/post/quick-golang.html)
 - [Go Test 单元测试简明教程](https://geektutu.com/post/quick-go-test.html)
-- [SQLite 常用命令](https://geektutu.com/post/cheat-sheet-sqlite.html)
\ No newline at end of file
+- [SQLite 常用命令速查表](https://geektutu.com/post/cheat-sheet-sqlite.html)
\ No newline at end of file
diff --git a/gee-orm/doc/geeorm-day2.md b/gee-orm/doc/geeorm-day2.md
index 8546762..60f02f5 100644
--- a/gee-orm/doc/geeorm-day2.md
+++ b/gee-orm/doc/geeorm-day2.md
@@ -238,7 +238,7 @@ func TestParse(t *testing.T) {
 }
 ```
 
-## Session
+## 3 Session
 
 Session 的核心功能是与数据库进行交互。因此，我们将数据库表的增/删操作实现在子包 session 中。在此之前，Session 的结构需要做一些调整。
 
@@ -332,7 +332,7 @@ func TestSession_CreateTable(t *testing.T) {
 }
 ```
 
-## Engine
+## 4 Engine
 
 因为 Session 构造函数增加了对 dialect 的依赖，Engine 需要作一些细微的调整。
 
@@ -384,4 +384,4 @@ func (engine *Engine) NewSession() *session.Session {
 
 - [Go 语言简明教程](https://geektutu.com/post/quick-golang.html)
 - [Go Test 单元测试简明教程](https://geektutu.com/post/quick-go-test.html)
-- [SQLite 常用命令](https://geektutu.com/post/cheat-sheet-sqlite.html)
\ No newline at end of file
+- [SQLite 常用命令速查表](https://geektutu.com/post/cheat-sheet-sqlite.html)
\ No newline at end of file
diff --git a/gee-orm/doc/geeorm-day3.md b/gee-orm/doc/geeorm-day3.md
index ed0b47d..26790de 100644
--- a/gee-orm/doc/geeorm-day3.md
+++ b/gee-orm/doc/geeorm-day3.md
@@ -1,7 +1,7 @@
 ---
 title: 动手写ORM框架 - GeeORM第三天 插入和查询记录
-date: 2020-03-03 23:00:00
-description: 7天用 Go语言/golang 从零实现 ORM 框架 GeeORM 教程(7 days implement golang object relational mapping framework from scratch tutorial)，动手写 ORM 框架，参照 gorm, xorm 的实现。实现新增(insert)记录的功能；使用反射(reflect)将数据库的记录转换为对应的结构体，实现查询(select)功能。
+date: 2020-03-08 01:00:00
+description: 7天用 Go语言/golang 从零实现 ORM 框架 GeeORM 教程(7 days implement golang object relational mapping framework from scratch tutorial)，动手写 ORM 框架，参照 gorm, xorm 的实现。实现新增(insert)记录的功能；使用反射(reflect)将数据库的记录转换为对应的结构体实例，实现查询(select)功能。
 tags:
 - Go
 nav: 从零实现
@@ -22,4 +22,360 @@ published: false
 本文是[7天用Go从零实现ORM框架GeeORM](https://geektutu.com/post/geeorm.html)的第三篇。
 
 - 实现新增(insert)记录的功能。
-- 使用反射(reflect)将数据库的记录转换为对应的结构体，实现查询(select)功能。
\ No newline at end of file
+- 使用反射(reflect)将数据库的记录转换为对应的结构体实例，实现查询(select)功能。
+
+## 1 Clause 构造 SQL 语句
+
+从第三天开始，GeeORM 需要涉及一些较为复杂的操作，例如查询操作。查询语句一般由很多个子句(clause) 构成。SELECT 语句的构成通常是这样的：
+
+```sql
+SELECT col1, col2, ...
+    FROM table_name
+    WHERE [ conditions ]
+    GROUP BY col1
+    HAVING [ conditions ]
+```
+
+也就是说，如果想一次构造出完整的 SQL 语句是比较困难的，因此我们将构造 SQL 语句这一部分独立出来，放在子package clause 中实现。
+
+首先在 `clause/generator.go` 中实现各个子句的生成规则。
+
+[day3-save-query/clause/generator.go](https://github.com/geektutu/7days-golang/tree/master/gee-orm/day3-save-query/clause)
+
+
+```go
+package clause
+
+import (
+	"fmt"
+	"strings"
+)
+
+type generator func(values ...interface{}) (string, []interface{})
+
+var generators map[Type]generator
+
+func init() {
+	generators = make(map[Type]generator)
+	generators[INSERT] = _insert
+	generators[VALUES] = _values
+	generators[SELECT] = _select
+	generators[LIMIT] = _limit
+	generators[WHERE] = _where
+	generators[ORDERBY] = _orderBy
+}
+
+func genBindVars(num int) string {
+	var vars []string
+	for i := 0; i < num; i++ {
+		vars = append(vars, "?")
+	}
+	return strings.Join(vars, ", ")
+}
+
+func _insert(values ...interface{}) (string, []interface{}) {
+	// INSERT INTO $tableName ($fields)
+	tableName := values[0]
+	fields := strings.Join(values[1].([]string), ",")
+	return fmt.Sprintf("INSERT INTO %s (%v)", tableName, fields), []interface{}{}
+}
+
+func _values(values ...interface{}) (string, []interface{}) {
+	// VALUES ($v1), ($v2), ...
+	var bindStr string
+	var sql strings.Builder
+	var vars []interface{}
+	sql.WriteString("VALUES ")
+	for i, value := range values {
+		v := value.([]interface{})
+		if bindStr == "" {
+			bindStr = genBindVars(len(v))
+		}
+		sql.WriteString(fmt.Sprintf("(%v)", bindStr))
+		if i+1 != len(values) {
+			sql.WriteString(", ")
+		}
+		vars = append(vars, v...)
+	}
+	return sql.String(), vars
+
+}
+
+func _select(values ...interface{}) (string, []interface{}) {
+	// SELECT $fields FROM $tableName
+	tableName := values[0]
+	fields := strings.Join(values[1].([]string), ",")
+	return fmt.Sprintf("SELECT %v FROM %s", fields, tableName), []interface{}{}
+}
+
+func _limit(values ...interface{}) (string, []interface{}) {
+	// LIMIT $num
+	return "LIMIT ?", values
+}
+
+func _where(values ...interface{}) (string, []interface{}) {
+	// WHERE $desc
+	desc, vars := values[0], values[1:]
+	return fmt.Sprintf("WHERE %s", desc), vars
+}
+
+func _orderBy(values ...interface{}) (string, []interface{}) {
+	return fmt.Sprintf("ORDER BY %s", values[0]), []interface{}{}
+}
+```
+
+然后在 `clause/clause.go` 中实现结构体 `Clause` 拼接各个独立的子句。
+
+[day3-save-query/clause/clause.go](https://github.com/geektutu/7days-golang/tree/master/gee-orm/day3-save-query/clause)
+
+```go
+package clause
+
+import "strings"
+
+type Clause struct {
+	sql     map[Type]string
+	sqlVars map[Type][]interface{}
+}
+
+type Type int
+const (
+	INSERT Type = iota
+	VALUES
+	SELECT
+	LIMIT
+	WHERE
+	ORDERBY
+)
+
+func (c *Clause) Set(name Type, vars ...interface{}) {
+	if c.sql == nil {
+		c.sql = make(map[Type]string)
+		c.sqlVars = make(map[Type][]interface{})
+	}
+	sql, vars := generators[name](vars...)
+	c.sql[name] = sql
+	c.sqlVars[name] = vars
+}
+
+func (c *Clause) Build(orders ...Type) (string, []interface{}) {
+	var sqls []string
+	var vars []interface{}
+	for _, order := range orders {
+		if sql, ok := c.sql[order]; ok {
+			sqls = append(sqls, sql)
+			vars = append(vars, c.sqlVars[order]...)
+		}
+	}
+	return strings.Join(sqls, " "), vars
+}
+```
+
+- `Set` 方法根据 `Type` 调用对应的 generator，生成该子句对应的 SQL 语句。
+- `Build` 方法根据传入的 `Type` 的顺序，构造出最终的 SQL 语句。
+
+在 `clause_test.go` 实现对应的测试用例：
+
+```go
+func testSelect(t *testing.T) {
+	var clause Clause
+	clause.Set(LIMIT, 3)
+	clause.Set(SELECT, "User", []string{"*"})
+	clause.Set(WHERE, "Name = ?", "Tom")
+	clause.Set(ORDERBY, "Age ASC")
+	sql, vars := clause.Build(SELECT, WHERE, ORDERBY, LIMIT)
+	t.Log(sql, vars)
+	if sql != "SELECT * FROM User WHERE Name = ? ORDER BY Age ASC LIMIT ?" {
+		t.Fatal("failed to build SQL")
+	}
+	if !reflect.DeepEqual(vars, []interface{}{"Tom", 3}) {
+		t.Fatal("failed to build SQLVars")
+	}
+}
+
+func TestClause_Build(t *testing.T) {
+	t.Run("select", func(t *testing.T) {
+		testSelect(t)
+	})
+}
+```
+
+## 2 实现 Insert 功能
+
+clause 已经支持生成简单的插入(INSERT) 和 查询(SELECT) 的 SQL 语句，那么紧接着我们就可以在 session 中实现对应的功能了。
+
+INSERT 对应的 SQL 语句一般是这样的：
+
+```sql
+INSERT INTO table_name(col1, col2, col3, ...) VALUES
+    (A1, A2, A3, ...),
+    (B1, B2, B3, ...),
+    ...
+```
+
+在 ORM 框架中期望 Insert 的调用方式如下：
+
+```go
+s := geeorm.NewEngine().NewSession()
+u1 := &User{Name: "Tom", Age: 18}
+u2 := &User{Name: "Sam", Age: 25}
+s.Insert(u1, u2, ...)
+```
+
+也就是说，我们还需要一个步骤，根据数据库中列的顺序，从对象中找到对应的值，按顺序平铺。即 `u1`、`u2` 转换为 `("Tom", 18), ("Same", 25)` 这样的格式。
+
+因此在实现 Insert 功能之前，还需要给 `Schema` 新增一个函数 `RecordValues` 完成上述的转换。
+
+[day3-save-query/schema/schema.go](https://github.com/geektutu/7days-golang/tree/master/gee-orm/day3-save-query/schema)
+
+```go
+func (schema *Schema) RecordValues(dest interface{}) []interface{} {
+	destValue := reflect.Indirect(reflect.ValueOf(dest))
+	var fieldValues []interface{}
+	for _, field := range schema.Fields {
+		fieldValues = append(fieldValues, destValue.FieldByName(field.Name).Interface())
+	}
+	return fieldValues
+}
+```
+
+在 session 文件夹下新建 record.go，用于实现记录增删查改相关的代码。
+
+[day3-save-query/session/record.go](https://github.com/geektutu/7days-golang/tree/master/gee-orm/day3-save-query/session)
+
+```go
+package session
+
+import (
+	"geeorm/clause"
+	"reflect"
+)
+
+func (s *Session) Insert(values ...interface{}) (int64, error) {
+	recordValues := make([]interface{}, 0)
+	for _, value := range values {
+		table := s.Model(value).RefTable()
+		s.clause.Set(clause.INSERT, table.Name, table.FieldNames)
+		recordValues = append(recordValues, table.RecordValues(value))
+	}
+
+	s.clause.Set(clause.VALUES, recordValues...)
+	sql, vars := s.clause.Build(clause.INSERT, clause.VALUES)
+	result, err := s.Raw(sql, vars...).Exec()
+	if err != nil {
+		return 0, err
+	}
+
+	return result.RowsAffected()
+}
+```
+
+后续所有构造 SQL 语句的方式都将与 `Insert` 中构造 SQL 语句的方式一致。分两步：
+
+- 1）多次调用 `clause.Set()` 构造好每一个子句。
+- 2）调用一次 `clause.Build()` 按照传入的顺序构造出最终的 SQL 语句。
+
+构造完成后，调用 `Raw().Exec()` 方法执行。
+
+## 3 实现 Find 功能
+
+期望的调用方式是这样的：传入一个切片指针，查询的结果保存在切片中。
+
+```go
+s := geeorm.NewEngine().NewSession()
+var users []User
+s.Find(&users);
+```
+
+Find 功能的难点和 Insert 恰好反了过来。Insert 需要将已经存在的对象的每一个字段的值平铺开来，而 Find 则是需要根据平铺开的字段的值构造出对象。同样，也需要用到反射(reflect)。
+
+```go
+func (s *Session) Find(values interface{}) error {
+	destSlice := reflect.Indirect(reflect.ValueOf(values))
+	destType := destSlice.Type().Elem()
+	table := s.Model(reflect.New(destType).Elem().Interface()).RefTable()
+
+	s.clause.Set(clause.SELECT, table.Name, table.FieldNames)
+	sql, vars := s.clause.Build(clause.SELECT, clause.WHERE, clause.ORDERBY, clause.LIMIT)
+	rows, err := s.Raw(sql, vars...).QueryRows()
+	if err != nil {
+		return err
+	}
+
+	for rows.Next() {
+		dest := reflect.New(destType).Elem()
+		var values []interface{}
+		for _, name := range table.FieldNames {
+			values = append(values, dest.FieldByName(name).Addr().Interface())
+		}
+		if err := rows.Scan(values...); err != nil {
+			return err
+		}
+		destSlice.Set(reflect.Append(destSlice, dest))
+	}
+	return rows.Close()
+}
+```
+
+Find 的代码实现比较复杂，主要分为以下几步：
+
+- 1) `destSlice.Type().Elem()` 获取切片的单个元素的类型 `destType`，使用 `reflect.New()` 方法创建一个 `destType` 的实例，作为 `Model()` 的入参，映射出表结构 `RefTable()`。
+- 2）根据表结构，使用 clause 构造出 SELECT 语句，查询到所有符合条件的记录 `rows`。
+- 3）遍历每一行记录，利用反射创建 `destType` 的实例 `dest`，将 `dest` 的所有字段平铺开，构造切片 `values`。
+- 4）调用 `rows.Scan()` 将该行记录每一列的值依次赋值给 values 中的每一个字段。
+- 5）将 `dest` 添加到切片 `destSlice` 中。循环直到所有的记录都添加到切片 `destSlice` 中。
+
+## 4 测试
+
+在 session 文件夹下新建 `record_test.go`，创建测试用例。
+
+> `User` 和 `NewSession()` 的定义位于 raw_test.go 中。
+
+[day3-save-query/session/record_test.go](https://github.com/geektutu/7days-golang/tree/master/gee-orm/day3-save-query/session)
+
+```go
+package session
+
+import "testing"
+
+var (
+	user1 = &User{"Tom", 18}
+	user2 = &User{"Sam", 25}
+	user3 = &User{"Jack", 25}
+)
+
+func testRecordInit(t *testing.T) *Session {
+	t.Helper()
+	s := NewSession().Model(&User{})
+	err1 := s.DropTable()
+	err2 := s.CreateTable()
+	_, err3 := s.Insert(user1, user2)
+	if err1 != nil || err2 != nil || err3 != nil {
+		t.Fatal("failed init test records")
+	}
+	return s
+}
+
+func TestSession_Insert(t *testing.T) {
+	s := testRecordInit(t)
+	affected, err := s.Insert(user3)
+	if err != nil || affected != 1 {
+		t.Fatal("failed to create record")
+	}
+}
+
+func TestSession_Find(t *testing.T) {
+	s := testRecordInit(t)
+	var users []User
+	if err := s.Find(&users); err != nil || len(users) != 2 {
+		t.Fatal("failed to query all")
+	}
+}
+```
+
+## 附 推荐阅读
+
+- [Go 语言简明教程](https://geektutu.com/post/quick-golang.html)
+- [Go Test 单元测试简明教程](https://geektutu.com/post/quick-go-test.html)
+- [SQLite 常用命令速查表](https://geektutu.com/post/cheat-sheet-sqlite.html)
+- [Laws Of Reflection - golang.org](https://blog.golang.org/laws-of-reflection)
\ No newline at end of file
diff --git a/gee-orm/doc/geeorm.md b/gee-orm/doc/geeorm.md
index 78f4087..c25af6c 100644
--- a/gee-orm/doc/geeorm.md
+++ b/gee-orm/doc/geeorm.md
@@ -134,4 +134,5 @@ gorm 正在彻底重构 v1 版本，短期内看不到发布 v2 的可能。相
 ## 附 推荐阅读
 
 - [Go 语言简明教程](https://geektutu.com/post/quick-golang.html)
-- [Go Test 单元测试简明教程](https://geektutu.com/post/quick-go-test.html)
\ No newline at end of file
+- [Go Test 单元测试简明教程](https://geektutu.com/post/quick-go-test.html)
+- [SQLite 常用命令速查表](https://geektutu.com/post/cheat-sheet-sqlite.html)
\ No newline at end of file

From 2b03ff8dbb8dbc4a976c8602406a4ad8f8eb91fd Mon Sep 17 00:00:00 2001
From: gzdaijie <gzdaijie@gmail.com>
Date: Sun, 8 Mar 2020 22:07:06 +0800
Subject: [PATCH 060/122] add day4-day7

---
 README.md                                 |  14 +-
 gee-orm/day5-hooks/session/hooks.go       |  13 +-
 gee-orm/day6-transaction/session/hooks.go |  13 +-
 gee-orm/day7-migrate/geeorm_test.go       |   2 +-
 gee-orm/day7-migrate/session/hooks.go     |  13 +-
 gee-orm/doc/geeorm-day2.md                |   2 +-
 gee-orm/doc/geeorm-day3.md                |  28 ++-
 gee-orm/doc/geeorm-day4.md                | 266 +++++++++++++++++++++-
 gee-orm/doc/geeorm-day5.md                | 136 ++++++++++-
 gee-orm/doc/geeorm-day6.md                | 257 ++++++++++++++++++++-
 gee-orm/doc/geeorm-day7.md                | 150 +++++++++++-
 gee-orm/doc/geeorm.md                     |  14 +-
 12 files changed, 858 insertions(+), 50 deletions(-)

diff --git a/README.md b/README.md
index 5a9a75a..a85bc69 100644
--- a/README.md
+++ b/README.md
@@ -42,13 +42,13 @@
 
 gorm 准备推出完全重写的 v2 版本(目前还在开发中)，相对 gorm-v1 来说，xorm 的设计更容易理解，所以 geeorm 接口设计上主要参考了 xorm，一些细节实现上参考了 gorm。
 
-- 第一天：database/sql 基础 | [Code](gee-orm/day1-database-sql)
-- 第二天：对象表结构映射 | [Code](gee-orm/day2-reflect-schema)
-- 第三天：插入/查询记录 | [Code](gee-orm/day3-save-query)
-- 第四天：链式操作与更新删除 | [Code](gee-orm/day4-chain-operation)
-- 第五天：实现钩子(Hooks) | [Code](gee-orm/day5-hooks)
-- 第六天：支持事务(Transaction) | [Code](gee-orm/day6-transaction)
-- 第七天：数据库迁移(Migrate) | [Code](gee-orm/day7-migrate)
+- 第一天：[database/sql 基础](https://geektutu.com/post/geeorm-day1.html) | [Code](gee-orm/day1-database-sql)
+- 第二天：[对象表结构映射](https://geektutu.com/post/geeorm-day2.html) | [Code](gee-orm/day2-reflect-schema)
+- 第三天：[记录新增和查询](https://geektutu.com/post/geeorm-day3.html) | [Code](gee-orm/day3-save-query)
+- 第四天：[链式操作与更新删除](https://geektutu.com/post/geeorm-day4.html) | [Code](gee-orm/day4-chain-operation)
+- 第五天：[实现钩子(Hooks)](https://geektutu.com/post/geeorm-day5.html) | [Code](gee-orm/day5-hooks)
+- 第六天：[支持事务(Transaction)](https://geektutu.com/post/geeorm-day6.html) | [Code](gee-orm/day6-transaction)
+- 第七天：[数据库迁移(Migrate)](https://geektutu.com/post/geeorm-day7.html) | [Code](gee-orm/day7-migrate)
 
 ### WebAssembly 使用示例
 
diff --git a/gee-orm/day5-hooks/session/hooks.go b/gee-orm/day5-hooks/session/hooks.go
index 12462a4..d73c3c2 100644
--- a/gee-orm/day5-hooks/session/hooks.go
+++ b/gee-orm/day5-hooks/session/hooks.go
@@ -1,13 +1,16 @@
 package session
 
-import "reflect"
+import (
+	"geeorm/log"
+	"reflect"
+)
 
 // Hooks constants
 const (
 	BeforeQuery  = "BeforeQuery"
 	AfterQuery   = "AfterQuery"
 	BeforeUpdate = "BeforeUpdate"
-	AfterUpdate  = "AfterUpate"
+	AfterUpdate  = "AfterUpdate"
 	BeforeDelete = "BeforeDelete"
 	AfterDelete  = "AfterDelete"
 	BeforeInsert = "BeforeInsert"
@@ -15,7 +18,7 @@ const (
 )
 
 // CallMethod calls the registered hooks
-func (s *Session) CallMethod(method string, value interface{}) error {
+func (s *Session) CallMethod(method string, value interface{}) {
 	fm := reflect.ValueOf(s.RefTable().Model).MethodByName(method)
 	if value != nil {
 		fm = reflect.ValueOf(value).MethodByName(method)
@@ -24,9 +27,9 @@ func (s *Session) CallMethod(method string, value interface{}) error {
 	if fm.IsValid() {
 		if v := fm.Call(param); len(v) > 0 {
 			if err, ok := v[0].Interface().(error); ok {
-				return err
+				log.Error(err)
 			}
 		}
 	}
-	return nil
+	return
 }
diff --git a/gee-orm/day6-transaction/session/hooks.go b/gee-orm/day6-transaction/session/hooks.go
index 12462a4..d73c3c2 100644
--- a/gee-orm/day6-transaction/session/hooks.go
+++ b/gee-orm/day6-transaction/session/hooks.go
@@ -1,13 +1,16 @@
 package session
 
-import "reflect"
+import (
+	"geeorm/log"
+	"reflect"
+)
 
 // Hooks constants
 const (
 	BeforeQuery  = "BeforeQuery"
 	AfterQuery   = "AfterQuery"
 	BeforeUpdate = "BeforeUpdate"
-	AfterUpdate  = "AfterUpate"
+	AfterUpdate  = "AfterUpdate"
 	BeforeDelete = "BeforeDelete"
 	AfterDelete  = "AfterDelete"
 	BeforeInsert = "BeforeInsert"
@@ -15,7 +18,7 @@ const (
 )
 
 // CallMethod calls the registered hooks
-func (s *Session) CallMethod(method string, value interface{}) error {
+func (s *Session) CallMethod(method string, value interface{}) {
 	fm := reflect.ValueOf(s.RefTable().Model).MethodByName(method)
 	if value != nil {
 		fm = reflect.ValueOf(value).MethodByName(method)
@@ -24,9 +27,9 @@ func (s *Session) CallMethod(method string, value interface{}) error {
 	if fm.IsValid() {
 		if v := fm.Call(param); len(v) > 0 {
 			if err, ok := v[0].Interface().(error); ok {
-				return err
+				log.Error(err)
 			}
 		}
 	}
-	return nil
+	return
 }
diff --git a/gee-orm/day7-migrate/geeorm_test.go b/gee-orm/day7-migrate/geeorm_test.go
index b9656c5..4ccacf7 100644
--- a/gee-orm/day7-migrate/geeorm_test.go
+++ b/gee-orm/day7-migrate/geeorm_test.go
@@ -74,7 +74,7 @@ func TestEngine_Migrate(t *testing.T) {
 	defer engine.Close()
 	s := engine.NewSession()
 	_, _ = s.Raw("DROP TABLE IF EXISTS User;").Exec()
-	_, _ = s.Raw("CREATE TABLE User(Name text, XXX integer);").Exec()
+	_, _ = s.Raw("CREATE TABLE User(Name text PRIMARY KEY, XXX integer);").Exec()
 	_, _ = s.Raw("INSERT INTO User(`Name`) values (?), (?)", "Tom", "Sam").Exec()
 	engine.Migrate(&User{})
 
diff --git a/gee-orm/day7-migrate/session/hooks.go b/gee-orm/day7-migrate/session/hooks.go
index 12462a4..d73c3c2 100644
--- a/gee-orm/day7-migrate/session/hooks.go
+++ b/gee-orm/day7-migrate/session/hooks.go
@@ -1,13 +1,16 @@
 package session
 
-import "reflect"
+import (
+	"geeorm/log"
+	"reflect"
+)
 
 // Hooks constants
 const (
 	BeforeQuery  = "BeforeQuery"
 	AfterQuery   = "AfterQuery"
 	BeforeUpdate = "BeforeUpdate"
-	AfterUpdate  = "AfterUpate"
+	AfterUpdate  = "AfterUpdate"
 	BeforeDelete = "BeforeDelete"
 	AfterDelete  = "AfterDelete"
 	BeforeInsert = "BeforeInsert"
@@ -15,7 +18,7 @@ const (
 )
 
 // CallMethod calls the registered hooks
-func (s *Session) CallMethod(method string, value interface{}) error {
+func (s *Session) CallMethod(method string, value interface{}) {
 	fm := reflect.ValueOf(s.RefTable().Model).MethodByName(method)
 	if value != nil {
 		fm = reflect.ValueOf(value).MethodByName(method)
@@ -24,9 +27,9 @@ func (s *Session) CallMethod(method string, value interface{}) error {
 	if fm.IsValid() {
 		if v := fm.Call(param); len(v) > 0 {
 			if err, ok := v[0].Interface().(error); ok {
-				return err
+				log.Error(err)
 			}
 		}
 	}
-	return nil
+	return
 }
diff --git a/gee-orm/doc/geeorm-day2.md b/gee-orm/doc/geeorm-day2.md
index 60f02f5..9287a51 100644
--- a/gee-orm/doc/geeorm-day2.md
+++ b/gee-orm/doc/geeorm-day2.md
@@ -22,7 +22,7 @@ github: https://github.com/geektutu/7days-golang
 
 - 使用 dialect 隔离不同数据库之间的差异，便于扩展。
 - 使用反射(reflect)获取任意 struct 对象的名称和字段，映射为数据中的表。
-- 数据库表的创建(create)、删除(drop)。
+- 数据库表的创建(create)、删除(drop)。**代码约150行**
 
 ## 1 Dialect
 
diff --git a/gee-orm/doc/geeorm-day3.md b/gee-orm/doc/geeorm-day3.md
index 26790de..ff089e1 100644
--- a/gee-orm/doc/geeorm-day3.md
+++ b/gee-orm/doc/geeorm-day3.md
@@ -1,5 +1,5 @@
 ---
-title: 动手写ORM框架 - GeeORM第三天 插入和查询记录
+title: 动手写ORM框架 - GeeORM第三天 记录新增和查询
 date: 2020-03-08 01:00:00
 description: 7天用 Go语言/golang 从零实现 ORM 框架 GeeORM 教程(7 days implement golang object relational mapping framework from scratch tutorial)，动手写 ORM 框架，参照 gorm, xorm 的实现。实现新增(insert)记录的功能；使用反射(reflect)将数据库的记录转换为对应的结构体实例，实现查询(select)功能。
 tags:
@@ -22,7 +22,7 @@ published: false
 本文是[7天用Go从零实现ORM框架GeeORM](https://geektutu.com/post/geeorm.html)的第三篇。
 
 - 实现新增(insert)记录的功能。
-- 使用反射(reflect)将数据库的记录转换为对应的结构体实例，实现查询(select)功能。
+- 使用反射(reflect)将数据库的记录转换为对应的结构体实例，实现查询(select)功能。**代码约150行**
 
 ## 1 Clause 构造 SQL 语句
 
@@ -202,6 +202,26 @@ func TestClause_Build(t *testing.T) {
 
 ## 2 实现 Insert 功能
 
+首先为 Session 添加成员变量 clause
+
+```go
+// session/raw.go
+type Session struct {
+	db       *sql.DB
+	dialect  dialect.Dialect
+	refTable *schema.Schema
+	clause   clause.Clause
+	sql      strings.Builder
+	sqlVars  []interface{}
+}
+
+func (s *Session) Clear() {
+	s.sql.Reset()
+	s.sqlVars = nil
+	s.clause = clause.Clause{}
+}
+```
+
 clause 已经支持生成简单的插入(INSERT) 和 查询(SELECT) 的 SQL 语句，那么紧接着我们就可以在 session 中实现对应的功能了。
 
 INSERT 对应的 SQL 语句一般是这样的：
@@ -216,7 +236,7 @@ INSERT INTO table_name(col1, col2, col3, ...) VALUES
 在 ORM 框架中期望 Insert 的调用方式如下：
 
 ```go
-s := geeorm.NewEngine().NewSession()
+s := geeorm.NewEngine("sqlite3", "gee.db").NewSession()
 u1 := &User{Name: "Tom", Age: 18}
 u2 := &User{Name: "Sam", Age: 25}
 s.Insert(u1, u2, ...)
@@ -282,7 +302,7 @@ func (s *Session) Insert(values ...interface{}) (int64, error) {
 期望的调用方式是这样的：传入一个切片指针，查询的结果保存在切片中。
 
 ```go
-s := geeorm.NewEngine().NewSession()
+s := geeorm.NewEngine("sqlite3", "gee.db").NewSession()
 var users []User
 s.Find(&users);
 ```
diff --git a/gee-orm/doc/geeorm-day4.md b/gee-orm/doc/geeorm-day4.md
index 98cc55c..6e0d307 100644
--- a/gee-orm/doc/geeorm-day4.md
+++ b/gee-orm/doc/geeorm-day4.md
@@ -1,7 +1,7 @@
 ---
 title: 动手写ORM框架 - GeeORM第四天 链式操作与更新删除
-date: 2020-03-03 23:00:00
-description: 7天用 Go语言/golang 从零实现 ORM 框架 GeeORM 教程(7 days implement golang object relational mapping framework from scratch tutorial)，动手写 ORM 框架，参照 gorm, xorm 的实现。通过链式(chain)操作，支持查询条件(where, order by, limit 等)的叠加；实现记录的更新(update)和删除(delete)功能。
+date: 2020-03-08 16:00:00
+description: 7天用 Go语言/golang 从零实现 ORM 框架 GeeORM 教程(7 days implement golang object relational mapping framework from scratch tutorial)，动手写 ORM 框架，参照 gorm, xorm 的实现。通过链式(chain)操作，支持查询条件(where, order by, limit 等)的叠加；实现记录的更新(update)、删除(delete)和统计(count)功能。
 tags:
 - Go
 nav: 从零实现
@@ -16,10 +16,268 @@ keywords:
 - delete from
 image: post/geeorm/geeorm_sm.jpg
 github: https://github.com/geektutu/7days-golang
-published: false
 ---
 
 本文是[7天用Go从零实现ORM框架GeeORM](https://geektutu.com/post/geeorm.html)的第四篇。
 
 - 通过链式(chain)操作，支持查询条件(where, order by, limit 等)的叠加。
-- 实现记录的更新(update)和删除(delete)功能。
\ No newline at end of file
+- 实现记录的更新(update)、删除(delete)和统计(count)功能。**代码约100行**
+
+## 1 支持 Update、Delete 和 Count
+
+### 1.1 子句生成器
+
+clause 负责构造 SQL 语句，如果需要增加对更新(update)、删除(delete)和统计(count)功能的支持，第一步自然是在 clause 中实现 update、delete 和 count 子句的生成器。
+
+第一步：在原来的基础上，新增 UPDATE、DELETE、COUNT 三个 `Type` 类型的枚举值。
+
+[day4-chain-operation/clause/clause.go](https://github.com/geektutu/7days-golang/tree/master/gee-orm/day4-chain-operation/clause)
+
+```go
+// Support types for Clause
+const (
+	INSERT Type = iota
+	VALUES
+	SELECT
+	LIMIT
+	WHERE
+	ORDERBY
+	UPDATE
+	DELETE
+	COUNT
+)
+```
+
+第二步：实现对应字句的 generator，并注册到全局变量 `generators` 中
+
+[day4-chain-operation/clause/generator.go](https://github.com/geektutu/7days-golang/tree/master/gee-orm/day4-chain-operation/clause)
+
+```go
+func init() {
+	generators = make(map[Type]generator)
+	generators[INSERT] = _insert
+	generators[VALUES] = _values
+	generators[SELECT] = _select
+	generators[LIMIT] = _limit
+	generators[WHERE] = _where
+	generators[ORDERBY] = _orderBy
+	generators[UPDATE] = _update
+	generators[DELETE] = _delete
+	generators[COUNT] = _count
+}
+
+func _update(values ...interface{}) (string, []interface{}) {
+	tableName := values[0]
+	m := values[1].(map[string]interface{})
+	var keys []string
+	var vars []interface{}
+	for k, v := range m {
+		keys = append(keys, k+" = ?")
+		vars = append(vars, v)
+	}
+	return fmt.Sprintf("UPDATE %s SET %s", tableName, strings.Join(keys, ", ")), vars
+}
+
+func _delete(values ...interface{}) (string, []interface{}) {
+	return fmt.Sprintf("DELETE FROM %s", values[0]), []interface{}{}
+}
+
+func _count(values ...interface{}) (string, []interface{}) {
+	return _select(values[0], []string{"count(*)"})
+}
+```
+
+- `_update` 设计入参是2个，第一个参数是表名(table)，第二个参数是 map 类型，表示待更新的键值对。
+- `_delete` 只有一个入参，即表名。
+- `_count` 只有一个入参，即表名，并复用了 `_select` 生成器。
+
+
+### 1.2 Update 方法
+
+子句的 generator 已经准备好了，接下来和 Insert、Find 等方法一样，在 `session/record.go` 中按照一定顺序拼接 SQL 语句并调用就可以了。
+
+[day4-chain-operation/session/record.go](https://github.com/geektutu/7days-golang/tree/master/gee-orm/day4-chain-operation/session)
+
+```go
+// support map[string]interface{}
+// also support kv list: "Name", "Tom", "Age", 18, ....
+func (s *Session) Update(kv ...interface{}) (int64, error) {
+	m, ok := kv[0].(map[string]interface{})
+	if !ok {
+		m = make(map[string]interface{})
+		for i := 0; i < len(kv); i += 2 {
+			m[kv[i].(string)] = kv[i+1]
+		}
+	}
+	s.clause.Set(clause.UPDATE, s.RefTable().Name, m)
+	sql, vars := s.clause.Build(clause.UPDATE, clause.WHERE)
+	result, err := s.Raw(sql, vars...).Exec()
+	if err != nil {
+		return 0, err
+	}
+	return result.RowsAffected()
+}
+```
+
+Update 方法比较特别的一点在于，Update 接受 2 种入参，平铺开来的键值对和 map 类型的键值对。因为 generator 接受的参数是 map 类型的键值对，因此 `Update` 方法会动态地判断传入参数的类型，如果是不是 map 类型，则会自动转换。
+
+
+### 1.3 Delete 方法
+
+```go
+// Delete records with where clause
+func (s *Session) Delete() (int64, error) {
+	s.clause.Set(clause.DELETE, s.RefTable().Name)
+	sql, vars := s.clause.Build(clause.DELETE, clause.WHERE)
+	result, err := s.Raw(sql, vars...).Exec()
+	if err != nil {
+		return 0, err
+	}
+	return result.RowsAffected()
+}
+```
+
+### 1.4 Count 方法
+
+```go
+// Count records with where clause
+func (s *Session) Count() (int64, error) {
+	s.clause.Set(clause.COUNT, s.RefTable().Name)
+	sql, vars := s.clause.Build(clause.COUNT, clause.WHERE)
+	row := s.Raw(sql, vars...).QueryRow()
+	var tmp int64
+	if err := row.Scan(&tmp); err != nil {
+		return 0, err
+	}
+	return tmp, nil
+}
+```
+
+## 2 链式调用(chain)
+
+链式调用是一种简化代码的编程方式，能够使代码更简洁、易读。链式调用的原理也非常简单，某个对象调用某个方法后，将该对象的引用/指针返回，即可以继续调用该对象的其他方法。通常来说，当某个对象需要一次调用多个方法来设置其属性时，就非常适合改造为链式调用了。
+
+SQL 语句的构造过程就非常符合这个条件。SQL 语句由多个子句构成，典型的例如 SELECT 语句，往往需要设置查询条件（WHERE）、限制返回行数（LIMIT）等。理想的调用方式应该是这样的：
+
+```go
+s := geeorm.NewEngine("sqlite3", "gee.db").NewSession()
+var users []User
+s.Where("Age > 18").Limit(3).Find(&users)
+```
+
+从上面的示例中，可以看出，`WHERE`、`LIMIT`、`ORDER BY` 等查询条件语句非常适合链式调用。这几个子句的 generator 在之前就已经实现了，那我们接下来在 `session/record.go` 中添加对应的方法即可。
+
+[day4-chain-operation/session/record.go](https://github.com/geektutu/7days-golang/tree/master/gee-orm/day4-chain-operation/session)
+
+```go
+// Limit adds limit condition to clause
+func (s *Session) Limit(num int) *Session {
+	s.clause.Set(clause.LIMIT, num)
+	return s
+}
+
+// Where adds limit condition to clause
+func (s *Session) Where(desc string, args ...interface{}) *Session {
+	var vars []interface{}
+	s.clause.Set(clause.WHERE, append(append(vars, desc), args...)...)
+	return s
+}
+
+// OrderBy adds order by condition to clause
+func (s *Session) OrderBy(desc string) *Session {
+	s.clause.Set(clause.ORDERBY, desc)
+	return s
+}
+```
+
+## 3 First 只返回一条记录
+
+很多时候，我们期望 SQL 语句只返回一条记录，比如根据某个童鞋的学号查询他的信息，返回结果有且只有一条。结合链式调用，我们可以非常容易地实现 First 方法。
+
+```go
+func (s *Session) First(value interface{}) error {
+	dest := reflect.Indirect(reflect.ValueOf(value))
+	destSlice := reflect.New(reflect.SliceOf(dest.Type())).Elem()
+	if err := s.Limit(1).Find(destSlice.Addr().Interface()); err != nil {
+		return err
+	}
+	if destSlice.Len() == 0 {
+		return errors.New("NOT FOUND")
+	}
+	dest.Set(destSlice.Index(0))
+	return nil
+}
+```
+
+First 方法可以这么使用：
+
+```go
+u := &User{}
+_ = s.OrderBy("Age DESC").First(u)
+```
+
+> 实现原理：根据传入的类型，利用反射构造切片，调用 `Limit(1)` 限制返回的行数，调用 `Find` 方法获取到查询结果。
+
+## 4 测试
+
+接下来呢，我们在 `record_test.go` 中添加几个测试用例，检测功能是否正常。
+
+```go
+package session
+
+import "testing"
+
+var (
+	user1 = &User{"Tom", 18}
+	user2 = &User{"Sam", 25}
+	user3 = &User{"Jack", 25}
+)
+
+func testRecordInit(t *testing.T) *Session {
+	t.Helper()
+	s := NewSession().Model(&User{})
+	err1 := s.DropTable()
+	err2 := s.CreateTable()
+	_, err3 := s.Insert(user1, user2)
+	if err1 != nil || err2 != nil || err3 != nil {
+		t.Fatal("failed init test records")
+	}
+	return s
+}
+
+func TestSession_Limit(t *testing.T) {
+	s := testRecordInit(t)
+	var users []User
+	err := s.Limit(1).Find(&users)
+	if err != nil || len(users) != 1 {
+		t.Fatal("failed to query with limit condition")
+	}
+}
+
+func TestSession_Update(t *testing.T) {
+	s := testRecordInit(t)
+	affected, _ := s.Where("Name = ?", "Tom").Update("Age", 30)
+	u := &User{}
+	_ = s.OrderBy("Age DESC").First(u)
+
+	if affected != 1 || u.Age != 30 {
+		t.Fatal("failed to update")
+	}
+}
+
+func TestSession_DeleteAndCount(t *testing.T) {
+	s := testRecordInit(t)
+	affected, _ := s.Where("Name = ?", "Tom").Delete()
+	count, _ := s.Count()
+
+	if affected != 1 || count != 1 {
+		t.Fatal("failed to delete or count")
+	}
+}
+```
+
+## 附 推荐阅读
+
+- [Go 语言简明教程](https://geektutu.com/post/quick-golang.html)
+- [Go Test 单元测试简明教程](https://geektutu.com/post/quick-go-test.html)
+- [SQLite 常用命令速查表](https://geektutu.com/post/cheat-sheet-sqlite.html)
\ No newline at end of file
diff --git a/gee-orm/doc/geeorm-day5.md b/gee-orm/doc/geeorm-day5.md
index cbb86cd..e0bf9e2 100644
--- a/gee-orm/doc/geeorm-day5.md
+++ b/gee-orm/doc/geeorm-day5.md
@@ -1,6 +1,6 @@
 ---
 title: 动手写ORM框架 - GeeORM第五天 实现钩子(Hooks)
-date: 2020-03-03 23:00:00
+date: 2020-03-08 18:00:00
 description: 7天用 Go语言/golang 从零实现 ORM 框架 GeeORM 教程(7 days implement golang object relational mapping framework from scratch tutorial)，动手写 ORM 框架，参照 gorm, xorm 的实现。通过反射(reflect)获取结构体绑定的钩子(hooks)，并调用；支持增删查改(CRUD)前后调用钩子。
 tags:
 - Go
@@ -16,10 +16,140 @@ keywords:
 - BeforeUpdate
 image: post/geeorm/geeorm_sm.jpg
 github: https://github.com/geektutu/7days-golang
-published: false
 ---
 
 本文是[7天用Go从零实现ORM框架GeeORM](https://geektutu.com/post/geeorm.html)的第五篇。
 
 - 通过反射(reflect)获取结构体绑定的钩子(hooks)，并调用。
-- 支持增删查改(CRUD)前后调用钩子。
\ No newline at end of file
+- 支持增删查改(CRUD)前后调用钩子。**代码约50行**
+
+## 1 Hook 机制
+
+Hook，翻译为钩子，其主要思想是提前在可能增加功能的地方埋好(预设)一个钩子，当我们需要重新修改或者增加这个地方的逻辑的时候，把扩展的类或者方法挂载到这个点即可。钩子的应用非常广泛，例如 Github 支持的 travis 持续集成服务，当有 `git push` 事件发生时，会触发 travis 拉取新的代码进行构建。IDE 中钩子也非常常见，比如，当按下 `Ctrl + s` 后，自动格式化代码。再比如前端常用的 `hot reload` 机制，前端代码发生变更时，自动编译打包，通知浏览器自动刷新页面，实现所写即所得。
+
+钩子机制设计的好坏，取决于扩展点选择的是否合适。例如对于持续集成来说，代码如果不发生变更，反复构建是没有意义的，因此钩子应设计在代码可能发生变更的地方，比如 MR、PR 合并前后。
+
+那对于 ORM 框架来说，合适的扩展点在哪里呢？很显然，记录的增删查改前后都是非常合适的。
+
+比如，我们设计一个 `Account` 类，`Account` 包含有一个隐私字段 `Password`，那么每次查询后都需要做脱敏处理，才能继续使用。如果提供了 `AfterQuery` 的钩子，查询后，自动地将 `Password` 字段的值脱敏，是不是能省去很多冗余的代码呢？
+
+## 2 实现钩子
+
+GeeORM 的钩子与结构体绑定，即每个结构体需要实现各自的钩子。hook 相关的代码实现在 `session/hooks.go` 中。
+
+[day5-hooks/session/hooks.go](https://github.com/geektutu/7days-golang/tree/master/gee-orm/day5-hooks/session)
+
+```go
+package session
+
+import (
+	"geeorm/log"
+	"reflect"
+)
+
+// Hooks constants
+const (
+	BeforeQuery  = "BeforeQuery"
+	AfterQuery   = "AfterQuery"
+	BeforeUpdate = "BeforeUpdate"
+	AfterUpdate  = "AfterUpdate"
+	BeforeDelete = "BeforeDelete"
+	AfterDelete  = "AfterDelete"
+	BeforeInsert = "BeforeInsert"
+	AfterInsert  = "AfterInsert"
+)
+
+// CallMethod calls the registered hooks
+func (s *Session) CallMethod(method string, value interface{}) {
+	fm := reflect.ValueOf(s.RefTable().Model).MethodByName(method)
+	if value != nil {
+		fm = reflect.ValueOf(value).MethodByName(method)
+	}
+	param := []reflect.Value{reflect.ValueOf(s)}
+	if fm.IsValid() {
+		if v := fm.Call(param); len(v) > 0 {
+			if err, ok := v[0].Interface().(error); ok {
+				log.Error(err)
+			}
+		}
+	}
+	return
+}
+```
+
+- 钩子机制同样是通过反射来实现的，`s.RefTable().Model` 或 `value` 即当前会话正在操作的对象，使用 `MethodByName` 方法反射得到该对象的方法。
+- 将 `s *Session` 作为入参调用。每一个钩子的入参类型均是 `*Session`。
+
+接下来，将 `CallMethod()` 方法在 Find、Insert、Update、Delete 方法内部调用即可。例如，`Find` 方法修改为：
+
+```go
+// Find gets all eligible records
+func (s *Session) Find(values interface{}) error {
+	s.CallMethod(BeforeQuery, nil)
+    // ...
+    for rows.Next() {
+        dest := reflect.New(destType).Elem()
+        // ...
+        s.CallMethod(AfterQuery, dest.Addr().Interface())
+        // ...
+	}
+	return rows.Close()
+}
+```
+
+- `AfterQuery` 钩子可以操作每一行记录。
+
+## 3 测试
+
+新建 `session/hooks.go` 文件添加对应的测试用例。
+
+```go
+package session
+
+import (
+	"geeorm/log"
+	"testing"
+)
+
+type Account struct {
+	ID       int `geeorm:"PRIMARY KEY"`
+	Password string
+}
+
+func (account *Account) BeforeInsert(s *Session) error {
+	log.Info("before inert", account)
+	account.ID += 1000
+	return nil
+}
+
+func (account *Account) AfterQuery(s *Session) error {
+	log.Info("after query", account)
+	account.Password = "******"
+	return nil
+}
+
+func TestSession_CallMethod(t *testing.T) {
+	s := NewSession().Model(&Account{})
+	_ = s.DropTable()
+	_ = s.CreateTable()
+	_, _ = s.Insert(&Account{1, "123456"}, &Account{2, "qwerty"})
+
+	u := &Account{}
+
+	err := s.First(u)
+	if err != nil || u.ID != 1001 || u.Password != "******" {
+		t.Fatal("Failed to call hooks after query, got", u)
+	}
+}
+```
+
+在这个测试用例中，测试了 `BeforeInsert` 和 `AfterQuery` 2 个钩子。
+
+- `BeforeInsert` 将 account.ID 的值增加 1000
+- `AfterQuery` 将密码脱敏，显示为 6 个 `*`。
+
+## 附 推荐阅读
+
+- [Go 语言简明教程](https://geektutu.com/post/quick-golang.html)
+- [Go Test 单元测试简明教程](https://geektutu.com/post/quick-go-test.html)
+- [SQLite 常用命令速查表](https://geektutu.com/post/cheat-sheet-sqlite.html)
\ No newline at end of file
diff --git a/gee-orm/doc/geeorm-day6.md b/gee-orm/doc/geeorm-day6.md
index e6f6f03..37955d3 100644
--- a/gee-orm/doc/geeorm-day6.md
+++ b/gee-orm/doc/geeorm-day6.md
@@ -1,7 +1,7 @@
 ---
 title: 动手写ORM框架 - GeeORM第六天 支持事务(Transaction) 
-date: 2020-03-03 23:00:00
-description: 7天用 Go语言/golang 从零实现 ORM 框架 GeeORM 教程(7 days implement golang object relational mapping framework from scratch tutorial)，动手写 ORM 框架，参照 gorm, xorm 的实现。介绍 SQLite 数据库中的事务(transaction)；封装事务，用户自定义回调函数实现原子操作。
+date: 2020-03-08 21:00:00
+description: 7天用 Go语言/golang 从零实现 ORM 框架 GeeORM 教程(7 days implement golang object relational mapping framework from scratch tutorial)，动手写 ORM 框架，参照 gorm, xorm 的实现。介绍数据库中的事务(transaction)；封装事务，用户自定义回调函数实现原子操作。
 tags:
 - Go
 nav: 从零实现
@@ -15,10 +15,257 @@ keywords:
 - transaction
 image: post/geeorm/geeorm_sm.jpg
 github: https://github.com/geektutu/7days-golang
-published: false
 ---
 
 本文是[7天用Go从零实现ORM框架GeeORM](https://geektutu.com/post/geeorm.html)的第六篇。
 
-- 介绍 SQLite 数据库中的事务(transaction)。
-- 封装事务，用户自定义回调函数实现原子操作。
\ No newline at end of file
+- 介绍数据库中的事务(transaction)。
+- 封装事务，用户自定义回调函数实现原子操作。**代码约100行**
+
+## 1 事务的 ACID 属性
+
+> 数据库事务(transaction)是访问并可能操作各种数据项的一个数据库操作序列，这些操作要么全部执行,要么全部不执行，是一个不可分割的工作单位。事务由事务开始与事务结束之间执行的全部数据库操作组成。
+
+举一个简单的例子，转账。A 转账给 B 一万元，那么数据库至少需要执行 2 个操作：
+
+- 1）A 的账户减掉一万元。
+- 2）B 的账户增加一万元。
+
+这两个操作要么全部执行，代表转账成功。任意一个操作失败了，之前的操作都必须回退，代表转账失败。一个操作完成，另一个操作失败，这种结果是不能够接受的。这种场景就非常适合利用数据库事务的特性来解决。
+
+如果一个数据库支持事务，那么必须具备 ACID 四个属性。
+
+- 1）原子性(Atomicity)：事务中的全部操作在数据库中是不可分割的，要么全部完成，要么全部不执行。
+- 2）一致性(Consistency): 几个并行执行的事务，其执行结果必须与按某一顺序 串行执行的结果相一致。
+- 3）隔离性(Isolation)：事务的执行不受其他事务的干扰，事务执行的中间结果对其他事务必须是透明的。
+- 4）持久性(Durability)：对于任意已提交事务，系统必须保证该事务对数据库的改变不被丢失，即使数据库出现故障。
+
+## 2 SQLite 和 Go 标准库中的事务
+
+SQLite 中创建一个事务的原生 SQL 长什么样子呢？
+
+```sql
+sqlite> BEGIN;
+sqlite> DELETE FROM User WHERE Age > 25;
+sqlite> INSERT INTO User VALUES ("Tom", 25), ("Jack", 18);
+sqlite> COMMIT;
+```
+
+`BEGIN` 开启事务，`COMMIT` 提交事务，`ROLLBACK` 回滚事务。任何一个事务，均以 `BEGIN` 开始，`COMMIT` 或 `ROLLBACK` 结束。
+
+Go 语言标准库 database/sql 提供了支持事务的接口。用一个简单的例子，看一看 Go 语言标准是如何支持事务的。
+
+```go
+package main
+
+import (
+	"database/sql"
+	_ "github.com/mattn/go-sqlite3"
+	"log"
+)
+
+func main() {
+	db, _ := sql.Open("sqlite3", "gee.db")
+	defer func() { _ = db.Close() }()
+	_, _ = db.Exec("CREATE TABLE IF NOT EXISTS User(`Name` text);")
+
+	tx, _ := db.Begin()
+	_, err1 := tx.Exec("INSERT INTO User(`Name`) VALUES (?)", "Tom")
+	_, err2 := tx.Exec("INSERT INTO User(`Name`) VALUES (?)", "Jack")
+	if err1 != nil || err2 != nil {
+		_ = tx.Rollback()
+		log.Println("Rollback", err1, err2)
+	} else {
+		_ = tx.Commit()
+		log.Println("Commit")
+	}
+}
+```
+
+Go 语言中实现事务和 SQL 原生语句其实是非常接近的。调用 `db.Begin()` 得到 `*sql.Tx` 对象，使用 `tx.Exec()` 执行一系列操作，如果发生错误，通过 `tx.Rollback()` 回滚，如果没有发生错误，则通过 `tx.Commit()` 提交。
+
+## 3 GeeORM 支持事务
+
+GeeORM 之前的操作均是执行完即自动提交的，每个操作是相互独立的。之前直接使用 `sql.DB` 对象执行 SQL 语句，如果要支持事务，需要更改为 `sql.Tx` 执行。在 Session 结构体中新增成员变量 `tx *sql.Tx`，当 `tx` 不为空时，则使用 `tx` 执行 SQL 语句，否则使用 `db` 执行 SQL 语句。这样既兼容了原有的执行方式，又提供了对事务的支持。
+
+[day6-transaction/session/raw.go](https://github.com/geektutu/7days-golang/tree/master/gee-orm/day6-transaction/session)
+
+```go
+type Session struct {
+	db       *sql.DB
+	dialect  dialect.Dialect
+	tx       *sql.Tx
+	refTable *schema.Schema
+	clause   clause.Clause
+	sql      strings.Builder
+	sqlVars  []interface{}
+}
+
+// CommonDB is a minimal function set of db
+type CommonDB interface {
+	Query(query string, args ...interface{}) (*sql.Rows, error)
+	QueryRow(query string, args ...interface{}) *sql.Row
+	Exec(query string, args ...interface{}) (sql.Result, error)
+}
+
+var _ CommonDB = (*sql.DB)(nil)
+var _ CommonDB = (*sql.Tx)(nil)
+
+// DB returns tx if a tx begins. otherwise return *sql.DB
+func (s *Session) DB() CommonDB {
+	if s.tx != nil {
+		return s.tx
+	}
+	return s.db
+}
+```
+
+新建文件 `session/transaction.go` 封装事务的 Begin、Commit 和 Rollback 三个接口。
+
+[day6-transaction/session/transaction.go](https://github.com/geektutu/7days-golang/tree/master/gee-orm/day6-transaction/session)
+
+```go
+package session
+
+import "geeorm/log"
+
+func (s *Session) Begin() (err error) {
+	log.Info("transaction begin")
+	if s.tx, err = s.db.Begin(); err != nil {
+		log.Error(err)
+		return
+	}
+	return
+}
+
+func (s *Session) Commit() (err error) {
+	log.Info("transaction commit")
+	if err = s.tx.Commit(); err != nil {
+		log.Error(err)
+	}
+	return
+}
+
+func (s *Session) Rollback() (err error) {
+	log.Info("transaction rollback")
+	if err = s.tx.Rollback(); err != nil {
+		log.Error(err)
+	}
+	return
+}
+```
+
+- 调用 `s.db.Begin()` 得到 `*sql.Tx` 对象，赋值给 s.tx。
+- 封装的另一个目的是统一打印日志，方便定位问题。
+
+
+最后一步，在 `geeorm.go` 中为用户提供傻瓜式/一键式使用的接口。
+
+[day6-transaction/geeorm.go](https://github.com/geektutu/7days-golang/tree/master/gee-orm/day6-transaction)
+
+```go
+type TxFunc func(*session.Session) (interface{}, error)
+
+func (engine *Engine) Transaction(f TxFunc) (result interface{}, err error) {
+	s := engine.NewSession()
+	if err := s.Begin(); err != nil {
+		return nil, err
+	}
+	defer func() {
+		if p := recover(); p != nil {
+			_ = s.Rollback()
+			panic(p) // re-throw panic after Rollback
+		} else if err != nil {
+			_ = s.Rollback() // err is non-nil; don't change it
+		} else {
+			err = s.Commit() // err is nil; if Commit returns error update err
+		}
+	}()
+
+	return f(s)
+}
+```
+
+> Transaction 的实现参考了 [stackoverflow](https://stackoverflow.com/questions/16184238/database-sql-tx-detecting-commit-or-rollback)
+
+用户只需要将所有的操作放到一个回调函数中，作为入参传递给 `engine.Transaction()`，发生任何错误，自动回滚，如果没有错误发生，则提交。
+
+## 4 测试
+
+在 `geeorm_test.go` 中添加测试用例看看 Transaction 如何工作的吧。
+
+```go
+func OpenDB(t *testing.T) *Engine {
+	t.Helper()
+	engine, err := NewEngine("sqlite3", "gee.db")
+	if err != nil {
+		t.Fatal("failed to connect", err)
+	}
+	return engine
+}
+
+type User struct {
+	Name string `geeorm:"PRIMARY KEY"`
+	Age  int
+}
+
+func TestEngine_Transaction(t *testing.T) {
+	t.Run("rollback", func(t *testing.T) {
+		transactionRollback(t)
+	})
+	t.Run("commit", func(t *testing.T) {
+		transactionCommit(t)
+	})
+}
+```
+
+首先是 rollback 的用例：
+
+```go
+func transactionRollback(t *testing.T) {
+	engine := OpenDB(t)
+	defer engine.Close()
+	s := engine.NewSession()
+	_ = s.Model(&User{}).DropTable()
+	_, err := engine.Transaction(func(s *session.Session) (result interface{}, err error) {
+		_ = s.Model(&User{}).CreateTable()
+		_, err = s.Insert(&User{"Tom", 18})
+		return nil, errors.New("Error")
+	})
+	if err == nil || s.HasTable() {
+		t.Fatal("failed to rollback")
+	}
+}
+```
+
+- 在这个用例中，如何执行成功，则会创建一张表 `User`，并插入一条记录。
+- 故意返回了一个自定义 error，最终事务回滚，表创建失败。
+
+接下来是 commit 的用例：
+
+```go
+func transactionCommit(t *testing.T) {
+	engine := OpenDB(t)
+	defer engine.Close()
+	s := engine.NewSession()
+	_ = s.Model(&User{}).DropTable()
+	_, err := engine.Transaction(func(s *session.Session) (result interface{}, err error) {
+		_ = s.Model(&User{}).CreateTable()
+		_, err = s.Insert(&User{"Tom", 18})
+		return
+	})
+	u := &User{}
+	_ = s.First(u)
+	if err != nil || u.Name != "Tom" {
+		t.Fatal("failed to commit")
+	}
+}
+```
+
+- 创建表和插入记录均成功执行，最终通过 `s.First()` 方法查询到插入的记录。
+
+## 附 推荐阅读
+
+- [Go 语言简明教程](https://geektutu.com/post/quick-golang.html)
+- [Go Test 单元测试简明教程](https://geektutu.com/post/quick-go-test.html)
+- [SQLite 常用命令速查表](https://geektutu.com/post/cheat-sheet-sqlite.html)
\ No newline at end of file
diff --git a/gee-orm/doc/geeorm-day7.md b/gee-orm/doc/geeorm-day7.md
index 6e2bf40..44079fd 100644
--- a/gee-orm/doc/geeorm-day7.md
+++ b/gee-orm/doc/geeorm-day7.md
@@ -1,6 +1,6 @@
 ---
 title: 动手写ORM框架 - GeeORM第七天 数据库迁移(Migrate)
-date: 2020-03-03 23:00:00
+date: 2020-03-08 23:00:00
 description: 7天用 Go语言/golang 从零实现 ORM 框架 GeeORM 教程(7 days implement golang object relational mapping framework from scratch tutorial)，动手写 ORM 框架，参照 gorm, xorm 的实现。结构体(struct)变更时，数据库表的字段(field)自动迁移(migrate)；仅支持字段新增与删除，不支持字段类型变更。
 tags:
 - Go
@@ -15,10 +15,154 @@ keywords:
 - migrate
 image: post/geeorm/geeorm_sm.jpg
 github: https://github.com/geektutu/7days-golang
-published: false
 ---
 
 本文是[7天用Go从零实现ORM框架GeeORM](https://geektutu.com/post/geeorm.html)的第七篇。
 
 - 结构体(struct)变更时，数据库表的字段(field)自动迁移(migrate)。
-- 仅支持字段新增与删除，不支持字段类型变更。
\ No newline at end of file
+- 仅支持字段新增与删除，不支持字段类型变更。**代码约70行**
+
+## 1 使用 SQL 语句 Migrate
+
+数据库 Migrate 一直是数据库运维人员最为头痛的问题，如果仅仅是一张表增删字段还比较容易，那如果涉及到外键等复杂的关联关系，数据库的迁移就会变得非常困难。
+
+GeeORM 的 Migrate 操作仅针对最为简单的场景，即支持字段的新增与删除，不支持字段类型变更。
+
+在实现 Migrate 之前，我们先看看如何使用原生的 SQL 语句增删字段。
+
+### 1.1 新增字段
+
+```sql
+ALTER TABLE table_name ADD COLUMN col_name, col_type;
+```
+
+大部分数据支持使用 `ALTER` 关键字新增字段，或者重命名字段。
+
+### 1.2 删除字段
+
+> 参考 [sqlite delete or add column - stackoverflow](https://stackoverflow.com/questions/8442147/how-to-delete-or-add-column-in-sqlite)
+
+对于 SQLite 来说，删除字段并不像新增字段那么容易，一个比较可行的方法需要执行下列几个步骤：
+
+```sql
+CREATE TABLE new_table AS SELECT col1, col2, ... from old_table
+DROP TABLE old_table
+ALTER TABLE new_table RENAME TO old_table;
+```
+
+- 第一步：从 `old_table` 中挑选需要保留的字段到 `new_table` 中。
+- 第二步：删除 `old_table`。
+- 第三步：重命名 `new_table` 为 `old_table`。
+
+## 2 GeeORM 实现 Migrate
+
+按照原生的 SQL 命令，利用之前实现的事务，在 `geeorm.go` 中实现 Migrate 方法。
+
+```go
+// difference returns a - b
+func difference(a []string, b []string) (diff []string) {
+	mapB := make(map[string]bool)
+	for _, v := range b {
+		mapB[v] = true
+	}
+	for _, v := range a {
+		if _, ok := mapB[v]; !ok {
+			diff = append(diff, v)
+		}
+	}
+	return
+}
+
+// Migrate table
+func (engine *Engine) Migrate(value interface{}) error {
+	_, err := engine.Transaction(func(s *session.Session) (result interface{}, err error) {
+		if !s.Model(value).HasTable() {
+			log.Infof("table %s doesn't exist", s.RefTable().Name)
+			return nil, s.CreateTable()
+		}
+		table := s.RefTable()
+		rows, _ := s.Raw(fmt.Sprintf("SELECT * FROM %s LIMIT 1", table.Name)).QueryRows()
+		columns, _ := rows.Columns()
+		addCols := difference(table.FieldNames, columns)
+		delCols := difference(columns, table.FieldNames)
+		log.Infof("added cols %v, deleted cols %v", addCols, delCols)
+
+		for _, col := range addCols {
+			f := table.GetField(col)
+			sqlStr := fmt.Sprintf("ALTER TABLE %s ADD COLUMN %s %s;", table.Name, f.Name, f.Tag)
+			if _, err = s.Raw(sqlStr).Exec(); err != nil {
+				return
+			}
+		}
+
+		if len(delCols) == 0 {
+			return
+		}
+		tmp := "tmp_" + table.Name
+		fieldStr := strings.Join(table.FieldNames, ", ")
+		s.Raw(fmt.Sprintf("CREATE TABLE %s AS SELECT %s from %s;", tmp, fieldStr, table.Name))
+		s.Raw(fmt.Sprintf("DROP TABLE %s;", table.Name))
+		s.Raw(fmt.Sprintf("ALTER TABLE %s RENAME TO %s;", tmp, table.Name))
+		_, err = s.Exec()
+		return
+	})
+	return err
+}
+```
+
+- `difference` 用来计算前后两个字段切片的差集。新表 - 旧表 = 新增字段，旧表 - 新表 = 删除字段。
+- 使用 `ALTER` 语句新增字段。
+- 使用创建新表并重命名的方式删除字段。
+
+## 3 测试
+
+在 `geeorm_test.go` 中添加 Migrate 的测试用例：
+
+```go
+type User struct {
+	Name string `geeorm:"PRIMARY KEY"`
+	Age  int
+}
+
+func TestEngine_Migrate(t *testing.T) {
+	engine := OpenDB(t)
+	defer engine.Close()
+	s := engine.NewSession()
+	_, _ = s.Raw("DROP TABLE IF EXISTS User;").Exec()
+	_, _ = s.Raw("CREATE TABLE User(Name text PRIMARY KEY, XXX integer);").Exec()
+	_, _ = s.Raw("INSERT INTO User(`Name`) values (?), (?)", "Tom", "Sam").Exec()
+	engine.Migrate(&User{})
+
+	rows, _ := s.Raw("SELECT * FROM User").QueryRows()
+	columns, _ := rows.Columns()
+	if !reflect.DeepEqual(columns, []string{"Name", "Age"}) {
+		t.Fatal("Failed to migrate table User, got columns", columns)
+	}
+}
+```
+
+- 首先假设原有的 `User` 包含两个字段 `Name` 和 `XXX`，在一次业务变更之后，`User` 结构体的字段变更为 `Name` 和 `Age`。
+- 即需要删除原有字段 `XXX`，并新增字段 `Age`。
+- 调用 `Migrate(&User{})` 之后，新表的结构为 `Name`，`Age`
+
+## 4 总结
+
+GeeORM 的整体实现比较粗糙，比如数据库的迁移仅仅考虑了最简单的场景。实现的特性也比较少，比如结构体嵌套的场景，外键的场景，复合主键的场景都没有覆盖。ORM 框架的代码规模一般都比较大，如果想尽可能地逼近数据库，就需要大量的代码来实现相关的特性；二是数据库之间的差异也是比较大的，实现的功能越多，数据库之间的差异就会越突出，有时候为了达到较好的性能，就不得不为每个数据做特殊处理；还有些 ORM 框架同时支持关系型数据库和非关系型数据库，这就要求框架本身有更高层次的抽象，不能局限在 SQL 这一层。
+
+GeeORM 仅 800 左右的代码是不可能做到这一点的。不过，GeeORM 的目的并不是实现一个可以在生产使用的 ORM 框架，而是希望尽可能多地介绍 ORM 框架大致的实现原理，例如
+
+- 在框架中如何屏蔽不同数据库之间的差异；
+- 数据库中表结构和编程语言中的对象是如何映射的；
+- 如何优雅地模拟查询条件，链式调用是个不错的选择；
+- 为什么 ORM 框架通常会提供 hooks 扩展的能力；
+- 事务的原理和 ORM 框架如何集成对事务的支持；
+- 一些难点问题，例如数据库迁移。
+- ...
+
+基于这几点，我觉得 GeeORM 的目的达到了。
+
+## 附 推荐阅读
+
+- [Go Test 单元测试简明教程](https://geektutu.com/post/quick-go-test.html)
+- [SQLite 常用命令速查表](https://geektutu.com/post/cheat-sheet-sqlite.html)
+- [sqlite delete or add column - stackoverflow](https://stackoverflow.com/questions/8442147/how-to-delete-or-add-column-in-sqlite)
diff --git a/gee-orm/doc/geeorm.md b/gee-orm/doc/geeorm.md
index c25af6c..f9c14da 100644
--- a/gee-orm/doc/geeorm.md
+++ b/gee-orm/doc/geeorm.md
@@ -122,13 +122,13 @@ gorm 正在彻底重构 v1 版本，短期内看不到发布 v2 的可能。相
 
 ## 3 目录
 
-- 第一天：database/sql 基础 | [Code](https://github.com/geektutu/7days-golang/blob/master/gee-orm/day1-database-sql)
-- 第二天：对象表结构映射 | [Code](https://github.com/geektutu/7days-golang/blob/master/gee-orm/day2-reflect-schema)
-- 第三天：插入/查询记录 | [Code](https://github.com/geektutu/7days-golang/blob/master/gee-orm/day3-save-query)
-- 第四天：链式操作与更新删除 | [Code](https://github.com/geektutu/7days-golang/blob/master/gee-orm/day4-chain-operation)
-- 第五天：实现钩子(Hooks) | [Code](https://github.com/geektutu/7days-golang/blob/master/gee-orm/day5-hooks)
-- 第六天：支持事务(Transaction) | [Code](https://github.com/geektutu/7days-golang/blob/master/gee-orm/day6-transaction)
-- 第七天：数据库迁移(Migrate) | [Code](https://github.com/geektutu/7days-golang/blob/master/gee-orm/day7-migrate)
+- 第一天：[database/sql 基础](https://geektutu.com/post/geeorm-day1.html) | [Code](https://github.com/geektutu/7days-golang/blob/master/gee-orm/day1-database-sql)
+- 第二天：[对象表结构映射](https://geektutu.com/post/geeorm-day2.html) | [Code](https://github.com/geektutu/7days-golang/blob/master/gee-orm/day2-reflect-schema)
+- 第三天：[记录新增和查询](https://geektutu.com/post/geeorm-day3.html) | [Code](https://github.com/geektutu/7days-golang/blob/master/gee-orm/day3-save-query)
+- 第四天：[链式操作与更新删除](https://geektutu.com/post/geeorm-day4.html) | [Code](https://github.com/geektutu/7days-golang/blob/master/gee-orm/day4-chain-operation)
+- 第五天：[实现钩子(Hooks)](https://geektutu.com/post/geeorm-day5.html) | [Code](https://github.com/geektutu/7days-golang/blob/master/gee-orm/day5-hooks)
+- 第六天：[支持事务(Transaction)](https://geektutu.com/post/geeorm-day6.html) | [Code](https://github.com/geektutu/7days-golang/blob/master/gee-orm/day6-transaction)
+- 第七天：[数据库迁移(Migrate)](https://geektutu.com/post/geeorm-day7.html) | [Code](https://github.com/geektutu/7days-golang/blob/master/gee-orm/day7-migrate)
 
 
 ## 附 推荐阅读

From b9f5de709c2b5ce49405bfc5e45d2e9ce82f2c4b Mon Sep 17 00:00:00 2001
From: gzdaijie <gzdaijie@163.com>
Date: Mon, 9 Mar 2020 01:41:19 +0800
Subject: [PATCH 061/122] publish day3

---
 gee-orm/doc/geeorm-day3.md | 1 -
 1 file changed, 1 deletion(-)

diff --git a/gee-orm/doc/geeorm-day3.md b/gee-orm/doc/geeorm-day3.md
index ff089e1..85f5f6f 100644
--- a/gee-orm/doc/geeorm-day3.md
+++ b/gee-orm/doc/geeorm-day3.md
@@ -16,7 +16,6 @@ keywords:
 - select from
 image: post/geeorm/geeorm_sm.jpg
 github: https://github.com/geektutu/7days-golang
-published: false
 ---
 
 本文是[7天用Go从零实现ORM框架GeeORM](https://geektutu.com/post/geeorm.html)的第三篇。

From eaf66a3933f7d125a1e0f8ad4718293f3f2484f2 Mon Sep 17 00:00:00 2001
From: gzdaijie <gzdaijie@163.com>
Date: Sat, 14 Mar 2020 11:12:50 +0800
Subject: [PATCH 062/122] fix typo

---
 gee-cache/day1-lru/geecache/lru/lru.go             | 9 ++++-----
 gee-cache/day2-single-node/geecache/lru/lru.go     | 9 ++++-----
 gee-cache/day3-http-server/geecache/lru/lru.go     | 9 ++++-----
 gee-cache/day4-consistent-hash/geecache/lru/lru.go | 9 ++++-----
 gee-cache/day5-multi-nodes/geecache/lru/lru.go     | 9 ++++-----
 gee-cache/day6-single-flight/geecache/lru/lru.go   | 9 ++++-----
 gee-cache/day7-proto-buf/geecache/lru/lru.go       | 9 ++++-----
 gee-cache/doc/geecache-day1.md                     | 9 ++++-----
 gee-orm/day7-migrate/geeorm.go                     | 2 +-
 gee-orm/doc/geeorm-day7.md                         | 2 +-
 gee-web/doc/gee-day3.md                            | 2 +-
 11 files changed, 35 insertions(+), 43 deletions(-)

diff --git a/gee-cache/day1-lru/geecache/lru/lru.go b/gee-cache/day1-lru/geecache/lru/lru.go
index 6fa617a..dc1a317 100644
--- a/gee-cache/day1-lru/geecache/lru/lru.go
+++ b/gee-cache/day1-lru/geecache/lru/lru.go
@@ -39,12 +39,11 @@ func (c *Cache) Add(key string, value Value) {
 		kv := ele.Value.(*entry)
 		c.nbytes += int64(value.Len()) - int64(kv.value.Len())
 		kv.value = value
-		return
+	} else {
+		ele := c.ll.PushFront(&entry{key, value})
+		c.cache[key] = ele
+		c.nbytes += int64(len(key)) + int64(value.Len())
 	}
-	ele := c.ll.PushFront(&entry{key, value})
-	c.cache[key] = ele
-	c.nbytes += int64(len(key)) + int64(value.Len())
-
 	for c.maxBytes != 0 && c.maxBytes < c.nbytes {
 		c.RemoveOldest()
 	}
diff --git a/gee-cache/day2-single-node/geecache/lru/lru.go b/gee-cache/day2-single-node/geecache/lru/lru.go
index 6fa617a..dc1a317 100644
--- a/gee-cache/day2-single-node/geecache/lru/lru.go
+++ b/gee-cache/day2-single-node/geecache/lru/lru.go
@@ -39,12 +39,11 @@ func (c *Cache) Add(key string, value Value) {
 		kv := ele.Value.(*entry)
 		c.nbytes += int64(value.Len()) - int64(kv.value.Len())
 		kv.value = value
-		return
+	} else {
+		ele := c.ll.PushFront(&entry{key, value})
+		c.cache[key] = ele
+		c.nbytes += int64(len(key)) + int64(value.Len())
 	}
-	ele := c.ll.PushFront(&entry{key, value})
-	c.cache[key] = ele
-	c.nbytes += int64(len(key)) + int64(value.Len())
-
 	for c.maxBytes != 0 && c.maxBytes < c.nbytes {
 		c.RemoveOldest()
 	}
diff --git a/gee-cache/day3-http-server/geecache/lru/lru.go b/gee-cache/day3-http-server/geecache/lru/lru.go
index 6fa617a..dc1a317 100644
--- a/gee-cache/day3-http-server/geecache/lru/lru.go
+++ b/gee-cache/day3-http-server/geecache/lru/lru.go
@@ -39,12 +39,11 @@ func (c *Cache) Add(key string, value Value) {
 		kv := ele.Value.(*entry)
 		c.nbytes += int64(value.Len()) - int64(kv.value.Len())
 		kv.value = value
-		return
+	} else {
+		ele := c.ll.PushFront(&entry{key, value})
+		c.cache[key] = ele
+		c.nbytes += int64(len(key)) + int64(value.Len())
 	}
-	ele := c.ll.PushFront(&entry{key, value})
-	c.cache[key] = ele
-	c.nbytes += int64(len(key)) + int64(value.Len())
-
 	for c.maxBytes != 0 && c.maxBytes < c.nbytes {
 		c.RemoveOldest()
 	}
diff --git a/gee-cache/day4-consistent-hash/geecache/lru/lru.go b/gee-cache/day4-consistent-hash/geecache/lru/lru.go
index 6fa617a..dc1a317 100644
--- a/gee-cache/day4-consistent-hash/geecache/lru/lru.go
+++ b/gee-cache/day4-consistent-hash/geecache/lru/lru.go
@@ -39,12 +39,11 @@ func (c *Cache) Add(key string, value Value) {
 		kv := ele.Value.(*entry)
 		c.nbytes += int64(value.Len()) - int64(kv.value.Len())
 		kv.value = value
-		return
+	} else {
+		ele := c.ll.PushFront(&entry{key, value})
+		c.cache[key] = ele
+		c.nbytes += int64(len(key)) + int64(value.Len())
 	}
-	ele := c.ll.PushFront(&entry{key, value})
-	c.cache[key] = ele
-	c.nbytes += int64(len(key)) + int64(value.Len())
-
 	for c.maxBytes != 0 && c.maxBytes < c.nbytes {
 		c.RemoveOldest()
 	}
diff --git a/gee-cache/day5-multi-nodes/geecache/lru/lru.go b/gee-cache/day5-multi-nodes/geecache/lru/lru.go
index 6fa617a..dc1a317 100644
--- a/gee-cache/day5-multi-nodes/geecache/lru/lru.go
+++ b/gee-cache/day5-multi-nodes/geecache/lru/lru.go
@@ -39,12 +39,11 @@ func (c *Cache) Add(key string, value Value) {
 		kv := ele.Value.(*entry)
 		c.nbytes += int64(value.Len()) - int64(kv.value.Len())
 		kv.value = value
-		return
+	} else {
+		ele := c.ll.PushFront(&entry{key, value})
+		c.cache[key] = ele
+		c.nbytes += int64(len(key)) + int64(value.Len())
 	}
-	ele := c.ll.PushFront(&entry{key, value})
-	c.cache[key] = ele
-	c.nbytes += int64(len(key)) + int64(value.Len())
-
 	for c.maxBytes != 0 && c.maxBytes < c.nbytes {
 		c.RemoveOldest()
 	}
diff --git a/gee-cache/day6-single-flight/geecache/lru/lru.go b/gee-cache/day6-single-flight/geecache/lru/lru.go
index 6fa617a..dc1a317 100644
--- a/gee-cache/day6-single-flight/geecache/lru/lru.go
+++ b/gee-cache/day6-single-flight/geecache/lru/lru.go
@@ -39,12 +39,11 @@ func (c *Cache) Add(key string, value Value) {
 		kv := ele.Value.(*entry)
 		c.nbytes += int64(value.Len()) - int64(kv.value.Len())
 		kv.value = value
-		return
+	} else {
+		ele := c.ll.PushFront(&entry{key, value})
+		c.cache[key] = ele
+		c.nbytes += int64(len(key)) + int64(value.Len())
 	}
-	ele := c.ll.PushFront(&entry{key, value})
-	c.cache[key] = ele
-	c.nbytes += int64(len(key)) + int64(value.Len())
-
 	for c.maxBytes != 0 && c.maxBytes < c.nbytes {
 		c.RemoveOldest()
 	}
diff --git a/gee-cache/day7-proto-buf/geecache/lru/lru.go b/gee-cache/day7-proto-buf/geecache/lru/lru.go
index 6fa617a..dc1a317 100644
--- a/gee-cache/day7-proto-buf/geecache/lru/lru.go
+++ b/gee-cache/day7-proto-buf/geecache/lru/lru.go
@@ -39,12 +39,11 @@ func (c *Cache) Add(key string, value Value) {
 		kv := ele.Value.(*entry)
 		c.nbytes += int64(value.Len()) - int64(kv.value.Len())
 		kv.value = value
-		return
+	} else {
+		ele := c.ll.PushFront(&entry{key, value})
+		c.cache[key] = ele
+		c.nbytes += int64(len(key)) + int64(value.Len())
 	}
-	ele := c.ll.PushFront(&entry{key, value})
-	c.cache[key] = ele
-	c.nbytes += int64(len(key)) + int64(value.Len())
-
 	for c.maxBytes != 0 && c.maxBytes < c.nbytes {
 		c.RemoveOldest()
 	}
diff --git a/gee-cache/doc/geecache-day1.md b/gee-cache/doc/geecache-day1.md
index 064d90a..2f096d9 100644
--- a/gee-cache/doc/geecache-day1.md
+++ b/gee-cache/doc/geecache-day1.md
@@ -155,12 +155,11 @@ func (c *Cache) Add(key string, value Value) {
 		kv := ele.Value.(*entry)
 		c.nbytes += int64(value.Len()) - int64(kv.value.Len())
 		kv.value = value
-		return
+	} else {
+		ele := c.ll.PushFront(&entry{key, value})
+		c.cache[key] = ele
+		c.nbytes += int64(len(key)) + int64(value.Len())
 	}
-	ele := c.ll.PushFront(&entry{key, value})
-	c.cache[key] = ele
-	c.nbytes += int64(len(key)) + int64(value.Len())
-
 	for c.maxBytes != 0 && c.maxBytes < c.nbytes {
 		c.RemoveOldest()
 	}
diff --git a/gee-orm/day7-migrate/geeorm.go b/gee-orm/day7-migrate/geeorm.go
index 017d116..f9bbcd8 100644
--- a/gee-orm/day7-migrate/geeorm.go
+++ b/gee-orm/day7-migrate/geeorm.go
@@ -106,7 +106,7 @@ func (engine *Engine) Migrate(value interface{}) error {
 
 		for _, col := range addCols {
 			f := table.GetField(col)
-			sqlStr := fmt.Sprintf("ALTER TABLE %s ADD COLUMN %s %s;", table.Name, f.Name, f.Tag)
+			sqlStr := fmt.Sprintf("ALTER TABLE %s ADD COLUMN %s %s;", table.Name, f.Name, f.Type)
 			if _, err = s.Raw(sqlStr).Exec(); err != nil {
 				return
 			}
diff --git a/gee-orm/doc/geeorm-day7.md b/gee-orm/doc/geeorm-day7.md
index 44079fd..7e6dc1c 100644
--- a/gee-orm/doc/geeorm-day7.md
+++ b/gee-orm/doc/geeorm-day7.md
@@ -89,7 +89,7 @@ func (engine *Engine) Migrate(value interface{}) error {
 
 		for _, col := range addCols {
 			f := table.GetField(col)
-			sqlStr := fmt.Sprintf("ALTER TABLE %s ADD COLUMN %s %s;", table.Name, f.Name, f.Tag)
+			sqlStr := fmt.Sprintf("ALTER TABLE %s ADD COLUMN %s %s;", table.Name, f.Name, f.Type)
 			if _, err = s.Raw(sqlStr).Exec(); err != nil {
 				return
 			}
diff --git a/gee-web/doc/gee-day3.md b/gee-web/doc/gee-day3.md
index 4b34f6d..0d66e54 100644
--- a/gee-web/doc/gee-day3.md
+++ b/gee-web/doc/gee-day3.md
@@ -18,7 +18,7 @@ github: https://github.com/geektutu/7days-golang
 
 本文是 [7天用Go从零实现Web框架Gee教程系列](https://geektutu.com/post/gee.html)的第三篇。
 
-- 使用 Tire 树实现动态路由(dynamic route)解析。
+- 使用 Trie 树实现动态路由(dynamic route)解析。
 - 支持两种模式`:name`和`*filepath`，**代码约150行**。
 
 ## Trie 树简介

From d8451f920dee2b55a186d1af3187395f53e83697 Mon Sep 17 00:00:00 2001
From: chaunceyjiang <chaunceyiang@gmail.com>
Date: Mon, 23 Mar 2020 11:54:32 +0800
Subject: [PATCH 063/122] Add custom table name

---
 gee-orm/day2-reflect-schema/schema/schema.go     | 13 ++++++++++++-
 .../day2-reflect-schema/schema/schema_test.go    | 16 ++++++++++++++++
 gee-orm/day3-save-query/schema/schema.go         | 14 ++++++++++++--
 gee-orm/day3-save-query/schema/schema_test.go    | 16 ++++++++++++++++
 gee-orm/day4-chain-operation/schema/schema.go    | 14 ++++++++++++--
 .../day4-chain-operation/schema/schema_test.go   | 16 ++++++++++++++++
 gee-orm/day5-hooks/schema/schema.go              | 13 ++++++++++++-
 gee-orm/day5-hooks/schema/schema_test.go         | 16 ++++++++++++++++
 gee-orm/day6-transaction/schema/schema.go        | 14 ++++++++++++--
 gee-orm/day6-transaction/schema/schema_test.go   | 16 ++++++++++++++++
 gee-orm/day7-migrate/schema/schema.go            | 14 ++++++++++++--
 gee-orm/day7-migrate/schema/schema_test.go       | 16 ++++++++++++++++
 12 files changed, 168 insertions(+), 10 deletions(-)

diff --git a/gee-orm/day2-reflect-schema/schema/schema.go b/gee-orm/day2-reflect-schema/schema/schema.go
index ff76283..93d36da 100644
--- a/gee-orm/day2-reflect-schema/schema/schema.go
+++ b/gee-orm/day2-reflect-schema/schema/schema.go
@@ -37,12 +37,23 @@ func (schema *Schema) RecordValues(dest interface{}) []interface{} {
 	return fieldValues
 }
 
+type ITableName interface {
+	TableName() string
+}
+
 // Parse a struct to a Schema instance
 func Parse(dest interface{}, d dialect.Dialect) *Schema {
 	modelType := reflect.Indirect(reflect.ValueOf(dest)).Type()
+	var tableName string
+	t, ok := dest.(ITableName)
+	if !ok {
+		tableName = modelType.Name()
+	} else {
+		tableName = t.TableName()
+	}
 	schema := &Schema{
 		Model:    dest,
-		Name:     modelType.Name(),
+		Name:     tableName,
 		fieldMap: make(map[string]*Field),
 	}
 
diff --git a/gee-orm/day2-reflect-schema/schema/schema_test.go b/gee-orm/day2-reflect-schema/schema/schema_test.go
index 47ae9fc..8f625cb 100644
--- a/gee-orm/day2-reflect-schema/schema/schema_test.go
+++ b/gee-orm/day2-reflect-schema/schema/schema_test.go
@@ -33,3 +33,19 @@ func TestSchema_RecordValues(t *testing.T) {
 		t.Fatal("failed to get values")
 	}
 }
+
+type UserTest struct {
+	Name string `geeorm:"PRIMARY KEY"`
+	Age  int
+}
+
+func (u *UserTest) TableName() string {
+	return "ns_user_test"
+}
+
+func TestSchema_TableName(t *testing.T) {
+	schema := Parse(&UserTest{}, TestDial)
+	if schema.Name != "ns_user_test" || len(schema.Fields) != 2 {
+		t.Fatal("failed to parse User struct")
+	}
+}
diff --git a/gee-orm/day3-save-query/schema/schema.go b/gee-orm/day3-save-query/schema/schema.go
index ff76283..2c9b927 100644
--- a/gee-orm/day3-save-query/schema/schema.go
+++ b/gee-orm/day3-save-query/schema/schema.go
@@ -37,15 +37,25 @@ func (schema *Schema) RecordValues(dest interface{}) []interface{} {
 	return fieldValues
 }
 
+type ITableName interface {
+	TableName() string
+}
+
 // Parse a struct to a Schema instance
 func Parse(dest interface{}, d dialect.Dialect) *Schema {
 	modelType := reflect.Indirect(reflect.ValueOf(dest)).Type()
+	var tableName string
+	t, ok := dest.(ITableName)
+	if !ok {
+		tableName = modelType.Name()
+	} else {
+		tableName = t.TableName()
+	}
 	schema := &Schema{
 		Model:    dest,
-		Name:     modelType.Name(),
+		Name:     tableName,
 		fieldMap: make(map[string]*Field),
 	}
-
 	for i := 0; i < modelType.NumField(); i++ {
 		p := modelType.Field(i)
 		if !p.Anonymous && ast.IsExported(p.Name) {
diff --git a/gee-orm/day3-save-query/schema/schema_test.go b/gee-orm/day3-save-query/schema/schema_test.go
index 47ae9fc..8f625cb 100644
--- a/gee-orm/day3-save-query/schema/schema_test.go
+++ b/gee-orm/day3-save-query/schema/schema_test.go
@@ -33,3 +33,19 @@ func TestSchema_RecordValues(t *testing.T) {
 		t.Fatal("failed to get values")
 	}
 }
+
+type UserTest struct {
+	Name string `geeorm:"PRIMARY KEY"`
+	Age  int
+}
+
+func (u *UserTest) TableName() string {
+	return "ns_user_test"
+}
+
+func TestSchema_TableName(t *testing.T) {
+	schema := Parse(&UserTest{}, TestDial)
+	if schema.Name != "ns_user_test" || len(schema.Fields) != 2 {
+		t.Fatal("failed to parse User struct")
+	}
+}
diff --git a/gee-orm/day4-chain-operation/schema/schema.go b/gee-orm/day4-chain-operation/schema/schema.go
index ff76283..2c9b927 100644
--- a/gee-orm/day4-chain-operation/schema/schema.go
+++ b/gee-orm/day4-chain-operation/schema/schema.go
@@ -37,15 +37,25 @@ func (schema *Schema) RecordValues(dest interface{}) []interface{} {
 	return fieldValues
 }
 
+type ITableName interface {
+	TableName() string
+}
+
 // Parse a struct to a Schema instance
 func Parse(dest interface{}, d dialect.Dialect) *Schema {
 	modelType := reflect.Indirect(reflect.ValueOf(dest)).Type()
+	var tableName string
+	t, ok := dest.(ITableName)
+	if !ok {
+		tableName = modelType.Name()
+	} else {
+		tableName = t.TableName()
+	}
 	schema := &Schema{
 		Model:    dest,
-		Name:     modelType.Name(),
+		Name:     tableName,
 		fieldMap: make(map[string]*Field),
 	}
-
 	for i := 0; i < modelType.NumField(); i++ {
 		p := modelType.Field(i)
 		if !p.Anonymous && ast.IsExported(p.Name) {
diff --git a/gee-orm/day4-chain-operation/schema/schema_test.go b/gee-orm/day4-chain-operation/schema/schema_test.go
index 47ae9fc..8f625cb 100644
--- a/gee-orm/day4-chain-operation/schema/schema_test.go
+++ b/gee-orm/day4-chain-operation/schema/schema_test.go
@@ -33,3 +33,19 @@ func TestSchema_RecordValues(t *testing.T) {
 		t.Fatal("failed to get values")
 	}
 }
+
+type UserTest struct {
+	Name string `geeorm:"PRIMARY KEY"`
+	Age  int
+}
+
+func (u *UserTest) TableName() string {
+	return "ns_user_test"
+}
+
+func TestSchema_TableName(t *testing.T) {
+	schema := Parse(&UserTest{}, TestDial)
+	if schema.Name != "ns_user_test" || len(schema.Fields) != 2 {
+		t.Fatal("failed to parse User struct")
+	}
+}
diff --git a/gee-orm/day5-hooks/schema/schema.go b/gee-orm/day5-hooks/schema/schema.go
index ff76283..93d36da 100644
--- a/gee-orm/day5-hooks/schema/schema.go
+++ b/gee-orm/day5-hooks/schema/schema.go
@@ -37,12 +37,23 @@ func (schema *Schema) RecordValues(dest interface{}) []interface{} {
 	return fieldValues
 }
 
+type ITableName interface {
+	TableName() string
+}
+
 // Parse a struct to a Schema instance
 func Parse(dest interface{}, d dialect.Dialect) *Schema {
 	modelType := reflect.Indirect(reflect.ValueOf(dest)).Type()
+	var tableName string
+	t, ok := dest.(ITableName)
+	if !ok {
+		tableName = modelType.Name()
+	} else {
+		tableName = t.TableName()
+	}
 	schema := &Schema{
 		Model:    dest,
-		Name:     modelType.Name(),
+		Name:     tableName,
 		fieldMap: make(map[string]*Field),
 	}
 
diff --git a/gee-orm/day5-hooks/schema/schema_test.go b/gee-orm/day5-hooks/schema/schema_test.go
index 47ae9fc..8f625cb 100644
--- a/gee-orm/day5-hooks/schema/schema_test.go
+++ b/gee-orm/day5-hooks/schema/schema_test.go
@@ -33,3 +33,19 @@ func TestSchema_RecordValues(t *testing.T) {
 		t.Fatal("failed to get values")
 	}
 }
+
+type UserTest struct {
+	Name string `geeorm:"PRIMARY KEY"`
+	Age  int
+}
+
+func (u *UserTest) TableName() string {
+	return "ns_user_test"
+}
+
+func TestSchema_TableName(t *testing.T) {
+	schema := Parse(&UserTest{}, TestDial)
+	if schema.Name != "ns_user_test" || len(schema.Fields) != 2 {
+		t.Fatal("failed to parse User struct")
+	}
+}
diff --git a/gee-orm/day6-transaction/schema/schema.go b/gee-orm/day6-transaction/schema/schema.go
index ff76283..2c9b927 100644
--- a/gee-orm/day6-transaction/schema/schema.go
+++ b/gee-orm/day6-transaction/schema/schema.go
@@ -37,15 +37,25 @@ func (schema *Schema) RecordValues(dest interface{}) []interface{} {
 	return fieldValues
 }
 
+type ITableName interface {
+	TableName() string
+}
+
 // Parse a struct to a Schema instance
 func Parse(dest interface{}, d dialect.Dialect) *Schema {
 	modelType := reflect.Indirect(reflect.ValueOf(dest)).Type()
+	var tableName string
+	t, ok := dest.(ITableName)
+	if !ok {
+		tableName = modelType.Name()
+	} else {
+		tableName = t.TableName()
+	}
 	schema := &Schema{
 		Model:    dest,
-		Name:     modelType.Name(),
+		Name:     tableName,
 		fieldMap: make(map[string]*Field),
 	}
-
 	for i := 0; i < modelType.NumField(); i++ {
 		p := modelType.Field(i)
 		if !p.Anonymous && ast.IsExported(p.Name) {
diff --git a/gee-orm/day6-transaction/schema/schema_test.go b/gee-orm/day6-transaction/schema/schema_test.go
index 47ae9fc..8f625cb 100644
--- a/gee-orm/day6-transaction/schema/schema_test.go
+++ b/gee-orm/day6-transaction/schema/schema_test.go
@@ -33,3 +33,19 @@ func TestSchema_RecordValues(t *testing.T) {
 		t.Fatal("failed to get values")
 	}
 }
+
+type UserTest struct {
+	Name string `geeorm:"PRIMARY KEY"`
+	Age  int
+}
+
+func (u *UserTest) TableName() string {
+	return "ns_user_test"
+}
+
+func TestSchema_TableName(t *testing.T) {
+	schema := Parse(&UserTest{}, TestDial)
+	if schema.Name != "ns_user_test" || len(schema.Fields) != 2 {
+		t.Fatal("failed to parse User struct")
+	}
+}
diff --git a/gee-orm/day7-migrate/schema/schema.go b/gee-orm/day7-migrate/schema/schema.go
index ff76283..2c9b927 100644
--- a/gee-orm/day7-migrate/schema/schema.go
+++ b/gee-orm/day7-migrate/schema/schema.go
@@ -37,15 +37,25 @@ func (schema *Schema) RecordValues(dest interface{}) []interface{} {
 	return fieldValues
 }
 
+type ITableName interface {
+	TableName() string
+}
+
 // Parse a struct to a Schema instance
 func Parse(dest interface{}, d dialect.Dialect) *Schema {
 	modelType := reflect.Indirect(reflect.ValueOf(dest)).Type()
+	var tableName string
+	t, ok := dest.(ITableName)
+	if !ok {
+		tableName = modelType.Name()
+	} else {
+		tableName = t.TableName()
+	}
 	schema := &Schema{
 		Model:    dest,
-		Name:     modelType.Name(),
+		Name:     tableName,
 		fieldMap: make(map[string]*Field),
 	}
-
 	for i := 0; i < modelType.NumField(); i++ {
 		p := modelType.Field(i)
 		if !p.Anonymous && ast.IsExported(p.Name) {
diff --git a/gee-orm/day7-migrate/schema/schema_test.go b/gee-orm/day7-migrate/schema/schema_test.go
index 47ae9fc..8f625cb 100644
--- a/gee-orm/day7-migrate/schema/schema_test.go
+++ b/gee-orm/day7-migrate/schema/schema_test.go
@@ -33,3 +33,19 @@ func TestSchema_RecordValues(t *testing.T) {
 		t.Fatal("failed to get values")
 	}
 }
+
+type UserTest struct {
+	Name string `geeorm:"PRIMARY KEY"`
+	Age  int
+}
+
+func (u *UserTest) TableName() string {
+	return "ns_user_test"
+}
+
+func TestSchema_TableName(t *testing.T) {
+	schema := Parse(&UserTest{}, TestDial)
+	if schema.Name != "ns_user_test" || len(schema.Fields) != 2 {
+		t.Fatal("failed to parse User struct")
+	}
+}

From 09764a019e3322ce1eb3b9e4f6c5a0df6e2acb87 Mon Sep 17 00:00:00 2001
From: gzdaijie <gzdaijie@gmail.com>
Date: Sun, 29 Mar 2020 15:09:21 +0800
Subject: [PATCH 064/122] fix tire to trie

---
 README.md          | 4 ++--
 gee-web/README.md  | 2 +-
 gee-web/doc/gee.md | 2 +-
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/README.md b/README.md
index a85bc69..37d366d 100644
--- a/README.md
+++ b/README.md
@@ -18,7 +18,7 @@
 
 - 第一天：[前置知识(http.Handler接口)](https://geektutu.com/post/gee-day1.html) | [Code](gee-web/day1-http-base)
 - 第二天：[上下文设计(Context)](https://geektutu.com/post/gee-day2.html) | [Code](gee-web/day2-context)
-- 第三天：[Tire树路由(Router)](https://geektutu.com/post/gee-day3.html) | [Code](gee-web/day3-router)
+- 第三天：[Trie树路由(Router)](https://geektutu.com/post/gee-day3.html) | [Code](gee-web/day3-router)
 - 第四天：[分组控制(Group)](https://geektutu.com/post/gee-day4.html) | [Code](gee-web/day4-group)
 - 第五天：[中间件(Middleware)](https://geektutu.com/post/gee-day5.html) | [Code](gee-web/day5-middleware)
 - 第六天：[HTML模板(Template)](https://geektutu.com/post/gee-day6.html) | [Code](gee-web/day6-template)
@@ -70,7 +70,7 @@ What can I write in 7 days? A gin-like web framework? A distributed cache like g
 
 - Day 1 - http.Handler Interface Basic [Code](gee-web/day1-http-base)
 - Day 2 - Design a Flexiable Context [Code](gee-web/day2-context)
-- Day 3 - Router with Tire-Tree Algorithm [Code](gee-web/day3-router)
+- Day 3 - Router with Trie-Tree Algorithm [Code](gee-web/day3-router)
 - Day 4 - Group Control [Code](gee-web/day4-group)
 - Day 5 - Middleware Mechanism [Code](gee-web/day5-middleware)
 - Day 6 - Embeded Template Support [Code](gee-web/day6-template)
diff --git a/gee-web/README.md b/gee-web/README.md
index 67ccdf2..6e8f19b 100644
--- a/gee-web/README.md
+++ b/gee-web/README.md
@@ -12,7 +12,7 @@
 
 - [第一天：前置知识(http.Handler接口)](https://geektutu.com/post/gee-day1.html)
 - [第二天：上下文设计(Context)](https://geektutu.com/post/gee-day2.html)
-- [第三天：Tire树路由(Router)](https://geektutu.com/post/gee-day3.html)
+- [第三天：Trie树路由(Router)](https://geektutu.com/post/gee-day3.html)
 - [第四天：分组控制(Group)](https://geektutu.com/post/gee-day4.html)
 - [第五天：中间件(Middleware)](https://geektutu.com/post/gee-day5.html)
 - [第六天：HTML模板(Template)](https://geektutu.com/post/gee-day6.html)
diff --git a/gee-web/doc/gee.md b/gee-web/doc/gee.md
index 87e3a34..0596aaf 100644
--- a/gee-web/doc/gee.md
+++ b/gee-web/doc/gee.md
@@ -65,7 +65,7 @@ func handler(w http.ResponseWriter, r *http.Request) {
 
 - 第一天：[前置知识(http.Handler接口)](https://geektutu.com/post/gee-day1.html)，[Code - Github](https://github.com/geektutu/7days-golang/tree/master/gee-web/day1-http-base)
 - 第二天：[上下文设计(Context)](https://geektutu.com/post/gee-day2.html)，[Code - Github](https://github.com/geektutu/7days-golang/tree/master/gee-web/day2-context)
-- 第三天：[Tire树路由(Router)](https://geektutu.com/post/gee-day3.html)，[Code - Github](https://github.com/geektutu/7days-golang/tree/master/gee-web/day3-router)
+- 第三天：[Trie树路由(Router)](https://geektutu.com/post/gee-day3.html)，[Code - Github](https://github.com/geektutu/7days-golang/tree/master/gee-web/day3-router)
 - 第四天：[分组控制(Group)](https://geektutu.com/post/gee-day4.html)，[Code - Github](https://github.com/geektutu/7days-golang/tree/master/gee-web/day4-group)
 - 第五天：[中间件(Middleware)](https://geektutu.com/post/gee-day5.html)，[Code - Github](https://github.com/geektutu/7days-golang/tree/master/gee-web/day5-middleware)
 - 第六天：[HTML模板(Template)](https://geektutu.com/post/gee-day6.html)，[Code - Github](https://github.com/geektutu/7days-golang/tree/master/gee-web/day6-template)

From bd6ec6c992c538ec2ed806f6a3b44272f96376e4 Mon Sep 17 00:00:00 2001
From: gzdaijie <gzdaijie@gmail.com>
Date: Sun, 29 Mar 2020 22:24:42 +0800
Subject: [PATCH 065/122] init geebolt

---
 gee-bolt/day1-pages/go.mod  |  3 ++
 gee-bolt/day1-pages/meta.go | 33 ++++++++++++++
 gee-bolt/day1-pages/page.go | 88 +++++++++++++++++++++++++++++++++++++
 3 files changed, 124 insertions(+)
 create mode 100644 gee-bolt/day1-pages/go.mod
 create mode 100644 gee-bolt/day1-pages/meta.go
 create mode 100644 gee-bolt/day1-pages/page.go

diff --git a/gee-bolt/day1-pages/go.mod b/gee-bolt/day1-pages/go.mod
new file mode 100644
index 0000000..17b5990
--- /dev/null
+++ b/gee-bolt/day1-pages/go.mod
@@ -0,0 +1,3 @@
+module geebolt
+
+go 1.13
diff --git a/gee-bolt/day1-pages/meta.go b/gee-bolt/day1-pages/meta.go
new file mode 100644
index 0000000..4e9cdb1
--- /dev/null
+++ b/gee-bolt/day1-pages/meta.go
@@ -0,0 +1,33 @@
+package geebolt
+
+import (
+	"errors"
+	"hash/fnv"
+	"unsafe"
+)
+
+// Represent a marker value to indicate that a file is a gee-bolt DB
+const magic uint32 = 0xED0CDAED
+
+type meta struct {
+	magic    uint32
+	pageSize uint32
+	pgid     uint64
+	checksum uint64
+}
+
+func (m *meta) sum64() uint64 {
+	var h = fnv.New64a()
+	_, _ = h.Write((*[unsafe.Offsetof(meta{}.checksum)]byte)(unsafe.Pointer(m))[:])
+	return h.Sum64()
+}
+
+func (m *meta) validate() error {
+	if m.magic != magic {
+		return errors.New("invalid magic number")
+	}
+	if m.checksum != m.sum64() {
+		return errors.New("invalid checksum")
+	}
+	return nil
+}
diff --git a/gee-bolt/day1-pages/page.go b/gee-bolt/day1-pages/page.go
new file mode 100644
index 0000000..18fc492
--- /dev/null
+++ b/gee-bolt/day1-pages/page.go
@@ -0,0 +1,88 @@
+package geebolt
+
+import (
+	"fmt"
+	"reflect"
+	"unsafe"
+)
+
+const pageHeaderSize = unsafe.Sizeof(page{})
+const branchPageElementSize = unsafe.Sizeof(branchPageElement{})
+const leafPageElementSize = unsafe.Sizeof(leafPageElement{})
+const maxKeysPerPage = 1024
+
+const (
+	branchPageFlag uint16 = iota
+	leafPageFlag
+	metaPageFlag
+	freelistPageFlag
+)
+
+type page struct {
+	id       uint64
+	flags    uint16
+	count    uint16
+	overflow uint32
+}
+
+type leafPageElement struct {
+	pos   uint32
+	ksize uint32
+	vsize uint32
+}
+
+type branchPageElement struct {
+	pos   uint32
+	ksize uint32
+	pgid  uint64
+}
+
+func (p *page) typ() string {
+	switch p.flags {
+	case branchPageFlag:
+		return "branch"
+	case leafPageFlag:
+		return "leaf"
+	case metaPageFlag:
+		return "meta"
+	case freelistPageFlag:
+		return "freelist"
+	}
+	return fmt.Sprintf("unknown<%02x>", p.flags)
+}
+
+func (p *page) meta() *meta {
+	return (*meta)(unsafe.Pointer(uintptr(unsafe.Pointer(p)) + pageHeaderSize))
+}
+
+func (p *page) dataPtr() unsafe.Pointer {
+	return unsafe.Pointer(&reflect.SliceHeader{
+		Data: uintptr(unsafe.Pointer(p)) + pageHeaderSize,
+		Len:  int(p.count),
+		Cap:  int(p.count),
+	})
+}
+
+func (p *page) leafPageElement(index uint16) *leafPageElement {
+	off := pageHeaderSize + uintptr(index)*leafPageElementSize
+	return (*leafPageElement)(unsafe.Pointer(uintptr(unsafe.Pointer(p)) + off))
+}
+
+func (p *page) leafPageElements() []leafPageElement {
+	if p.count == 0 {
+		return nil
+	}
+	return *(*[]leafPageElement)(p.dataPtr())
+}
+
+func (p *page) branchPageElement(index uint16) *branchPageElement {
+	off := pageHeaderSize + uintptr(index)*branchPageElementSize
+	return (*branchPageElement)(unsafe.Pointer(uintptr(unsafe.Pointer(p)) + off))
+}
+
+func (p *page) branchPageElements() []branchPageElement {
+	if p.count == 0 {
+		return nil
+	}
+	return *(*[]branchPageElement)(p.dataPtr())
+}

From 7123e232f439741b6857354a98afb71f4d8808c5 Mon Sep 17 00:00:00 2001
From: singlemancombat <freeworld@Vincents-iMac.local>
Date: Tue, 31 Mar 2020 16:28:22 -0700
Subject: [PATCH 066/122] Remove redundant type conversion.

---
 gee-cache/day5-multi-nodes/main.go   | 2 +-
 gee-cache/day6-single-flight/main.go | 2 +-
 gee-cache/day7-proto-buf/main.go     | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/gee-cache/day5-multi-nodes/main.go b/gee-cache/day5-multi-nodes/main.go
index b8677f2..56abc7e 100644
--- a/gee-cache/day5-multi-nodes/main.go
+++ b/gee-cache/day5-multi-nodes/main.go
@@ -82,5 +82,5 @@ func main() {
 	if api {
 		go startAPIServer(apiAddr, gee)
 	}
-	startCacheServer(addrMap[port], []string(addrs), gee)
+	startCacheServer(addrMap[port], addrs, gee)
 }
diff --git a/gee-cache/day6-single-flight/main.go b/gee-cache/day6-single-flight/main.go
index b8677f2..56abc7e 100644
--- a/gee-cache/day6-single-flight/main.go
+++ b/gee-cache/day6-single-flight/main.go
@@ -82,5 +82,5 @@ func main() {
 	if api {
 		go startAPIServer(apiAddr, gee)
 	}
-	startCacheServer(addrMap[port], []string(addrs), gee)
+	startCacheServer(addrMap[port], addrs, gee)
 }
diff --git a/gee-cache/day7-proto-buf/main.go b/gee-cache/day7-proto-buf/main.go
index b8677f2..56abc7e 100644
--- a/gee-cache/day7-proto-buf/main.go
+++ b/gee-cache/day7-proto-buf/main.go
@@ -82,5 +82,5 @@ func main() {
 	if api {
 		go startAPIServer(apiAddr, gee)
 	}
-	startCacheServer(addrMap[port], []string(addrs), gee)
+	startCacheServer(addrMap[port], addrs, gee)
 }

From fb9b6cfadef3e9807bd8d9ed137484a28e4938bb Mon Sep 17 00:00:00 2001
From: singlemancombat <freeworld@Vincents-iMac.local>
Date: Wed, 1 Apr 2020 00:48:51 -0700
Subject: [PATCH 067/122] Return without info logging if failed to close
 database.

---
 gee-orm/day7-migrate/geeorm.go | 1 +
 1 file changed, 1 insertion(+)

diff --git a/gee-orm/day7-migrate/geeorm.go b/gee-orm/day7-migrate/geeorm.go
index f9bbcd8..fe6d477 100644
--- a/gee-orm/day7-migrate/geeorm.go
+++ b/gee-orm/day7-migrate/geeorm.go
@@ -43,6 +43,7 @@ func NewEngine(driver, source string) (e *Engine, err error) {
 func (engine *Engine) Close() {
 	if err := engine.db.Close(); err != nil {
 		log.Error("Failed to close database")
+		return
 	}
 	log.Info("Close database success")
 }

From d5509e03bb15a3dc8725acdc5aa821d80c008317 Mon Sep 17 00:00:00 2001
From: gzdaijie <gzdaijie@163.com>
Date: Mon, 20 Apr 2020 23:22:11 +0800
Subject: [PATCH 068/122] fix geecache typo

---
 gee-cache/doc/geecache-day2.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/gee-cache/doc/geecache-day2.md b/gee-cache/doc/geecache-day2.md
index c899111..7f75af8 100644
--- a/gee-cache/doc/geecache-day2.md
+++ b/gee-cache/doc/geecache-day2.md
@@ -217,7 +217,7 @@ geecache/
 
 ### 3.1 回调 Getter
 
-我们思考一下，如果缓存不存在，应从数据源（文件，数据库等）获取数据并添加到缓存中。GeeCache 是否应该支持多种数据源的配置呢？不应该，一是数据源的种类太多，没办法一一实现；而是扩展性不好。如何从源头获取数据，应该是用户决定的事情，我们就把这件事交给用户好了。因此，我们设计了一个回调函数(callback)，在缓存不存在时，调用这个函数，得到源数据。
+我们思考一下，如果缓存不存在，应从数据源（文件，数据库等）获取数据并添加到缓存中。GeeCache 是否应该支持多种数据源的配置呢？不应该，一是数据源的种类太多，没办法一一实现；二是扩展性不好。如何从源头获取数据，应该是用户决定的事情，我们就把这件事交给用户好了。因此，我们设计了一个回调函数(callback)，在缓存不存在时，调用这个函数，得到源数据。
 
 [day2-single-node/geecache/geecache.go - github](https://github.com/geektutu/7days-golang/tree/master/gee-cache/day2-single-node/geecache)
 

From 2d18404992d9414f3658cafb467a6a5a728ee0c7 Mon Sep 17 00:00:00 2001
From: gzdaijie <gzdaijie@gmail.com>
Date: Sun, 3 May 2020 18:52:50 +0800
Subject: [PATCH 069/122] geerpc init project, add feature: decode & encode
 args, reply

---
 gee-bolt/day2-mmap/db.go                  |  18 ++++
 gee-bolt/day2-mmap/go.mod                 |   3 +
 gee-bolt/day3-tree/go.mod                 |   3 +
 gee-bolt/day3-tree/meta.go                |  33 +++++++
 gee-bolt/day3-tree/node.go                |  53 ++++++++++
 gee-bolt/day3-tree/page.go                |  88 +++++++++++++++++
 gee-rpc/day1-encode/go.mod                |   3 +
 gee-rpc/day1-encode/protocol/codec.go     |  26 +++++
 gee-rpc/day1-encode/protocol/message.go   | 113 ++++++++++++++++++++++
 gee-rpc/day1-encode/protocol/path.go      |   3 +
 gee-rpc/day1-encode/server/server.go      |  76 +++++++++++++++
 gee-rpc/day1-encode/server/server_test.go |  76 +++++++++++++++
 gee-rpc/day1-encode/server/service.go     |  99 +++++++++++++++++++
 13 files changed, 594 insertions(+)
 create mode 100755 gee-bolt/day2-mmap/db.go
 create mode 100755 gee-bolt/day2-mmap/go.mod
 create mode 100755 gee-bolt/day3-tree/go.mod
 create mode 100644 gee-bolt/day3-tree/meta.go
 create mode 100755 gee-bolt/day3-tree/node.go
 create mode 100644 gee-bolt/day3-tree/page.go
 create mode 100644 gee-rpc/day1-encode/go.mod
 create mode 100755 gee-rpc/day1-encode/protocol/codec.go
 create mode 100755 gee-rpc/day1-encode/protocol/message.go
 create mode 100755 gee-rpc/day1-encode/protocol/path.go
 create mode 100755 gee-rpc/day1-encode/server/server.go
 create mode 100755 gee-rpc/day1-encode/server/server_test.go
 create mode 100755 gee-rpc/day1-encode/server/service.go

diff --git a/gee-bolt/day2-mmap/db.go b/gee-bolt/day2-mmap/db.go
new file mode 100755
index 0000000..9c644d1
--- /dev/null
+++ b/gee-bolt/day2-mmap/db.go
@@ -0,0 +1,18 @@
+package geebolt
+
+import "os"
+
+type DB struct {
+	data []byte
+	file *os.File
+}
+
+const maxMapSize = 1 << 31
+
+func (db *DB) mmap(sz int) error {
+	b, err := syscall.Mmap()
+}
+
+func Open(path string) {
+
+}
diff --git a/gee-bolt/day2-mmap/go.mod b/gee-bolt/day2-mmap/go.mod
new file mode 100755
index 0000000..17b5990
--- /dev/null
+++ b/gee-bolt/day2-mmap/go.mod
@@ -0,0 +1,3 @@
+module geebolt
+
+go 1.13
diff --git a/gee-bolt/day3-tree/go.mod b/gee-bolt/day3-tree/go.mod
new file mode 100755
index 0000000..17b5990
--- /dev/null
+++ b/gee-bolt/day3-tree/go.mod
@@ -0,0 +1,3 @@
+module geebolt
+
+go 1.13
diff --git a/gee-bolt/day3-tree/meta.go b/gee-bolt/day3-tree/meta.go
new file mode 100644
index 0000000..4e9cdb1
--- /dev/null
+++ b/gee-bolt/day3-tree/meta.go
@@ -0,0 +1,33 @@
+package geebolt
+
+import (
+	"errors"
+	"hash/fnv"
+	"unsafe"
+)
+
+// Represent a marker value to indicate that a file is a gee-bolt DB
+const magic uint32 = 0xED0CDAED
+
+type meta struct {
+	magic    uint32
+	pageSize uint32
+	pgid     uint64
+	checksum uint64
+}
+
+func (m *meta) sum64() uint64 {
+	var h = fnv.New64a()
+	_, _ = h.Write((*[unsafe.Offsetof(meta{}.checksum)]byte)(unsafe.Pointer(m))[:])
+	return h.Sum64()
+}
+
+func (m *meta) validate() error {
+	if m.magic != magic {
+		return errors.New("invalid magic number")
+	}
+	if m.checksum != m.sum64() {
+		return errors.New("invalid checksum")
+	}
+	return nil
+}
diff --git a/gee-bolt/day3-tree/node.go b/gee-bolt/day3-tree/node.go
new file mode 100755
index 0000000..a40c51a
--- /dev/null
+++ b/gee-bolt/day3-tree/node.go
@@ -0,0 +1,53 @@
+package geebolt
+
+import (
+	"bytes"
+	"sort"
+)
+
+type kv struct {
+	key   []byte
+	value []byte
+}
+
+type node struct {
+	isLeaf   bool
+	key      []byte
+	parent   *node
+	children []*node
+	kvs      []kv
+}
+
+func (n *node) root() *node {
+	if n.parent == nil {
+		return n
+	}
+	return n.parent.root()
+}
+
+func (n *node) index(key []byte) (index int, exact bool) {
+	index = sort.Search(len(n.kvs), func(i int) bool {
+		return bytes.Compare(n.kvs[i].key, key) != -1
+	})
+	exact = len(n.kvs) > 0 && index < len(n.kvs) && bytes.Equal(n.kvs[index].key, key)
+	return
+}
+
+func (n *node) put(oldKey, newKey, value []byte) {
+	index, exact := n.index(oldKey)
+	if !exact {
+		n.kvs = append(n.kvs, kv{})
+		copy(n.kvs[index+1:], n.kvs[index:])
+	}
+	kv := &n.kvs[index]
+	kv.key = newKey
+	kv.value = value
+}
+
+func (n *node) del(key []byte)  {
+	index, exact := n.index(key)
+	if exact {
+		n.kvs = append(n.kvs[:index], n.kvs[index+1:]...)
+	}
+}
+
diff --git a/gee-bolt/day3-tree/page.go b/gee-bolt/day3-tree/page.go
new file mode 100644
index 0000000..18fc492
--- /dev/null
+++ b/gee-bolt/day3-tree/page.go
@@ -0,0 +1,88 @@
+package geebolt
+
+import (
+	"fmt"
+	"reflect"
+	"unsafe"
+)
+
+const pageHeaderSize = unsafe.Sizeof(page{})
+const branchPageElementSize = unsafe.Sizeof(branchPageElement{})
+const leafPageElementSize = unsafe.Sizeof(leafPageElement{})
+const maxKeysPerPage = 1024
+
+const (
+	branchPageFlag uint16 = iota
+	leafPageFlag
+	metaPageFlag
+	freelistPageFlag
+)
+
+type page struct {
+	id       uint64
+	flags    uint16
+	count    uint16
+	overflow uint32
+}
+
+type leafPageElement struct {
+	pos   uint32
+	ksize uint32
+	vsize uint32
+}
+
+type branchPageElement struct {
+	pos   uint32
+	ksize uint32
+	pgid  uint64
+}
+
+func (p *page) typ() string {
+	switch p.flags {
+	case branchPageFlag:
+		return "branch"
+	case leafPageFlag:
+		return "leaf"
+	case metaPageFlag:
+		return "meta"
+	case freelistPageFlag:
+		return "freelist"
+	}
+	return fmt.Sprintf("unknown<%02x>", p.flags)
+}
+
+func (p *page) meta() *meta {
+	return (*meta)(unsafe.Pointer(uintptr(unsafe.Pointer(p)) + pageHeaderSize))
+}
+
+func (p *page) dataPtr() unsafe.Pointer {
+	return unsafe.Pointer(&reflect.SliceHeader{
+		Data: uintptr(unsafe.Pointer(p)) + pageHeaderSize,
+		Len:  int(p.count),
+		Cap:  int(p.count),
+	})
+}
+
+func (p *page) leafPageElement(index uint16) *leafPageElement {
+	off := pageHeaderSize + uintptr(index)*leafPageElementSize
+	return (*leafPageElement)(unsafe.Pointer(uintptr(unsafe.Pointer(p)) + off))
+}
+
+func (p *page) leafPageElements() []leafPageElement {
+	if p.count == 0 {
+		return nil
+	}
+	return *(*[]leafPageElement)(p.dataPtr())
+}
+
+func (p *page) branchPageElement(index uint16) *branchPageElement {
+	off := pageHeaderSize + uintptr(index)*branchPageElementSize
+	return (*branchPageElement)(unsafe.Pointer(uintptr(unsafe.Pointer(p)) + off))
+}
+
+func (p *page) branchPageElements() []branchPageElement {
+	if p.count == 0 {
+		return nil
+	}
+	return *(*[]branchPageElement)(p.dataPtr())
+}
diff --git a/gee-rpc/day1-encode/go.mod b/gee-rpc/day1-encode/go.mod
new file mode 100644
index 0000000..0ec8aeb
--- /dev/null
+++ b/gee-rpc/day1-encode/go.mod
@@ -0,0 +1,3 @@
+module geerpc
+
+go 1.13
diff --git a/gee-rpc/day1-encode/protocol/codec.go b/gee-rpc/day1-encode/protocol/codec.go
new file mode 100755
index 0000000..62b3b50
--- /dev/null
+++ b/gee-rpc/day1-encode/protocol/codec.go
@@ -0,0 +1,26 @@
+package protocol
+
+import (
+	"bytes"
+	"encoding/json"
+)
+
+type Codec interface {
+	Encode(i interface{}) ([]byte, error)
+	Decode(data []byte, i interface{}) error
+}
+
+// JSONCodec uses json marshaler and unmarshaler.
+type JSONCodec struct{}
+
+// Encode encodes an object into slice of bytes.
+func (c JSONCodec) Encode(i interface{}) ([]byte, error) {
+	return json.Marshal(i)
+}
+
+// Decode decodes an object from slice of bytes.
+func (c JSONCodec) Decode(data []byte, i interface{}) error {
+	d := json.NewDecoder(bytes.NewBuffer(data))
+	d.UseNumber()
+	return d.Decode(i)
+}
diff --git a/gee-rpc/day1-encode/protocol/message.go b/gee-rpc/day1-encode/protocol/message.go
new file mode 100755
index 0000000..08dd3ca
--- /dev/null
+++ b/gee-rpc/day1-encode/protocol/message.go
@@ -0,0 +1,113 @@
+package protocol
+
+import (
+	"bytes"
+	"encoding/binary"
+	"fmt"
+	"io"
+	"strings"
+)
+
+const MagicNumber int32 = 0xECABCD
+
+type SerializeType int8
+
+const (
+	JSON SerializeType = iota
+)
+
+var Codecs = map[SerializeType]Codec{
+	JSON: &JSONCodec{},
+}
+
+type Status int8
+
+const (
+	OK Status = iota
+	ExecError
+	NotFoundError
+)
+
+type Header struct {
+	Magic             int32
+	Status            Status
+	SerializeType     SerializeType
+	ServiceMethodSize int32
+	PayloadSize       int32
+}
+
+type Message struct {
+	*Header
+	ServiceMethod string
+	Payload       []byte
+}
+
+func NewMessage() *Message {
+	return &Message{
+		Header: &Header{Magic: MagicNumber},
+	}
+}
+
+func (m *Message) HandleError(status Status, err error) *Message {
+	m.Status = status
+	_ = m.SetPayload(err)
+	return m
+}
+
+func (m *Message) SetServiceMethod(name string) {
+	m.ServiceMethod = name
+}
+
+func (m *Message) GetServiceMethod() (service, method string, err error) {
+	parts := strings.Split(m.ServiceMethod, ".")
+	if len(parts) != 2 || parts[0] == "" || parts[1] == "" {
+		return "", "", fmt.Errorf("<service.method> format error")
+	}
+	return parts[0], parts[1], nil
+}
+
+func (m *Message) GetPayload(i interface{}) error {
+	return Codecs[m.SerializeType].Decode(m.Payload, i)
+}
+
+func (m *Message) SetPayload(i interface{}) (err error) {
+	m.Payload, err = Codecs[m.SerializeType].Encode(i)
+	return
+}
+
+func (m *Message) Clone() *Message {
+	m2 := NewMessage()
+	*m2.Header = *m.Header
+	m2.ServiceMethod = m.ServiceMethod
+	return m2
+}
+func Read(r io.Reader) (*Message, error) {
+	m := NewMessage()
+	if err := binary.Read(r, binary.BigEndian, m.Header); err != nil {
+		return nil, err
+	}
+	if m.Magic != MagicNumber {
+		return nil, fmt.Errorf("invalid message: wrong magic number")
+	}
+
+	buf := make([]byte, m.ServiceMethodSize+m.PayloadSize)
+	if err := binary.Read(r, binary.BigEndian, buf); err != nil {
+		return nil, err
+	}
+	m.ServiceMethod = string(buf[:m.ServiceMethodSize])
+	m.Payload = buf[m.ServiceMethodSize:]
+	return m, nil
+}
+func (m *Message) Write(w io.Writer) error {
+	m.PayloadSize = int32(len(m.Payload))
+	m.ServiceMethodSize = int32(len(m.ServiceMethod))
+	buf := bytes.NewBufferString(m.ServiceMethod)
+	buf.Write(m.Payload)
+	if err := binary.Write(w, binary.BigEndian, m.Header); err != nil {
+		return err
+	}
+	if err := binary.Write(w, binary.BigEndian, buf.Bytes()); err != nil {
+		return err
+	}
+	return nil
+}
diff --git a/gee-rpc/day1-encode/protocol/path.go b/gee-rpc/day1-encode/protocol/path.go
new file mode 100755
index 0000000..cbd854c
--- /dev/null
+++ b/gee-rpc/day1-encode/protocol/path.go
@@ -0,0 +1,3 @@
+package protocol
+
+const DefaultRPCPath = "/_geerpc"
diff --git a/gee-rpc/day1-encode/server/server.go b/gee-rpc/day1-encode/server/server.go
new file mode 100755
index 0000000..021b3ae
--- /dev/null
+++ b/gee-rpc/day1-encode/server/server.go
@@ -0,0 +1,76 @@
+package server
+
+import (
+	"fmt"
+	"log"
+	"net"
+	"net/http"
+
+	"geerpc/protocol"
+)
+
+type Server struct {
+	ln      net.Listener
+	service map[string]*service
+}
+
+func NewServer() *Server {
+	return &Server{
+		service: make(map[string]*service),
+	}
+}
+
+func (s *Server) Address() net.Addr {
+	return s.ln.Addr()
+}
+
+func (s *Server) Serve(network, address string) (err error) {
+	if network == "http" {
+		if s.ln, err = net.Listen("tcp", address); err != nil {
+			return err
+		}
+		http.Handle(protocol.DefaultRPCPath, s)
+		return http.Serve(s.ln, nil)
+	}
+	panic(network + " not support")
+}
+
+func (s *Server) ServeHTTP(w http.ResponseWriter, req *http.Request) {
+	m, err := protocol.Read(req.Body)
+	if err != nil {
+		log.Println("failed to read message from body")
+		_, _ = w.Write([]byte("fail"))
+		return
+	}
+
+	log.Println(req.Method, m.ServiceMethod)
+
+	respMsg := s.call(m)
+	_ = respMsg.Write(w)
+}
+
+func (s *Server) Register(receiver interface{}) {
+	service := newService(receiver)
+	s.service[service.name] = service
+}
+
+func (s *Server) call(req *protocol.Message) (resp *protocol.Message) {
+	serviceName, methodName, err := req.GetServiceMethod()
+	resp = req.Clone()
+	if err != nil {
+		return resp.HandleError(protocol.NotFoundError, err)
+	}
+
+	service := s.service[serviceName]
+	if service == nil || service.method[methodName] == nil {
+		return resp.HandleError(protocol.NotFoundError, fmt.Errorf("%s not found", req.ServiceMethod))
+	}
+
+	return service.call(methodName, req)
+}
+
+func _assert(condition bool, msg string, v ...interface{}) {
+	if !condition {
+		panic(fmt.Sprintf(msg, v...))
+	}
+}
diff --git a/gee-rpc/day1-encode/server/server_test.go b/gee-rpc/day1-encode/server/server_test.go
new file mode 100755
index 0000000..6aed5a5
--- /dev/null
+++ b/gee-rpc/day1-encode/server/server_test.go
@@ -0,0 +1,76 @@
+package server
+
+import (
+	"bytes"
+	"fmt"
+	"geerpc/protocol"
+	"net"
+	"net/http"
+	"testing"
+	"time"
+)
+
+type Calc struct{}
+
+type Req struct {
+	Num1 int
+	Num2 int
+}
+
+func (c *Calc) Add(req Req, reply *int) error {
+	*reply = req.Num1 + req.Num2
+	return nil
+}
+
+func TestServer_Register(t *testing.T) {
+	s := NewServer()
+	s.Register(&Calc{})
+
+	service := s.service["Calc"]
+	if service == nil || service.method["Add"] == nil {
+		t.Fatal("failed to register")
+	}
+}
+
+func TestServer_Call(t *testing.T) {
+	s := NewServer()
+	s.Register(&Calc{})
+	req := &Req{Num1: 10, Num2: 20}
+
+	reqMsg := protocol.NewMessage()
+	reqMsg.SetServiceMethod("Calc.Add")
+	_ = reqMsg.SetPayload(req)
+
+	respMsg := s.call(reqMsg)
+	var ans int
+	_ = respMsg.GetPayload(&ans)
+	if ans != req.Num1+req.Num2 {
+		t.Fatal("failed to call Calc.Add")
+	}
+}
+
+func TestServer_Serve(t *testing.T) {
+	s := NewServer()
+	s.Register(&Calc{})
+	go func() { _ = s.Serve("http", ":0") }()
+
+	time.Sleep(time.Second)
+	port := s.Address().(*net.TCPAddr).Port
+	addr := fmt.Sprintf("http://localhost:%d%s", port, protocol.DefaultRPCPath)
+
+	reqMsg := protocol.NewMessage()
+	reqMsg.SetServiceMethod("Calc.Add")
+	_ = reqMsg.SetPayload(&Req{1, 2})
+
+	var buf bytes.Buffer
+	_ = reqMsg.Write(&buf)
+	resp, _ := http.Post(addr, "application/octet-stream", &buf)
+
+	respMsg, _ := protocol.Read(resp.Body)
+
+	var ans int
+	_ = respMsg.GetPayload(&ans)
+	if respMsg.Status != protocol.OK || ans != 3 {
+		t.Fatal("failed to call Calc.Add")
+	}
+}
diff --git a/gee-rpc/day1-encode/server/service.go b/gee-rpc/day1-encode/server/service.go
new file mode 100755
index 0000000..2cc506b
--- /dev/null
+++ b/gee-rpc/day1-encode/server/service.go
@@ -0,0 +1,99 @@
+package server
+
+import (
+	"geerpc/protocol"
+	"go/ast"
+	"log"
+	"reflect"
+)
+
+type methodType struct {
+	method    reflect.Method
+	ArgType   reflect.Type
+	ReplyType reflect.Type
+}
+
+func (m *methodType) NewArg() interface{} {
+	return newTypeInter(m.ArgType)
+}
+
+func (m *methodType) NewReply() interface{} {
+	return newTypeInter(m.ReplyType)
+}
+
+func newTypeInter(t reflect.Type) interface{} {
+	var v reflect.Value
+	if t.Kind() == reflect.Ptr { // reply must be ptr
+		v = reflect.New(t.Elem())
+	} else {
+		v = reflect.New(t)
+	}
+	return v.Interface()
+}
+
+type service struct {
+	name   string
+	rcvr   reflect.Value
+	method map[string]*methodType
+}
+
+func newService(receiver interface{}) *service {
+	service := new(service)
+	service.method = make(map[string]*methodType)
+	service.name = reflect.Indirect(reflect.ValueOf(receiver)).Type().Name()
+	service.rcvr = reflect.ValueOf(receiver)
+
+	_assert(ast.IsExported(service.name), "%service is not exported", service.name)
+	rcvrType := reflect.TypeOf(receiver)
+	for i := 0; i < rcvrType.NumMethod(); i++ {
+		method := rcvrType.Method(i)
+		mType := method.Type
+		if mType.NumIn() != 3 || mType.NumOut() != 1 {
+			continue
+		}
+		if mType.Out(0) != reflect.TypeOf((*error)(nil)).Elem() {
+			continue
+		}
+
+		argType, replyType := mType.In(1), mType.In(2)
+		if !isExportedOrBuiltinType(argType) || !isExportedOrBuiltinType(replyType) {
+			continue
+		}
+
+		service.method[method.Name] = &methodType{
+			method:    method,
+			ArgType:   argType,
+			ReplyType: replyType,
+		}
+		log.Printf("Register %s.%s\n", service.name, method.Name)
+	}
+
+	return service
+}
+
+func (s *service) call(methodName string, reqMsg *protocol.Message) (resp *protocol.Message) {
+	mType := s.method[methodName]
+	resp = reqMsg.Clone()
+
+	arg, reply := mType.NewArg(), mType.NewReply()
+	if err := reqMsg.GetPayload(arg); err != nil {
+		return resp.HandleError(protocol.ExecError, err)
+	}
+
+	f := mType.method.Func
+	returnValues := f.Call([]reflect.Value{s.rcvr, reflect.ValueOf(arg).Elem(), reflect.ValueOf(reply)})
+
+	if errInter := returnValues[0].Interface(); errInter != nil {
+		return resp.HandleError(protocol.ExecError, errInter.(error))
+	}
+
+	if err := resp.SetPayload(reply); err != nil {
+		return resp.HandleError(protocol.ExecError, err)
+	}
+
+	return resp
+}
+
+func isExportedOrBuiltinType(t reflect.Type) bool {
+	return ast.IsExported(t.Name()) || t.PkgPath() == ""
+}

From 9aae5955bc400655843e51bae0e6c992bc769903 Mon Sep 17 00:00:00 2001
From: gzdaijie <gzdaijie@163.com>
Date: Sat, 16 May 2020 10:43:00 +0800
Subject: [PATCH 070/122] change top pos

---
 gee-cache/doc/geecache.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/gee-cache/doc/geecache.md b/gee-cache/doc/geecache.md
index 3eb89ad..ab0219b 100644
--- a/gee-cache/doc/geecache.md
+++ b/gee-cache/doc/geecache.md
@@ -11,6 +11,7 @@ keywords:
 - Go语言
 - 从零实现分布式缓存
 - 动手写分布式缓存
+top: 2
 image: post/geecache/geecache_sm.jpg
 github: https://github.com/geektutu/7days-golang
 ---

From 21f733ba6d69dbc722821db5eb42a769f40a41cc Mon Sep 17 00:00:00 2001
From: gzdaijie <gzdaijie@163.com>
Date: Sat, 16 May 2020 10:45:11 +0800
Subject: [PATCH 071/122] change top pos

---
 gee-cache/doc/geecache.md | 1 -
 1 file changed, 1 deletion(-)

diff --git a/gee-cache/doc/geecache.md b/gee-cache/doc/geecache.md
index ab0219b..3eb89ad 100644
--- a/gee-cache/doc/geecache.md
+++ b/gee-cache/doc/geecache.md
@@ -11,7 +11,6 @@ keywords:
 - Go语言
 - 从零实现分布式缓存
 - 动手写分布式缓存
-top: 2
 image: post/geecache/geecache_sm.jpg
 github: https://github.com/geektutu/7days-golang
 ---

From b4651d23b0f213e550c2af4c3cd07cbd76de0657 Mon Sep 17 00:00:00 2001
From: gzdaijie <gzdaijie@gmail.com>
Date: Wed, 30 Sep 2020 01:04:47 +0800
Subject: [PATCH 072/122] add codec & server code for gee-rpc

---
 gee-rpc/day1-codec/codec/codec.go          |  39 ++++++
 gee-rpc/day1-codec/codec/gob.go            |  57 ++++++++
 gee-rpc/{day1-encode => day1-codec}/go.mod |   0
 gee-rpc/day1-codec/main/main.go            |  52 ++++++++
 gee-rpc/day1-codec/server.go               | 144 +++++++++++++++++++++
 gee-rpc/day1-encode/protocol/codec.go      |  26 ----
 gee-rpc/day1-encode/protocol/message.go    | 113 ----------------
 gee-rpc/day1-encode/protocol/path.go       |   3 -
 gee-rpc/day1-encode/server/server.go       |  76 -----------
 gee-rpc/day1-encode/server/server_test.go  |  76 -----------
 gee-rpc/day1-encode/server/service.go      |  99 --------------
 gee-rpc/day3-service/service.go            |  96 ++++++++++++++
 12 files changed, 388 insertions(+), 393 deletions(-)
 create mode 100644 gee-rpc/day1-codec/codec/codec.go
 create mode 100644 gee-rpc/day1-codec/codec/gob.go
 rename gee-rpc/{day1-encode => day1-codec}/go.mod (100%)
 create mode 100644 gee-rpc/day1-codec/main/main.go
 create mode 100644 gee-rpc/day1-codec/server.go
 delete mode 100755 gee-rpc/day1-encode/protocol/codec.go
 delete mode 100755 gee-rpc/day1-encode/protocol/message.go
 delete mode 100755 gee-rpc/day1-encode/protocol/path.go
 delete mode 100755 gee-rpc/day1-encode/server/server.go
 delete mode 100755 gee-rpc/day1-encode/server/server_test.go
 delete mode 100755 gee-rpc/day1-encode/server/service.go
 create mode 100644 gee-rpc/day3-service/service.go

diff --git a/gee-rpc/day1-codec/codec/codec.go b/gee-rpc/day1-codec/codec/codec.go
new file mode 100644
index 0000000..54d2e56
--- /dev/null
+++ b/gee-rpc/day1-codec/codec/codec.go
@@ -0,0 +1,39 @@
+package codec
+
+import (
+	"io"
+	"sync"
+)
+
+type Header struct {
+	ServiceMethod string // format "Service.Method"
+	Seq           uint64 // sequence number chosen by client
+	Error         string
+}
+
+var HeaderPool = sync.Pool{
+	New: func() interface{} { return &Header{} },
+}
+
+type Codec interface {
+	io.Closer
+	ReadHeader(*Header) error
+	ReadBody(interface{}) error
+	Write(*Header, interface{}) error
+}
+
+type NewCodecFunc func(io.ReadWriteCloser) Codec
+
+type Type string
+
+const (
+	GobType  Type = "application/gob"
+	JsonType Type = "application/json"
+)
+
+var NewCodecFuncMap map[Type]NewCodecFunc
+
+func init() {
+	NewCodecFuncMap = make(map[Type]NewCodecFunc)
+	NewCodecFuncMap[GobType] = NewGobCodec
+}
diff --git a/gee-rpc/day1-codec/codec/gob.go b/gee-rpc/day1-codec/codec/gob.go
new file mode 100644
index 0000000..808d97b
--- /dev/null
+++ b/gee-rpc/day1-codec/codec/gob.go
@@ -0,0 +1,57 @@
+package codec
+
+import (
+	"bufio"
+	"encoding/gob"
+	"io"
+	"log"
+)
+
+type GobCodec struct {
+	conn io.ReadWriteCloser
+	buf  *bufio.Writer
+	dec  *gob.Decoder
+	enc  *gob.Encoder
+}
+
+var _ Codec = (*GobCodec)(nil)
+
+func NewGobCodec(conn io.ReadWriteCloser) Codec {
+	buf := bufio.NewWriter(conn)
+	return &GobCodec{
+		conn: conn,
+		buf:  buf,
+		dec:  gob.NewDecoder(conn),
+		enc:  gob.NewEncoder(buf),
+	}
+}
+
+func (c *GobCodec) ReadHeader(h *Header) error {
+	return c.dec.Decode(h)
+}
+
+func (c *GobCodec) ReadBody(body interface{}) error {
+	return c.dec.Decode(body)
+}
+
+func (c *GobCodec) Write(h *Header, body interface{}) (err error) {
+	defer func() {
+		_ = c.buf.Flush()
+		if err != nil {
+			_ = c.Close()
+		}
+	}()
+	if err := c.enc.Encode(h); err != nil {
+		log.Println("rpc: gob error encoding header:", err)
+		return err
+	}
+	if err := c.enc.Encode(body); err != nil {
+		log.Println("rpc: gob error encoding body:", err)
+		return err
+	}
+	return nil
+}
+
+func (c *GobCodec) Close() error {
+	return c.conn.Close()
+}
diff --git a/gee-rpc/day1-encode/go.mod b/gee-rpc/day1-codec/go.mod
similarity index 100%
rename from gee-rpc/day1-encode/go.mod
rename to gee-rpc/day1-codec/go.mod
diff --git a/gee-rpc/day1-codec/main/main.go b/gee-rpc/day1-codec/main/main.go
new file mode 100644
index 0000000..96f2273
--- /dev/null
+++ b/gee-rpc/day1-codec/main/main.go
@@ -0,0 +1,52 @@
+package main
+
+import (
+	"encoding/json"
+	"fmt"
+	"geerpc"
+	"geerpc/codec"
+	"log"
+	"net"
+	"net/http"
+	"time"
+)
+
+func startServer() {
+	l, err := net.Listen("tcp", ":9999")
+	if err != nil {
+		log.Panic("network error:", err)
+	}
+	geerpc.Accept(l)
+
+}
+
+func main() {
+	log.SetPrefix("")
+	go startServer()
+	time.Sleep(time.Second)
+
+	// In fact, following code is like a simple GeeRPC Client
+	conn, _ := net.Dial("tcp", ":9999")
+	defer func() { _ = conn.Close() }()
+
+	// negotiate options
+	_ = json.NewEncoder(conn).Encode(&geerpc.Options{
+		MagicNumber: geerpc.MagicNumber,
+		CodecType:   codec.GobType,
+	})
+
+	cc := codec.NewGobCodec(conn)
+	// send request & receive response
+	for i := 0; i < 3; i++ {
+		h := &codec.Header{
+			ServiceMethod: "Foo.Sum",
+			Seq:           uint64(i),
+		}
+		_ = cc.Write(h, fmt.Sprintf("geerpc req %d", h.Seq))
+		_ = cc.ReadHeader(h)
+		var reply string
+		_ = cc.ReadBody(&reply)
+		log.Println("reply:", reply)
+	}
+	log.Fatal(http.ListenAndServe(":9999", nil))
+}
diff --git a/gee-rpc/day1-codec/server.go b/gee-rpc/day1-codec/server.go
new file mode 100644
index 0000000..3e32f1f
--- /dev/null
+++ b/gee-rpc/day1-codec/server.go
@@ -0,0 +1,144 @@
+package geerpc
+
+import (
+	"encoding/json"
+	"fmt"
+	"geerpc/codec"
+	"io"
+	"log"
+	"net"
+	"sync"
+)
+
+type Server struct{}
+
+const MagicNumber = 0x3bef5c
+
+type Options struct {
+	MagicNumber int        // MagicNumber marks this's a geerpc request
+	CodecType   codec.Type // client may choose different Codec to encode body
+}
+
+func newServer() *Server {
+	return &Server{}
+}
+
+var DefaultServer = newServer()
+
+func (server *Server) ServeConn(conn io.ReadWriteCloser) {
+	defer func() { _ = conn.Close() }()
+	var opt Options
+	if err := json.NewDecoder(conn).Decode(&opt); err != nil {
+		log.Println("rpc server: options error: ", err)
+		return
+	}
+	if opt.MagicNumber != MagicNumber {
+		log.Printf("rpc server: invalid magic number %x", opt.MagicNumber)
+		return
+	}
+	f := codec.NewCodecFuncMap[opt.CodecType]
+	if f == nil {
+		log.Printf("rpc server: invalid codec type %s", opt.CodecType)
+		return
+	}
+	server.ServeCodec(f(conn))
+}
+
+// request stores all information of a call
+type request struct {
+	h    *codec.Header // header of request argv
+	argv string        // TODO suppose argv is a string
+}
+
+var requestPool = sync.Pool{
+	New: func() interface{} { return &request{} },
+}
+
+func (server *Server) readRequestHeader(cc codec.Codec) (req *request, keepReading bool, err error) {
+	req, _ = requestPool.Get().(*request)
+	h, _ := codec.HeaderPool.Get().(*codec.Header)
+	if err = cc.ReadHeader(h); err != nil {
+		log.Println("rpc server: read header error:", err)
+		return
+	}
+	// We read the header successfully. If we see an error now,
+	// we can still recover and move on to the next request.
+	keepReading = true
+	req.h = h
+	return
+}
+
+func (server *Server) readRequest(cc codec.Codec) (req *request, keepReading bool, err error) {
+	req, keepReading, err = server.readRequestHeader(cc)
+	if err != nil {
+		// discard argv
+		_ = cc.ReadBody(nil)
+		return
+	}
+
+	// We read the header successfully. If we see an error now,
+	// we can still recover and move on to the next request.
+	keepReading = true
+
+	// TODO: suppose argv is a string, now we can't judge the type of request argv
+	var str string
+	if err = cc.ReadBody(&str); err != nil {
+		log.Println("rpc server: read argv err:", err)
+	}
+	req.argv = str
+	return
+}
+
+func (server *Server) sendResponse(cc codec.Codec, h *codec.Header, body interface{}, sending *sync.Mutex) {
+	sending.Lock()
+	defer sending.Unlock()
+	if err := cc.Write(h, body); err != nil {
+		log.Println("rpc server: write response error:", err)
+	}
+}
+
+func (server *Server) Handle(cc codec.Codec, req *request, sending *sync.Mutex, wg *sync.WaitGroup) {
+	// TODO, should call registered rpc methods
+	// day 1 just print argv and send a hello message
+	defer wg.Done()
+	log.Println(req.h, req.argv)
+	server.sendResponse(cc, req.h, fmt.Sprintf("geerpc resp %d", req.h.Seq), sending)
+}
+
+// invalidRequest is a placeholder for response argv when error occurs
+var invalidRequest = struct{}{}
+
+func (server *Server) ServeCodec(cc codec.Codec) {
+	sending := new(sync.Mutex) // ensure header and argv is not separated by other response
+	wg := new(sync.WaitGroup)  // wait until all request are handled
+	for {
+		req, keepReading, err := server.readRequest(cc)
+		if err != nil {
+			if !keepReading {
+				break // it's not possible to recover, so close the connection
+			}
+			if req != nil {
+				req.h.Error = err.Error()
+				server.sendResponse(cc, req.h, invalidRequest, sending)
+			}
+			continue
+		}
+		wg.Add(1)
+		go server.Handle(cc, req, sending, wg)
+	}
+	wg.Wait()
+	_ = cc.Close()
+}
+
+func (server *Server) Accept(lis net.Listener) {
+	for {
+		conn, err := lis.Accept()
+		if err != nil {
+			log.Println("rpc server: accept error:", err)
+			return
+		}
+		go server.ServeConn(conn)
+	}
+}
+
+func Accept(lis net.Listener) { DefaultServer.Accept(lis) }
diff --git a/gee-rpc/day1-encode/protocol/codec.go b/gee-rpc/day1-encode/protocol/codec.go
deleted file mode 100755
index 62b3b50..0000000
--- a/gee-rpc/day1-encode/protocol/codec.go
+++ /dev/null
@@ -1,26 +0,0 @@
-package protocol
-
-import (
-	"bytes"
-	"encoding/json"
-)
-
-type Codec interface {
-	Encode(i interface{}) ([]byte, error)
-	Decode(data []byte, i interface{}) error
-}
-
-// JSONCodec uses json marshaler and unmarshaler.
-type JSONCodec struct{}
-
-// Encode encodes an object into slice of bytes.
-func (c JSONCodec) Encode(i interface{}) ([]byte, error) {
-	return json.Marshal(i)
-}
-
-// Decode decodes an object from slice of bytes.
-func (c JSONCodec) Decode(data []byte, i interface{}) error {
-	d := json.NewDecoder(bytes.NewBuffer(data))
-	d.UseNumber()
-	return d.Decode(i)
-}
diff --git a/gee-rpc/day1-encode/protocol/message.go b/gee-rpc/day1-encode/protocol/message.go
deleted file mode 100755
index 08dd3ca..0000000
--- a/gee-rpc/day1-encode/protocol/message.go
+++ /dev/null
@@ -1,113 +0,0 @@
-package protocol
-
-import (
-	"bytes"
-	"encoding/binary"
-	"fmt"
-	"io"
-	"strings"
-)
-
-const MagicNumber int32 = 0xECABCD
-
-type SerializeType int8
-
-const (
-	JSON SerializeType = iota
-)
-
-var Codecs = map[SerializeType]Codec{
-	JSON: &JSONCodec{},
-}
-
-type Status int8
-
-const (
-	OK Status = iota
-	ExecError
-	NotFoundError
-)
-
-type Header struct {
-	Magic             int32
-	Status            Status
-	SerializeType     SerializeType
-	ServiceMethodSize int32
-	PayloadSize       int32
-}
-
-type Message struct {
-	*Header
-	ServiceMethod string
-	Payload       []byte
-}
-
-func NewMessage() *Message {
-	return &Message{
-		Header: &Header{Magic: MagicNumber},
-	}
-}
-
-func (m *Message) HandleError(status Status, err error) *Message {
-	m.Status = status
-	_ = m.SetPayload(err)
-	return m
-}
-
-func (m *Message) SetServiceMethod(name string) {
-	m.ServiceMethod = name
-}
-
-func (m *Message) GetServiceMethod() (service, method string, err error) {
-	parts := strings.Split(m.ServiceMethod, ".")
-	if len(parts) != 2 || parts[0] == "" || parts[1] == "" {
-		return "", "", fmt.Errorf("<service.method> format error")
-	}
-	return parts[0], parts[1], nil
-}
-
-func (m *Message) GetPayload(i interface{}) error {
-	return Codecs[m.SerializeType].Decode(m.Payload, i)
-}
-
-func (m *Message) SetPayload(i interface{}) (err error) {
-	m.Payload, err = Codecs[m.SerializeType].Encode(i)
-	return
-}
-
-func (m *Message) Clone() *Message {
-	m2 := NewMessage()
-	*m2.Header = *m.Header
-	m2.ServiceMethod = m.ServiceMethod
-	return m2
-}
-func Read(r io.Reader) (*Message, error) {
-	m := NewMessage()
-	if err := binary.Read(r, binary.BigEndian, m.Header); err != nil {
-		return nil, err
-	}
-	if m.Magic != MagicNumber {
-		return nil, fmt.Errorf("invalid message: wrong magic number")
-	}
-
-	buf := make([]byte, m.ServiceMethodSize+m.PayloadSize)
-	if err := binary.Read(r, binary.BigEndian, buf); err != nil {
-		return nil, err
-	}
-	m.ServiceMethod = string(buf[:m.ServiceMethodSize])
-	m.Payload = buf[m.ServiceMethodSize:]
-	return m, nil
-}
-func (m *Message) Write(w io.Writer) error {
-	m.PayloadSize = int32(len(m.Payload))
-	m.ServiceMethodSize = int32(len(m.ServiceMethod))
-	buf := bytes.NewBufferString(m.ServiceMethod)
-	buf.Write(m.Payload)
-	if err := binary.Write(w, binary.BigEndian, m.Header); err != nil {
-		return err
-	}
-	if err := binary.Write(w, binary.BigEndian, buf.Bytes()); err != nil {
-		return err
-	}
-	return nil
-}
diff --git a/gee-rpc/day1-encode/protocol/path.go b/gee-rpc/day1-encode/protocol/path.go
deleted file mode 100755
index cbd854c..0000000
--- a/gee-rpc/day1-encode/protocol/path.go
+++ /dev/null
@@ -1,3 +0,0 @@
-package protocol
-
-const DefaultRPCPath = "/_geerpc"
diff --git a/gee-rpc/day1-encode/server/server.go b/gee-rpc/day1-encode/server/server.go
deleted file mode 100755
index 021b3ae..0000000
--- a/gee-rpc/day1-encode/server/server.go
+++ /dev/null
@@ -1,76 +0,0 @@
-package server
-
-import (
-	"fmt"
-	"log"
-	"net"
-	"net/http"
-
-	"geerpc/protocol"
-)
-
-type Server struct {
-	ln      net.Listener
-	service map[string]*service
-}
-
-func NewServer() *Server {
-	return &Server{
-		service: make(map[string]*service),
-	}
-}
-
-func (s *Server) Address() net.Addr {
-	return s.ln.Addr()
-}
-
-func (s *Server) Serve(network, address string) (err error) {
-	if network == "http" {
-		if s.ln, err = net.Listen("tcp", address); err != nil {
-			return err
-		}
-		http.Handle(protocol.DefaultRPCPath, s)
-		return http.Serve(s.ln, nil)
-	}
-	panic(network + " not support")
-}
-
-func (s *Server) ServeHTTP(w http.ResponseWriter, req *http.Request) {
-	m, err := protocol.Read(req.Body)
-	if err != nil {
-		log.Println("failed to read message from body")
-		_, _ = w.Write([]byte("fail"))
-		return
-	}
-
-	log.Println(req.Method, m.ServiceMethod)
-
-	respMsg := s.call(m)
-	_ = respMsg.Write(w)
-}
-
-func (s *Server) Register(receiver interface{}) {
-	service := newService(receiver)
-	s.service[service.name] = service
-}
-
-func (s *Server) call(req *protocol.Message) (resp *protocol.Message) {
-	serviceName, methodName, err := req.GetServiceMethod()
-	resp = req.Clone()
-	if err != nil {
-		return resp.HandleError(protocol.NotFoundError, err)
-	}
-
-	service := s.service[serviceName]
-	if service == nil || service.method[methodName] == nil {
-		return resp.HandleError(protocol.NotFoundError, fmt.Errorf("%s not found", req.ServiceMethod))
-	}
-
-	return service.call(methodName, req)
-}
-
-func _assert(condition bool, msg string, v ...interface{}) {
-	if !condition {
-		panic(fmt.Sprintf(msg, v...))
-	}
-}
diff --git a/gee-rpc/day1-encode/server/server_test.go b/gee-rpc/day1-encode/server/server_test.go
deleted file mode 100755
index 6aed5a5..0000000
--- a/gee-rpc/day1-encode/server/server_test.go
+++ /dev/null
@@ -1,76 +0,0 @@
-package server
-
-import (
-	"bytes"
-	"fmt"
-	"geerpc/protocol"
-	"net"
-	"net/http"
-	"testing"
-	"time"
-)
-
-type Calc struct{}
-
-type Req struct {
-	Num1 int
-	Num2 int
-}
-
-func (c *Calc) Add(req Req, reply *int) error {
-	*reply = req.Num1 + req.Num2
-	return nil
-}
-
-func TestServer_Register(t *testing.T) {
-	s := NewServer()
-	s.Register(&Calc{})
-
-	service := s.service["Calc"]
-	if service == nil || service.method["Add"] == nil {
-		t.Fatal("failed to register")
-	}
-}
-
-func TestServer_Call(t *testing.T) {
-	s := NewServer()
-	s.Register(&Calc{})
-	req := &Req{Num1: 10, Num2: 20}
-
-	reqMsg := protocol.NewMessage()
-	reqMsg.SetServiceMethod("Calc.Add")
-	_ = reqMsg.SetPayload(req)
-
-	respMsg := s.call(reqMsg)
-	var ans int
-	_ = respMsg.GetPayload(&ans)
-	if ans != req.Num1+req.Num2 {
-		t.Fatal("failed to call Calc.Add")
-	}
-}
-
-func TestServer_Serve(t *testing.T) {
-	s := NewServer()
-	s.Register(&Calc{})
-	go func() { _ = s.Serve("http", ":0") }()
-
-	time.Sleep(time.Second)
-	port := s.Address().(*net.TCPAddr).Port
-	addr := fmt.Sprintf("http://localhost:%d%s", port, protocol.DefaultRPCPath)
-
-	reqMsg := protocol.NewMessage()
-	reqMsg.SetServiceMethod("Calc.Add")
-	_ = reqMsg.SetPayload(&Req{1, 2})
-
-	var buf bytes.Buffer
-	_ = reqMsg.Write(&buf)
-	resp, _ := http.Post(addr, "application/octet-stream", &buf)
-
-	respMsg, _ := protocol.Read(resp.Body)
-
-	var ans int
-	_ = respMsg.GetPayload(&ans)
-	if respMsg.Status != protocol.OK || ans != 3 {
-		t.Fatal("failed to call Calc.Add")
-	}
-}
diff --git a/gee-rpc/day1-encode/server/service.go b/gee-rpc/day1-encode/server/service.go
deleted file mode 100755
index 2cc506b..0000000
--- a/gee-rpc/day1-encode/server/service.go
+++ /dev/null
@@ -1,99 +0,0 @@
-package server
-
-import (
-	"geerpc/protocol"
-	"go/ast"
-	"log"
-	"reflect"
-)
-
-type methodType struct {
-	method    reflect.Method
-	ArgType   reflect.Type
-	ReplyType reflect.Type
-}
-
-func (m *methodType) NewArg() interface{} {
-	return newTypeInter(m.ArgType)
-}
-
-func (m *methodType) NewReply() interface{} {
-	return newTypeInter(m.ReplyType)
-}
-
-func newTypeInter(t reflect.Type) interface{} {
-	var v reflect.Value
-	if t.Kind() == reflect.Ptr { // reply must be ptr
-		v = reflect.New(t.Elem())
-	} else {
-		v = reflect.New(t)
-	}
-	return v.Interface()
-}
-
-type service struct {
-	name   string
-	rcvr   reflect.Value
-	method map[string]*methodType
-}
-
-func newService(receiver interface{}) *service {
-	service := new(service)
-	service.method = make(map[string]*methodType)
-	service.name = reflect.Indirect(reflect.ValueOf(receiver)).Type().Name()
-	service.rcvr = reflect.ValueOf(receiver)
-
-	_assert(ast.IsExported(service.name), "%service is not exported", service.name)
-	rcvrType := reflect.TypeOf(receiver)
-	for i := 0; i < rcvrType.NumMethod(); i++ {
-		method := rcvrType.Method(i)
-		mType := method.Type
-		if mType.NumIn() != 3 || mType.NumOut() != 1 {
-			continue
-		}
-		if mType.Out(0) != reflect.TypeOf((*error)(nil)).Elem() {
-			continue
-		}
-
-		argType, replyType := mType.In(1), mType.In(2)
-		if !isExportedOrBuiltinType(argType) || !isExportedOrBuiltinType(replyType) {
-			continue
-		}
-
-		service.method[method.Name] = &methodType{
-			method:    method,
-			ArgType:   argType,
-			ReplyType: replyType,
-		}
-		log.Printf("Register %s.%s\n", service.name, method.Name)
-	}
-
-	return service
-}
-
-func (s *service) call(methodName string, reqMsg *protocol.Message) (resp *protocol.Message) {
-	mType := s.method[methodName]
-	resp = reqMsg.Clone()
-
-	arg, reply := mType.NewArg(), mType.NewReply()
-	if err := reqMsg.GetPayload(arg); err != nil {
-		return resp.HandleError(protocol.ExecError, err)
-	}
-
-	f := mType.method.Func
-	returnValues := f.Call([]reflect.Value{s.rcvr, reflect.ValueOf(arg).Elem(), reflect.ValueOf(reply)})
-
-	if errInter := returnValues[0].Interface(); errInter != nil {
-		return resp.HandleError(protocol.ExecError, errInter.(error))
-	}
-
-	if err := resp.SetPayload(reply); err != nil {
-		return resp.HandleError(protocol.ExecError, err)
-	}
-
-	return resp
-}
-
-func isExportedOrBuiltinType(t reflect.Type) bool {
-	return ast.IsExported(t.Name()) || t.PkgPath() == ""
-}
diff --git a/gee-rpc/day3-service/service.go b/gee-rpc/day3-service/service.go
new file mode 100644
index 0000000..de7182b
--- /dev/null
+++ b/gee-rpc/day3-service/service.go
@@ -0,0 +1,96 @@
+package geerpc
+
+import (
+	"go/ast"
+	"log"
+	"reflect"
+)
+
+type methodType struct {
+	method    reflect.Method
+	argType   reflect.Type
+	replyType reflect.Type
+}
+
+func (m *methodType) NewArg() reflect.Value {
+	var argv reflect.Value
+	// arg may be a pointer type, or a value type
+	if m.argType.Kind() == reflect.Ptr {
+		argv = reflect.New(m.argType.Elem())
+	} else {
+		argv = reflect.New(m.argType)
+	}
+	return argv
+}
+
+func (m *methodType) NewReply() interface{} {
+	// reply must be a pointer type
+	replyv := reflect.New(m.replyType.Elem())
+	switch m.replyType.Elem().Kind() {
+	case reflect.Map:
+		replyv.Elem().Set(reflect.MakeMap(m.replyType.Elem()))
+	case reflect.Slice:
+		replyv.Elem().Set(reflect.MakeSlice(m.replyType.Elem(), 0, 0))
+	}
+	return replyv
+}
+
+type service struct {
+	name   string
+	typ    reflect.Type
+	rcvr   reflect.Value
+	method map[string]*methodType
+}
+
+func newService(rcvr interface{}) *service {
+	s := new(service)
+	s.rcvr = reflect.ValueOf(rcvr)
+	s.name = reflect.Indirect(s.rcvr).Type().Name()
+	s.typ = reflect.TypeOf(rcvr)
+	if !ast.IsExported(s.name) {
+		log.Fatalf("rpc server: %s is not a valid service name", s.name)
+	}
+	return s
+}
+
+func (s *service) registerMethods() {
+	s.method = make(map[string]*methodType)
+	for i := 0; i < s.typ.NumMethod(); i++ {
+		method := s.typ.Method(i)
+		mType := method.Type
+		if mType.NumIn() != 3 || mType.NumOut() != 1 {
+			continue
+		}
+		if mType.Out(0) != reflect.TypeOf((*error)(nil)).Elem() {
+			continue
+		}
+
+		argType, replyType := mType.In(1), mType.In(2)
+		if !isExportedOrBuiltinType(argType) || !isExportedOrBuiltinType(replyType) {
+			continue
+		}
+		s.method[method.Name] = &methodType{
+			method:    method,
+			argType:   argType,
+			replyType: replyType,
+		}
+		log.Printf("rpc server: register %s.%s\n", s.name, method.Name)
+	}
+}
+
+func (s *service) call(mType methodType, argv, replyv reflect.Value) error {
+	f := mType.method.Func
+	// if argv is not a ptr, need to indirect before calling.
+	if mType.argType.Kind() != reflect.Ptr {
+		argv = argv.Elem()
+	}
+	returnValues := f.Call([]reflect.Value{s.rcvr, argv, replyv})
+	if errInter := returnValues[0].Interface(); errInter != nil {
+		return errInter.(error)
+	}
+	return nil
+}
+
+func isExportedOrBuiltinType(t reflect.Type) bool {
+	return ast.IsExported(t.Name()) || t.PkgPath() == ""
+}

From dfdb0ed8bb5a259e6430bcfce73d15e91718f423 Mon Sep 17 00:00:00 2001
From: gzdaijie <gzdaijie@gmail.com>
Date: Thu, 1 Oct 2020 15:59:49 +0800
Subject: [PATCH 073/122] geerpc day2, implement a rpc client

---
 gee-rpc/day1-codec/main/main.go    |  24 ++--
 gee-rpc/day1-codec/server.go       | 106 ++++++++------
 gee-rpc/day2-client/client.go      | 219 +++++++++++++++++++++++++++++
 gee-rpc/day2-client/codec/codec.go |  39 +++++
 gee-rpc/day2-client/codec/gob.go   |  57 ++++++++
 gee-rpc/day2-client/go.mod         |   3 +
 gee-rpc/day2-client/main/main.go   |  36 +++++
 gee-rpc/day2-client/server.go      | 170 ++++++++++++++++++++++
 8 files changed, 601 insertions(+), 53 deletions(-)
 create mode 100644 gee-rpc/day2-client/client.go
 create mode 100644 gee-rpc/day2-client/codec/codec.go
 create mode 100644 gee-rpc/day2-client/codec/gob.go
 create mode 100644 gee-rpc/day2-client/go.mod
 create mode 100644 gee-rpc/day2-client/main/main.go
 create mode 100644 gee-rpc/day2-client/server.go

diff --git a/gee-rpc/day1-codec/main/main.go b/gee-rpc/day1-codec/main/main.go
index 96f2273..95dd9e2 100644
--- a/gee-rpc/day1-codec/main/main.go
+++ b/gee-rpc/day1-codec/main/main.go
@@ -7,29 +7,28 @@ import (
 	"geerpc/codec"
 	"log"
 	"net"
-	"net/http"
-	"time"
 )
 
-func startServer() {
-	l, err := net.Listen("tcp", ":9999")
+func startServer(addr chan string) {
+	// pick a free port
+	l, err := net.Listen("tcp", ":0")
 	if err != nil {
-		log.Panic("network error:", err)
+		log.Fatal("network error:", err)
 	}
+	log.Println("start rpc server on", l.Addr())
+	addr <- l.Addr().String()
 	geerpc.Accept(l)
-
 }
 
 func main() {
-	log.SetPrefix("")
-	go startServer()
-	time.Sleep(time.Second)
+	addr := make(chan string)
+	go startServer(addr)
 
-	// In fact, following code is like a simple GeeRPC Client
-	conn, _ := net.Dial("tcp", ":9999")
+	// in fact, following code is like a simple geerpc client
+	conn, _ := net.Dial("tcp", <-addr)
 	defer func() { _ = conn.Close() }()
 
-	// negotiate options
+	// send options
 	_ = json.NewEncoder(conn).Encode(&geerpc.Options{
 		MagicNumber: geerpc.MagicNumber,
 		CodecType:   codec.GobType,
@@ -48,5 +47,4 @@ func main() {
 		_ = cc.ReadBody(&reply)
 		log.Println("reply:", reply)
 	}
-	log.Fatal(http.ListenAndServe(":9999", nil))
 }
diff --git a/gee-rpc/day1-codec/server.go b/gee-rpc/day1-codec/server.go
index 3e32f1f..7646f9d 100644
--- a/gee-rpc/day1-codec/server.go
+++ b/gee-rpc/day1-codec/server.go
@@ -1,3 +1,7 @@
+// Copyright 2009 The Go Authors. All rights reserved.
+// Use of this source code is governed by a BSD-style
+// license that can be found in the LICENSE file.
+
 package geerpc
 
 import (
@@ -7,11 +11,10 @@ import (
 	"io"
 	"log"
 	"net"
+	"reflect"
 	"sync"
 )
 
-type Server struct{}
-
 const MagicNumber = 0x3bef5c
 
 type Options struct {
@@ -19,12 +22,24 @@ type Options struct {
 	CodecType   codec.Type // client may choose different Codec to encode body
 }
 
-func newServer() *Server {
+var defaultOptions = &Options{
+	MagicNumber: MagicNumber,
+	CodecType:   codec.GobType,
+}
+
+// Server represents an RPC Server.
+type Server struct{}
+
+// NewServer returns a new Server.
+func NewServer() *Server {
 	return &Server{}
 }
 
-var DefaultServer = newServer()
+// DefaultServer is the default instance of *Server.
+var DefaultServer = NewServer()
 
+// ServeConn runs the server on a single connection.
+// ServeConn blocks, serving the connection until the client hangs up.
 func (server *Server) ServeConn(conn io.ReadWriteCloser) {
 	defer func() { _ = conn.Close() }()
 	var opt Options
@@ -41,13 +56,38 @@ func (server *Server) ServeConn(conn io.ReadWriteCloser) {
 		log.Printf("rpc server: invalid codec type %s", opt.CodecType)
 		return
 	}
-	server.ServeCodec(f(conn))
+	server.serveCodec(f(conn))
+}
+
+// invalidRequest is a placeholder for response argv when error occurs
+var invalidRequest = struct{}{}
+
+func (server *Server) serveCodec(cc codec.Codec) {
+	sending := new(sync.Mutex) // ensure header and argv is not separated by other response
+	wg := new(sync.WaitGroup)  // wait until all request are handled
+	for {
+		req, keepReading, err := server.readRequest(cc)
+		if err != nil {
+			if !keepReading {
+				break // it's not possible to recover, so close the connection
+			}
+			if req != nil {
+				req.h.Error = err.Error()
+				server.sendResponse(cc, req.h, invalidRequest, sending)
+			}
+			continue
+		}
+		wg.Add(1)
+		go server.handleRequest(cc, req, sending, wg)
+	}
+	wg.Wait()
+	_ = cc.Close()
 }
 
 // request stores all information of a call
 type request struct {
-	h    *codec.Header // header of request argv
-	argv string        // TODO suppose argv is a string
+	h            *codec.Header // header of request
+	argv, replyv reflect.Value // argv and replyv of request
 }
 
 var requestPool = sync.Pool{
@@ -58,6 +98,10 @@ func (server *Server) readRequestHeader(cc codec.Codec) (req *request, keepReadi
 	req, _ = requestPool.Get().(*request)
 	h, _ := codec.HeaderPool.Get().(*codec.Header)
 	if err = cc.ReadHeader(h); err != nil {
+		// client closed the connection
+		if err == io.EOF || err != io.ErrUnexpectedEOF {
+			return
+		}
 		log.Println("rpc server: read header error:", err)
 		return
 	}
@@ -80,12 +124,12 @@ func (server *Server) readRequest(cc codec.Codec) (req *request, keepReading boo
 	// we can still recover and move on to the next request.
 	keepReading = true
 
-	// TODO: suppose argv is a string, now we can't judge the type of request argv
-	var str string
-	if err = cc.ReadBody(&str); err != nil {
+	// TODO: now we can't judge the type of request argv
+	// day 1, just suppose it's string
+	req.argv = reflect.New(reflect.TypeOf(""))
+	if err = cc.ReadBody(req.argv.Interface()); err != nil {
 		log.Println("rpc server: read argv err:", err)
 	}
-	req.argv = str
 	return
 }
 
@@ -97,39 +141,19 @@ func (server *Server) sendResponse(cc codec.Codec, h *codec.Header, body interfa
 	}
 }
 
-func (server *Server) Handle(cc codec.Codec, req *request, sending *sync.Mutex, wg *sync.WaitGroup) {
-	// TODO, should call registered rpc methods
-	// day 1 just print argv and send a hello message
+func (server *Server) handleRequest(cc codec.Codec, req *request, sending *sync.Mutex, wg *sync.WaitGroup) {
+	// TODO, should call registered rpc methods to get the right replyv
+	// day 1, just print argv and send a hello message
 	defer wg.Done()
-	log.Println(req.h, req.argv)
-	server.sendResponse(cc, req.h, fmt.Sprintf("geerpc resp %d", req.h.Seq), sending)
-}
-
-// invalidRequest is a placeholder for response argv when error occurs
-var invalidRequest = struct{}{}
+	defer codec.HeaderPool.Put(req.h) // recycle Header object
+	log.Println(req.h, req.argv.Elem())
+	req.replyv = reflect.ValueOf(fmt.Sprintf("geerpc resp %d", req.h.Seq))
+	server.sendResponse(cc, req.h, req.replyv.Interface(), sending)
 
-func (server *Server) ServeCodec(cc codec.Codec) {
-	sending := new(sync.Mutex) // ensure header and argv is not separated by other response
-	wg := new(sync.WaitGroup)  // wait until all request are handled
-	for {
-		req, keepReading, err := server.readRequest(cc)
-		if err != nil {
-			if !keepReading {
-				break // it's not possible to recover, so close the connection
-			}
-			if req != nil {
-				req.h.Error = err.Error()
-				server.sendResponse(cc, req.h, invalidRequest, sending)
-			}
-			continue
-		}
-		wg.Add(1)
-		go server.Handle(cc, req, sending, wg)
-	}
-	wg.Wait()
-	_ = cc.Close()
 }
 
+// Accept accepts connections on the listener and serves requests
+// for each incoming connection.
 func (server *Server) Accept(lis net.Listener) {
 	for {
 		conn, err := lis.Accept()
@@ -141,4 +165,6 @@ func (server *Server) Accept(lis net.Listener) {
 	}
 }
 
+// Accept accepts connections on the listener and serves requests
+// for each incoming connection.
 func Accept(lis net.Listener) { DefaultServer.Accept(lis) }
diff --git a/gee-rpc/day2-client/client.go b/gee-rpc/day2-client/client.go
new file mode 100644
index 0000000..79ef524
--- /dev/null
+++ b/gee-rpc/day2-client/client.go
@@ -0,0 +1,219 @@
+// Copyright 2009 The Go Authors. All rights reserved.
+// Use of this source code is governed by a BSD-style
+// license that can be found in the LICENSE file.
+
+package geerpc
+
+import (
+	"encoding/json"
+	"errors"
+	"fmt"
+	"geerpc/codec"
+	"io"
+	"log"
+	"net"
+	"sync"
+)
+
+// Call represents an active RPC.
+type Call struct {
+	ServiceMethod string      // format "<service>.<method>"
+	Args          interface{} // arguments to the function
+	Reply         interface{} // reply from the function
+	Error         error       // if error occurs, it will be set
+	Done          chan *Call  // Strobes when call is complete.
+}
+
+func (call *Call) done() {
+	call.Done <- call
+}
+
+// Client represents an RPC Client.
+// There may be multiple outstanding Calls associated
+// with a single Client, and a Client may be used by
+// multiple goroutines simultaneously.
+type Client struct {
+	cc      codec.Codec
+	sending sync.Mutex // protect sending a complete request
+	mu      sync.Mutex // protect following
+	seq     uint64
+	pending map[uint64]*Call
+	closed  bool // user has called Close
+}
+
+var _ io.Closer = (*Client)(nil)
+
+var ErrShutdown = errors.New("connection is shut down")
+
+// Close the connection
+func (client *Client) Close() error {
+	client.mu.Lock()
+	defer client.mu.Unlock()
+	if client.closed {
+		return ErrShutdown
+	}
+	client.closed = true
+	return client.cc.Close()
+}
+
+func (client *Client) registerCall(call *Call) (uint64, error) {
+	client.mu.Lock()
+	defer client.mu.Unlock()
+	if client.closed {
+		return 0, ErrShutdown
+	}
+	seq := client.seq
+	client.pending[seq] = call
+	client.seq++
+	return seq, nil
+}
+
+func (client *Client) removeCall(seq uint64) *Call {
+	client.mu.Lock()
+	defer client.mu.Unlock()
+	call := client.pending[seq]
+	delete(client.pending, seq)
+	return call
+}
+
+func (client *Client) terminateCalls(err error) {
+	client.sending.Lock()
+	defer client.sending.Unlock()
+	client.mu.Lock()
+	defer client.mu.Unlock()
+	for _, call := range client.pending {
+		call.Error = err
+		call.done()
+	}
+}
+
+func (client *Client) send(call *Call) {
+	// make sure that the client will send a complete request
+	client.sending.Lock()
+	defer client.sending.Unlock()
+
+	// register this call.
+	seq, err := client.registerCall(call)
+	if err != nil {
+		call.Error = err
+		call.done()
+		return
+	}
+
+	// prepare request header
+	h, _ := codec.HeaderPool.Get().(*codec.Header)
+	h.ServiceMethod = call.ServiceMethod
+	h.Seq = seq
+	h.Error = ""
+	defer codec.HeaderPool.Put(h)
+
+	// encode and send the request
+	if err := client.cc.Write(h, call.Args); err != nil {
+		call := client.removeCall(seq)
+		// call may be nil, it usually means that Write partially failed,
+		// client has received the response and handled
+		if call != nil {
+			call.Error = err
+			call.done()
+		}
+	}
+}
+
+func (client *Client) receive() {
+	h, _ := codec.HeaderPool.Get().(*codec.Header)
+	defer codec.HeaderPool.Put(h)
+	var err error
+	for err == nil {
+		if err = client.cc.ReadHeader(h); err != nil {
+			break
+		}
+		call := client.removeCall(h.Seq)
+		switch {
+		case call == nil:
+			// it usually means that Write partially failed
+			// and call was already removed.
+			err = client.cc.ReadBody(nil)
+		case h.Error != "":
+			call.Error = fmt.Errorf(h.Error)
+			err = client.cc.ReadBody(nil)
+			call.done()
+		default:
+			err = client.cc.ReadBody(call.Reply)
+			call.done()
+		}
+	}
+	// error occurs, so terminateCalls pending calls
+	client.terminateCalls(err)
+}
+
+// Go invokes the function asynchronously.
+// It returns the Call structure representing the invocation.
+func (client *Client) Go(serviceMethod string, args, reply interface{}, done chan *Call) *Call {
+	if done == nil {
+		done = make(chan *Call, 10)
+	} else if cap(done) == 0 {
+		log.Panic("rpc client: done channel is unbuffered")
+	}
+	call := &Call{
+		ServiceMethod: serviceMethod,
+		Args:          args,
+		Reply:         reply,
+		Done:          done,
+	}
+	client.send(call)
+	return call
+}
+
+// Call invokes the named function, waits for it to complete,
+// and returns its error status.
+func (client *Client) Call(serviceMethod string, args, reply interface{}) error {
+	call := <-client.Go(serviceMethod, args, reply, make(chan *Call, 1)).Done
+	return call.Error
+}
+
+func NewClient(conn io.ReadWriteCloser, opt *Options) (*Client, error) {
+	var err error
+	defer func() {
+		if err != nil {
+			_ = conn.Close()
+		}
+	}()
+	if opt.MagicNumber == 0 {
+		opt.MagicNumber = MagicNumber
+	}
+	f := codec.NewCodecFuncMap[opt.CodecType]
+	if f == nil {
+		err = fmt.Errorf("invalid codec type %s", opt.CodecType)
+		log.Println("rpc client: codec error:", err)
+		return nil, err
+	}
+	// send options with server
+	if err = json.NewEncoder(conn).Encode(opt); err != nil {
+		log.Println("rpc client: options error: ", err)
+		return nil, err
+	}
+	return newClientCodec(f(conn)), nil
+}
+
+func newClientCodec(cc codec.Codec) *Client {
+	client := &Client{
+		cc:      cc,
+		pending: make(map[uint64]*Call),
+	}
+	go client.receive()
+	return client
+}
+
+// DialWithOptions connects to an RPC server at the specified network address
+func DialWithOptions(network, address string, opt *Options) (*Client, error) {
+	conn, err := net.Dial(network, address)
+	if err != nil {
+		return nil, err
+	}
+	return NewClient(conn, opt)
+}
+
+// Dial connects to an RPC server at the specified network address
+func Dial(network, address string) (*Client, error) {
+	return DialWithOptions(network, address, defaultOptions)
+}
diff --git a/gee-rpc/day2-client/codec/codec.go b/gee-rpc/day2-client/codec/codec.go
new file mode 100644
index 0000000..54d2e56
--- /dev/null
+++ b/gee-rpc/day2-client/codec/codec.go
@@ -0,0 +1,39 @@
+package codec
+
+import (
+	"io"
+	"sync"
+)
+
+type Header struct {
+	ServiceMethod string // format "Service.Method"
+	Seq           uint64 // sequence number chosen by client
+	Error         string
+}
+
+var HeaderPool = sync.Pool{
+	New: func() interface{} { return &Header{} },
+}
+
+type Codec interface {
+	io.Closer
+	ReadHeader(*Header) error
+	ReadBody(interface{}) error
+	Write(*Header, interface{}) error
+}
+
+type NewCodecFunc func(io.ReadWriteCloser) Codec
+
+type Type string
+
+const (
+	GobType  Type = "application/gob"
+	JsonType Type = "application/json"
+)
+
+var NewCodecFuncMap map[Type]NewCodecFunc
+
+func init() {
+	NewCodecFuncMap = make(map[Type]NewCodecFunc)
+	NewCodecFuncMap[GobType] = NewGobCodec
+}
diff --git a/gee-rpc/day2-client/codec/gob.go b/gee-rpc/day2-client/codec/gob.go
new file mode 100644
index 0000000..808d97b
--- /dev/null
+++ b/gee-rpc/day2-client/codec/gob.go
@@ -0,0 +1,57 @@
+package codec
+
+import (
+	"bufio"
+	"encoding/gob"
+	"io"
+	"log"
+)
+
+type GobCodec struct {
+	conn io.ReadWriteCloser
+	buf  *bufio.Writer
+	dec  *gob.Decoder
+	enc  *gob.Encoder
+}
+
+var _ Codec = (*GobCodec)(nil)
+
+func NewGobCodec(conn io.ReadWriteCloser) Codec {
+	buf := bufio.NewWriter(conn)
+	return &GobCodec{
+		conn: conn,
+		buf:  buf,
+		dec:  gob.NewDecoder(conn),
+		enc:  gob.NewEncoder(buf),
+	}
+}
+
+func (c *GobCodec) ReadHeader(h *Header) error {
+	return c.dec.Decode(h)
+}
+
+func (c *GobCodec) ReadBody(body interface{}) error {
+	return c.dec.Decode(body)
+}
+
+func (c *GobCodec) Write(h *Header, body interface{}) (err error) {
+	defer func() {
+		_ = c.buf.Flush()
+		if err != nil {
+			_ = c.Close()
+		}
+	}()
+	if err := c.enc.Encode(h); err != nil {
+		log.Println("rpc: gob error encoding header:", err)
+		return err
+	}
+	if err := c.enc.Encode(body); err != nil {
+		log.Println("rpc: gob error encoding body:", err)
+		return err
+	}
+	return nil
+}
+
+func (c *GobCodec) Close() error {
+	return c.conn.Close()
+}
diff --git a/gee-rpc/day2-client/go.mod b/gee-rpc/day2-client/go.mod
new file mode 100644
index 0000000..0ec8aeb
--- /dev/null
+++ b/gee-rpc/day2-client/go.mod
@@ -0,0 +1,3 @@
+module geerpc
+
+go 1.13
diff --git a/gee-rpc/day2-client/main/main.go b/gee-rpc/day2-client/main/main.go
new file mode 100644
index 0000000..b370e82
--- /dev/null
+++ b/gee-rpc/day2-client/main/main.go
@@ -0,0 +1,36 @@
+package main
+
+import (
+	"fmt"
+	"geerpc"
+	"log"
+	"net"
+)
+
+func startServer(addr chan string) {
+	// pick a free port
+	l, err := net.Listen("tcp", ":0")
+	if err != nil {
+		log.Fatal("network error:", err)
+	}
+	log.Println("start rpc server on", l.Addr())
+	addr <- l.Addr().String()
+	geerpc.Accept(l)
+}
+
+func main() {
+	addr := make(chan string)
+	go startServer(addr)
+	client, _ := geerpc.Dial("tcp", <-addr)
+	defer func() { _ = client.Close() }()
+
+	// send request & receive response
+	for i := 0; i < 3; i++ {
+		args := fmt.Sprintf("geerpc req %d", i)
+		var reply string
+		if err := client.Call("Foo.Sum", args, &reply); err != nil {
+			log.Fatal("call Foo.Sum error", err)
+		}
+		log.Println("reply:", reply)
+	}
+}
diff --git a/gee-rpc/day2-client/server.go b/gee-rpc/day2-client/server.go
new file mode 100644
index 0000000..7646f9d
--- /dev/null
+++ b/gee-rpc/day2-client/server.go
@@ -0,0 +1,170 @@
+// Copyright 2009 The Go Authors. All rights reserved.
+// Use of this source code is governed by a BSD-style
+// license that can be found in the LICENSE file.
+
+package geerpc
+
+import (
+	"encoding/json"
+	"fmt"
+	"geerpc/codec"
+	"io"
+	"log"
+	"net"
+	"reflect"
+	"sync"
+)
+
+const MagicNumber = 0x3bef5c
+
+type Options struct {
+	MagicNumber int        // MagicNumber marks this's a geerpc request
+	CodecType   codec.Type // client may choose different Codec to encode body
+}
+
+var defaultOptions = &Options{
+	MagicNumber: MagicNumber,
+	CodecType:   codec.GobType,
+}
+
+// Server represents an RPC Server.
+type Server struct{}
+
+// NewServer returns a new Server.
+func NewServer() *Server {
+	return &Server{}
+}
+
+// DefaultServer is the default instance of *Server.
+var DefaultServer = NewServer()
+
+// ServeConn runs the server on a single connection.
+// ServeConn blocks, serving the connection until the client hangs up.
+func (server *Server) ServeConn(conn io.ReadWriteCloser) {
+	defer func() { _ = conn.Close() }()
+	var opt Options
+	if err := json.NewDecoder(conn).Decode(&opt); err != nil {
+		log.Println("rpc server: options error: ", err)
+		return
+	}
+	if opt.MagicNumber != MagicNumber {
+		log.Printf("rpc server: invalid magic number %x", opt.MagicNumber)
+		return
+	}
+	f := codec.NewCodecFuncMap[opt.CodecType]
+	if f == nil {
+		log.Printf("rpc server: invalid codec type %s", opt.CodecType)
+		return
+	}
+	server.serveCodec(f(conn))
+}
+
+// invalidRequest is a placeholder for response argv when error occurs
+var invalidRequest = struct{}{}
+
+func (server *Server) serveCodec(cc codec.Codec) {
+	sending := new(sync.Mutex) // ensure header and argv is not separated by other response
+	wg := new(sync.WaitGroup)  // wait until all request are handled
+	for {
+		req, keepReading, err := server.readRequest(cc)
+		if err != nil {
+			if !keepReading {
+				break // it's not possible to recover, so close the connection
+			}
+			if req != nil {
+				req.h.Error = err.Error()
+				server.sendResponse(cc, req.h, invalidRequest, sending)
+			}
+			continue
+		}
+		wg.Add(1)
+		go server.handleRequest(cc, req, sending, wg)
+	}
+	wg.Wait()
+	_ = cc.Close()
+}
+
+// request stores all information of a call
+type request struct {
+	h            *codec.Header // header of request
+	argv, replyv reflect.Value // argv and replyv of request
+}
+
+var requestPool = sync.Pool{
+	New: func() interface{} { return &request{} },
+}
+
+func (server *Server) readRequestHeader(cc codec.Codec) (req *request, keepReading bool, err error) {
+	req, _ = requestPool.Get().(*request)
+	h, _ := codec.HeaderPool.Get().(*codec.Header)
+	if err = cc.ReadHeader(h); err != nil {
+		// client closed the connection
+		if err == io.EOF || err != io.ErrUnexpectedEOF {
+			return
+		}
+		log.Println("rpc server: read header error:", err)
+		return
+	}
+	// We read the header successfully. If we see an error now,
+	// we can still recover and move on to the next request.
+	keepReading = true
+	req.h = h
+	return
+}
+
+func (server *Server) readRequest(cc codec.Codec) (req *request, keepReading bool, err error) {
+	req, keepReading, err = server.readRequestHeader(cc)
+	if err != nil {
+		// discard argv
+		_ = cc.ReadBody(nil)
+		return
+	}
+
+	// We read the header successfully. If we see an error now,
+	// we can still recover and move on to the next request.
+	keepReading = true
+
+	// TODO: now we can't judge the type of request argv
+	// day 1, just suppose it's string
+	req.argv = reflect.New(reflect.TypeOf(""))
+	if err = cc.ReadBody(req.argv.Interface()); err != nil {
+		log.Println("rpc server: read argv err:", err)
+	}
+	return
+}
+
+func (server *Server) sendResponse(cc codec.Codec, h *codec.Header, body interface{}, sending *sync.Mutex) {
+	sending.Lock()
+	defer sending.Unlock()
+	if err := cc.Write(h, body); err != nil {
+		log.Println("rpc server: write response error:", err)
+	}
+}
+
+func (server *Server) handleRequest(cc codec.Codec, req *request, sending *sync.Mutex, wg *sync.WaitGroup) {
+	// TODO, should call registered rpc methods to get the right replyv
+	// day 1, just print argv and send a hello message
+	defer wg.Done()
+	defer codec.HeaderPool.Put(req.h) // recycle Header object
+	log.Println(req.h, req.argv.Elem())
+	req.replyv = reflect.ValueOf(fmt.Sprintf("geerpc resp %d", req.h.Seq))
+	server.sendResponse(cc, req.h, req.replyv.Interface(), sending)
+
+}
+
+// Accept accepts connections on the listener and serves requests
+// for each incoming connection.
+func (server *Server) Accept(lis net.Listener) {
+	for {
+		conn, err := lis.Accept()
+		if err != nil {
+			log.Println("rpc server: accept error:", err)
+			return
+		}
+		go server.ServeConn(conn)
+	}
+}
+
+// Accept accepts connections on the listener and serves requests
+// for each incoming connection.
+func Accept(lis net.Listener) { DefaultServer.Accept(lis) }

From 0cc8314dff4ecca8a50d7126f2238136e99a1ce2 Mon Sep 17 00:00:00 2001
From: gzdaijie <gzdaijie@gmail.com>
Date: Thu, 1 Oct 2020 16:18:30 +0800
Subject: [PATCH 074/122] fix HeaderPool recycle opportunity, add geerpc day3
 service

---
 gee-rpc/day1-codec/codec/gob.go      |   4 +-
 gee-rpc/day1-codec/main/main.go      |   2 +-
 gee-rpc/day1-codec/server.go         |  57 +++----
 gee-rpc/day2-client/client.go        |   8 +-
 gee-rpc/day2-client/codec/gob.go     |   4 +-
 gee-rpc/day2-client/main/main.go     |  21 ++-
 gee-rpc/day2-client/server.go        |  57 +++----
 gee-rpc/day3-service/client.go       | 221 +++++++++++++++++++++++++++
 gee-rpc/day3-service/codec/codec.go  |  39 +++++
 gee-rpc/day3-service/codec/gob.go    |  57 +++++++
 gee-rpc/day3-service/go.mod          |   3 +
 gee-rpc/day3-service/main/main.go    |  55 +++++++
 gee-rpc/day3-service/server.go       | 203 ++++++++++++++++++++++++
 gee-rpc/day3-service/service.go      |  19 ++-
 gee-rpc/day3-service/service_test.go |  48 ++++++
 15 files changed, 697 insertions(+), 101 deletions(-)
 create mode 100644 gee-rpc/day3-service/client.go
 create mode 100644 gee-rpc/day3-service/codec/codec.go
 create mode 100644 gee-rpc/day3-service/codec/gob.go
 create mode 100644 gee-rpc/day3-service/go.mod
 create mode 100644 gee-rpc/day3-service/main/main.go
 create mode 100644 gee-rpc/day3-service/server.go
 create mode 100644 gee-rpc/day3-service/service_test.go

diff --git a/gee-rpc/day1-codec/codec/gob.go b/gee-rpc/day1-codec/codec/gob.go
index 808d97b..e4b2a67 100644
--- a/gee-rpc/day1-codec/codec/gob.go
+++ b/gee-rpc/day1-codec/codec/gob.go
@@ -42,11 +42,11 @@ func (c *GobCodec) Write(h *Header, body interface{}) (err error) {
 		}
 	}()
 	if err := c.enc.Encode(h); err != nil {
-		log.Println("rpc: gob error encoding header:", err)
+		log.Println("rpc codec: gob error encoding header:", err)
 		return err
 	}
 	if err := c.enc.Encode(body); err != nil {
-		log.Println("rpc: gob error encoding body:", err)
+		log.Println("rpc codec: gob error encoding body:", err)
 		return err
 	}
 	return nil
diff --git a/gee-rpc/day1-codec/main/main.go b/gee-rpc/day1-codec/main/main.go
index 95dd9e2..a715209 100644
--- a/gee-rpc/day1-codec/main/main.go
+++ b/gee-rpc/day1-codec/main/main.go
@@ -36,7 +36,7 @@ func main() {
 
 	cc := codec.NewGobCodec(conn)
 	// send request & receive response
-	for i := 0; i < 3; i++ {
+	for i := 0; i < 5; i++ {
 		h := &codec.Header{
 			ServiceMethod: "Foo.Sum",
 			Seq:           uint64(i),
diff --git a/gee-rpc/day1-codec/server.go b/gee-rpc/day1-codec/server.go
index 7646f9d..5a8a9bf 100644
--- a/gee-rpc/day1-codec/server.go
+++ b/gee-rpc/day1-codec/server.go
@@ -63,18 +63,16 @@ func (server *Server) ServeConn(conn io.ReadWriteCloser) {
 var invalidRequest = struct{}{}
 
 func (server *Server) serveCodec(cc codec.Codec) {
-	sending := new(sync.Mutex) // ensure header and argv is not separated by other response
+	sending := new(sync.Mutex) // make sure to send a complete response
 	wg := new(sync.WaitGroup)  // wait until all request are handled
 	for {
-		req, keepReading, err := server.readRequest(cc)
+		req, err := server.readRequest(cc)
 		if err != nil {
-			if !keepReading {
+			if req == nil {
 				break // it's not possible to recover, so close the connection
 			}
-			if req != nil {
-				req.h.Error = err.Error()
-				server.sendResponse(cc, req.h, invalidRequest, sending)
-			}
+			req.h.Error = err.Error()
+			server.sendResponse(cc, req.h, invalidRequest, sending)
 			continue
 		}
 		wg.Add(1)
@@ -90,47 +88,31 @@ type request struct {
 	argv, replyv reflect.Value // argv and replyv of request
 }
 
-var requestPool = sync.Pool{
-	New: func() interface{} { return &request{} },
-}
-
-func (server *Server) readRequestHeader(cc codec.Codec) (req *request, keepReading bool, err error) {
-	req, _ = requestPool.Get().(*request)
+func (server *Server) readRequestHeader(cc codec.Codec) (*codec.Header, error) {
 	h, _ := codec.HeaderPool.Get().(*codec.Header)
-	if err = cc.ReadHeader(h); err != nil {
-		// client closed the connection
-		if err == io.EOF || err != io.ErrUnexpectedEOF {
-			return
+	if err := cc.ReadHeader(h); err != nil {
+		codec.HeaderPool.Put(h)
+		if err != io.EOF && err != io.ErrUnexpectedEOF {
+			log.Println("rpc server: read header error:", err)
 		}
-		log.Println("rpc server: read header error:", err)
-		return
+		return nil, err
 	}
-	// We read the header successfully. If we see an error now,
-	// we can still recover and move on to the next request.
-	keepReading = true
-	req.h = h
-	return
+	return h, nil
 }
 
-func (server *Server) readRequest(cc codec.Codec) (req *request, keepReading bool, err error) {
-	req, keepReading, err = server.readRequestHeader(cc)
+func (server *Server) readRequest(cc codec.Codec) (*request, error) {
+	h, err := server.readRequestHeader(cc)
 	if err != nil {
-		// discard argv
-		_ = cc.ReadBody(nil)
-		return
+		return nil, err
 	}
-
-	// We read the header successfully. If we see an error now,
-	// we can still recover and move on to the next request.
-	keepReading = true
-
-	// TODO: now we can't judge the type of request argv
+	req := &request{h: h}
+	// TODO: now we don't know the type of request argv
 	// day 1, just suppose it's string
 	req.argv = reflect.New(reflect.TypeOf(""))
 	if err = cc.ReadBody(req.argv.Interface()); err != nil {
 		log.Println("rpc server: read argv err:", err)
 	}
-	return
+	return req, nil
 }
 
 func (server *Server) sendResponse(cc codec.Codec, h *codec.Header, body interface{}, sending *sync.Mutex) {
@@ -139,17 +121,16 @@ func (server *Server) sendResponse(cc codec.Codec, h *codec.Header, body interfa
 	if err := cc.Write(h, body); err != nil {
 		log.Println("rpc server: write response error:", err)
 	}
+	codec.HeaderPool.Put(h) // recycle Header object
 }
 
 func (server *Server) handleRequest(cc codec.Codec, req *request, sending *sync.Mutex, wg *sync.WaitGroup) {
 	// TODO, should call registered rpc methods to get the right replyv
 	// day 1, just print argv and send a hello message
 	defer wg.Done()
-	defer codec.HeaderPool.Put(req.h) // recycle Header object
 	log.Println(req.h, req.argv.Elem())
 	req.replyv = reflect.ValueOf(fmt.Sprintf("geerpc resp %d", req.h.Seq))
 	server.sendResponse(cc, req.h, req.replyv.Interface(), sending)
-
 }
 
 // Accept accepts connections on the listener and serves requests
diff --git a/gee-rpc/day2-client/client.go b/gee-rpc/day2-client/client.go
index 79ef524..2cbbb0c 100644
--- a/gee-rpc/day2-client/client.go
+++ b/gee-rpc/day2-client/client.go
@@ -120,11 +120,10 @@ func (client *Client) send(call *Call) {
 }
 
 func (client *Client) receive() {
-	h, _ := codec.HeaderPool.Get().(*codec.Header)
-	defer codec.HeaderPool.Put(h)
+	var h codec.Header
 	var err error
 	for err == nil {
-		if err = client.cc.ReadHeader(h); err != nil {
+		if err = client.cc.ReadHeader(&h); err != nil {
 			break
 		}
 		call := client.removeCall(h.Seq)
@@ -139,6 +138,9 @@ func (client *Client) receive() {
 			call.done()
 		default:
 			err = client.cc.ReadBody(call.Reply)
+			if err != nil {
+				call.Error = errors.New("reading body " + err.Error())
+			}
 			call.done()
 		}
 	}
diff --git a/gee-rpc/day2-client/codec/gob.go b/gee-rpc/day2-client/codec/gob.go
index 808d97b..e4b2a67 100644
--- a/gee-rpc/day2-client/codec/gob.go
+++ b/gee-rpc/day2-client/codec/gob.go
@@ -42,11 +42,11 @@ func (c *GobCodec) Write(h *Header, body interface{}) (err error) {
 		}
 	}()
 	if err := c.enc.Encode(h); err != nil {
-		log.Println("rpc: gob error encoding header:", err)
+		log.Println("rpc codec: gob error encoding header:", err)
 		return err
 	}
 	if err := c.enc.Encode(body); err != nil {
-		log.Println("rpc: gob error encoding body:", err)
+		log.Println("rpc codec: gob error encoding body:", err)
 		return err
 	}
 	return nil
diff --git a/gee-rpc/day2-client/main/main.go b/gee-rpc/day2-client/main/main.go
index b370e82..e291353 100644
--- a/gee-rpc/day2-client/main/main.go
+++ b/gee-rpc/day2-client/main/main.go
@@ -5,6 +5,7 @@ import (
 	"geerpc"
 	"log"
 	"net"
+	"sync"
 )
 
 func startServer(addr chan string) {
@@ -25,12 +26,18 @@ func main() {
 	defer func() { _ = client.Close() }()
 
 	// send request & receive response
-	for i := 0; i < 3; i++ {
-		args := fmt.Sprintf("geerpc req %d", i)
-		var reply string
-		if err := client.Call("Foo.Sum", args, &reply); err != nil {
-			log.Fatal("call Foo.Sum error", err)
-		}
-		log.Println("reply:", reply)
+	var wg sync.WaitGroup
+	for i := 0; i < 5; i++ {
+		wg.Add(1)
+		go func(i int) {
+			defer wg.Done()
+			args := fmt.Sprintf("geerpc req %d", i)
+			var reply string
+			if err := client.Call("Foo.Sum", args, &reply); err != nil {
+				log.Fatal("call Foo.Sum error:", err)
+			}
+			log.Println("reply:", reply)
+		}(i)
 	}
+	wg.Wait()
 }
diff --git a/gee-rpc/day2-client/server.go b/gee-rpc/day2-client/server.go
index 7646f9d..5a8a9bf 100644
--- a/gee-rpc/day2-client/server.go
+++ b/gee-rpc/day2-client/server.go
@@ -63,18 +63,16 @@ func (server *Server) ServeConn(conn io.ReadWriteCloser) {
 var invalidRequest = struct{}{}
 
 func (server *Server) serveCodec(cc codec.Codec) {
-	sending := new(sync.Mutex) // ensure header and argv is not separated by other response
+	sending := new(sync.Mutex) // make sure to send a complete response
 	wg := new(sync.WaitGroup)  // wait until all request are handled
 	for {
-		req, keepReading, err := server.readRequest(cc)
+		req, err := server.readRequest(cc)
 		if err != nil {
-			if !keepReading {
+			if req == nil {
 				break // it's not possible to recover, so close the connection
 			}
-			if req != nil {
-				req.h.Error = err.Error()
-				server.sendResponse(cc, req.h, invalidRequest, sending)
-			}
+			req.h.Error = err.Error()
+			server.sendResponse(cc, req.h, invalidRequest, sending)
 			continue
 		}
 		wg.Add(1)
@@ -90,47 +88,31 @@ type request struct {
 	argv, replyv reflect.Value // argv and replyv of request
 }
 
-var requestPool = sync.Pool{
-	New: func() interface{} { return &request{} },
-}
-
-func (server *Server) readRequestHeader(cc codec.Codec) (req *request, keepReading bool, err error) {
-	req, _ = requestPool.Get().(*request)
+func (server *Server) readRequestHeader(cc codec.Codec) (*codec.Header, error) {
 	h, _ := codec.HeaderPool.Get().(*codec.Header)
-	if err = cc.ReadHeader(h); err != nil {
-		// client closed the connection
-		if err == io.EOF || err != io.ErrUnexpectedEOF {
-			return
+	if err := cc.ReadHeader(h); err != nil {
+		codec.HeaderPool.Put(h)
+		if err != io.EOF && err != io.ErrUnexpectedEOF {
+			log.Println("rpc server: read header error:", err)
 		}
-		log.Println("rpc server: read header error:", err)
-		return
+		return nil, err
 	}
-	// We read the header successfully. If we see an error now,
-	// we can still recover and move on to the next request.
-	keepReading = true
-	req.h = h
-	return
+	return h, nil
 }
 
-func (server *Server) readRequest(cc codec.Codec) (req *request, keepReading bool, err error) {
-	req, keepReading, err = server.readRequestHeader(cc)
+func (server *Server) readRequest(cc codec.Codec) (*request, error) {
+	h, err := server.readRequestHeader(cc)
 	if err != nil {
-		// discard argv
-		_ = cc.ReadBody(nil)
-		return
+		return nil, err
 	}
-
-	// We read the header successfully. If we see an error now,
-	// we can still recover and move on to the next request.
-	keepReading = true
-
-	// TODO: now we can't judge the type of request argv
+	req := &request{h: h}
+	// TODO: now we don't know the type of request argv
 	// day 1, just suppose it's string
 	req.argv = reflect.New(reflect.TypeOf(""))
 	if err = cc.ReadBody(req.argv.Interface()); err != nil {
 		log.Println("rpc server: read argv err:", err)
 	}
-	return
+	return req, nil
 }
 
 func (server *Server) sendResponse(cc codec.Codec, h *codec.Header, body interface{}, sending *sync.Mutex) {
@@ -139,17 +121,16 @@ func (server *Server) sendResponse(cc codec.Codec, h *codec.Header, body interfa
 	if err := cc.Write(h, body); err != nil {
 		log.Println("rpc server: write response error:", err)
 	}
+	codec.HeaderPool.Put(h) // recycle Header object
 }
 
 func (server *Server) handleRequest(cc codec.Codec, req *request, sending *sync.Mutex, wg *sync.WaitGroup) {
 	// TODO, should call registered rpc methods to get the right replyv
 	// day 1, just print argv and send a hello message
 	defer wg.Done()
-	defer codec.HeaderPool.Put(req.h) // recycle Header object
 	log.Println(req.h, req.argv.Elem())
 	req.replyv = reflect.ValueOf(fmt.Sprintf("geerpc resp %d", req.h.Seq))
 	server.sendResponse(cc, req.h, req.replyv.Interface(), sending)
-
 }
 
 // Accept accepts connections on the listener and serves requests
diff --git a/gee-rpc/day3-service/client.go b/gee-rpc/day3-service/client.go
new file mode 100644
index 0000000..2cbbb0c
--- /dev/null
+++ b/gee-rpc/day3-service/client.go
@@ -0,0 +1,221 @@
+// Copyright 2009 The Go Authors. All rights reserved.
+// Use of this source code is governed by a BSD-style
+// license that can be found in the LICENSE file.
+
+package geerpc
+
+import (
+	"encoding/json"
+	"errors"
+	"fmt"
+	"geerpc/codec"
+	"io"
+	"log"
+	"net"
+	"sync"
+)
+
+// Call represents an active RPC.
+type Call struct {
+	ServiceMethod string      // format "<service>.<method>"
+	Args          interface{} // arguments to the function
+	Reply         interface{} // reply from the function
+	Error         error       // if error occurs, it will be set
+	Done          chan *Call  // Strobes when call is complete.
+}
+
+func (call *Call) done() {
+	call.Done <- call
+}
+
+// Client represents an RPC Client.
+// There may be multiple outstanding Calls associated
+// with a single Client, and a Client may be used by
+// multiple goroutines simultaneously.
+type Client struct {
+	cc      codec.Codec
+	sending sync.Mutex // protect sending a complete request
+	mu      sync.Mutex // protect following
+	seq     uint64
+	pending map[uint64]*Call
+	closed  bool // user has called Close
+}
+
+var _ io.Closer = (*Client)(nil)
+
+var ErrShutdown = errors.New("connection is shut down")
+
+// Close the connection
+func (client *Client) Close() error {
+	client.mu.Lock()
+	defer client.mu.Unlock()
+	if client.closed {
+		return ErrShutdown
+	}
+	client.closed = true
+	return client.cc.Close()
+}
+
+func (client *Client) registerCall(call *Call) (uint64, error) {
+	client.mu.Lock()
+	defer client.mu.Unlock()
+	if client.closed {
+		return 0, ErrShutdown
+	}
+	seq := client.seq
+	client.pending[seq] = call
+	client.seq++
+	return seq, nil
+}
+
+func (client *Client) removeCall(seq uint64) *Call {
+	client.mu.Lock()
+	defer client.mu.Unlock()
+	call := client.pending[seq]
+	delete(client.pending, seq)
+	return call
+}
+
+func (client *Client) terminateCalls(err error) {
+	client.sending.Lock()
+	defer client.sending.Unlock()
+	client.mu.Lock()
+	defer client.mu.Unlock()
+	for _, call := range client.pending {
+		call.Error = err
+		call.done()
+	}
+}
+
+func (client *Client) send(call *Call) {
+	// make sure that the client will send a complete request
+	client.sending.Lock()
+	defer client.sending.Unlock()
+
+	// register this call.
+	seq, err := client.registerCall(call)
+	if err != nil {
+		call.Error = err
+		call.done()
+		return
+	}
+
+	// prepare request header
+	h, _ := codec.HeaderPool.Get().(*codec.Header)
+	h.ServiceMethod = call.ServiceMethod
+	h.Seq = seq
+	h.Error = ""
+	defer codec.HeaderPool.Put(h)
+
+	// encode and send the request
+	if err := client.cc.Write(h, call.Args); err != nil {
+		call := client.removeCall(seq)
+		// call may be nil, it usually means that Write partially failed,
+		// client has received the response and handled
+		if call != nil {
+			call.Error = err
+			call.done()
+		}
+	}
+}
+
+func (client *Client) receive() {
+	var h codec.Header
+	var err error
+	for err == nil {
+		if err = client.cc.ReadHeader(&h); err != nil {
+			break
+		}
+		call := client.removeCall(h.Seq)
+		switch {
+		case call == nil:
+			// it usually means that Write partially failed
+			// and call was already removed.
+			err = client.cc.ReadBody(nil)
+		case h.Error != "":
+			call.Error = fmt.Errorf(h.Error)
+			err = client.cc.ReadBody(nil)
+			call.done()
+		default:
+			err = client.cc.ReadBody(call.Reply)
+			if err != nil {
+				call.Error = errors.New("reading body " + err.Error())
+			}
+			call.done()
+		}
+	}
+	// error occurs, so terminateCalls pending calls
+	client.terminateCalls(err)
+}
+
+// Go invokes the function asynchronously.
+// It returns the Call structure representing the invocation.
+func (client *Client) Go(serviceMethod string, args, reply interface{}, done chan *Call) *Call {
+	if done == nil {
+		done = make(chan *Call, 10)
+	} else if cap(done) == 0 {
+		log.Panic("rpc client: done channel is unbuffered")
+	}
+	call := &Call{
+		ServiceMethod: serviceMethod,
+		Args:          args,
+		Reply:         reply,
+		Done:          done,
+	}
+	client.send(call)
+	return call
+}
+
+// Call invokes the named function, waits for it to complete,
+// and returns its error status.
+func (client *Client) Call(serviceMethod string, args, reply interface{}) error {
+	call := <-client.Go(serviceMethod, args, reply, make(chan *Call, 1)).Done
+	return call.Error
+}
+
+func NewClient(conn io.ReadWriteCloser, opt *Options) (*Client, error) {
+	var err error
+	defer func() {
+		if err != nil {
+			_ = conn.Close()
+		}
+	}()
+	if opt.MagicNumber == 0 {
+		opt.MagicNumber = MagicNumber
+	}
+	f := codec.NewCodecFuncMap[opt.CodecType]
+	if f == nil {
+		err = fmt.Errorf("invalid codec type %s", opt.CodecType)
+		log.Println("rpc client: codec error:", err)
+		return nil, err
+	}
+	// send options with server
+	if err = json.NewEncoder(conn).Encode(opt); err != nil {
+		log.Println("rpc client: options error: ", err)
+		return nil, err
+	}
+	return newClientCodec(f(conn)), nil
+}
+
+func newClientCodec(cc codec.Codec) *Client {
+	client := &Client{
+		cc:      cc,
+		pending: make(map[uint64]*Call),
+	}
+	go client.receive()
+	return client
+}
+
+// DialWithOptions connects to an RPC server at the specified network address
+func DialWithOptions(network, address string, opt *Options) (*Client, error) {
+	conn, err := net.Dial(network, address)
+	if err != nil {
+		return nil, err
+	}
+	return NewClient(conn, opt)
+}
+
+// Dial connects to an RPC server at the specified network address
+func Dial(network, address string) (*Client, error) {
+	return DialWithOptions(network, address, defaultOptions)
+}
diff --git a/gee-rpc/day3-service/codec/codec.go b/gee-rpc/day3-service/codec/codec.go
new file mode 100644
index 0000000..54d2e56
--- /dev/null
+++ b/gee-rpc/day3-service/codec/codec.go
@@ -0,0 +1,39 @@
+package codec
+
+import (
+	"io"
+	"sync"
+)
+
+type Header struct {
+	ServiceMethod string // format "Service.Method"
+	Seq           uint64 // sequence number chosen by client
+	Error         string
+}
+
+var HeaderPool = sync.Pool{
+	New: func() interface{} { return &Header{} },
+}
+
+type Codec interface {
+	io.Closer
+	ReadHeader(*Header) error
+	ReadBody(interface{}) error
+	Write(*Header, interface{}) error
+}
+
+type NewCodecFunc func(io.ReadWriteCloser) Codec
+
+type Type string
+
+const (
+	GobType  Type = "application/gob"
+	JsonType Type = "application/json"
+)
+
+var NewCodecFuncMap map[Type]NewCodecFunc
+
+func init() {
+	NewCodecFuncMap = make(map[Type]NewCodecFunc)
+	NewCodecFuncMap[GobType] = NewGobCodec
+}
diff --git a/gee-rpc/day3-service/codec/gob.go b/gee-rpc/day3-service/codec/gob.go
new file mode 100644
index 0000000..808d97b
--- /dev/null
+++ b/gee-rpc/day3-service/codec/gob.go
@@ -0,0 +1,57 @@
+package codec
+
+import (
+	"bufio"
+	"encoding/gob"
+	"io"
+	"log"
+)
+
+type GobCodec struct {
+	conn io.ReadWriteCloser
+	buf  *bufio.Writer
+	dec  *gob.Decoder
+	enc  *gob.Encoder
+}
+
+var _ Codec = (*GobCodec)(nil)
+
+func NewGobCodec(conn io.ReadWriteCloser) Codec {
+	buf := bufio.NewWriter(conn)
+	return &GobCodec{
+		conn: conn,
+		buf:  buf,
+		dec:  gob.NewDecoder(conn),
+		enc:  gob.NewEncoder(buf),
+	}
+}
+
+func (c *GobCodec) ReadHeader(h *Header) error {
+	return c.dec.Decode(h)
+}
+
+func (c *GobCodec) ReadBody(body interface{}) error {
+	return c.dec.Decode(body)
+}
+
+func (c *GobCodec) Write(h *Header, body interface{}) (err error) {
+	defer func() {
+		_ = c.buf.Flush()
+		if err != nil {
+			_ = c.Close()
+		}
+	}()
+	if err := c.enc.Encode(h); err != nil {
+		log.Println("rpc: gob error encoding header:", err)
+		return err
+	}
+	if err := c.enc.Encode(body); err != nil {
+		log.Println("rpc: gob error encoding body:", err)
+		return err
+	}
+	return nil
+}
+
+func (c *GobCodec) Close() error {
+	return c.conn.Close()
+}
diff --git a/gee-rpc/day3-service/go.mod b/gee-rpc/day3-service/go.mod
new file mode 100644
index 0000000..0ec8aeb
--- /dev/null
+++ b/gee-rpc/day3-service/go.mod
@@ -0,0 +1,3 @@
+module geerpc
+
+go 1.13
diff --git a/gee-rpc/day3-service/main/main.go b/gee-rpc/day3-service/main/main.go
new file mode 100644
index 0000000..c526e11
--- /dev/null
+++ b/gee-rpc/day3-service/main/main.go
@@ -0,0 +1,55 @@
+package main
+
+import (
+	"geerpc"
+	"log"
+	"net"
+	"sync"
+)
+
+type Foo int
+
+type Args struct{ Num1, Num2 int }
+
+func (f Foo) Sum(args Args, reply *int) error {
+	*reply = args.Num1 + args.Num2
+	return nil
+}
+
+func startServer(addr chan string) {
+	var foo Foo
+	if err := geerpc.Register(&foo); err != nil {
+		log.Fatal("register error:", err)
+	}
+	// pick a free port
+	l, err := net.Listen("tcp", ":0")
+	if err != nil {
+		log.Fatal("network error:", err)
+	}
+	log.Println("start rpc server on", l.Addr())
+	addr <- l.Addr().String()
+	geerpc.Accept(l)
+}
+
+func main() {
+	addr := make(chan string)
+	go startServer(addr)
+	client, _ := geerpc.Dial("tcp", <-addr)
+	defer func() { _ = client.Close() }()
+
+	// send request & receive response
+	var wg sync.WaitGroup
+	for i := 0; i < 5; i++ {
+		wg.Add(1)
+		go func(i int) {
+			defer wg.Done()
+			args := &Args{Num1: i, Num2: i * i}
+			var reply int
+			if err := client.Call("Foo.Sum", args, &reply); err != nil {
+				log.Fatal("call Foo.Sum error:", err)
+			}
+			log.Printf("%d + %d = %d", args.Num1, args.Num2, reply)
+		}(i)
+	}
+	wg.Wait()
+}
diff --git a/gee-rpc/day3-service/server.go b/gee-rpc/day3-service/server.go
new file mode 100644
index 0000000..f29f33d
--- /dev/null
+++ b/gee-rpc/day3-service/server.go
@@ -0,0 +1,203 @@
+// Copyright 2009 The Go Authors. All rights reserved.
+// Use of this source code is governed by a BSD-style
+// license that can be found in the LICENSE file.
+
+package geerpc
+
+import (
+	"encoding/json"
+	"errors"
+	"geerpc/codec"
+	"io"
+	"log"
+	"net"
+	"reflect"
+	"strings"
+	"sync"
+)
+
+const MagicNumber = 0x3bef5c
+
+type Options struct {
+	MagicNumber int        // MagicNumber marks this's a geerpc request
+	CodecType   codec.Type // client may choose different Codec to encode body
+}
+
+var defaultOptions = &Options{
+	MagicNumber: MagicNumber,
+	CodecType:   codec.GobType,
+}
+
+// Server represents an RPC Server.
+type Server struct {
+	serviceMap sync.Map
+}
+
+// NewServer returns a new Server.
+func NewServer() *Server {
+	return &Server{}
+}
+
+// DefaultServer is the default instance of *Server.
+var DefaultServer = NewServer()
+
+// ServeConn runs the server on a single connection.
+// ServeConn blocks, serving the connection until the client hangs up.
+func (server *Server) ServeConn(conn io.ReadWriteCloser) {
+	defer func() { _ = conn.Close() }()
+	var opt Options
+	if err := json.NewDecoder(conn).Decode(&opt); err != nil {
+		log.Println("rpc server: options error: ", err)
+		return
+	}
+	if opt.MagicNumber != MagicNumber {
+		log.Printf("rpc server: invalid magic number %x", opt.MagicNumber)
+		return
+	}
+	f := codec.NewCodecFuncMap[opt.CodecType]
+	if f == nil {
+		log.Printf("rpc server: invalid codec type %s", opt.CodecType)
+		return
+	}
+	server.serveCodec(f(conn))
+}
+
+// invalidRequest is a placeholder for response argv when error occurs
+var invalidRequest = struct{}{}
+
+func (server *Server) serveCodec(cc codec.Codec) {
+	sending := new(sync.Mutex) // make sure to send a complete response
+	wg := new(sync.WaitGroup)  // wait until all request are handled
+	for {
+		req, err := server.readRequest(cc)
+		if err != nil {
+			if req == nil {
+				break // it's not possible to recover, so close the connection
+			}
+			req.h.Error = err.Error()
+			server.sendResponse(cc, req.h, invalidRequest, sending)
+			continue
+		}
+		wg.Add(1)
+		go server.handleRequest(cc, req, sending, wg)
+	}
+	wg.Wait()
+	_ = cc.Close()
+}
+
+// request stores all information of a call
+type request struct {
+	h            *codec.Header // header of request
+	argv, replyv reflect.Value // argv and replyv of request
+	mtype        *methodType
+	svc          *service
+}
+
+func (server *Server) readRequestHeader(cc codec.Codec) (*codec.Header, error) {
+	h, _ := codec.HeaderPool.Get().(*codec.Header)
+	if err := cc.ReadHeader(h); err != nil {
+		codec.HeaderPool.Put(h)
+		if err != io.EOF && err != io.ErrUnexpectedEOF {
+			log.Println("rpc server: read header error:", err)
+		}
+		return nil, err
+	}
+	return h, nil
+}
+
+func (server *Server) findService(serviceMethod string) (svc *service, mtype *methodType, err error) {
+	dot := strings.LastIndex(serviceMethod, ".")
+	if dot < 0 {
+		err = errors.New("rpc server: service/method request ill-formed: " + serviceMethod)
+		return
+	}
+	serviceName, methodName := serviceMethod[:dot], serviceMethod[dot+1:]
+	svci, ok := server.serviceMap.Load(serviceName)
+	if !ok {
+		err = errors.New("rpc server: can't find service " + serviceName)
+		return
+	}
+	svc = svci.(*service)
+	mtype = svc.method[methodName]
+	if mtype == nil {
+		err = errors.New("rpc server: can't find method " + methodName)
+	}
+	return
+}
+
+func (server *Server) readRequest(cc codec.Codec) (*request, error) {
+	h, err := server.readRequestHeader(cc)
+	if err != nil {
+		return nil, err
+	}
+	req := &request{h: h}
+	req.svc, req.mtype, err = server.findService(h.ServiceMethod)
+	if err != nil {
+		return req, err
+	}
+	req.argv = req.mtype.newArgv()
+	req.replyv = req.mtype.newReplyv()
+
+	// make sure that argvi is a pointer, ReadBody need a pointer as parameter
+	argvi := req.argv.Interface()
+	if req.argv.Type().Kind() != reflect.Ptr {
+		argvi = req.argv.Addr().Interface()
+	}
+	if err = cc.ReadBody(argvi); err != nil {
+		log.Println("rpc server: read body err:", err)
+		return req, err
+	}
+	return req, nil
+}
+
+func (server *Server) sendResponse(cc codec.Codec, h *codec.Header, body interface{}, sending *sync.Mutex) {
+	sending.Lock()
+	defer sending.Unlock()
+	if err := cc.Write(h, body); err != nil {
+		log.Println("rpc server: write response error:", err)
+	}
+	codec.HeaderPool.Put(h) // recycle Header object
+}
+
+func (server *Server) handleRequest(cc codec.Codec, req *request, sending *sync.Mutex, wg *sync.WaitGroup) {
+	defer wg.Done()
+	err := req.svc.call(req.mtype, req.argv, req.replyv)
+	if err != nil {
+		req.h.Error = err.Error()
+	}
+	server.sendResponse(cc, req.h, req.replyv.Interface(), sending)
+}
+
+// Accept accepts connections on the listener and serves requests
+// for each incoming connection.
+func (server *Server) Accept(lis net.Listener) {
+	for {
+		conn, err := lis.Accept()
+		if err != nil {
+			log.Println("rpc server: accept error:", err)
+			return
+		}
+		go server.ServeConn(conn)
+	}
+}
+
+// Accept accepts connections on the listener and serves requests
+// for each incoming connection.
+func Accept(lis net.Listener) { DefaultServer.Accept(lis) }
+
+// Register publishes in the server the set of methods of the
+// receiver value that satisfy the following conditions:
+//	- exported method of exported type
+//	- two arguments, both of exported type
+//	- the second argument is a pointer
+//	- one return value, of type error
+func (server *Server) Register(rcvr interface{}) error {
+	s := newService(rcvr)
+	if _, dup := server.serviceMap.LoadOrStore(s.name, s); dup {
+		return errors.New("rpc: service already defined: " + s.name)
+	}
+	return nil
+}
+
+// Register publishes the receiver's methods in the DefaultServer.
+func Register(rcvr interface{}) error { return DefaultServer.Register(rcvr) }
diff --git a/gee-rpc/day3-service/service.go b/gee-rpc/day3-service/service.go
index de7182b..fcdfe8d 100644
--- a/gee-rpc/day3-service/service.go
+++ b/gee-rpc/day3-service/service.go
@@ -4,26 +4,28 @@ import (
 	"go/ast"
 	"log"
 	"reflect"
+	"sync/atomic"
 )
 
 type methodType struct {
 	method    reflect.Method
 	argType   reflect.Type
 	replyType reflect.Type
+	numCalls  uint64
 }
 
-func (m *methodType) NewArg() reflect.Value {
+func (m *methodType) newArgv() reflect.Value {
 	var argv reflect.Value
 	// arg may be a pointer type, or a value type
 	if m.argType.Kind() == reflect.Ptr {
 		argv = reflect.New(m.argType.Elem())
 	} else {
-		argv = reflect.New(m.argType)
+		argv = reflect.New(m.argType).Elem()
 	}
 	return argv
 }
 
-func (m *methodType) NewReply() interface{} {
+func (m *methodType) newReplyv() reflect.Value {
 	// reply must be a pointer type
 	replyv := reflect.New(m.replyType.Elem())
 	switch m.replyType.Elem().Kind() {
@@ -50,6 +52,7 @@ func newService(rcvr interface{}) *service {
 	if !ast.IsExported(s.name) {
 		log.Fatalf("rpc server: %s is not a valid service name", s.name)
 	}
+	s.registerMethods()
 	return s
 }
 
@@ -64,7 +67,6 @@ func (s *service) registerMethods() {
 		if mType.Out(0) != reflect.TypeOf((*error)(nil)).Elem() {
 			continue
 		}
-
 		argType, replyType := mType.In(1), mType.In(2)
 		if !isExportedOrBuiltinType(argType) || !isExportedOrBuiltinType(replyType) {
 			continue
@@ -78,12 +80,9 @@ func (s *service) registerMethods() {
 	}
 }
 
-func (s *service) call(mType methodType, argv, replyv reflect.Value) error {
-	f := mType.method.Func
-	// if argv is not a ptr, need to indirect before calling.
-	if mType.argType.Kind() != reflect.Ptr {
-		argv = argv.Elem()
-	}
+func (s *service) call(m *methodType, argv, replyv reflect.Value) error {
+	atomic.AddUint64(&m.numCalls, 1)
+	f := m.method.Func
 	returnValues := f.Call([]reflect.Value{s.rcvr, argv, replyv})
 	if errInter := returnValues[0].Interface(); errInter != nil {
 		return errInter.(error)
diff --git a/gee-rpc/day3-service/service_test.go b/gee-rpc/day3-service/service_test.go
new file mode 100644
index 0000000..4b35124
--- /dev/null
+++ b/gee-rpc/day3-service/service_test.go
@@ -0,0 +1,48 @@
+package geerpc
+
+import (
+	"fmt"
+	"reflect"
+	"testing"
+)
+
+type Foo int
+
+type Args struct{ Num1, Num2 int }
+
+func (f Foo) Sum(args Args, reply *int) error {
+	*reply = args.Num1 + args.Num2
+	return nil
+}
+
+// it's not a exported method
+func (f Foo) sum(args Args, reply *int) error {
+	*reply = args.Num1 + args.Num2
+	return nil
+}
+
+func _assert(condition bool, msg string, v ...interface{}) {
+	if !condition {
+		panic(fmt.Sprintf("assertion failed: "+msg, v...))
+	}
+}
+
+func TestNewService(t *testing.T) {
+	var foo Foo
+	s := newService(&foo)
+	_assert(len(s.method) == 1, "wrong service method, expect 1, but got %d", len(s.method))
+	mType := s.method["Sum"]
+	_assert(mType != nil, "wrong method, Sum shouldn't nil")
+}
+
+func TestMethodType_Call(t *testing.T) {
+	var foo Foo
+	s := newService(&foo)
+	mType := s.method["Sum"]
+
+	argv := mType.newArgv()
+	replyv := mType.newReplyv()
+	argv.Set(reflect.ValueOf(Args{Num1: 1, Num2: 3}))
+	err := s.call(mType, argv, replyv)
+	_assert(err == nil && *replyv.Interface().(*int) == 4 && mType.numCalls == 1, "failed to call Foo.Sum")
+}

From 7bd912d051d6e94c4e4a723800c4ad1625e82996 Mon Sep 17 00:00:00 2001
From: gzdaijie <gzdaijie@gmail.com>
Date: Thu, 1 Oct 2020 19:24:57 +0800
Subject: [PATCH 075/122] remove headerPool to simplify the code

---
 gee-rpc/day1-codec/codec/codec.go   |  5 -----
 gee-rpc/day1-codec/server.go        |  8 +++-----
 gee-rpc/day2-client/client.go       | 15 +++++++--------
 gee-rpc/day2-client/codec/codec.go  |  5 -----
 gee-rpc/day2-client/server.go       |  8 +++-----
 gee-rpc/day3-service/client.go      | 15 +++++++--------
 gee-rpc/day3-service/codec/codec.go |  5 -----
 gee-rpc/day3-service/server.go      |  8 +++-----
 8 files changed, 23 insertions(+), 46 deletions(-)

diff --git a/gee-rpc/day1-codec/codec/codec.go b/gee-rpc/day1-codec/codec/codec.go
index 54d2e56..ba28fba 100644
--- a/gee-rpc/day1-codec/codec/codec.go
+++ b/gee-rpc/day1-codec/codec/codec.go
@@ -2,7 +2,6 @@ package codec
 
 import (
 	"io"
-	"sync"
 )
 
 type Header struct {
@@ -11,10 +10,6 @@ type Header struct {
 	Error         string
 }
 
-var HeaderPool = sync.Pool{
-	New: func() interface{} { return &Header{} },
-}
-
 type Codec interface {
 	io.Closer
 	ReadHeader(*Header) error
diff --git a/gee-rpc/day1-codec/server.go b/gee-rpc/day1-codec/server.go
index 5a8a9bf..06ef763 100644
--- a/gee-rpc/day1-codec/server.go
+++ b/gee-rpc/day1-codec/server.go
@@ -89,15 +89,14 @@ type request struct {
 }
 
 func (server *Server) readRequestHeader(cc codec.Codec) (*codec.Header, error) {
-	h, _ := codec.HeaderPool.Get().(*codec.Header)
-	if err := cc.ReadHeader(h); err != nil {
-		codec.HeaderPool.Put(h)
+	var h codec.Header
+	if err := cc.ReadHeader(&h); err != nil {
 		if err != io.EOF && err != io.ErrUnexpectedEOF {
 			log.Println("rpc server: read header error:", err)
 		}
 		return nil, err
 	}
-	return h, nil
+	return &h, nil
 }
 
 func (server *Server) readRequest(cc codec.Codec) (*request, error) {
@@ -121,7 +120,6 @@ func (server *Server) sendResponse(cc codec.Codec, h *codec.Header, body interfa
 	if err := cc.Write(h, body); err != nil {
 		log.Println("rpc server: write response error:", err)
 	}
-	codec.HeaderPool.Put(h) // recycle Header object
 }
 
 func (server *Server) handleRequest(cc codec.Codec, req *request, sending *sync.Mutex, wg *sync.WaitGroup) {
diff --git a/gee-rpc/day2-client/client.go b/gee-rpc/day2-client/client.go
index 2cbbb0c..3fd885e 100644
--- a/gee-rpc/day2-client/client.go
+++ b/gee-rpc/day2-client/client.go
@@ -34,7 +34,8 @@ func (call *Call) done() {
 // multiple goroutines simultaneously.
 type Client struct {
 	cc      codec.Codec
-	sending sync.Mutex // protect sending a complete request
+	sending sync.Mutex // protect following
+	header  codec.Header
 	mu      sync.Mutex // protect following
 	seq     uint64
 	pending map[uint64]*Call
@@ -101,14 +102,12 @@ func (client *Client) send(call *Call) {
 	}
 
 	// prepare request header
-	h, _ := codec.HeaderPool.Get().(*codec.Header)
-	h.ServiceMethod = call.ServiceMethod
-	h.Seq = seq
-	h.Error = ""
-	defer codec.HeaderPool.Put(h)
+	client.header.ServiceMethod = call.ServiceMethod
+	client.header.Seq = seq
+	client.header.Error = ""
 
 	// encode and send the request
-	if err := client.cc.Write(h, call.Args); err != nil {
+	if err := client.cc.Write(&client.header, call.Args); err != nil {
 		call := client.removeCall(seq)
 		// call may be nil, it usually means that Write partially failed,
 		// client has received the response and handled
@@ -120,9 +119,9 @@ func (client *Client) send(call *Call) {
 }
 
 func (client *Client) receive() {
-	var h codec.Header
 	var err error
 	for err == nil {
+		var h codec.Header
 		if err = client.cc.ReadHeader(&h); err != nil {
 			break
 		}
diff --git a/gee-rpc/day2-client/codec/codec.go b/gee-rpc/day2-client/codec/codec.go
index 54d2e56..ba28fba 100644
--- a/gee-rpc/day2-client/codec/codec.go
+++ b/gee-rpc/day2-client/codec/codec.go
@@ -2,7 +2,6 @@ package codec
 
 import (
 	"io"
-	"sync"
 )
 
 type Header struct {
@@ -11,10 +10,6 @@ type Header struct {
 	Error         string
 }
 
-var HeaderPool = sync.Pool{
-	New: func() interface{} { return &Header{} },
-}
-
 type Codec interface {
 	io.Closer
 	ReadHeader(*Header) error
diff --git a/gee-rpc/day2-client/server.go b/gee-rpc/day2-client/server.go
index 5a8a9bf..06ef763 100644
--- a/gee-rpc/day2-client/server.go
+++ b/gee-rpc/day2-client/server.go
@@ -89,15 +89,14 @@ type request struct {
 }
 
 func (server *Server) readRequestHeader(cc codec.Codec) (*codec.Header, error) {
-	h, _ := codec.HeaderPool.Get().(*codec.Header)
-	if err := cc.ReadHeader(h); err != nil {
-		codec.HeaderPool.Put(h)
+	var h codec.Header
+	if err := cc.ReadHeader(&h); err != nil {
 		if err != io.EOF && err != io.ErrUnexpectedEOF {
 			log.Println("rpc server: read header error:", err)
 		}
 		return nil, err
 	}
-	return h, nil
+	return &h, nil
 }
 
 func (server *Server) readRequest(cc codec.Codec) (*request, error) {
@@ -121,7 +120,6 @@ func (server *Server) sendResponse(cc codec.Codec, h *codec.Header, body interfa
 	if err := cc.Write(h, body); err != nil {
 		log.Println("rpc server: write response error:", err)
 	}
-	codec.HeaderPool.Put(h) // recycle Header object
 }
 
 func (server *Server) handleRequest(cc codec.Codec, req *request, sending *sync.Mutex, wg *sync.WaitGroup) {
diff --git a/gee-rpc/day3-service/client.go b/gee-rpc/day3-service/client.go
index 2cbbb0c..3fd885e 100644
--- a/gee-rpc/day3-service/client.go
+++ b/gee-rpc/day3-service/client.go
@@ -34,7 +34,8 @@ func (call *Call) done() {
 // multiple goroutines simultaneously.
 type Client struct {
 	cc      codec.Codec
-	sending sync.Mutex // protect sending a complete request
+	sending sync.Mutex // protect following
+	header  codec.Header
 	mu      sync.Mutex // protect following
 	seq     uint64
 	pending map[uint64]*Call
@@ -101,14 +102,12 @@ func (client *Client) send(call *Call) {
 	}
 
 	// prepare request header
-	h, _ := codec.HeaderPool.Get().(*codec.Header)
-	h.ServiceMethod = call.ServiceMethod
-	h.Seq = seq
-	h.Error = ""
-	defer codec.HeaderPool.Put(h)
+	client.header.ServiceMethod = call.ServiceMethod
+	client.header.Seq = seq
+	client.header.Error = ""
 
 	// encode and send the request
-	if err := client.cc.Write(h, call.Args); err != nil {
+	if err := client.cc.Write(&client.header, call.Args); err != nil {
 		call := client.removeCall(seq)
 		// call may be nil, it usually means that Write partially failed,
 		// client has received the response and handled
@@ -120,9 +119,9 @@ func (client *Client) send(call *Call) {
 }
 
 func (client *Client) receive() {
-	var h codec.Header
 	var err error
 	for err == nil {
+		var h codec.Header
 		if err = client.cc.ReadHeader(&h); err != nil {
 			break
 		}
diff --git a/gee-rpc/day3-service/codec/codec.go b/gee-rpc/day3-service/codec/codec.go
index 54d2e56..ba28fba 100644
--- a/gee-rpc/day3-service/codec/codec.go
+++ b/gee-rpc/day3-service/codec/codec.go
@@ -2,7 +2,6 @@ package codec
 
 import (
 	"io"
-	"sync"
 )
 
 type Header struct {
@@ -11,10 +10,6 @@ type Header struct {
 	Error         string
 }
 
-var HeaderPool = sync.Pool{
-	New: func() interface{} { return &Header{} },
-}
-
 type Codec interface {
 	io.Closer
 	ReadHeader(*Header) error
diff --git a/gee-rpc/day3-service/server.go b/gee-rpc/day3-service/server.go
index f29f33d..6558dad 100644
--- a/gee-rpc/day3-service/server.go
+++ b/gee-rpc/day3-service/server.go
@@ -94,15 +94,14 @@ type request struct {
 }
 
 func (server *Server) readRequestHeader(cc codec.Codec) (*codec.Header, error) {
-	h, _ := codec.HeaderPool.Get().(*codec.Header)
-	if err := cc.ReadHeader(h); err != nil {
-		codec.HeaderPool.Put(h)
+	var h codec.Header
+	if err := cc.ReadHeader(&h); err != nil {
 		if err != io.EOF && err != io.ErrUnexpectedEOF {
 			log.Println("rpc server: read header error:", err)
 		}
 		return nil, err
 	}
-	return h, nil
+	return &h, nil
 }
 
 func (server *Server) findService(serviceMethod string) (svc *service, mtype *methodType, err error) {
@@ -156,7 +155,6 @@ func (server *Server) sendResponse(cc codec.Codec, h *codec.Header, body interfa
 	if err := cc.Write(h, body); err != nil {
 		log.Println("rpc server: write response error:", err)
 	}
-	codec.HeaderPool.Put(h) // recycle Header object
 }
 
 func (server *Server) handleRequest(cc codec.Codec, req *request, sending *sync.Mutex, wg *sync.WaitGroup) {

From 4f981d40adab02909882ff23d94940783c58ada5 Mon Sep 17 00:00:00 2001
From: gzdaijie <gzdaijie@gmail.com>
Date: Thu, 1 Oct 2020 22:12:48 +0800
Subject: [PATCH 076/122] add geerpc day4 http and debug

---
 gee-rpc/day2-client/client.go           |  13 +-
 gee-rpc/day3-service/client.go          |  13 +-
 gee-rpc/day3-service/service.go         |  32 +--
 gee-rpc/day4-http-debug/client.go       | 254 ++++++++++++++++++++++++
 gee-rpc/day4-http-debug/codec/codec.go  |  34 ++++
 gee-rpc/day4-http-debug/codec/gob.go    |  57 ++++++
 gee-rpc/day4-http-debug/debug.go        |  60 ++++++
 gee-rpc/day4-http-debug/go.mod          |   3 +
 gee-rpc/day4-http-debug/main/main.go    |  53 +++++
 gee-rpc/day4-http-debug/server.go       | 238 ++++++++++++++++++++++
 gee-rpc/day4-http-debug/service.go      |  95 +++++++++
 gee-rpc/day4-http-debug/service_test.go |  48 +++++
 12 files changed, 870 insertions(+), 30 deletions(-)
 create mode 100644 gee-rpc/day4-http-debug/client.go
 create mode 100644 gee-rpc/day4-http-debug/codec/codec.go
 create mode 100644 gee-rpc/day4-http-debug/codec/gob.go
 create mode 100644 gee-rpc/day4-http-debug/debug.go
 create mode 100644 gee-rpc/day4-http-debug/go.mod
 create mode 100644 gee-rpc/day4-http-debug/main/main.go
 create mode 100644 gee-rpc/day4-http-debug/server.go
 create mode 100644 gee-rpc/day4-http-debug/service.go
 create mode 100644 gee-rpc/day4-http-debug/service_test.go

diff --git a/gee-rpc/day2-client/client.go b/gee-rpc/day2-client/client.go
index 3fd885e..83119f0 100644
--- a/gee-rpc/day2-client/client.go
+++ b/gee-rpc/day2-client/client.go
@@ -205,16 +205,15 @@ func newClientCodec(cc codec.Codec) *Client {
 	return client
 }
 
-// DialWithOptions connects to an RPC server at the specified network address
-func DialWithOptions(network, address string, opt *Options) (*Client, error) {
+// Dial connects to an RPC server at the specified network address
+func Dial(network, address string, opts ...*Options) (*Client, error) {
+	opt := defaultOptions
+	if len(opts) > 0 && opts[0] != nil {
+		opt = opts[0]
+	}
 	conn, err := net.Dial(network, address)
 	if err != nil {
 		return nil, err
 	}
 	return NewClient(conn, opt)
 }
-
-// Dial connects to an RPC server at the specified network address
-func Dial(network, address string) (*Client, error) {
-	return DialWithOptions(network, address, defaultOptions)
-}
diff --git a/gee-rpc/day3-service/client.go b/gee-rpc/day3-service/client.go
index 3fd885e..83119f0 100644
--- a/gee-rpc/day3-service/client.go
+++ b/gee-rpc/day3-service/client.go
@@ -205,16 +205,15 @@ func newClientCodec(cc codec.Codec) *Client {
 	return client
 }
 
-// DialWithOptions connects to an RPC server at the specified network address
-func DialWithOptions(network, address string, opt *Options) (*Client, error) {
+// Dial connects to an RPC server at the specified network address
+func Dial(network, address string, opts ...*Options) (*Client, error) {
+	opt := defaultOptions
+	if len(opts) > 0 && opts[0] != nil {
+		opt = opts[0]
+	}
 	conn, err := net.Dial(network, address)
 	if err != nil {
 		return nil, err
 	}
 	return NewClient(conn, opt)
 }
-
-// Dial connects to an RPC server at the specified network address
-func Dial(network, address string) (*Client, error) {
-	return DialWithOptions(network, address, defaultOptions)
-}
diff --git a/gee-rpc/day3-service/service.go b/gee-rpc/day3-service/service.go
index fcdfe8d..e0711cd 100644
--- a/gee-rpc/day3-service/service.go
+++ b/gee-rpc/day3-service/service.go
@@ -8,31 +8,31 @@ import (
 )
 
 type methodType struct {
-	method    reflect.Method
-	argType   reflect.Type
-	replyType reflect.Type
-	numCalls  uint64
+	Method    reflect.Method
+	ArgType   reflect.Type
+	ReplyType reflect.Type
+	NumCalls  uint64
 }
 
 func (m *methodType) newArgv() reflect.Value {
 	var argv reflect.Value
 	// arg may be a pointer type, or a value type
-	if m.argType.Kind() == reflect.Ptr {
-		argv = reflect.New(m.argType.Elem())
+	if m.ArgType.Kind() == reflect.Ptr {
+		argv = reflect.New(m.ArgType.Elem())
 	} else {
-		argv = reflect.New(m.argType).Elem()
+		argv = reflect.New(m.ArgType).Elem()
 	}
 	return argv
 }
 
 func (m *methodType) newReplyv() reflect.Value {
 	// reply must be a pointer type
-	replyv := reflect.New(m.replyType.Elem())
-	switch m.replyType.Elem().Kind() {
+	replyv := reflect.New(m.ReplyType.Elem())
+	switch m.ReplyType.Elem().Kind() {
 	case reflect.Map:
-		replyv.Elem().Set(reflect.MakeMap(m.replyType.Elem()))
+		replyv.Elem().Set(reflect.MakeMap(m.ReplyType.Elem()))
 	case reflect.Slice:
-		replyv.Elem().Set(reflect.MakeSlice(m.replyType.Elem(), 0, 0))
+		replyv.Elem().Set(reflect.MakeSlice(m.ReplyType.Elem(), 0, 0))
 	}
 	return replyv
 }
@@ -72,17 +72,17 @@ func (s *service) registerMethods() {
 			continue
 		}
 		s.method[method.Name] = &methodType{
-			method:    method,
-			argType:   argType,
-			replyType: replyType,
+			Method:    method,
+			ArgType:   argType,
+			ReplyType: replyType,
 		}
 		log.Printf("rpc server: register %s.%s\n", s.name, method.Name)
 	}
 }
 
 func (s *service) call(m *methodType, argv, replyv reflect.Value) error {
-	atomic.AddUint64(&m.numCalls, 1)
-	f := m.method.Func
+	atomic.AddUint64(&m.NumCalls, 1)
+	f := m.Method.Func
 	returnValues := f.Call([]reflect.Value{s.rcvr, argv, replyv})
 	if errInter := returnValues[0].Interface(); errInter != nil {
 		return errInter.(error)
diff --git a/gee-rpc/day4-http-debug/client.go b/gee-rpc/day4-http-debug/client.go
new file mode 100644
index 0000000..3b53c16
--- /dev/null
+++ b/gee-rpc/day4-http-debug/client.go
@@ -0,0 +1,254 @@
+// Copyright 2009 The Go Authors. All rights reserved.
+// Use of this source code is governed by a BSD-style
+// license that can be found in the LICENSE file.
+
+package geerpc
+
+import (
+	"bufio"
+	"encoding/json"
+	"errors"
+	"fmt"
+	"geerpc/codec"
+	"io"
+	"log"
+	"net"
+	"net/http"
+	"sync"
+)
+
+// Call represents an active RPC.
+type Call struct {
+	ServiceMethod string      // format "<service>.<Method>"
+	Args          interface{} // arguments to the function
+	Reply         interface{} // reply from the function
+	Error         error       // if error occurs, it will be set
+	Done          chan *Call  // Strobes when call is complete.
+}
+
+func (call *Call) done() {
+	call.Done <- call
+}
+
+// Client represents an RPC Client.
+// There may be multiple outstanding Calls associated
+// with a single Client, and a Client may be used by
+// multiple goroutines simultaneously.
+type Client struct {
+	cc      codec.Codec
+	sending sync.Mutex // protect following
+	header  codec.Header
+	mu      sync.Mutex // protect following
+	seq     uint64
+	pending map[uint64]*Call
+	closed  bool // user has called Close
+}
+
+var _ io.Closer = (*Client)(nil)
+
+var ErrShutdown = errors.New("connection is shut down")
+
+// Close the connection
+func (client *Client) Close() error {
+	client.mu.Lock()
+	defer client.mu.Unlock()
+	if client.closed {
+		return ErrShutdown
+	}
+	client.closed = true
+	return client.cc.Close()
+}
+
+func (client *Client) registerCall(call *Call) (uint64, error) {
+	client.mu.Lock()
+	defer client.mu.Unlock()
+	if client.closed {
+		return 0, ErrShutdown
+	}
+	seq := client.seq
+	client.pending[seq] = call
+	client.seq++
+	return seq, nil
+}
+
+func (client *Client) removeCall(seq uint64) *Call {
+	client.mu.Lock()
+	defer client.mu.Unlock()
+	call := client.pending[seq]
+	delete(client.pending, seq)
+	return call
+}
+
+func (client *Client) terminateCalls(err error) {
+	client.sending.Lock()
+	defer client.sending.Unlock()
+	client.mu.Lock()
+	defer client.mu.Unlock()
+	for _, call := range client.pending {
+		call.Error = err
+		call.done()
+	}
+}
+
+func (client *Client) send(call *Call) {
+	// make sure that the client will send a complete request
+	client.sending.Lock()
+	defer client.sending.Unlock()
+
+	// register this call.
+	seq, err := client.registerCall(call)
+	if err != nil {
+		call.Error = err
+		call.done()
+		return
+	}
+
+	// prepare request header
+	client.header.ServiceMethod = call.ServiceMethod
+	client.header.Seq = seq
+	client.header.Error = ""
+
+	// encode and send the request
+	if err := client.cc.Write(&client.header, call.Args); err != nil {
+		call := client.removeCall(seq)
+		// call may be nil, it usually means that Write partially failed,
+		// client has received the response and handled
+		if call != nil {
+			call.Error = err
+			call.done()
+		}
+	}
+}
+
+func (client *Client) receive() {
+	var err error
+	for err == nil {
+		var h codec.Header
+		if err = client.cc.ReadHeader(&h); err != nil {
+			break
+		}
+		call := client.removeCall(h.Seq)
+		switch {
+		case call == nil:
+			// it usually means that Write partially failed
+			// and call was already removed.
+			err = client.cc.ReadBody(nil)
+		case h.Error != "":
+			call.Error = fmt.Errorf(h.Error)
+			err = client.cc.ReadBody(nil)
+			call.done()
+		default:
+			err = client.cc.ReadBody(call.Reply)
+			if err != nil {
+				call.Error = errors.New("reading body " + err.Error())
+			}
+			call.done()
+		}
+	}
+	// error occurs, so terminateCalls pending calls
+	client.terminateCalls(err)
+}
+
+// Go invokes the function asynchronously.
+// It returns the Call structure representing the invocation.
+func (client *Client) Go(serviceMethod string, args, reply interface{}, done chan *Call) *Call {
+	if done == nil {
+		done = make(chan *Call, 10)
+	} else if cap(done) == 0 {
+		log.Panic("rpc client: done channel is unbuffered")
+	}
+	call := &Call{
+		ServiceMethod: serviceMethod,
+		Args:          args,
+		Reply:         reply,
+		Done:          done,
+	}
+	client.send(call)
+	return call
+}
+
+// Call invokes the named function, waits for it to complete,
+// and returns its error status.
+func (client *Client) Call(serviceMethod string, args, reply interface{}) error {
+	call := <-client.Go(serviceMethod, args, reply, make(chan *Call, 1)).Done
+	return call.Error
+}
+
+func NewClient(conn io.ReadWriteCloser, opt *Options) (*Client, error) {
+	var err error
+	defer func() {
+		if err != nil {
+			_ = conn.Close()
+		}
+	}()
+	if opt.MagicNumber == 0 {
+		opt.MagicNumber = MagicNumber
+	}
+	f := codec.NewCodecFuncMap[opt.CodecType]
+	if f == nil {
+		err = fmt.Errorf("invalid codec type %s", opt.CodecType)
+		log.Println("rpc client: codec error:", err)
+		return nil, err
+	}
+	// send options with server
+	if err = json.NewEncoder(conn).Encode(opt); err != nil {
+		log.Println("rpc client: options error: ", err)
+		return nil, err
+	}
+	return newClientCodec(f(conn)), nil
+}
+
+func newClientCodec(cc codec.Codec) *Client {
+	client := &Client{
+		cc:      cc,
+		pending: make(map[uint64]*Call),
+	}
+	go client.receive()
+	return client
+}
+
+// Dial connects to an RPC server at the specified network address
+func Dial(network, address string, opts ...*Options) (*Client, error) {
+	opt := defaultOptions
+	if len(opts) > 0 && opts[0] != nil {
+		opt = opts[0]
+	}
+	conn, err := net.Dial(network, address)
+	if err != nil {
+		return nil, err
+	}
+	return NewClient(conn, opt)
+}
+
+// DialHTTP connects to an HTTP RPC server at the specified network address
+// listening on the default HTTP RPC path.
+func DialHTTP(network, address string, opts ...*Options) (*Client, error) {
+	return DialHTTPPath(network, address, defaultRPCPath, opts...)
+}
+
+// DialHTTPPath connects to an HTTP RPC server
+// at the specified network address and path.
+func DialHTTPPath(network, address, path string, opts ...*Options) (*Client, error) {
+	opt := defaultOptions
+	if len(opts) > 0 && opts[0] != nil {
+		opt = opts[0]
+	}
+	var err error
+	conn, err := net.Dial(network, address)
+	if err != nil {
+		return nil, err
+	}
+	_, _ = io.WriteString(conn, fmt.Sprintf("CONNECT %s HTTP/1.0\n\n", path))
+
+	// Require successful HTTP response
+	// before switching to RPC protocol.
+	resp, err := http.ReadResponse(bufio.NewReader(conn), &http.Request{Method: "CONNECT"})
+	if err == nil && resp.Status == connected {
+		return NewClient(conn, opt)
+	}
+	if err == nil {
+		err = errors.New("unexpected HTTP response: " + resp.Status)
+	}
+	_ = conn.Close()
+	return nil, err
+}
diff --git a/gee-rpc/day4-http-debug/codec/codec.go b/gee-rpc/day4-http-debug/codec/codec.go
new file mode 100644
index 0000000..ba28fba
--- /dev/null
+++ b/gee-rpc/day4-http-debug/codec/codec.go
@@ -0,0 +1,34 @@
+package codec
+
+import (
+	"io"
+)
+
+type Header struct {
+	ServiceMethod string // format "Service.Method"
+	Seq           uint64 // sequence number chosen by client
+	Error         string
+}
+
+type Codec interface {
+	io.Closer
+	ReadHeader(*Header) error
+	ReadBody(interface{}) error
+	Write(*Header, interface{}) error
+}
+
+type NewCodecFunc func(io.ReadWriteCloser) Codec
+
+type Type string
+
+const (
+	GobType  Type = "application/gob"
+	JsonType Type = "application/json"
+)
+
+var NewCodecFuncMap map[Type]NewCodecFunc
+
+func init() {
+	NewCodecFuncMap = make(map[Type]NewCodecFunc)
+	NewCodecFuncMap[GobType] = NewGobCodec
+}
diff --git a/gee-rpc/day4-http-debug/codec/gob.go b/gee-rpc/day4-http-debug/codec/gob.go
new file mode 100644
index 0000000..808d97b
--- /dev/null
+++ b/gee-rpc/day4-http-debug/codec/gob.go
@@ -0,0 +1,57 @@
+package codec
+
+import (
+	"bufio"
+	"encoding/gob"
+	"io"
+	"log"
+)
+
+type GobCodec struct {
+	conn io.ReadWriteCloser
+	buf  *bufio.Writer
+	dec  *gob.Decoder
+	enc  *gob.Encoder
+}
+
+var _ Codec = (*GobCodec)(nil)
+
+func NewGobCodec(conn io.ReadWriteCloser) Codec {
+	buf := bufio.NewWriter(conn)
+	return &GobCodec{
+		conn: conn,
+		buf:  buf,
+		dec:  gob.NewDecoder(conn),
+		enc:  gob.NewEncoder(buf),
+	}
+}
+
+func (c *GobCodec) ReadHeader(h *Header) error {
+	return c.dec.Decode(h)
+}
+
+func (c *GobCodec) ReadBody(body interface{}) error {
+	return c.dec.Decode(body)
+}
+
+func (c *GobCodec) Write(h *Header, body interface{}) (err error) {
+	defer func() {
+		_ = c.buf.Flush()
+		if err != nil {
+			_ = c.Close()
+		}
+	}()
+	if err := c.enc.Encode(h); err != nil {
+		log.Println("rpc: gob error encoding header:", err)
+		return err
+	}
+	if err := c.enc.Encode(body); err != nil {
+		log.Println("rpc: gob error encoding body:", err)
+		return err
+	}
+	return nil
+}
+
+func (c *GobCodec) Close() error {
+	return c.conn.Close()
+}
diff --git a/gee-rpc/day4-http-debug/debug.go b/gee-rpc/day4-http-debug/debug.go
new file mode 100644
index 0000000..d76de55
--- /dev/null
+++ b/gee-rpc/day4-http-debug/debug.go
@@ -0,0 +1,60 @@
+// Copyright 2009 The Go Authors. All rights reserved.
+// Use of this source code is governed by a BSD-style
+// license that can be found in the LICENSE file.
+
+package geerpc
+
+import (
+	"fmt"
+	"html/template"
+	"net/http"
+)
+
+const debugText = `<html>
+	<body>
+	<title>GeeRPC Services</title>
+	{{range .}}
+	<hr>
+	Service {{.Name}}
+	<hr>
+		<table>
+		<th align=center>Method</th><th align=center>Calls</th>
+		{{range $name, $mtype := .Method}}
+			<tr>
+			<td align=left font=fixed>{{$name}}({{$mtype.ArgType}}, {{$mtype.ReplyType}}) error</td>
+			<td align=center>{{$mtype.NumCalls}}</td>
+			</tr>
+		{{end}}
+		</table>
+	{{end}}
+	</body>
+	</html>`
+
+var debug = template.Must(template.New("RPC debug").Parse(debugText))
+
+type debugHTTP struct {
+	*Server
+}
+
+type debugService struct {
+	Name   string
+	Method map[string]*methodType
+}
+
+// Runs at /debug/rpc
+func (server debugHTTP) ServeHTTP(w http.ResponseWriter, req *http.Request) {
+	// Build a sorted version of the data.
+	var services []debugService
+	server.serviceMap.Range(func(namei, svci interface{}) bool {
+		svc := svci.(*service)
+		services = append(services, debugService{
+			Name:   namei.(string),
+			Method: svc.method,
+		})
+		return true
+	})
+	err := debug.Execute(w, services)
+	if err != nil {
+		_, _ = fmt.Fprintln(w, "rpc: error executing template:", err.Error())
+	}
+}
diff --git a/gee-rpc/day4-http-debug/go.mod b/gee-rpc/day4-http-debug/go.mod
new file mode 100644
index 0000000..0ec8aeb
--- /dev/null
+++ b/gee-rpc/day4-http-debug/go.mod
@@ -0,0 +1,3 @@
+module geerpc
+
+go 1.13
diff --git a/gee-rpc/day4-http-debug/main/main.go b/gee-rpc/day4-http-debug/main/main.go
new file mode 100644
index 0000000..13bb592
--- /dev/null
+++ b/gee-rpc/day4-http-debug/main/main.go
@@ -0,0 +1,53 @@
+package main
+
+import (
+	"geerpc"
+	"log"
+	"net/http"
+	"sync"
+	"time"
+)
+
+type Foo int
+
+type Args struct{ Num1, Num2 int }
+
+func (f Foo) Sum(args Args, reply *int) error {
+	*reply = args.Num1 + args.Num2
+	return nil
+}
+
+func startServer(addr string) {
+	var foo Foo
+	_ = geerpc.Register(&foo)
+	geerpc.HandleHTTP()
+	log.Fatal(http.ListenAndServe(addr, nil))
+}
+
+func call() {
+	// start server may cost some time
+	time.Sleep(time.Second)
+	client, _ := geerpc.DialHTTP("tcp", ":9999")
+	defer func() { _ = client.Close() }()
+
+	// send request & receive response
+	var wg sync.WaitGroup
+	for i := 0; i < 5; i++ {
+		wg.Add(1)
+		go func(i int) {
+			defer wg.Done()
+			args := &Args{Num1: i, Num2: i * i}
+			var reply int
+			if err := client.Call("Foo.Sum", args, &reply); err != nil {
+				log.Fatal("call Foo.Sum error:", err)
+			}
+			log.Printf("%d + %d = %d", args.Num1, args.Num2, reply)
+		}(i)
+	}
+	wg.Wait()
+}
+
+func main() {
+	go call()
+	startServer(":9999")
+}
diff --git a/gee-rpc/day4-http-debug/server.go b/gee-rpc/day4-http-debug/server.go
new file mode 100644
index 0000000..ffb85ee
--- /dev/null
+++ b/gee-rpc/day4-http-debug/server.go
@@ -0,0 +1,238 @@
+// Copyright 2009 The Go Authors. All rights reserved.
+// Use of this source code is governed by a BSD-style
+// license that can be found in the LICENSE file.
+
+package geerpc
+
+import (
+	"encoding/json"
+	"errors"
+	"geerpc/codec"
+	"io"
+	"log"
+	"net"
+	"net/http"
+	"reflect"
+	"strings"
+	"sync"
+)
+
+const MagicNumber = 0x3bef5c
+
+type Options struct {
+	MagicNumber int        // MagicNumber marks this's a geerpc request
+	CodecType   codec.Type // client may choose different Codec to encode body
+}
+
+var defaultOptions = &Options{
+	MagicNumber: MagicNumber,
+	CodecType:   codec.GobType,
+}
+
+// Server represents an RPC Server.
+type Server struct {
+	serviceMap sync.Map
+}
+
+// NewServer returns a new Server.
+func NewServer() *Server {
+	return &Server{}
+}
+
+// DefaultServer is the default instance of *Server.
+var DefaultServer = NewServer()
+
+// ServeConn runs the server on a single connection.
+// ServeConn blocks, serving the connection until the client hangs up.
+func (server *Server) ServeConn(conn io.ReadWriteCloser) {
+	defer func() { _ = conn.Close() }()
+	var opt Options
+	if err := json.NewDecoder(conn).Decode(&opt); err != nil {
+		log.Println("rpc server: options error: ", err)
+		return
+	}
+	if opt.MagicNumber != MagicNumber {
+		log.Printf("rpc server: invalid magic number %x", opt.MagicNumber)
+		return
+	}
+	f := codec.NewCodecFuncMap[opt.CodecType]
+	if f == nil {
+		log.Printf("rpc server: invalid codec type %s", opt.CodecType)
+		return
+	}
+	server.serveCodec(f(conn))
+}
+
+// invalidRequest is a placeholder for response argv when error occurs
+var invalidRequest = struct{}{}
+
+func (server *Server) serveCodec(cc codec.Codec) {
+	sending := new(sync.Mutex) // make sure to send a complete response
+	wg := new(sync.WaitGroup)  // wait until all request are handled
+	for {
+		req, err := server.readRequest(cc)
+		if err != nil {
+			if req == nil {
+				break // it's not possible to recover, so close the connection
+			}
+			req.h.Error = err.Error()
+			server.sendResponse(cc, req.h, invalidRequest, sending)
+			continue
+		}
+		wg.Add(1)
+		go server.handleRequest(cc, req, sending, wg)
+	}
+	wg.Wait()
+	_ = cc.Close()
+}
+
+// request stores all information of a call
+type request struct {
+	h            *codec.Header // header of request
+	argv, replyv reflect.Value // argv and replyv of request
+	mtype        *methodType
+	svc          *service
+}
+
+func (server *Server) readRequestHeader(cc codec.Codec) (*codec.Header, error) {
+	var h codec.Header
+	if err := cc.ReadHeader(&h); err != nil {
+		if err != io.EOF && err != io.ErrUnexpectedEOF {
+			log.Println("rpc server: read header error:", err)
+		}
+		return nil, err
+	}
+	return &h, nil
+}
+
+func (server *Server) findService(serviceMethod string) (svc *service, mtype *methodType, err error) {
+	dot := strings.LastIndex(serviceMethod, ".")
+	if dot < 0 {
+		err = errors.New("rpc server: service/Method request ill-formed: " + serviceMethod)
+		return
+	}
+	serviceName, methodName := serviceMethod[:dot], serviceMethod[dot+1:]
+	svci, ok := server.serviceMap.Load(serviceName)
+	if !ok {
+		err = errors.New("rpc server: can't find service " + serviceName)
+		return
+	}
+	svc = svci.(*service)
+	mtype = svc.method[methodName]
+	if mtype == nil {
+		err = errors.New("rpc server: can't find Method " + methodName)
+	}
+	return
+}
+
+func (server *Server) readRequest(cc codec.Codec) (*request, error) {
+	h, err := server.readRequestHeader(cc)
+	if err != nil {
+		return nil, err
+	}
+	req := &request{h: h}
+	req.svc, req.mtype, err = server.findService(h.ServiceMethod)
+	if err != nil {
+		return req, err
+	}
+	req.argv = req.mtype.newArgv()
+	req.replyv = req.mtype.newReplyv()
+
+	// make sure that argvi is a pointer, ReadBody need a pointer as parameter
+	argvi := req.argv.Interface()
+	if req.argv.Type().Kind() != reflect.Ptr {
+		argvi = req.argv.Addr().Interface()
+	}
+	if err = cc.ReadBody(argvi); err != nil {
+		log.Println("rpc server: read body err:", err)
+		return req, err
+	}
+	return req, nil
+}
+
+func (server *Server) sendResponse(cc codec.Codec, h *codec.Header, body interface{}, sending *sync.Mutex) {
+	sending.Lock()
+	defer sending.Unlock()
+	if err := cc.Write(h, body); err != nil {
+		log.Println("rpc server: write response error:", err)
+	}
+}
+
+func (server *Server) handleRequest(cc codec.Codec, req *request, sending *sync.Mutex, wg *sync.WaitGroup) {
+	defer wg.Done()
+	err := req.svc.call(req.mtype, req.argv, req.replyv)
+	if err != nil {
+		req.h.Error = err.Error()
+	}
+	server.sendResponse(cc, req.h, req.replyv.Interface(), sending)
+}
+
+// Accept accepts connections on the listener and serves requests
+// for each incoming connection.
+func (server *Server) Accept(lis net.Listener) {
+	for {
+		conn, err := lis.Accept()
+		if err != nil {
+			log.Println("rpc server: accept error:", err)
+			return
+		}
+		go server.ServeConn(conn)
+	}
+}
+
+// Accept accepts connections on the listener and serves requests
+// for each incoming connection.
+func Accept(lis net.Listener) { DefaultServer.Accept(lis) }
+
+// Register publishes in the server the set of methods of the
+// receiver value that satisfy the following conditions:
+//	- exported Method of exported type
+//	- two arguments, both of exported type
+//	- the second argument is a pointer
+//	- one return value, of type error
+func (server *Server) Register(rcvr interface{}) error {
+	s := newService(rcvr)
+	if _, dup := server.serviceMap.LoadOrStore(s.name, s); dup {
+		return errors.New("rpc: service already defined: " + s.name)
+	}
+	return nil
+}
+
+// Register publishes the receiver's methods in the DefaultServer.
+func Register(rcvr interface{}) error { return DefaultServer.Register(rcvr) }
+
+const (
+	connected        = "200 Connected to Gee RPC"
+	defaultRPCPath   = "/_geeprc_"
+	defaultDebugPath = "/debug/geerpc"
+)
+
+// ServeHTTP implements an http.Handler that answers RPC requests.
+func (server *Server) ServeHTTP(w http.ResponseWriter, req *http.Request) {
+	if req.Method != "CONNECT" {
+		w.Header().Set("Content-Type", "text/plain; charset=utf-8")
+		w.WriteHeader(http.StatusMethodNotAllowed)
+		_, _ = io.WriteString(w, "405 must CONNECT\n")
+		return
+	}
+	conn, _, err := w.(http.Hijacker).Hijack()
+	if err != nil {
+		log.Print("rpc hijacking ", req.RemoteAddr, ": ", err.Error())
+		return
+	}
+	_, _ = io.WriteString(conn, "HTTP/1.0 "+connected+"\n\n")
+	server.ServeConn(conn)
+}
+
+// HandleHTTP registers an HTTP handler for RPC messages on rpcPath,
+// and a debugging handler on debugPath.
+// It is still necessary to invoke http.Serve(), typically in a go statement.
+func (server *Server) HandleHTTP(rpcPath, debugPath string) {
+	http.Handle(rpcPath, server)
+	http.Handle(debugPath, debugHTTP{server})
+	log.Println("rpc server debug path:", debugPath)
+}
+
+func HandleHTTP() {
+	DefaultServer.HandleHTTP(defaultRPCPath, defaultDebugPath)
+}
diff --git a/gee-rpc/day4-http-debug/service.go b/gee-rpc/day4-http-debug/service.go
new file mode 100644
index 0000000..e0711cd
--- /dev/null
+++ b/gee-rpc/day4-http-debug/service.go
@@ -0,0 +1,95 @@
+package geerpc
+
+import (
+	"go/ast"
+	"log"
+	"reflect"
+	"sync/atomic"
+)
+
+type methodType struct {
+	Method    reflect.Method
+	ArgType   reflect.Type
+	ReplyType reflect.Type
+	NumCalls  uint64
+}
+
+func (m *methodType) newArgv() reflect.Value {
+	var argv reflect.Value
+	// arg may be a pointer type, or a value type
+	if m.ArgType.Kind() == reflect.Ptr {
+		argv = reflect.New(m.ArgType.Elem())
+	} else {
+		argv = reflect.New(m.ArgType).Elem()
+	}
+	return argv
+}
+
+func (m *methodType) newReplyv() reflect.Value {
+	// reply must be a pointer type
+	replyv := reflect.New(m.ReplyType.Elem())
+	switch m.ReplyType.Elem().Kind() {
+	case reflect.Map:
+		replyv.Elem().Set(reflect.MakeMap(m.ReplyType.Elem()))
+	case reflect.Slice:
+		replyv.Elem().Set(reflect.MakeSlice(m.ReplyType.Elem(), 0, 0))
+	}
+	return replyv
+}
+
+type service struct {
+	name   string
+	typ    reflect.Type
+	rcvr   reflect.Value
+	method map[string]*methodType
+}
+
+func newService(rcvr interface{}) *service {
+	s := new(service)
+	s.rcvr = reflect.ValueOf(rcvr)
+	s.name = reflect.Indirect(s.rcvr).Type().Name()
+	s.typ = reflect.TypeOf(rcvr)
+	if !ast.IsExported(s.name) {
+		log.Fatalf("rpc server: %s is not a valid service name", s.name)
+	}
+	s.registerMethods()
+	return s
+}
+
+func (s *service) registerMethods() {
+	s.method = make(map[string]*methodType)
+	for i := 0; i < s.typ.NumMethod(); i++ {
+		method := s.typ.Method(i)
+		mType := method.Type
+		if mType.NumIn() != 3 || mType.NumOut() != 1 {
+			continue
+		}
+		if mType.Out(0) != reflect.TypeOf((*error)(nil)).Elem() {
+			continue
+		}
+		argType, replyType := mType.In(1), mType.In(2)
+		if !isExportedOrBuiltinType(argType) || !isExportedOrBuiltinType(replyType) {
+			continue
+		}
+		s.method[method.Name] = &methodType{
+			Method:    method,
+			ArgType:   argType,
+			ReplyType: replyType,
+		}
+		log.Printf("rpc server: register %s.%s\n", s.name, method.Name)
+	}
+}
+
+func (s *service) call(m *methodType, argv, replyv reflect.Value) error {
+	atomic.AddUint64(&m.NumCalls, 1)
+	f := m.Method.Func
+	returnValues := f.Call([]reflect.Value{s.rcvr, argv, replyv})
+	if errInter := returnValues[0].Interface(); errInter != nil {
+		return errInter.(error)
+	}
+	return nil
+}
+
+func isExportedOrBuiltinType(t reflect.Type) bool {
+	return ast.IsExported(t.Name()) || t.PkgPath() == ""
+}
diff --git a/gee-rpc/day4-http-debug/service_test.go b/gee-rpc/day4-http-debug/service_test.go
new file mode 100644
index 0000000..7ba2786
--- /dev/null
+++ b/gee-rpc/day4-http-debug/service_test.go
@@ -0,0 +1,48 @@
+package geerpc
+
+import (
+	"fmt"
+	"reflect"
+	"testing"
+)
+
+type Foo int
+
+type Args struct{ Num1, Num2 int }
+
+func (f Foo) Sum(args Args, reply *int) error {
+	*reply = args.Num1 + args.Num2
+	return nil
+}
+
+// it's not a exported Method
+func (f Foo) sum(args Args, reply *int) error {
+	*reply = args.Num1 + args.Num2
+	return nil
+}
+
+func _assert(condition bool, msg string, v ...interface{}) {
+	if !condition {
+		panic(fmt.Sprintf("assertion failed: "+msg, v...))
+	}
+}
+
+func TestNewService(t *testing.T) {
+	var foo Foo
+	s := newService(&foo)
+	_assert(len(s.method) == 1, "wrong service Method, expect 1, but got %d", len(s.method))
+	mType := s.method["Sum"]
+	_assert(mType != nil, "wrong Method, Sum shouldn't nil")
+}
+
+func TestMethodType_Call(t *testing.T) {
+	var foo Foo
+	s := newService(&foo)
+	mType := s.method["Sum"]
+
+	argv := mType.newArgv()
+	replyv := mType.newReplyv()
+	argv.Set(reflect.ValueOf(Args{Num1: 1, Num2: 3}))
+	err := s.call(mType, argv, replyv)
+	_assert(err == nil && *replyv.Interface().(*int) == 4 && mType.NumCalls == 1, "failed to call Foo.Sum")
+}

From 714311df7dca8bb6412872779abb4dc8aa277d8c Mon Sep 17 00:00:00 2001
From: gzdaijie <gzdaijie@gmail.com>
Date: Fri, 2 Oct 2020 16:56:01 +0800
Subject: [PATCH 077/122] remove duplicate error definition

---
 gee-rpc/day4-http-debug/client.go | 1 -
 1 file changed, 1 deletion(-)

diff --git a/gee-rpc/day4-http-debug/client.go b/gee-rpc/day4-http-debug/client.go
index 3b53c16..8ab5ef0 100644
--- a/gee-rpc/day4-http-debug/client.go
+++ b/gee-rpc/day4-http-debug/client.go
@@ -233,7 +233,6 @@ func DialHTTPPath(network, address, path string, opts ...*Options) (*Client, err
 	if len(opts) > 0 && opts[0] != nil {
 		opt = opts[0]
 	}
-	var err error
 	conn, err := net.Dial(network, address)
 	if err != nil {
 		return nil, err

From a411eba0b231930f93333fffa4259652e8917ef6 Mon Sep 17 00:00:00 2001
From: gzdaijie <gzdaijie@gmail.com>
Date: Fri, 2 Oct 2020 17:25:53 +0800
Subject: [PATCH 078/122] fix service numCalls read issue

---
 gee-rpc/day3-service/service.go         | 14 +++++++++-----
 gee-rpc/day3-service/service_test.go    |  8 ++++----
 gee-rpc/day4-http-debug/service.go      | 14 +++++++++-----
 gee-rpc/day4-http-debug/service_test.go |  2 +-
 4 files changed, 23 insertions(+), 15 deletions(-)

diff --git a/gee-rpc/day3-service/service.go b/gee-rpc/day3-service/service.go
index e0711cd..306683c 100644
--- a/gee-rpc/day3-service/service.go
+++ b/gee-rpc/day3-service/service.go
@@ -8,10 +8,14 @@ import (
 )
 
 type methodType struct {
-	Method    reflect.Method
+	method    reflect.Method
 	ArgType   reflect.Type
 	ReplyType reflect.Type
-	NumCalls  uint64
+	numCalls  uint64
+}
+
+func (m *methodType) NumCalls() uint64 {
+	return atomic.LoadUint64(&m.numCalls)
 }
 
 func (m *methodType) newArgv() reflect.Value {
@@ -72,7 +76,7 @@ func (s *service) registerMethods() {
 			continue
 		}
 		s.method[method.Name] = &methodType{
-			Method:    method,
+			method:    method,
 			ArgType:   argType,
 			ReplyType: replyType,
 		}
@@ -81,8 +85,8 @@ func (s *service) registerMethods() {
 }
 
 func (s *service) call(m *methodType, argv, replyv reflect.Value) error {
-	atomic.AddUint64(&m.NumCalls, 1)
-	f := m.Method.Func
+	atomic.AddUint64(&m.numCalls, 1)
+	f := m.method.Func
 	returnValues := f.Call([]reflect.Value{s.rcvr, argv, replyv})
 	if errInter := returnValues[0].Interface(); errInter != nil {
 		return errInter.(error)
diff --git a/gee-rpc/day3-service/service_test.go b/gee-rpc/day3-service/service_test.go
index 4b35124..c8266df 100644
--- a/gee-rpc/day3-service/service_test.go
+++ b/gee-rpc/day3-service/service_test.go
@@ -15,7 +15,7 @@ func (f Foo) Sum(args Args, reply *int) error {
 	return nil
 }
 
-// it's not a exported method
+// it's not a exported Method
 func (f Foo) sum(args Args, reply *int) error {
 	*reply = args.Num1 + args.Num2
 	return nil
@@ -30,9 +30,9 @@ func _assert(condition bool, msg string, v ...interface{}) {
 func TestNewService(t *testing.T) {
 	var foo Foo
 	s := newService(&foo)
-	_assert(len(s.method) == 1, "wrong service method, expect 1, but got %d", len(s.method))
+	_assert(len(s.method) == 1, "wrong service Method, expect 1, but got %d", len(s.method))
 	mType := s.method["Sum"]
-	_assert(mType != nil, "wrong method, Sum shouldn't nil")
+	_assert(mType != nil, "wrong Method, Sum shouldn't nil")
 }
 
 func TestMethodType_Call(t *testing.T) {
@@ -44,5 +44,5 @@ func TestMethodType_Call(t *testing.T) {
 	replyv := mType.newReplyv()
 	argv.Set(reflect.ValueOf(Args{Num1: 1, Num2: 3}))
 	err := s.call(mType, argv, replyv)
-	_assert(err == nil && *replyv.Interface().(*int) == 4 && mType.numCalls == 1, "failed to call Foo.Sum")
+	_assert(err == nil && *replyv.Interface().(*int) == 4 && mType.NumCalls() == 1, "failed to call Foo.Sum")
 }
diff --git a/gee-rpc/day4-http-debug/service.go b/gee-rpc/day4-http-debug/service.go
index e0711cd..306683c 100644
--- a/gee-rpc/day4-http-debug/service.go
+++ b/gee-rpc/day4-http-debug/service.go
@@ -8,10 +8,14 @@ import (
 )
 
 type methodType struct {
-	Method    reflect.Method
+	method    reflect.Method
 	ArgType   reflect.Type
 	ReplyType reflect.Type
-	NumCalls  uint64
+	numCalls  uint64
+}
+
+func (m *methodType) NumCalls() uint64 {
+	return atomic.LoadUint64(&m.numCalls)
 }
 
 func (m *methodType) newArgv() reflect.Value {
@@ -72,7 +76,7 @@ func (s *service) registerMethods() {
 			continue
 		}
 		s.method[method.Name] = &methodType{
-			Method:    method,
+			method:    method,
 			ArgType:   argType,
 			ReplyType: replyType,
 		}
@@ -81,8 +85,8 @@ func (s *service) registerMethods() {
 }
 
 func (s *service) call(m *methodType, argv, replyv reflect.Value) error {
-	atomic.AddUint64(&m.NumCalls, 1)
-	f := m.Method.Func
+	atomic.AddUint64(&m.numCalls, 1)
+	f := m.method.Func
 	returnValues := f.Call([]reflect.Value{s.rcvr, argv, replyv})
 	if errInter := returnValues[0].Interface(); errInter != nil {
 		return errInter.(error)
diff --git a/gee-rpc/day4-http-debug/service_test.go b/gee-rpc/day4-http-debug/service_test.go
index 7ba2786..c8266df 100644
--- a/gee-rpc/day4-http-debug/service_test.go
+++ b/gee-rpc/day4-http-debug/service_test.go
@@ -44,5 +44,5 @@ func TestMethodType_Call(t *testing.T) {
 	replyv := mType.newReplyv()
 	argv.Set(reflect.ValueOf(Args{Num1: 1, Num2: 3}))
 	err := s.call(mType, argv, replyv)
-	_assert(err == nil && *replyv.Interface().(*int) == 4 && mType.NumCalls == 1, "failed to call Foo.Sum")
+	_assert(err == nil && *replyv.Interface().(*int) == 4 && mType.NumCalls() == 1, "failed to call Foo.Sum")
 }

From d9162cc910a51159d7a23a64628834d6cd13c35c Mon Sep 17 00:00:00 2001
From: gzdaijie <gzdaijie@gmail.com>
Date: Fri, 2 Oct 2020 23:44:13 +0800
Subject: [PATCH 079/122] gee-rpc: add Client struct filed opt to record
 options user will pass

---
 gee-rpc/day2-client/client.go     | 42 ++++++++++++++++----------
 gee-rpc/day3-service/client.go    | 42 ++++++++++++++++----------
 gee-rpc/day4-http-debug/client.go | 50 +++++++++++++++++--------------
 3 files changed, 80 insertions(+), 54 deletions(-)

diff --git a/gee-rpc/day2-client/client.go b/gee-rpc/day2-client/client.go
index 83119f0..b73c461 100644
--- a/gee-rpc/day2-client/client.go
+++ b/gee-rpc/day2-client/client.go
@@ -34,6 +34,7 @@ func (call *Call) done() {
 // multiple goroutines simultaneously.
 type Client struct {
 	cc      codec.Codec
+	opt     *Options
 	sending sync.Mutex // protect following
 	header  codec.Header
 	mu      sync.Mutex // protect following
@@ -172,15 +173,26 @@ func (client *Client) Call(serviceMethod string, args, reply interface{}) error
 	return call.Error
 }
 
-func NewClient(conn io.ReadWriteCloser, opt *Options) (*Client, error) {
-	var err error
-	defer func() {
-		if err != nil {
-			_ = conn.Close()
-		}
-	}()
-	if opt.MagicNumber == 0 {
-		opt.MagicNumber = MagicNumber
+func parseOptions(opts ...*Options) (*Options, error) {
+	// if opts is nil or pass nil as parameter
+	if len(opts) == 0 || opts[0] == nil {
+		return defaultOptions, nil
+	}
+	if len(opts) != 1 {
+		return nil, errors.New("number of options is more than 1")
+	}
+	opt := opts[0]
+	opt.MagicNumber = defaultOptions.MagicNumber
+	if opt.CodecType == "" {
+		opt.CodecType = defaultOptions.CodecType
+	}
+	return opt, nil
+}
+
+func NewClient(conn io.ReadWriteCloser, opts ...*Options) (*Client, error) {
+	opt, err := parseOptions(opts...)
+	if err != nil {
+		return nil, err
 	}
 	f := codec.NewCodecFuncMap[opt.CodecType]
 	if f == nil {
@@ -191,14 +203,16 @@ func NewClient(conn io.ReadWriteCloser, opt *Options) (*Client, error) {
 	// send options with server
 	if err = json.NewEncoder(conn).Encode(opt); err != nil {
 		log.Println("rpc client: options error: ", err)
+		_ = conn.Close()
 		return nil, err
 	}
-	return newClientCodec(f(conn)), nil
+	return newClientCodec(f(conn), opt), nil
 }
 
-func newClientCodec(cc codec.Codec) *Client {
+func newClientCodec(cc codec.Codec, opt *Options) *Client {
 	client := &Client{
 		cc:      cc,
+		opt:     opt,
 		pending: make(map[uint64]*Call),
 	}
 	go client.receive()
@@ -207,13 +221,9 @@ func newClientCodec(cc codec.Codec) *Client {
 
 // Dial connects to an RPC server at the specified network address
 func Dial(network, address string, opts ...*Options) (*Client, error) {
-	opt := defaultOptions
-	if len(opts) > 0 && opts[0] != nil {
-		opt = opts[0]
-	}
 	conn, err := net.Dial(network, address)
 	if err != nil {
 		return nil, err
 	}
-	return NewClient(conn, opt)
+	return NewClient(conn, opts...)
 }
diff --git a/gee-rpc/day3-service/client.go b/gee-rpc/day3-service/client.go
index 83119f0..b73c461 100644
--- a/gee-rpc/day3-service/client.go
+++ b/gee-rpc/day3-service/client.go
@@ -34,6 +34,7 @@ func (call *Call) done() {
 // multiple goroutines simultaneously.
 type Client struct {
 	cc      codec.Codec
+	opt     *Options
 	sending sync.Mutex // protect following
 	header  codec.Header
 	mu      sync.Mutex // protect following
@@ -172,15 +173,26 @@ func (client *Client) Call(serviceMethod string, args, reply interface{}) error
 	return call.Error
 }
 
-func NewClient(conn io.ReadWriteCloser, opt *Options) (*Client, error) {
-	var err error
-	defer func() {
-		if err != nil {
-			_ = conn.Close()
-		}
-	}()
-	if opt.MagicNumber == 0 {
-		opt.MagicNumber = MagicNumber
+func parseOptions(opts ...*Options) (*Options, error) {
+	// if opts is nil or pass nil as parameter
+	if len(opts) == 0 || opts[0] == nil {
+		return defaultOptions, nil
+	}
+	if len(opts) != 1 {
+		return nil, errors.New("number of options is more than 1")
+	}
+	opt := opts[0]
+	opt.MagicNumber = defaultOptions.MagicNumber
+	if opt.CodecType == "" {
+		opt.CodecType = defaultOptions.CodecType
+	}
+	return opt, nil
+}
+
+func NewClient(conn io.ReadWriteCloser, opts ...*Options) (*Client, error) {
+	opt, err := parseOptions(opts...)
+	if err != nil {
+		return nil, err
 	}
 	f := codec.NewCodecFuncMap[opt.CodecType]
 	if f == nil {
@@ -191,14 +203,16 @@ func NewClient(conn io.ReadWriteCloser, opt *Options) (*Client, error) {
 	// send options with server
 	if err = json.NewEncoder(conn).Encode(opt); err != nil {
 		log.Println("rpc client: options error: ", err)
+		_ = conn.Close()
 		return nil, err
 	}
-	return newClientCodec(f(conn)), nil
+	return newClientCodec(f(conn), opt), nil
 }
 
-func newClientCodec(cc codec.Codec) *Client {
+func newClientCodec(cc codec.Codec, opt *Options) *Client {
 	client := &Client{
 		cc:      cc,
+		opt:     opt,
 		pending: make(map[uint64]*Call),
 	}
 	go client.receive()
@@ -207,13 +221,9 @@ func newClientCodec(cc codec.Codec) *Client {
 
 // Dial connects to an RPC server at the specified network address
 func Dial(network, address string, opts ...*Options) (*Client, error) {
-	opt := defaultOptions
-	if len(opts) > 0 && opts[0] != nil {
-		opt = opts[0]
-	}
 	conn, err := net.Dial(network, address)
 	if err != nil {
 		return nil, err
 	}
-	return NewClient(conn, opt)
+	return NewClient(conn, opts...)
 }
diff --git a/gee-rpc/day4-http-debug/client.go b/gee-rpc/day4-http-debug/client.go
index 8ab5ef0..7ae8938 100644
--- a/gee-rpc/day4-http-debug/client.go
+++ b/gee-rpc/day4-http-debug/client.go
@@ -19,7 +19,7 @@ import (
 
 // Call represents an active RPC.
 type Call struct {
-	ServiceMethod string      // format "<service>.<Method>"
+	ServiceMethod string      // format "<service>.<method>"
 	Args          interface{} // arguments to the function
 	Reply         interface{} // reply from the function
 	Error         error       // if error occurs, it will be set
@@ -36,6 +36,7 @@ func (call *Call) done() {
 // multiple goroutines simultaneously.
 type Client struct {
 	cc      codec.Codec
+	opt     *Options
 	sending sync.Mutex // protect following
 	header  codec.Header
 	mu      sync.Mutex // protect following
@@ -174,15 +175,26 @@ func (client *Client) Call(serviceMethod string, args, reply interface{}) error
 	return call.Error
 }
 
-func NewClient(conn io.ReadWriteCloser, opt *Options) (*Client, error) {
-	var err error
-	defer func() {
-		if err != nil {
-			_ = conn.Close()
-		}
-	}()
-	if opt.MagicNumber == 0 {
-		opt.MagicNumber = MagicNumber
+func parseOptions(opts ...*Options) (*Options, error) {
+	// if opts is nil or pass nil as parameter
+	if len(opts) == 0 || opts[0] == nil {
+		return defaultOptions, nil
+	}
+	if len(opts) != 1 {
+		return nil, errors.New("number of options is more than 1")
+	}
+	opt := opts[0]
+	opt.MagicNumber = defaultOptions.MagicNumber
+	if opt.CodecType == "" {
+		opt.CodecType = defaultOptions.CodecType
+	}
+	return opt, nil
+}
+
+func NewClient(conn io.ReadWriteCloser, opts ...*Options) (*Client, error) {
+	opt, err := parseOptions(opts...)
+	if err != nil {
+		return nil, err
 	}
 	f := codec.NewCodecFuncMap[opt.CodecType]
 	if f == nil {
@@ -193,14 +205,16 @@ func NewClient(conn io.ReadWriteCloser, opt *Options) (*Client, error) {
 	// send options with server
 	if err = json.NewEncoder(conn).Encode(opt); err != nil {
 		log.Println("rpc client: options error: ", err)
+		_ = conn.Close()
 		return nil, err
 	}
-	return newClientCodec(f(conn)), nil
+	return newClientCodec(f(conn), opt), nil
 }
 
-func newClientCodec(cc codec.Codec) *Client {
+func newClientCodec(cc codec.Codec, opt *Options) *Client {
 	client := &Client{
 		cc:      cc,
+		opt:     opt,
 		pending: make(map[uint64]*Call),
 	}
 	go client.receive()
@@ -209,15 +223,11 @@ func newClientCodec(cc codec.Codec) *Client {
 
 // Dial connects to an RPC server at the specified network address
 func Dial(network, address string, opts ...*Options) (*Client, error) {
-	opt := defaultOptions
-	if len(opts) > 0 && opts[0] != nil {
-		opt = opts[0]
-	}
 	conn, err := net.Dial(network, address)
 	if err != nil {
 		return nil, err
 	}
-	return NewClient(conn, opt)
+	return NewClient(conn, opts...)
 }
 
 // DialHTTP connects to an HTTP RPC server at the specified network address
@@ -229,10 +239,6 @@ func DialHTTP(network, address string, opts ...*Options) (*Client, error) {
 // DialHTTPPath connects to an HTTP RPC server
 // at the specified network address and path.
 func DialHTTPPath(network, address, path string, opts ...*Options) (*Client, error) {
-	opt := defaultOptions
-	if len(opts) > 0 && opts[0] != nil {
-		opt = opts[0]
-	}
 	conn, err := net.Dial(network, address)
 	if err != nil {
 		return nil, err
@@ -243,7 +249,7 @@ func DialHTTPPath(network, address, path string, opts ...*Options) (*Client, err
 	// before switching to RPC protocol.
 	resp, err := http.ReadResponse(bufio.NewReader(conn), &http.Request{Method: "CONNECT"})
 	if err == nil && resp.Status == connected {
-		return NewClient(conn, opt)
+		return NewClient(conn, opts...)
 	}
 	if err == nil {
 		err = errors.New("unexpected HTTP response: " + resp.Status)

From 7e7ee27beae493108f0eeabfb29479f96cd56dec Mon Sep 17 00:00:00 2001
From: gzdaijie <gzdaijie@gmail.com>
Date: Sat, 3 Oct 2020 10:54:28 +0800
Subject: [PATCH 080/122] gee-rpc: implement day5-timeout

---
 gee-rpc/day1-codec/main/main.go               |   6 +-
 gee-rpc/day1-codec/server.go                  |   6 +-
 gee-rpc/day2-client/client.go                 |  39 ++-
 gee-rpc/day2-client/server.go                 |   6 +-
 gee-rpc/day3-service/client.go                |  39 ++-
 gee-rpc/day3-service/server.go                |   8 +-
 .../client.go                                 |  92 +++---
 gee-rpc/day4-timeout/client_test.go           |  63 ++++
 .../codec/codec.go                            |   0
 .../codec/gob.go                              |   0
 .../{day4-http-debug => day4-timeout}/go.mod  |   0
 gee-rpc/day4-timeout/main/main.go             |  56 ++++
 gee-rpc/day4-timeout/server.go                | 228 +++++++++++++
 .../service.go                                |   0
 .../service_test.go                           |   0
 gee-rpc/day5-http-debug/client.go             | 310 ++++++++++++++++++
 gee-rpc/day5-http-debug/client_test.go        |  63 ++++
 gee-rpc/day5-http-debug/codec/codec.go        |  34 ++
 gee-rpc/day5-http-debug/codec/gob.go          |  57 ++++
 .../debug.go                                  |   0
 gee-rpc/day5-http-debug/go.mod                |   3 +
 .../main/main.go                              |   3 +-
 .../server.go                                 |  63 +++-
 gee-rpc/day5-http-debug/service.go            |  99 ++++++
 gee-rpc/day5-http-debug/service_test.go       |  48 +++
 25 files changed, 1117 insertions(+), 106 deletions(-)
 rename gee-rpc/{day4-http-debug => day4-timeout}/client.go (74%)
 create mode 100644 gee-rpc/day4-timeout/client_test.go
 rename gee-rpc/{day4-http-debug => day4-timeout}/codec/codec.go (100%)
 rename gee-rpc/{day4-http-debug => day4-timeout}/codec/gob.go (100%)
 rename gee-rpc/{day4-http-debug => day4-timeout}/go.mod (100%)
 create mode 100644 gee-rpc/day4-timeout/main/main.go
 create mode 100644 gee-rpc/day4-timeout/server.go
 rename gee-rpc/{day4-http-debug => day4-timeout}/service.go (100%)
 rename gee-rpc/{day4-http-debug => day4-timeout}/service_test.go (100%)
 create mode 100644 gee-rpc/day5-http-debug/client.go
 create mode 100644 gee-rpc/day5-http-debug/client_test.go
 create mode 100644 gee-rpc/day5-http-debug/codec/codec.go
 create mode 100644 gee-rpc/day5-http-debug/codec/gob.go
 rename gee-rpc/{day4-http-debug => day5-http-debug}/debug.go (100%)
 create mode 100644 gee-rpc/day5-http-debug/go.mod
 rename gee-rpc/{day4-http-debug => day5-http-debug}/main/main.go (90%)
 rename gee-rpc/{day4-http-debug => day5-http-debug}/server.go (80%)
 create mode 100644 gee-rpc/day5-http-debug/service.go
 create mode 100644 gee-rpc/day5-http-debug/service_test.go

diff --git a/gee-rpc/day1-codec/main/main.go b/gee-rpc/day1-codec/main/main.go
index a715209..8f29531 100644
--- a/gee-rpc/day1-codec/main/main.go
+++ b/gee-rpc/day1-codec/main/main.go
@@ -29,11 +29,7 @@ func main() {
 	defer func() { _ = conn.Close() }()
 
 	// send options
-	_ = json.NewEncoder(conn).Encode(&geerpc.Options{
-		MagicNumber: geerpc.MagicNumber,
-		CodecType:   codec.GobType,
-	})
-
+	_ = json.NewEncoder(conn).Encode(geerpc.DefaultOption)
 	cc := codec.NewGobCodec(conn)
 	// send request & receive response
 	for i := 0; i < 5; i++ {
diff --git a/gee-rpc/day1-codec/server.go b/gee-rpc/day1-codec/server.go
index 06ef763..fb93e4f 100644
--- a/gee-rpc/day1-codec/server.go
+++ b/gee-rpc/day1-codec/server.go
@@ -17,12 +17,12 @@ import (
 
 const MagicNumber = 0x3bef5c
 
-type Options struct {
+type Option struct {
 	MagicNumber int        // MagicNumber marks this's a geerpc request
 	CodecType   codec.Type // client may choose different Codec to encode body
 }
 
-var defaultOptions = &Options{
+var DefaultOption = &Option{
 	MagicNumber: MagicNumber,
 	CodecType:   codec.GobType,
 }
@@ -42,7 +42,7 @@ var DefaultServer = NewServer()
 // ServeConn blocks, serving the connection until the client hangs up.
 func (server *Server) ServeConn(conn io.ReadWriteCloser) {
 	defer func() { _ = conn.Close() }()
-	var opt Options
+	var opt Option
 	if err := json.NewDecoder(conn).Decode(&opt); err != nil {
 		log.Println("rpc server: options error: ", err)
 		return
diff --git a/gee-rpc/day2-client/client.go b/gee-rpc/day2-client/client.go
index b73c461..f9b09ee 100644
--- a/gee-rpc/day2-client/client.go
+++ b/gee-rpc/day2-client/client.go
@@ -17,6 +17,7 @@ import (
 
 // Call represents an active RPC.
 type Call struct {
+	Seq           uint64
 	ServiceMethod string      // format "<service>.<method>"
 	Args          interface{} // arguments to the function
 	Reply         interface{} // reply from the function
@@ -34,7 +35,7 @@ func (call *Call) done() {
 // multiple goroutines simultaneously.
 type Client struct {
 	cc      codec.Codec
-	opt     *Options
+	opt     *Option
 	sending sync.Mutex // protect following
 	header  codec.Header
 	mu      sync.Mutex // protect following
@@ -96,6 +97,7 @@ func (client *Client) send(call *Call) {
 
 	// register this call.
 	seq, err := client.registerCall(call)
+	call.Seq = seq
 	if err != nil {
 		call.Error = err
 		call.done()
@@ -173,35 +175,31 @@ func (client *Client) Call(serviceMethod string, args, reply interface{}) error
 	return call.Error
 }
 
-func parseOptions(opts ...*Options) (*Options, error) {
+func parseOptions(opts ...*Option) (*Option, error) {
 	// if opts is nil or pass nil as parameter
 	if len(opts) == 0 || opts[0] == nil {
-		return defaultOptions, nil
+		return DefaultOption, nil
 	}
 	if len(opts) != 1 {
 		return nil, errors.New("number of options is more than 1")
 	}
 	opt := opts[0]
-	opt.MagicNumber = defaultOptions.MagicNumber
+	opt.MagicNumber = DefaultOption.MagicNumber
 	if opt.CodecType == "" {
-		opt.CodecType = defaultOptions.CodecType
+		opt.CodecType = DefaultOption.CodecType
 	}
 	return opt, nil
 }
 
-func NewClient(conn io.ReadWriteCloser, opts ...*Options) (*Client, error) {
-	opt, err := parseOptions(opts...)
-	if err != nil {
-		return nil, err
-	}
+func NewClient(conn net.Conn, opt *Option) (*Client, error) {
 	f := codec.NewCodecFuncMap[opt.CodecType]
 	if f == nil {
-		err = fmt.Errorf("invalid codec type %s", opt.CodecType)
+		err := fmt.Errorf("invalid codec type %s", opt.CodecType)
 		log.Println("rpc client: codec error:", err)
 		return nil, err
 	}
 	// send options with server
-	if err = json.NewEncoder(conn).Encode(opt); err != nil {
+	if err := json.NewEncoder(conn).Encode(opt); err != nil {
 		log.Println("rpc client: options error: ", err)
 		_ = conn.Close()
 		return nil, err
@@ -209,8 +207,9 @@ func NewClient(conn io.ReadWriteCloser, opts ...*Options) (*Client, error) {
 	return newClientCodec(f(conn), opt), nil
 }
 
-func newClientCodec(cc codec.Codec, opt *Options) *Client {
+func newClientCodec(cc codec.Codec, opt *Option) *Client {
 	client := &Client{
+		seq:     1, // seq starts with 1, 0 means invalid call
 		cc:      cc,
 		opt:     opt,
 		pending: make(map[uint64]*Call),
@@ -219,11 +218,19 @@ func newClientCodec(cc codec.Codec, opt *Options) *Client {
 	return client
 }
 
-// Dial connects to an RPC server at the specified network address
-func Dial(network, address string, opts ...*Options) (*Client, error) {
+func dial(network, address string, opt *Option) (*Client, error) {
 	conn, err := net.Dial(network, address)
 	if err != nil {
 		return nil, err
 	}
-	return NewClient(conn, opts...)
+	return NewClient(conn, opt)
+}
+
+// Dial connects to an RPC server at the specified network address
+func Dial(network, address string, opts ...*Option) (*Client, error) {
+	opt, err := parseOptions(opts...)
+	if err != nil {
+		return nil, err
+	}
+	return dial(network, address, opt)
 }
diff --git a/gee-rpc/day2-client/server.go b/gee-rpc/day2-client/server.go
index 06ef763..fb93e4f 100644
--- a/gee-rpc/day2-client/server.go
+++ b/gee-rpc/day2-client/server.go
@@ -17,12 +17,12 @@ import (
 
 const MagicNumber = 0x3bef5c
 
-type Options struct {
+type Option struct {
 	MagicNumber int        // MagicNumber marks this's a geerpc request
 	CodecType   codec.Type // client may choose different Codec to encode body
 }
 
-var defaultOptions = &Options{
+var DefaultOption = &Option{
 	MagicNumber: MagicNumber,
 	CodecType:   codec.GobType,
 }
@@ -42,7 +42,7 @@ var DefaultServer = NewServer()
 // ServeConn blocks, serving the connection until the client hangs up.
 func (server *Server) ServeConn(conn io.ReadWriteCloser) {
 	defer func() { _ = conn.Close() }()
-	var opt Options
+	var opt Option
 	if err := json.NewDecoder(conn).Decode(&opt); err != nil {
 		log.Println("rpc server: options error: ", err)
 		return
diff --git a/gee-rpc/day3-service/client.go b/gee-rpc/day3-service/client.go
index b73c461..f9b09ee 100644
--- a/gee-rpc/day3-service/client.go
+++ b/gee-rpc/day3-service/client.go
@@ -17,6 +17,7 @@ import (
 
 // Call represents an active RPC.
 type Call struct {
+	Seq           uint64
 	ServiceMethod string      // format "<service>.<method>"
 	Args          interface{} // arguments to the function
 	Reply         interface{} // reply from the function
@@ -34,7 +35,7 @@ func (call *Call) done() {
 // multiple goroutines simultaneously.
 type Client struct {
 	cc      codec.Codec
-	opt     *Options
+	opt     *Option
 	sending sync.Mutex // protect following
 	header  codec.Header
 	mu      sync.Mutex // protect following
@@ -96,6 +97,7 @@ func (client *Client) send(call *Call) {
 
 	// register this call.
 	seq, err := client.registerCall(call)
+	call.Seq = seq
 	if err != nil {
 		call.Error = err
 		call.done()
@@ -173,35 +175,31 @@ func (client *Client) Call(serviceMethod string, args, reply interface{}) error
 	return call.Error
 }
 
-func parseOptions(opts ...*Options) (*Options, error) {
+func parseOptions(opts ...*Option) (*Option, error) {
 	// if opts is nil or pass nil as parameter
 	if len(opts) == 0 || opts[0] == nil {
-		return defaultOptions, nil
+		return DefaultOption, nil
 	}
 	if len(opts) != 1 {
 		return nil, errors.New("number of options is more than 1")
 	}
 	opt := opts[0]
-	opt.MagicNumber = defaultOptions.MagicNumber
+	opt.MagicNumber = DefaultOption.MagicNumber
 	if opt.CodecType == "" {
-		opt.CodecType = defaultOptions.CodecType
+		opt.CodecType = DefaultOption.CodecType
 	}
 	return opt, nil
 }
 
-func NewClient(conn io.ReadWriteCloser, opts ...*Options) (*Client, error) {
-	opt, err := parseOptions(opts...)
-	if err != nil {
-		return nil, err
-	}
+func NewClient(conn net.Conn, opt *Option) (*Client, error) {
 	f := codec.NewCodecFuncMap[opt.CodecType]
 	if f == nil {
-		err = fmt.Errorf("invalid codec type %s", opt.CodecType)
+		err := fmt.Errorf("invalid codec type %s", opt.CodecType)
 		log.Println("rpc client: codec error:", err)
 		return nil, err
 	}
 	// send options with server
-	if err = json.NewEncoder(conn).Encode(opt); err != nil {
+	if err := json.NewEncoder(conn).Encode(opt); err != nil {
 		log.Println("rpc client: options error: ", err)
 		_ = conn.Close()
 		return nil, err
@@ -209,8 +207,9 @@ func NewClient(conn io.ReadWriteCloser, opts ...*Options) (*Client, error) {
 	return newClientCodec(f(conn), opt), nil
 }
 
-func newClientCodec(cc codec.Codec, opt *Options) *Client {
+func newClientCodec(cc codec.Codec, opt *Option) *Client {
 	client := &Client{
+		seq:     1, // seq starts with 1, 0 means invalid call
 		cc:      cc,
 		opt:     opt,
 		pending: make(map[uint64]*Call),
@@ -219,11 +218,19 @@ func newClientCodec(cc codec.Codec, opt *Options) *Client {
 	return client
 }
 
-// Dial connects to an RPC server at the specified network address
-func Dial(network, address string, opts ...*Options) (*Client, error) {
+func dial(network, address string, opt *Option) (*Client, error) {
 	conn, err := net.Dial(network, address)
 	if err != nil {
 		return nil, err
 	}
-	return NewClient(conn, opts...)
+	return NewClient(conn, opt)
+}
+
+// Dial connects to an RPC server at the specified network address
+func Dial(network, address string, opts ...*Option) (*Client, error) {
+	opt, err := parseOptions(opts...)
+	if err != nil {
+		return nil, err
+	}
+	return dial(network, address, opt)
 }
diff --git a/gee-rpc/day3-service/server.go b/gee-rpc/day3-service/server.go
index 6558dad..4634394 100644
--- a/gee-rpc/day3-service/server.go
+++ b/gee-rpc/day3-service/server.go
@@ -18,12 +18,12 @@ import (
 
 const MagicNumber = 0x3bef5c
 
-type Options struct {
+type Option struct {
 	MagicNumber int        // MagicNumber marks this's a geerpc request
 	CodecType   codec.Type // client may choose different Codec to encode body
 }
 
-var defaultOptions = &Options{
+var DefaultOption = &Option{
 	MagicNumber: MagicNumber,
 	CodecType:   codec.GobType,
 }
@@ -45,7 +45,7 @@ var DefaultServer = NewServer()
 // ServeConn blocks, serving the connection until the client hangs up.
 func (server *Server) ServeConn(conn io.ReadWriteCloser) {
 	defer func() { _ = conn.Close() }()
-	var opt Options
+	var opt Option
 	if err := json.NewDecoder(conn).Decode(&opt); err != nil {
 		log.Println("rpc server: options error: ", err)
 		return
@@ -162,6 +162,8 @@ func (server *Server) handleRequest(cc codec.Codec, req *request, sending *sync.
 	err := req.svc.call(req.mtype, req.argv, req.replyv)
 	if err != nil {
 		req.h.Error = err.Error()
+		server.sendResponse(cc, req.h, invalidRequest, sending)
+		return
 	}
 	server.sendResponse(cc, req.h, req.replyv.Interface(), sending)
 }
diff --git a/gee-rpc/day4-http-debug/client.go b/gee-rpc/day4-timeout/client.go
similarity index 74%
rename from gee-rpc/day4-http-debug/client.go
rename to gee-rpc/day4-timeout/client.go
index 7ae8938..c9900fa 100644
--- a/gee-rpc/day4-http-debug/client.go
+++ b/gee-rpc/day4-timeout/client.go
@@ -5,7 +5,7 @@
 package geerpc
 
 import (
-	"bufio"
+	"context"
 	"encoding/json"
 	"errors"
 	"fmt"
@@ -13,12 +13,13 @@ import (
 	"io"
 	"log"
 	"net"
-	"net/http"
 	"sync"
+	"time"
 )
 
 // Call represents an active RPC.
 type Call struct {
+	Seq           uint64
 	ServiceMethod string      // format "<service>.<method>"
 	Args          interface{} // arguments to the function
 	Reply         interface{} // reply from the function
@@ -36,7 +37,7 @@ func (call *Call) done() {
 // multiple goroutines simultaneously.
 type Client struct {
 	cc      codec.Codec
-	opt     *Options
+	opt     *Option
 	sending sync.Mutex // protect following
 	header  codec.Header
 	mu      sync.Mutex // protect following
@@ -98,6 +99,7 @@ func (client *Client) send(call *Call) {
 
 	// register this call.
 	seq, err := client.registerCall(call)
+	call.Seq = seq
 	if err != nil {
 		call.Error = err
 		call.done()
@@ -170,40 +172,42 @@ func (client *Client) Go(serviceMethod string, args, reply interface{}, done cha
 
 // Call invokes the named function, waits for it to complete,
 // and returns its error status.
-func (client *Client) Call(serviceMethod string, args, reply interface{}) error {
-	call := <-client.Go(serviceMethod, args, reply, make(chan *Call, 1)).Done
-	return call.Error
+func (client *Client) Call(ctx context.Context, serviceMethod string, args, reply interface{}) error {
+	call := client.Go(serviceMethod, args, reply, make(chan *Call, 1))
+	select {
+	case <-ctx.Done():
+		client.removeCall(call.Seq)
+		return errors.New("rpc client: call failed: " + ctx.Err().Error())
+	case call := <-call.Done:
+		return call.Error
+	}
 }
 
-func parseOptions(opts ...*Options) (*Options, error) {
+func parseOptions(opts ...*Option) (*Option, error) {
 	// if opts is nil or pass nil as parameter
 	if len(opts) == 0 || opts[0] == nil {
-		return defaultOptions, nil
+		return DefaultOption, nil
 	}
 	if len(opts) != 1 {
 		return nil, errors.New("number of options is more than 1")
 	}
 	opt := opts[0]
-	opt.MagicNumber = defaultOptions.MagicNumber
+	opt.MagicNumber = DefaultOption.MagicNumber
 	if opt.CodecType == "" {
-		opt.CodecType = defaultOptions.CodecType
+		opt.CodecType = DefaultOption.CodecType
 	}
 	return opt, nil
 }
 
-func NewClient(conn io.ReadWriteCloser, opts ...*Options) (*Client, error) {
-	opt, err := parseOptions(opts...)
-	if err != nil {
-		return nil, err
-	}
+func NewClient(conn net.Conn, opt *Option) (*Client, error) {
 	f := codec.NewCodecFuncMap[opt.CodecType]
 	if f == nil {
-		err = fmt.Errorf("invalid codec type %s", opt.CodecType)
+		err := fmt.Errorf("invalid codec type %s", opt.CodecType)
 		log.Println("rpc client: codec error:", err)
 		return nil, err
 	}
 	// send options with server
-	if err = json.NewEncoder(conn).Encode(opt); err != nil {
+	if err := json.NewEncoder(conn).Encode(opt); err != nil {
 		log.Println("rpc client: options error: ", err)
 		_ = conn.Close()
 		return nil, err
@@ -211,8 +215,9 @@ func NewClient(conn io.ReadWriteCloser, opts ...*Options) (*Client, error) {
 	return newClientCodec(f(conn), opt), nil
 }
 
-func newClientCodec(cc codec.Codec, opt *Options) *Client {
+func newClientCodec(cc codec.Codec, opt *Option) *Client {
 	client := &Client{
+		seq:     1, // seq starts with 1, 0 means invalid call
 		cc:      cc,
 		opt:     opt,
 		pending: make(map[uint64]*Call),
@@ -221,39 +226,44 @@ func newClientCodec(cc codec.Codec, opt *Options) *Client {
 	return client
 }
 
-// Dial connects to an RPC server at the specified network address
-func Dial(network, address string, opts ...*Options) (*Client, error) {
+func dial(network, address string, opt *Option) (*Client, error) {
 	conn, err := net.Dial(network, address)
 	if err != nil {
 		return nil, err
 	}
-	return NewClient(conn, opts...)
+	return NewClient(conn, opt)
 }
 
-// DialHTTP connects to an HTTP RPC server at the specified network address
-// listening on the default HTTP RPC path.
-func DialHTTP(network, address string, opts ...*Options) (*Client, error) {
-	return DialHTTPPath(network, address, defaultRPCPath, opts...)
+type clientResult struct {
+	client *Client
+	err    error
 }
 
-// DialHTTPPath connects to an HTTP RPC server
-// at the specified network address and path.
-func DialHTTPPath(network, address, path string, opts ...*Options) (*Client, error) {
-	conn, err := net.Dial(network, address)
-	if err != nil {
-		return nil, err
+func dialTimeout(f func() (client *Client, err error), timeout time.Duration) (*Client, error) {
+	if timeout == 0 {
+		return f()
+	}
+	ch := make(chan clientResult)
+	go func() {
+		client, err := f()
+		ch <- clientResult{client: client, err: err}
+	}()
+	select {
+	case <-time.After(timeout):
+		return nil, fmt.Errorf("rpc client: dial timeout: expect within %s", timeout)
+	case result := <-ch:
+		return result.client, result.err
 	}
-	_, _ = io.WriteString(conn, fmt.Sprintf("CONNECT %s HTTP/1.0\n\n", path))
+}
 
-	// Require successful HTTP response
-	// before switching to RPC protocol.
-	resp, err := http.ReadResponse(bufio.NewReader(conn), &http.Request{Method: "CONNECT"})
-	if err == nil && resp.Status == connected {
-		return NewClient(conn, opts...)
+// Dial connects to an RPC server at the specified network address
+func Dial(network, address string, opts ...*Option) (*Client, error) {
+	opt, err := parseOptions(opts...)
+	if err != nil {
+		return nil, err
 	}
-	if err == nil {
-		err = errors.New("unexpected HTTP response: " + resp.Status)
+	f := func() (client *Client, err error) {
+		return dial(network, address, opt)
 	}
-	_ = conn.Close()
-	return nil, err
+	return dialTimeout(f, opt.ConnectTimeout)
 }
diff --git a/gee-rpc/day4-timeout/client_test.go b/gee-rpc/day4-timeout/client_test.go
new file mode 100644
index 0000000..5669f9c
--- /dev/null
+++ b/gee-rpc/day4-timeout/client_test.go
@@ -0,0 +1,63 @@
+package geerpc
+
+import (
+	"context"
+	"net"
+	"strings"
+	"testing"
+	"time"
+)
+
+type Bar int
+
+func (b Bar) Timeout(argv int, reply *int) error {
+	time.Sleep(time.Second * 2)
+	return nil
+}
+
+func startServer(addr chan string) {
+	var b Bar
+	_ = Register(&b)
+	// pick a free port
+	l, _ := net.Listen("tcp", ":0")
+	addr <- l.Addr().String()
+	Accept(l)
+}
+
+func TestClient_dialTimeout(t *testing.T) {
+	t.Parallel()
+	f := func() (client *Client, err error) {
+		time.Sleep(time.Second * 2)
+		return nil, nil
+	}
+	t.Run("timeout", func(t *testing.T) {
+		_, err := dialTimeout(f, time.Second)
+		_assert(err != nil && strings.Contains(err.Error(), "dial timeout"), "expect a timeout error")
+	})
+	t.Run("0", func(t *testing.T) {
+		_, err := dialTimeout(f, 0)
+		_assert(err == nil, "0 means no limit")
+	})
+}
+
+func TestClient_Call(t *testing.T) {
+	t.Parallel()
+	addrCh := make(chan string)
+	go startServer(addrCh)
+	addr := <-addrCh
+	t.Run("client timeout", func(t *testing.T) {
+		client, _ := Dial("tcp", addr)
+		ctx, _ := context.WithTimeout(context.Background(), time.Second)
+		var reply int
+		err := client.Call(ctx, "Bar.Timeout", 1, &reply)
+		_assert(err != nil && strings.Contains(err.Error(), ctx.Err().Error()), "expect a timeout error")
+	})
+	t.Run("server handle timeout", func(t *testing.T) {
+		client, _ := Dial("tcp", addr, &Option{
+			HandleTimeout: time.Second,
+		})
+		var reply int
+		err := client.Call(context.Background(), "Bar.Timeout", 1, &reply)
+		_assert(err != nil && strings.Contains(err.Error(), "handle timeout"), "expect a timeout error")
+	})
+}
diff --git a/gee-rpc/day4-http-debug/codec/codec.go b/gee-rpc/day4-timeout/codec/codec.go
similarity index 100%
rename from gee-rpc/day4-http-debug/codec/codec.go
rename to gee-rpc/day4-timeout/codec/codec.go
diff --git a/gee-rpc/day4-http-debug/codec/gob.go b/gee-rpc/day4-timeout/codec/gob.go
similarity index 100%
rename from gee-rpc/day4-http-debug/codec/gob.go
rename to gee-rpc/day4-timeout/codec/gob.go
diff --git a/gee-rpc/day4-http-debug/go.mod b/gee-rpc/day4-timeout/go.mod
similarity index 100%
rename from gee-rpc/day4-http-debug/go.mod
rename to gee-rpc/day4-timeout/go.mod
diff --git a/gee-rpc/day4-timeout/main/main.go b/gee-rpc/day4-timeout/main/main.go
new file mode 100644
index 0000000..e5e6050
--- /dev/null
+++ b/gee-rpc/day4-timeout/main/main.go
@@ -0,0 +1,56 @@
+package main
+
+import (
+	"context"
+	"geerpc"
+	"log"
+	"net"
+	"sync"
+)
+
+type Foo int
+
+type Args struct{ Num1, Num2 int }
+
+func (f Foo) Sum(args Args, reply *int) error {
+	*reply = args.Num1 + args.Num2
+	return nil
+}
+
+func startServer(addr chan string) {
+	var foo Foo
+	if err := geerpc.Register(&foo); err != nil {
+		log.Fatal("register error:", err)
+	}
+	// pick a free port
+	l, err := net.Listen("tcp", ":0")
+	if err != nil {
+		log.Fatal("network error:", err)
+	}
+	log.Println("start rpc server on", l.Addr())
+	addr <- l.Addr().String()
+	geerpc.Accept(l)
+}
+
+func main() {
+	addr := make(chan string)
+	go startServer(addr)
+	client, _ := geerpc.Dial("tcp", <-addr)
+	defer func() { _ = client.Close() }()
+
+	// send request & receive response
+	var wg sync.WaitGroup
+	for i := 0; i < 5; i++ {
+		wg.Add(1)
+		go func(i int) {
+			defer wg.Done()
+			args := &Args{Num1: i, Num2: i * i}
+			var reply int
+			if err := client.Call(context.Background(), "Foo.Sum", args, &reply); err != nil {
+				log.Fatal("call Foo.Sum error:", err)
+			}
+			log.Printf("%d + %d = %d", args.Num1, args.Num2, reply)
+		}(i)
+	}
+	wg.Wait()
+}
diff --git a/gee-rpc/day4-timeout/server.go b/gee-rpc/day4-timeout/server.go
new file mode 100644
index 0000000..a049914
--- /dev/null
+++ b/gee-rpc/day4-timeout/server.go
@@ -0,0 +1,228 @@
+// Copyright 2009 The Go Authors. All rights reserved.
+// Use of this source code is governed by a BSD-style
+// license that can be found in the LICENSE file.
+
+package geerpc
+
+import (
+	"encoding/json"
+	"errors"
+	"fmt"
+	"geerpc/codec"
+	"io"
+	"log"
+	"net"
+	"reflect"
+	"strings"
+	"sync"
+	"time"
+)
+
+const MagicNumber = 0x3bef5c
+
+type Option struct {
+	MagicNumber    int           // MagicNumber marks this's a geerpc request
+	CodecType      codec.Type    // client may choose different Codec to encode body
+	ConnectTimeout time.Duration // 0 means no limit
+	HandleTimeout  time.Duration
+}
+
+var DefaultOption = &Option{
+	MagicNumber:    MagicNumber,
+	CodecType:      codec.GobType,
+	ConnectTimeout: time.Second * 10,
+}
+
+// Server represents an RPC Server.
+type Server struct {
+	serviceMap sync.Map
+}
+
+// NewServer returns a new Server.
+func NewServer() *Server {
+	return &Server{}
+}
+
+// DefaultServer is the default instance of *Server.
+var DefaultServer = NewServer()
+
+// ServeConn runs the server on a single connection.
+// ServeConn blocks, serving the connection until the client hangs up.
+func (server *Server) ServeConn(conn io.ReadWriteCloser) {
+	defer func() { _ = conn.Close() }()
+	var opt Option
+	if err := json.NewDecoder(conn).Decode(&opt); err != nil {
+		log.Println("rpc server: options error: ", err)
+		return
+	}
+	if opt.MagicNumber != MagicNumber {
+		log.Printf("rpc server: invalid magic number %x", opt.MagicNumber)
+		return
+	}
+	f := codec.NewCodecFuncMap[opt.CodecType]
+	if f == nil {
+		log.Printf("rpc server: invalid codec type %s", opt.CodecType)
+		return
+	}
+	server.serveCodec(f(conn), &opt)
+}
+
+// invalidRequest is a placeholder for response argv when error occurs
+var invalidRequest = struct{}{}
+
+func (server *Server) serveCodec(cc codec.Codec, opt *Option) {
+	sending := new(sync.Mutex) // make sure to send a complete response
+	wg := new(sync.WaitGroup)  // wait until all request are handled
+	for {
+		req, err := server.readRequest(cc)
+		if err != nil {
+			if req == nil {
+				break // it's not possible to recover, so close the connection
+			}
+			req.h.Error = err.Error()
+			server.sendResponse(cc, req.h, invalidRequest, sending)
+			continue
+		}
+		wg.Add(1)
+		go server.handleRequest(cc, req, sending, wg, opt.HandleTimeout)
+	}
+	wg.Wait()
+	_ = cc.Close()
+}
+
+// request stores all information of a call
+type request struct {
+	h            *codec.Header // header of request
+	argv, replyv reflect.Value // argv and replyv of request
+	mtype        *methodType
+	svc          *service
+}
+
+func (server *Server) readRequestHeader(cc codec.Codec) (*codec.Header, error) {
+	var h codec.Header
+	if err := cc.ReadHeader(&h); err != nil {
+		if err != io.EOF && err != io.ErrUnexpectedEOF {
+			log.Println("rpc server: read header error:", err)
+		}
+		return nil, err
+	}
+	return &h, nil
+}
+
+func (server *Server) findService(serviceMethod string) (svc *service, mtype *methodType, err error) {
+	dot := strings.LastIndex(serviceMethod, ".")
+	if dot < 0 {
+		err = errors.New("rpc server: service/method request ill-formed: " + serviceMethod)
+		return
+	}
+	serviceName, methodName := serviceMethod[:dot], serviceMethod[dot+1:]
+	svci, ok := server.serviceMap.Load(serviceName)
+	if !ok {
+		err = errors.New("rpc server: can't find service " + serviceName)
+		return
+	}
+	svc = svci.(*service)
+	mtype = svc.method[methodName]
+	if mtype == nil {
+		err = errors.New("rpc server: can't find method " + methodName)
+	}
+	return
+}
+
+func (server *Server) readRequest(cc codec.Codec) (*request, error) {
+	h, err := server.readRequestHeader(cc)
+	if err != nil {
+		return nil, err
+	}
+	req := &request{h: h}
+	req.svc, req.mtype, err = server.findService(h.ServiceMethod)
+	if err != nil {
+		return req, err
+	}
+	req.argv = req.mtype.newArgv()
+	req.replyv = req.mtype.newReplyv()
+
+	// make sure that argvi is a pointer, ReadBody need a pointer as parameter
+	argvi := req.argv.Interface()
+	if req.argv.Type().Kind() != reflect.Ptr {
+		argvi = req.argv.Addr().Interface()
+	}
+	if err = cc.ReadBody(argvi); err != nil {
+		log.Println("rpc server: read body err:", err)
+		return req, err
+	}
+	return req, nil
+}
+
+func (server *Server) sendResponse(cc codec.Codec, h *codec.Header, body interface{}, sending *sync.Mutex) {
+	sending.Lock()
+	defer sending.Unlock()
+	if err := cc.Write(h, body); err != nil {
+		log.Println("rpc server: write response error:", err)
+	}
+}
+
+func (server *Server) handleRequest(cc codec.Codec, req *request, sending *sync.Mutex, wg *sync.WaitGroup, timeout time.Duration) {
+	defer wg.Done()
+	called := make(chan struct{})
+	sent := make(chan struct{})
+	go func() {
+		err := req.svc.call(req.mtype, req.argv, req.replyv)
+		called <- struct{}{}
+		if err != nil {
+			req.h.Error = err.Error()
+			server.sendResponse(cc, req.h, invalidRequest, sending)
+			sent <- struct{}{}
+			return
+		}
+		server.sendResponse(cc, req.h, req.replyv.Interface(), sending)
+		sent <- struct{}{}
+	}()
+
+	if timeout == 0 {
+		<-called
+		<-sent
+		return
+	}
+	select {
+	case <-time.After(timeout):
+		req.h.Error = fmt.Sprintf("rpc server: request handle timeout: expect within %s", timeout)
+		server.sendResponse(cc, req.h, invalidRequest, sending)
+	case <-called:
+		<-sent
+	}
+}
+
+// Accept accepts connections on the listener and serves requests
+// for each incoming connection.
+func (server *Server) Accept(lis net.Listener) {
+	for {
+		conn, err := lis.Accept()
+		if err != nil {
+			log.Println("rpc server: accept error:", err)
+			return
+		}
+		go server.ServeConn(conn)
+	}
+}
+
+// Accept accepts connections on the listener and serves requests
+// for each incoming connection.
+func Accept(lis net.Listener) { DefaultServer.Accept(lis) }
+
+// Register publishes in the server the set of methods of the
+// receiver value that satisfy the following conditions:
+//	- exported method of exported type
+//	- two arguments, both of exported type
+//	- the second argument is a pointer
+//	- one return value, of type error
+func (server *Server) Register(rcvr interface{}) error {
+	s := newService(rcvr)
+	if _, dup := server.serviceMap.LoadOrStore(s.name, s); dup {
+		return errors.New("rpc: service already defined: " + s.name)
+	}
+	return nil
+}
+
+// Register publishes the receiver's methods in the DefaultServer.
+func Register(rcvr interface{}) error { return DefaultServer.Register(rcvr) }
diff --git a/gee-rpc/day4-http-debug/service.go b/gee-rpc/day4-timeout/service.go
similarity index 100%
rename from gee-rpc/day4-http-debug/service.go
rename to gee-rpc/day4-timeout/service.go
diff --git a/gee-rpc/day4-http-debug/service_test.go b/gee-rpc/day4-timeout/service_test.go
similarity index 100%
rename from gee-rpc/day4-http-debug/service_test.go
rename to gee-rpc/day4-timeout/service_test.go
diff --git a/gee-rpc/day5-http-debug/client.go b/gee-rpc/day5-http-debug/client.go
new file mode 100644
index 0000000..5f336d7
--- /dev/null
+++ b/gee-rpc/day5-http-debug/client.go
@@ -0,0 +1,310 @@
+// Copyright 2009 The Go Authors. All rights reserved.
+// Use of this source code is governed by a BSD-style
+// license that can be found in the LICENSE file.
+
+package geerpc
+
+import (
+	"bufio"
+	"context"
+	"encoding/json"
+	"errors"
+	"fmt"
+	"geerpc/codec"
+	"io"
+	"log"
+	"net"
+	"net/http"
+	"sync"
+	"time"
+)
+
+// Call represents an active RPC.
+type Call struct {
+	Seq           uint64
+	ServiceMethod string      // format "<service>.<method>"
+	Args          interface{} // arguments to the function
+	Reply         interface{} // reply from the function
+	Error         error       // if error occurs, it will be set
+	Done          chan *Call  // Strobes when call is complete.
+}
+
+func (call *Call) done() {
+	call.Done <- call
+}
+
+// Client represents an RPC Client.
+// There may be multiple outstanding Calls associated
+// with a single Client, and a Client may be used by
+// multiple goroutines simultaneously.
+type Client struct {
+	cc      codec.Codec
+	opt     *Option
+	sending sync.Mutex // protect following
+	header  codec.Header
+	mu      sync.Mutex // protect following
+	seq     uint64
+	pending map[uint64]*Call
+	closed  bool // user has called Close
+}
+
+var _ io.Closer = (*Client)(nil)
+
+var ErrShutdown = errors.New("connection is shut down")
+
+// Close the connection
+func (client *Client) Close() error {
+	client.mu.Lock()
+	defer client.mu.Unlock()
+	if client.closed {
+		return ErrShutdown
+	}
+	client.closed = true
+	return client.cc.Close()
+}
+
+func (client *Client) registerCall(call *Call) (uint64, error) {
+	client.mu.Lock()
+	defer client.mu.Unlock()
+	if client.closed {
+		return 0, ErrShutdown
+	}
+	seq := client.seq
+	client.pending[seq] = call
+	client.seq++
+	return seq, nil
+}
+
+func (client *Client) removeCall(seq uint64) *Call {
+	client.mu.Lock()
+	defer client.mu.Unlock()
+	call := client.pending[seq]
+	delete(client.pending, seq)
+	return call
+}
+
+func (client *Client) terminateCalls(err error) {
+	client.sending.Lock()
+	defer client.sending.Unlock()
+	client.mu.Lock()
+	defer client.mu.Unlock()
+	for _, call := range client.pending {
+		call.Error = err
+		call.done()
+	}
+}
+
+func (client *Client) send(call *Call) {
+	// make sure that the client will send a complete request
+	client.sending.Lock()
+	defer client.sending.Unlock()
+
+	// register this call.
+	seq, err := client.registerCall(call)
+	call.Seq = seq
+	if err != nil {
+		call.Error = err
+		call.done()
+		return
+	}
+
+	// prepare request header
+	client.header.ServiceMethod = call.ServiceMethod
+	client.header.Seq = seq
+	client.header.Error = ""
+
+	// encode and send the request
+	if err := client.cc.Write(&client.header, call.Args); err != nil {
+		call := client.removeCall(seq)
+		// call may be nil, it usually means that Write partially failed,
+		// client has received the response and handled
+		if call != nil {
+			call.Error = err
+			call.done()
+		}
+	}
+}
+
+func (client *Client) receive() {
+	var err error
+	for err == nil {
+		var h codec.Header
+		if err = client.cc.ReadHeader(&h); err != nil {
+			break
+		}
+		call := client.removeCall(h.Seq)
+		switch {
+		case call == nil:
+			// it usually means that Write partially failed
+			// and call was already removed.
+			err = client.cc.ReadBody(nil)
+		case h.Error != "":
+			call.Error = fmt.Errorf(h.Error)
+			err = client.cc.ReadBody(nil)
+			call.done()
+		default:
+			err = client.cc.ReadBody(call.Reply)
+			if err != nil {
+				call.Error = errors.New("reading body " + err.Error())
+			}
+			call.done()
+		}
+	}
+	// error occurs, so terminateCalls pending calls
+	client.terminateCalls(err)
+}
+
+// Go invokes the function asynchronously.
+// It returns the Call structure representing the invocation.
+func (client *Client) Go(serviceMethod string, args, reply interface{}, done chan *Call) *Call {
+	if done == nil {
+		done = make(chan *Call, 10)
+	} else if cap(done) == 0 {
+		log.Panic("rpc client: done channel is unbuffered")
+	}
+	call := &Call{
+		ServiceMethod: serviceMethod,
+		Args:          args,
+		Reply:         reply,
+		Done:          done,
+	}
+	client.send(call)
+	return call
+}
+
+// Call invokes the named function, waits for it to complete,
+// and returns its error status.
+func (client *Client) Call(ctx context.Context, serviceMethod string, args, reply interface{}) error {
+	call := client.Go(serviceMethod, args, reply, make(chan *Call, 1))
+	select {
+	case <-ctx.Done():
+		client.removeCall(call.Seq)
+		return errors.New("rpc client: call failed: " + ctx.Err().Error())
+	case call := <-call.Done:
+		return call.Error
+	}
+}
+
+func parseOptions(opts ...*Option) (*Option, error) {
+	// if opts is nil or pass nil as parameter
+	if len(opts) == 0 || opts[0] == nil {
+		return DefaultOption, nil
+	}
+	if len(opts) != 1 {
+		return nil, errors.New("number of options is more than 1")
+	}
+	opt := opts[0]
+	opt.MagicNumber = DefaultOption.MagicNumber
+	if opt.CodecType == "" {
+		opt.CodecType = DefaultOption.CodecType
+	}
+	return opt, nil
+}
+
+func NewClient(conn net.Conn, opt *Option) (*Client, error) {
+	f := codec.NewCodecFuncMap[opt.CodecType]
+	if f == nil {
+		err := fmt.Errorf("invalid codec type %s", opt.CodecType)
+		log.Println("rpc client: codec error:", err)
+		return nil, err
+	}
+	// send options with server
+	if err := json.NewEncoder(conn).Encode(opt); err != nil {
+		log.Println("rpc client: options error: ", err)
+		_ = conn.Close()
+		return nil, err
+	}
+	return newClientCodec(f(conn), opt), nil
+}
+
+func newClientCodec(cc codec.Codec, opt *Option) *Client {
+	client := &Client{
+		seq:     1, // seq starts with 1, 0 means invalid call
+		cc:      cc,
+		opt:     opt,
+		pending: make(map[uint64]*Call),
+	}
+	go client.receive()
+	return client
+}
+
+func dial(network, address string, opt *Option) (*Client, error) {
+	conn, err := net.Dial(network, address)
+	if err != nil {
+		return nil, err
+	}
+	return NewClient(conn, opt)
+}
+
+type clientResult struct {
+	client *Client
+	err    error
+}
+
+func dialTimeout(f func() (client *Client, err error), timeout time.Duration) (*Client, error) {
+	if timeout == 0 {
+		return f()
+	}
+	ch := make(chan clientResult)
+	go func() {
+		client, err := f()
+		ch <- clientResult{client: client, err: err}
+	}()
+	select {
+	case <-time.After(timeout):
+		return nil, fmt.Errorf("rpc client: dial timeout: expect within %s", timeout)
+	case result := <-ch:
+		return result.client, result.err
+	}
+}
+
+// Dial connects to an RPC server at the specified network address
+func Dial(network, address string, opts ...*Option) (*Client, error) {
+	opt, err := parseOptions(opts...)
+	if err != nil {
+		return nil, err
+	}
+	f := func() (client *Client, err error) {
+		return dial(network, address, opt)
+	}
+	return dialTimeout(f, opt.ConnectTimeout)
+}
+
+func dialHTTPPath(network, address, path string, opt *Option) (*Client, error) {
+	conn, err := net.Dial(network, address)
+	if err != nil {
+		return nil, err
+	}
+	_, _ = io.WriteString(conn, fmt.Sprintf("CONNECT %s HTTP/1.0\n\n", path))
+
+	// Require successful HTTP response
+	// before switching to RPC protocol.
+	resp, err := http.ReadResponse(bufio.NewReader(conn), &http.Request{Method: "CONNECT"})
+	if err == nil && resp.Status == connected {
+		return NewClient(conn, opt)
+	}
+	if err == nil {
+		err = errors.New("unexpected HTTP response: " + resp.Status)
+	}
+	_ = conn.Close()
+	return nil, err
+}
+
+// DialHTTPPath connects to an HTTP RPC server
+// at the specified network address and path.
+func DialHTTPPath(network, address, path string, opts ...*Option) (*Client, error) {
+	opt, err := parseOptions(opts...)
+	if err != nil {
+		return nil, err
+	}
+	f := func() (*Client, error) {
+		return dialHTTPPath(network, address, path, opt)
+	}
+	return dialTimeout(f, opt.ConnectTimeout)
+}
+
+// DialHTTP connects to an HTTP RPC server at the specified network address
+// listening on the default HTTP RPC path.
+func DialHTTP(network, address string, opts ...*Option) (*Client, error) {
+	return DialHTTPPath(network, address, defaultRPCPath, opts...)
+}
diff --git a/gee-rpc/day5-http-debug/client_test.go b/gee-rpc/day5-http-debug/client_test.go
new file mode 100644
index 0000000..5669f9c
--- /dev/null
+++ b/gee-rpc/day5-http-debug/client_test.go
@@ -0,0 +1,63 @@
+package geerpc
+
+import (
+	"context"
+	"net"
+	"strings"
+	"testing"
+	"time"
+)
+
+type Bar int
+
+func (b Bar) Timeout(argv int, reply *int) error {
+	time.Sleep(time.Second * 2)
+	return nil
+}
+
+func startServer(addr chan string) {
+	var b Bar
+	_ = Register(&b)
+	// pick a free port
+	l, _ := net.Listen("tcp", ":0")
+	addr <- l.Addr().String()
+	Accept(l)
+}
+
+func TestClient_dialTimeout(t *testing.T) {
+	t.Parallel()
+	f := func() (client *Client, err error) {
+		time.Sleep(time.Second * 2)
+		return nil, nil
+	}
+	t.Run("timeout", func(t *testing.T) {
+		_, err := dialTimeout(f, time.Second)
+		_assert(err != nil && strings.Contains(err.Error(), "dial timeout"), "expect a timeout error")
+	})
+	t.Run("0", func(t *testing.T) {
+		_, err := dialTimeout(f, 0)
+		_assert(err == nil, "0 means no limit")
+	})
+}
+
+func TestClient_Call(t *testing.T) {
+	t.Parallel()
+	addrCh := make(chan string)
+	go startServer(addrCh)
+	addr := <-addrCh
+	t.Run("client timeout", func(t *testing.T) {
+		client, _ := Dial("tcp", addr)
+		ctx, _ := context.WithTimeout(context.Background(), time.Second)
+		var reply int
+		err := client.Call(ctx, "Bar.Timeout", 1, &reply)
+		_assert(err != nil && strings.Contains(err.Error(), ctx.Err().Error()), "expect a timeout error")
+	})
+	t.Run("server handle timeout", func(t *testing.T) {
+		client, _ := Dial("tcp", addr, &Option{
+			HandleTimeout: time.Second,
+		})
+		var reply int
+		err := client.Call(context.Background(), "Bar.Timeout", 1, &reply)
+		_assert(err != nil && strings.Contains(err.Error(), "handle timeout"), "expect a timeout error")
+	})
+}
diff --git a/gee-rpc/day5-http-debug/codec/codec.go b/gee-rpc/day5-http-debug/codec/codec.go
new file mode 100644
index 0000000..ba28fba
--- /dev/null
+++ b/gee-rpc/day5-http-debug/codec/codec.go
@@ -0,0 +1,34 @@
+package codec
+
+import (
+	"io"
+)
+
+type Header struct {
+	ServiceMethod string // format "Service.Method"
+	Seq           uint64 // sequence number chosen by client
+	Error         string
+}
+
+type Codec interface {
+	io.Closer
+	ReadHeader(*Header) error
+	ReadBody(interface{}) error
+	Write(*Header, interface{}) error
+}
+
+type NewCodecFunc func(io.ReadWriteCloser) Codec
+
+type Type string
+
+const (
+	GobType  Type = "application/gob"
+	JsonType Type = "application/json"
+)
+
+var NewCodecFuncMap map[Type]NewCodecFunc
+
+func init() {
+	NewCodecFuncMap = make(map[Type]NewCodecFunc)
+	NewCodecFuncMap[GobType] = NewGobCodec
+}
diff --git a/gee-rpc/day5-http-debug/codec/gob.go b/gee-rpc/day5-http-debug/codec/gob.go
new file mode 100644
index 0000000..808d97b
--- /dev/null
+++ b/gee-rpc/day5-http-debug/codec/gob.go
@@ -0,0 +1,57 @@
+package codec
+
+import (
+	"bufio"
+	"encoding/gob"
+	"io"
+	"log"
+)
+
+type GobCodec struct {
+	conn io.ReadWriteCloser
+	buf  *bufio.Writer
+	dec  *gob.Decoder
+	enc  *gob.Encoder
+}
+
+var _ Codec = (*GobCodec)(nil)
+
+func NewGobCodec(conn io.ReadWriteCloser) Codec {
+	buf := bufio.NewWriter(conn)
+	return &GobCodec{
+		conn: conn,
+		buf:  buf,
+		dec:  gob.NewDecoder(conn),
+		enc:  gob.NewEncoder(buf),
+	}
+}
+
+func (c *GobCodec) ReadHeader(h *Header) error {
+	return c.dec.Decode(h)
+}
+
+func (c *GobCodec) ReadBody(body interface{}) error {
+	return c.dec.Decode(body)
+}
+
+func (c *GobCodec) Write(h *Header, body interface{}) (err error) {
+	defer func() {
+		_ = c.buf.Flush()
+		if err != nil {
+			_ = c.Close()
+		}
+	}()
+	if err := c.enc.Encode(h); err != nil {
+		log.Println("rpc: gob error encoding header:", err)
+		return err
+	}
+	if err := c.enc.Encode(body); err != nil {
+		log.Println("rpc: gob error encoding body:", err)
+		return err
+	}
+	return nil
+}
+
+func (c *GobCodec) Close() error {
+	return c.conn.Close()
+}
diff --git a/gee-rpc/day4-http-debug/debug.go b/gee-rpc/day5-http-debug/debug.go
similarity index 100%
rename from gee-rpc/day4-http-debug/debug.go
rename to gee-rpc/day5-http-debug/debug.go
diff --git a/gee-rpc/day5-http-debug/go.mod b/gee-rpc/day5-http-debug/go.mod
new file mode 100644
index 0000000..0ec8aeb
--- /dev/null
+++ b/gee-rpc/day5-http-debug/go.mod
@@ -0,0 +1,3 @@
+module geerpc
+
+go 1.13
diff --git a/gee-rpc/day4-http-debug/main/main.go b/gee-rpc/day5-http-debug/main/main.go
similarity index 90%
rename from gee-rpc/day4-http-debug/main/main.go
rename to gee-rpc/day5-http-debug/main/main.go
index 13bb592..f25d909 100644
--- a/gee-rpc/day4-http-debug/main/main.go
+++ b/gee-rpc/day5-http-debug/main/main.go
@@ -1,6 +1,7 @@
 package main
 
 import (
+	"context"
 	"geerpc"
 	"log"
 	"net/http"
@@ -38,7 +39,7 @@ func call() {
 			defer wg.Done()
 			args := &Args{Num1: i, Num2: i * i}
 			var reply int
-			if err := client.Call("Foo.Sum", args, &reply); err != nil {
+			if err := client.Call(context.Background(), "Foo.Sum", args, &reply); err != nil {
 				log.Fatal("call Foo.Sum error:", err)
 			}
 			log.Printf("%d + %d = %d", args.Num1, args.Num2, reply)
diff --git a/gee-rpc/day4-http-debug/server.go b/gee-rpc/day5-http-debug/server.go
similarity index 80%
rename from gee-rpc/day4-http-debug/server.go
rename to gee-rpc/day5-http-debug/server.go
index ffb85ee..5be1c66 100644
--- a/gee-rpc/day4-http-debug/server.go
+++ b/gee-rpc/day5-http-debug/server.go
@@ -7,6 +7,7 @@ package geerpc
 import (
 	"encoding/json"
 	"errors"
+	"fmt"
 	"geerpc/codec"
 	"io"
 	"log"
@@ -15,18 +16,22 @@ import (
 	"reflect"
 	"strings"
 	"sync"
+	"time"
 )
 
 const MagicNumber = 0x3bef5c
 
-type Options struct {
-	MagicNumber int        // MagicNumber marks this's a geerpc request
-	CodecType   codec.Type // client may choose different Codec to encode body
+type Option struct {
+	MagicNumber    int           // MagicNumber marks this's a geerpc request
+	CodecType      codec.Type    // client may choose different Codec to encode body
+	ConnectTimeout time.Duration // 0 means no limit
+	HandleTimeout  time.Duration
 }
 
-var defaultOptions = &Options{
-	MagicNumber: MagicNumber,
-	CodecType:   codec.GobType,
+var DefaultOption = &Option{
+	MagicNumber:    MagicNumber,
+	CodecType:      codec.GobType,
+	ConnectTimeout: time.Second * 10,
 }
 
 // Server represents an RPC Server.
@@ -46,7 +51,7 @@ var DefaultServer = NewServer()
 // ServeConn blocks, serving the connection until the client hangs up.
 func (server *Server) ServeConn(conn io.ReadWriteCloser) {
 	defer func() { _ = conn.Close() }()
-	var opt Options
+	var opt Option
 	if err := json.NewDecoder(conn).Decode(&opt); err != nil {
 		log.Println("rpc server: options error: ", err)
 		return
@@ -60,13 +65,13 @@ func (server *Server) ServeConn(conn io.ReadWriteCloser) {
 		log.Printf("rpc server: invalid codec type %s", opt.CodecType)
 		return
 	}
-	server.serveCodec(f(conn))
+	server.serveCodec(f(conn), &opt)
 }
 
 // invalidRequest is a placeholder for response argv when error occurs
 var invalidRequest = struct{}{}
 
-func (server *Server) serveCodec(cc codec.Codec) {
+func (server *Server) serveCodec(cc codec.Codec, opt *Option) {
 	sending := new(sync.Mutex) // make sure to send a complete response
 	wg := new(sync.WaitGroup)  // wait until all request are handled
 	for {
@@ -80,7 +85,7 @@ func (server *Server) serveCodec(cc codec.Codec) {
 			continue
 		}
 		wg.Add(1)
-		go server.handleRequest(cc, req, sending, wg)
+		go server.handleRequest(cc, req, sending, wg, opt.HandleTimeout)
 	}
 	wg.Wait()
 	_ = cc.Close()
@@ -108,7 +113,7 @@ func (server *Server) readRequestHeader(cc codec.Codec) (*codec.Header, error) {
 func (server *Server) findService(serviceMethod string) (svc *service, mtype *methodType, err error) {
 	dot := strings.LastIndex(serviceMethod, ".")
 	if dot < 0 {
-		err = errors.New("rpc server: service/Method request ill-formed: " + serviceMethod)
+		err = errors.New("rpc server: service/method request ill-formed: " + serviceMethod)
 		return
 	}
 	serviceName, methodName := serviceMethod[:dot], serviceMethod[dot+1:]
@@ -120,7 +125,7 @@ func (server *Server) findService(serviceMethod string) (svc *service, mtype *me
 	svc = svci.(*service)
 	mtype = svc.method[methodName]
 	if mtype == nil {
-		err = errors.New("rpc server: can't find Method " + methodName)
+		err = errors.New("rpc server: can't find method " + methodName)
 	}
 	return
 }
@@ -158,13 +163,35 @@ func (server *Server) sendResponse(cc codec.Codec, h *codec.Header, body interfa
 	}
 }
 
-func (server *Server) handleRequest(cc codec.Codec, req *request, sending *sync.Mutex, wg *sync.WaitGroup) {
+func (server *Server) handleRequest(cc codec.Codec, req *request, sending *sync.Mutex, wg *sync.WaitGroup, timeout time.Duration) {
 	defer wg.Done()
-	err := req.svc.call(req.mtype, req.argv, req.replyv)
-	if err != nil {
-		req.h.Error = err.Error()
+	called := make(chan struct{})
+	sent := make(chan struct{})
+	go func() {
+		err := req.svc.call(req.mtype, req.argv, req.replyv)
+		called <- struct{}{}
+		if err != nil {
+			req.h.Error = err.Error()
+			server.sendResponse(cc, req.h, invalidRequest, sending)
+			sent <- struct{}{}
+			return
+		}
+		server.sendResponse(cc, req.h, req.replyv.Interface(), sending)
+		sent <- struct{}{}
+	}()
+
+	if timeout == 0 {
+		<-called
+		<-sent
+		return
+	}
+	select {
+	case <-time.After(timeout):
+		req.h.Error = fmt.Sprintf("rpc server: request handle timeout: expect within %s", timeout)
+		server.sendResponse(cc, req.h, invalidRequest, sending)
+	case <-called:
+		<-sent
 	}
-	server.sendResponse(cc, req.h, req.replyv.Interface(), sending)
 }
 
 // Accept accepts connections on the listener and serves requests
@@ -186,7 +213,7 @@ func Accept(lis net.Listener) { DefaultServer.Accept(lis) }
 
 // Register publishes in the server the set of methods of the
 // receiver value that satisfy the following conditions:
-//	- exported Method of exported type
+//	- exported method of exported type
 //	- two arguments, both of exported type
 //	- the second argument is a pointer
 //	- one return value, of type error
diff --git a/gee-rpc/day5-http-debug/service.go b/gee-rpc/day5-http-debug/service.go
new file mode 100644
index 0000000..306683c
--- /dev/null
+++ b/gee-rpc/day5-http-debug/service.go
@@ -0,0 +1,99 @@
+package geerpc
+
+import (
+	"go/ast"
+	"log"
+	"reflect"
+	"sync/atomic"
+)
+
+type methodType struct {
+	method    reflect.Method
+	ArgType   reflect.Type
+	ReplyType reflect.Type
+	numCalls  uint64
+}
+
+func (m *methodType) NumCalls() uint64 {
+	return atomic.LoadUint64(&m.numCalls)
+}
+
+func (m *methodType) newArgv() reflect.Value {
+	var argv reflect.Value
+	// arg may be a pointer type, or a value type
+	if m.ArgType.Kind() == reflect.Ptr {
+		argv = reflect.New(m.ArgType.Elem())
+	} else {
+		argv = reflect.New(m.ArgType).Elem()
+	}
+	return argv
+}
+
+func (m *methodType) newReplyv() reflect.Value {
+	// reply must be a pointer type
+	replyv := reflect.New(m.ReplyType.Elem())
+	switch m.ReplyType.Elem().Kind() {
+	case reflect.Map:
+		replyv.Elem().Set(reflect.MakeMap(m.ReplyType.Elem()))
+	case reflect.Slice:
+		replyv.Elem().Set(reflect.MakeSlice(m.ReplyType.Elem(), 0, 0))
+	}
+	return replyv
+}
+
+type service struct {
+	name   string
+	typ    reflect.Type
+	rcvr   reflect.Value
+	method map[string]*methodType
+}
+
+func newService(rcvr interface{}) *service {
+	s := new(service)
+	s.rcvr = reflect.ValueOf(rcvr)
+	s.name = reflect.Indirect(s.rcvr).Type().Name()
+	s.typ = reflect.TypeOf(rcvr)
+	if !ast.IsExported(s.name) {
+		log.Fatalf("rpc server: %s is not a valid service name", s.name)
+	}
+	s.registerMethods()
+	return s
+}
+
+func (s *service) registerMethods() {
+	s.method = make(map[string]*methodType)
+	for i := 0; i < s.typ.NumMethod(); i++ {
+		method := s.typ.Method(i)
+		mType := method.Type
+		if mType.NumIn() != 3 || mType.NumOut() != 1 {
+			continue
+		}
+		if mType.Out(0) != reflect.TypeOf((*error)(nil)).Elem() {
+			continue
+		}
+		argType, replyType := mType.In(1), mType.In(2)
+		if !isExportedOrBuiltinType(argType) || !isExportedOrBuiltinType(replyType) {
+			continue
+		}
+		s.method[method.Name] = &methodType{
+			method:    method,
+			ArgType:   argType,
+			ReplyType: replyType,
+		}
+		log.Printf("rpc server: register %s.%s\n", s.name, method.Name)
+	}
+}
+
+func (s *service) call(m *methodType, argv, replyv reflect.Value) error {
+	atomic.AddUint64(&m.numCalls, 1)
+	f := m.method.Func
+	returnValues := f.Call([]reflect.Value{s.rcvr, argv, replyv})
+	if errInter := returnValues[0].Interface(); errInter != nil {
+		return errInter.(error)
+	}
+	return nil
+}
+
+func isExportedOrBuiltinType(t reflect.Type) bool {
+	return ast.IsExported(t.Name()) || t.PkgPath() == ""
+}
diff --git a/gee-rpc/day5-http-debug/service_test.go b/gee-rpc/day5-http-debug/service_test.go
new file mode 100644
index 0000000..c8266df
--- /dev/null
+++ b/gee-rpc/day5-http-debug/service_test.go
@@ -0,0 +1,48 @@
+package geerpc
+
+import (
+	"fmt"
+	"reflect"
+	"testing"
+)
+
+type Foo int
+
+type Args struct{ Num1, Num2 int }
+
+func (f Foo) Sum(args Args, reply *int) error {
+	*reply = args.Num1 + args.Num2
+	return nil
+}
+
+// it's not a exported Method
+func (f Foo) sum(args Args, reply *int) error {
+	*reply = args.Num1 + args.Num2
+	return nil
+}
+
+func _assert(condition bool, msg string, v ...interface{}) {
+	if !condition {
+		panic(fmt.Sprintf("assertion failed: "+msg, v...))
+	}
+}
+
+func TestNewService(t *testing.T) {
+	var foo Foo
+	s := newService(&foo)
+	_assert(len(s.method) == 1, "wrong service Method, expect 1, but got %d", len(s.method))
+	mType := s.method["Sum"]
+	_assert(mType != nil, "wrong Method, Sum shouldn't nil")
+}
+
+func TestMethodType_Call(t *testing.T) {
+	var foo Foo
+	s := newService(&foo)
+	mType := s.method["Sum"]
+
+	argv := mType.newArgv()
+	replyv := mType.newReplyv()
+	argv.Set(reflect.ValueOf(Args{Num1: 1, Num2: 3}))
+	err := s.call(mType, argv, replyv)
+	_assert(err == nil && *replyv.Interface().(*int) == 4 && mType.NumCalls() == 1, "failed to call Foo.Sum")
+}

From bc9eadfff653a36f35866a7083a5ce7355155edf Mon Sep 17 00:00:00 2001
From: gzdaijie <gzdaijie@gmail.com>
Date: Sun, 4 Oct 2020 10:08:04 +0800
Subject: [PATCH 081/122] gee-rpc day6 registry

---
 gee-rpc/day2-client/client.go               |  31 +-
 gee-rpc/day3-service/client.go              |  31 +-
 gee-rpc/day4-timeout/client.go              |  73 +++--
 gee-rpc/day4-timeout/client_test.go         |   6 +-
 gee-rpc/day5-http-debug/client.go           | 110 ++++---
 gee-rpc/day5-http-debug/client_test.go      |  27 +-
 gee-rpc/day5-http-debug/debug.go            |   2 +-
 gee-rpc/day5-http-debug/main/main.go        |  19 +-
 gee-rpc/day5-http-debug/server.go           |  11 +-
 gee-rpc/day6-discovery/client.go            | 324 ++++++++++++++++++++
 gee-rpc/day6-discovery/client_test.go       |  84 +++++
 gee-rpc/day6-discovery/codec/codec.go       |  34 ++
 gee-rpc/day6-discovery/codec/gob.go         |  57 ++++
 gee-rpc/day6-discovery/debug.go             |  60 ++++
 gee-rpc/day6-discovery/go.mod               |   3 +
 gee-rpc/day6-discovery/main/main.go         |  55 ++++
 gee-rpc/day6-discovery/server.go            | 266 ++++++++++++++++
 gee-rpc/day6-discovery/service.go           |  99 ++++++
 gee-rpc/day6-discovery/service_test.go      |  48 +++
 gee-rpc/day6-discovery/xclient/discovery.go |  57 ++++
 gee-rpc/day6-discovery/xclient/xclient.go   |  48 +++
 21 files changed, 1322 insertions(+), 123 deletions(-)
 create mode 100644 gee-rpc/day6-discovery/client.go
 create mode 100644 gee-rpc/day6-discovery/client_test.go
 create mode 100644 gee-rpc/day6-discovery/codec/codec.go
 create mode 100644 gee-rpc/day6-discovery/codec/gob.go
 create mode 100644 gee-rpc/day6-discovery/debug.go
 create mode 100644 gee-rpc/day6-discovery/go.mod
 create mode 100644 gee-rpc/day6-discovery/main/main.go
 create mode 100644 gee-rpc/day6-discovery/server.go
 create mode 100644 gee-rpc/day6-discovery/service.go
 create mode 100644 gee-rpc/day6-discovery/service_test.go
 create mode 100644 gee-rpc/day6-discovery/xclient/discovery.go
 create mode 100644 gee-rpc/day6-discovery/xclient/xclient.go

diff --git a/gee-rpc/day2-client/client.go b/gee-rpc/day2-client/client.go
index f9b09ee..3df6ec9 100644
--- a/gee-rpc/day2-client/client.go
+++ b/gee-rpc/day2-client/client.go
@@ -34,14 +34,15 @@ func (call *Call) done() {
 // with a single Client, and a Client may be used by
 // multiple goroutines simultaneously.
 type Client struct {
-	cc      codec.Codec
-	opt     *Option
-	sending sync.Mutex // protect following
-	header  codec.Header
-	mu      sync.Mutex // protect following
-	seq     uint64
-	pending map[uint64]*Call
-	closed  bool // user has called Close
+	cc       codec.Codec
+	opt      *Option
+	sending  sync.Mutex // protect following
+	header   codec.Header
+	mu       sync.Mutex // protect following
+	seq      uint64
+	pending  map[uint64]*Call
+	closing  bool // user has called Close
+	shutdown bool // server has told us to stop
 }
 
 var _ io.Closer = (*Client)(nil)
@@ -52,17 +53,24 @@ var ErrShutdown = errors.New("connection is shut down")
 func (client *Client) Close() error {
 	client.mu.Lock()
 	defer client.mu.Unlock()
-	if client.closed {
+	if client.closing {
 		return ErrShutdown
 	}
-	client.closed = true
+	client.closing = true
 	return client.cc.Close()
 }
 
+// IsAvailable return true if the client does work
+func (client *Client) IsAvailable() bool {
+	client.mu.Lock()
+	defer client.mu.Unlock()
+	return !client.shutdown && !client.closing
+}
+
 func (client *Client) registerCall(call *Call) (uint64, error) {
 	client.mu.Lock()
 	defer client.mu.Unlock()
-	if client.closed {
+	if client.closing || client.shutdown {
 		return 0, ErrShutdown
 	}
 	seq := client.seq
@@ -84,6 +92,7 @@ func (client *Client) terminateCalls(err error) {
 	defer client.sending.Unlock()
 	client.mu.Lock()
 	defer client.mu.Unlock()
+	client.shutdown = true
 	for _, call := range client.pending {
 		call.Error = err
 		call.done()
diff --git a/gee-rpc/day3-service/client.go b/gee-rpc/day3-service/client.go
index f9b09ee..3df6ec9 100644
--- a/gee-rpc/day3-service/client.go
+++ b/gee-rpc/day3-service/client.go
@@ -34,14 +34,15 @@ func (call *Call) done() {
 // with a single Client, and a Client may be used by
 // multiple goroutines simultaneously.
 type Client struct {
-	cc      codec.Codec
-	opt     *Option
-	sending sync.Mutex // protect following
-	header  codec.Header
-	mu      sync.Mutex // protect following
-	seq     uint64
-	pending map[uint64]*Call
-	closed  bool // user has called Close
+	cc       codec.Codec
+	opt      *Option
+	sending  sync.Mutex // protect following
+	header   codec.Header
+	mu       sync.Mutex // protect following
+	seq      uint64
+	pending  map[uint64]*Call
+	closing  bool // user has called Close
+	shutdown bool // server has told us to stop
 }
 
 var _ io.Closer = (*Client)(nil)
@@ -52,17 +53,24 @@ var ErrShutdown = errors.New("connection is shut down")
 func (client *Client) Close() error {
 	client.mu.Lock()
 	defer client.mu.Unlock()
-	if client.closed {
+	if client.closing {
 		return ErrShutdown
 	}
-	client.closed = true
+	client.closing = true
 	return client.cc.Close()
 }
 
+// IsAvailable return true if the client does work
+func (client *Client) IsAvailable() bool {
+	client.mu.Lock()
+	defer client.mu.Unlock()
+	return !client.shutdown && !client.closing
+}
+
 func (client *Client) registerCall(call *Call) (uint64, error) {
 	client.mu.Lock()
 	defer client.mu.Unlock()
-	if client.closed {
+	if client.closing || client.shutdown {
 		return 0, ErrShutdown
 	}
 	seq := client.seq
@@ -84,6 +92,7 @@ func (client *Client) terminateCalls(err error) {
 	defer client.sending.Unlock()
 	client.mu.Lock()
 	defer client.mu.Unlock()
+	client.shutdown = true
 	for _, call := range client.pending {
 		call.Error = err
 		call.done()
diff --git a/gee-rpc/day4-timeout/client.go b/gee-rpc/day4-timeout/client.go
index c9900fa..b301647 100644
--- a/gee-rpc/day4-timeout/client.go
+++ b/gee-rpc/day4-timeout/client.go
@@ -36,14 +36,15 @@ func (call *Call) done() {
 // with a single Client, and a Client may be used by
 // multiple goroutines simultaneously.
 type Client struct {
-	cc      codec.Codec
-	opt     *Option
-	sending sync.Mutex // protect following
-	header  codec.Header
-	mu      sync.Mutex // protect following
-	seq     uint64
-	pending map[uint64]*Call
-	closed  bool // user has called Close
+	cc       codec.Codec
+	opt      *Option
+	sending  sync.Mutex // protect following
+	header   codec.Header
+	mu       sync.Mutex // protect following
+	seq      uint64
+	pending  map[uint64]*Call
+	closing  bool // user has called Close
+	shutdown bool // server has told us to stop
 }
 
 var _ io.Closer = (*Client)(nil)
@@ -54,17 +55,24 @@ var ErrShutdown = errors.New("connection is shut down")
 func (client *Client) Close() error {
 	client.mu.Lock()
 	defer client.mu.Unlock()
-	if client.closed {
+	if client.closing {
 		return ErrShutdown
 	}
-	client.closed = true
+	client.closing = true
 	return client.cc.Close()
 }
 
+// IsAvailable return true if the client does work
+func (client *Client) IsAvailable() bool {
+	client.mu.Lock()
+	defer client.mu.Unlock()
+	return !client.shutdown && !client.closing
+}
+
 func (client *Client) registerCall(call *Call) (uint64, error) {
 	client.mu.Lock()
 	defer client.mu.Unlock()
-	if client.closed {
+	if client.closing || client.shutdown {
 		return 0, ErrShutdown
 	}
 	seq := client.seq
@@ -86,6 +94,7 @@ func (client *Client) terminateCalls(err error) {
 	defer client.sending.Unlock()
 	client.mu.Lock()
 	defer client.mu.Unlock()
+	client.shutdown = true
 	for _, call := range client.pending {
 		call.Error = err
 		call.done()
@@ -226,44 +235,44 @@ func newClientCodec(cc codec.Codec, opt *Option) *Client {
 	return client
 }
 
-func dial(network, address string, opt *Option) (*Client, error) {
-	conn, err := net.Dial(network, address)
-	if err != nil {
-		return nil, err
-	}
-	return NewClient(conn, opt)
-}
-
 type clientResult struct {
 	client *Client
 	err    error
 }
 
-func dialTimeout(f func() (client *Client, err error), timeout time.Duration) (*Client, error) {
-	if timeout == 0 {
-		return f()
+type dialFunc func(network, address string, opt *Option) (client *Client, err error)
+
+func dialTimeout(f dialFunc, network, address string, opts ...*Option) (*Client, error) {
+	opt, err := parseOptions(opts...)
+	if err != nil {
+		return nil, err
 	}
 	ch := make(chan clientResult)
 	go func() {
-		client, err := f()
+		client, err := f(network, address, opt)
 		ch <- clientResult{client: client, err: err}
 	}()
+	if opt.ConnectTimeout == 0 {
+		result := <-ch
+		return result.client, result.err
+	}
 	select {
-	case <-time.After(timeout):
-		return nil, fmt.Errorf("rpc client: dial timeout: expect within %s", timeout)
+	case <-time.After(opt.ConnectTimeout):
+		return nil, fmt.Errorf("rpc client: dial timeout: expect within %s", opt.ConnectTimeout)
 	case result := <-ch:
 		return result.client, result.err
 	}
 }
 
-// Dial connects to an RPC server at the specified network address
-func Dial(network, address string, opts ...*Option) (*Client, error) {
-	opt, err := parseOptions(opts...)
+func dial(network, address string, opt *Option) (*Client, error) {
+	conn, err := net.Dial(network, address)
 	if err != nil {
 		return nil, err
 	}
-	f := func() (client *Client, err error) {
-		return dial(network, address, opt)
-	}
-	return dialTimeout(f, opt.ConnectTimeout)
+	return NewClient(conn, opt)
+}
+
+// Dial connects to an RPC server at the specified network address
+func Dial(network, address string, opts ...*Option) (*Client, error) {
+	return dialTimeout(dial, network, address, opts...)
 }
diff --git a/gee-rpc/day4-timeout/client_test.go b/gee-rpc/day4-timeout/client_test.go
index 5669f9c..ab2fa64 100644
--- a/gee-rpc/day4-timeout/client_test.go
+++ b/gee-rpc/day4-timeout/client_test.go
@@ -26,16 +26,16 @@ func startServer(addr chan string) {
 
 func TestClient_dialTimeout(t *testing.T) {
 	t.Parallel()
-	f := func() (client *Client, err error) {
+	f := func(network, address string, opt *Option) (client *Client, err error) {
 		time.Sleep(time.Second * 2)
 		return nil, nil
 	}
 	t.Run("timeout", func(t *testing.T) {
-		_, err := dialTimeout(f, time.Second)
+		_, err := dialTimeout(f, "", "", &Option{ConnectTimeout: time.Second})
 		_assert(err != nil && strings.Contains(err.Error(), "dial timeout"), "expect a timeout error")
 	})
 	t.Run("0", func(t *testing.T) {
-		_, err := dialTimeout(f, 0)
+		_, err := dialTimeout(f, "", "", &Option{ConnectTimeout: 0})
 		_assert(err == nil, "0 means no limit")
 	})
 }
diff --git a/gee-rpc/day5-http-debug/client.go b/gee-rpc/day5-http-debug/client.go
index 5f336d7..e9b4540 100644
--- a/gee-rpc/day5-http-debug/client.go
+++ b/gee-rpc/day5-http-debug/client.go
@@ -15,6 +15,7 @@ import (
 	"log"
 	"net"
 	"net/http"
+	"strings"
 	"sync"
 	"time"
 )
@@ -38,14 +39,15 @@ func (call *Call) done() {
 // with a single Client, and a Client may be used by
 // multiple goroutines simultaneously.
 type Client struct {
-	cc      codec.Codec
-	opt     *Option
-	sending sync.Mutex // protect following
-	header  codec.Header
-	mu      sync.Mutex // protect following
-	seq     uint64
-	pending map[uint64]*Call
-	closed  bool // user has called Close
+	cc       codec.Codec
+	opt      *Option
+	sending  sync.Mutex // protect following
+	header   codec.Header
+	mu       sync.Mutex // protect following
+	seq      uint64
+	pending  map[uint64]*Call
+	closing  bool // user has called Close
+	shutdown bool // server has told us to stop
 }
 
 var _ io.Closer = (*Client)(nil)
@@ -56,17 +58,24 @@ var ErrShutdown = errors.New("connection is shut down")
 func (client *Client) Close() error {
 	client.mu.Lock()
 	defer client.mu.Unlock()
-	if client.closed {
+	if client.closing {
 		return ErrShutdown
 	}
-	client.closed = true
+	client.closing = true
 	return client.cc.Close()
 }
 
+// IsAvailable return true if the client does work
+func (client *Client) IsAvailable() bool {
+	client.mu.Lock()
+	defer client.mu.Unlock()
+	return !client.shutdown && !client.closing
+}
+
 func (client *Client) registerCall(call *Call) (uint64, error) {
 	client.mu.Lock()
 	defer client.mu.Unlock()
-	if client.closed {
+	if client.closing || client.shutdown {
 		return 0, ErrShutdown
 	}
 	seq := client.seq
@@ -88,6 +97,7 @@ func (client *Client) terminateCalls(err error) {
 	defer client.sending.Unlock()
 	client.mu.Lock()
 	defer client.mu.Unlock()
+	client.shutdown = true
 	for _, call := range client.pending {
 		call.Error = err
 		call.done()
@@ -228,54 +238,54 @@ func newClientCodec(cc codec.Codec, opt *Option) *Client {
 	return client
 }
 
-func dial(network, address string, opt *Option) (*Client, error) {
-	conn, err := net.Dial(network, address)
-	if err != nil {
-		return nil, err
-	}
-	return NewClient(conn, opt)
-}
-
 type clientResult struct {
 	client *Client
 	err    error
 }
 
-func dialTimeout(f func() (client *Client, err error), timeout time.Duration) (*Client, error) {
-	if timeout == 0 {
-		return f()
+type dialFunc func(network, address string, opt *Option) (client *Client, err error)
+
+func dialTimeout(f dialFunc, network, address string, opts ...*Option) (*Client, error) {
+	opt, err := parseOptions(opts...)
+	if err != nil {
+		return nil, err
 	}
 	ch := make(chan clientResult)
 	go func() {
-		client, err := f()
+		client, err := f(network, address, opt)
 		ch <- clientResult{client: client, err: err}
 	}()
+	if opt.ConnectTimeout == 0 {
+		result := <-ch
+		return result.client, result.err
+	}
 	select {
-	case <-time.After(timeout):
-		return nil, fmt.Errorf("rpc client: dial timeout: expect within %s", timeout)
+	case <-time.After(opt.ConnectTimeout):
+		return nil, fmt.Errorf("rpc client: dial timeout: expect within %s", opt.ConnectTimeout)
 	case result := <-ch:
 		return result.client, result.err
 	}
 }
 
-// Dial connects to an RPC server at the specified network address
-func Dial(network, address string, opts ...*Option) (*Client, error) {
-	opt, err := parseOptions(opts...)
+func dial(network, address string, opt *Option) (*Client, error) {
+	conn, err := net.Dial(network, address)
 	if err != nil {
 		return nil, err
 	}
-	f := func() (client *Client, err error) {
-		return dial(network, address, opt)
-	}
-	return dialTimeout(f, opt.ConnectTimeout)
+	return NewClient(conn, opt)
 }
 
-func dialHTTPPath(network, address, path string, opt *Option) (*Client, error) {
+// Dial connects to an RPC server at the specified network address
+func Dial(network, address string, opts ...*Option) (*Client, error) {
+	return dialTimeout(dial, network, address, opts...)
+}
+
+func dialHTTP(network, address string, opt *Option) (*Client, error) {
 	conn, err := net.Dial(network, address)
 	if err != nil {
 		return nil, err
 	}
-	_, _ = io.WriteString(conn, fmt.Sprintf("CONNECT %s HTTP/1.0\n\n", path))
+	_, _ = io.WriteString(conn, fmt.Sprintf("CONNECT %s HTTP/1.0\n\n", defaultRPCPath))
 
 	// Require successful HTTP response
 	// before switching to RPC protocol.
@@ -290,21 +300,25 @@ func dialHTTPPath(network, address, path string, opt *Option) (*Client, error) {
 	return nil, err
 }
 
-// DialHTTPPath connects to an HTTP RPC server
-// at the specified network address and path.
-func DialHTTPPath(network, address, path string, opts ...*Option) (*Client, error) {
-	opt, err := parseOptions(opts...)
-	if err != nil {
-		return nil, err
-	}
-	f := func() (*Client, error) {
-		return dialHTTPPath(network, address, path, opt)
-	}
-	return dialTimeout(f, opt.ConnectTimeout)
-}
-
 // DialHTTP connects to an HTTP RPC server at the specified network address
 // listening on the default HTTP RPC path.
 func DialHTTP(network, address string, opts ...*Option) (*Client, error) {
-	return DialHTTPPath(network, address, defaultRPCPath, opts...)
+	return dialTimeout(dialHTTP, network, address, opts...)
+}
+
+// XDial use a general format to represent a rpc server
+// eg, http@10.0.0.1:7001, tcp@10.0.0.1:9999, unix@/tmp/geerpc.sock
+func XDial(rpcAddr string, opts ...*Option) (*Client, error) {
+	parts := strings.Split(rpcAddr, "@")
+	if len(parts) != 2 {
+		return nil, fmt.Errorf("rpc client err: wrong format '%s', expect protocol@addr", rpcAddr)
+	}
+	protocol, addr := parts[0], parts[1]
+	switch protocol {
+	case "http":
+		return DialHTTP("tcp", addr, opts...)
+	default:
+		// tcp, unix or other transport protocol
+		return Dial(protocol, addr, opts...)
+	}
 }
diff --git a/gee-rpc/day5-http-debug/client_test.go b/gee-rpc/day5-http-debug/client_test.go
index 5669f9c..10b9817 100644
--- a/gee-rpc/day5-http-debug/client_test.go
+++ b/gee-rpc/day5-http-debug/client_test.go
@@ -3,6 +3,8 @@ package geerpc
 import (
 	"context"
 	"net"
+	"os"
+	"runtime"
 	"strings"
 	"testing"
 	"time"
@@ -26,16 +28,16 @@ func startServer(addr chan string) {
 
 func TestClient_dialTimeout(t *testing.T) {
 	t.Parallel()
-	f := func() (client *Client, err error) {
+	f := func(network, address string, opt *Option) (client *Client, err error) {
 		time.Sleep(time.Second * 2)
 		return nil, nil
 	}
 	t.Run("timeout", func(t *testing.T) {
-		_, err := dialTimeout(f, time.Second)
+		_, err := dialTimeout(f, "", "", &Option{ConnectTimeout: time.Second})
 		_assert(err != nil && strings.Contains(err.Error(), "dial timeout"), "expect a timeout error")
 	})
 	t.Run("0", func(t *testing.T) {
-		_, err := dialTimeout(f, 0)
+		_, err := dialTimeout(f, "", "", &Option{ConnectTimeout: 0})
 		_assert(err == nil, "0 means no limit")
 	})
 }
@@ -61,3 +63,22 @@ func TestClient_Call(t *testing.T) {
 		_assert(err != nil && strings.Contains(err.Error(), "handle timeout"), "expect a timeout error")
 	})
 }
+
+func TestXDial(t *testing.T) {
+	if runtime.GOOS == "linux" {
+		ch := make(chan struct{})
+		addr := "/tmp/geerpc.sock"
+		go func() {
+			_ = os.Remove(addr)
+			l, err := net.Listen("unix", addr)
+			if err != nil {
+				t.Fatal("failed to listen unix socket")
+			}
+			ch <- struct{}{}
+			Accept(l)
+		}()
+		<-ch
+		_, err := XDial("unix@" + addr)
+		_assert(err == nil, "failed to connect unix socket")
+	}
+}
diff --git a/gee-rpc/day5-http-debug/debug.go b/gee-rpc/day5-http-debug/debug.go
index d76de55..ece1ffd 100644
--- a/gee-rpc/day5-http-debug/debug.go
+++ b/gee-rpc/day5-http-debug/debug.go
@@ -41,7 +41,7 @@ type debugService struct {
 	Method map[string]*methodType
 }
 
-// Runs at /debug/rpc
+// Runs at /debug/geerpc
 func (server debugHTTP) ServeHTTP(w http.ResponseWriter, req *http.Request) {
 	// Build a sorted version of the data.
 	var services []debugService
diff --git a/gee-rpc/day5-http-debug/main/main.go b/gee-rpc/day5-http-debug/main/main.go
index f25d909..a71af74 100644
--- a/gee-rpc/day5-http-debug/main/main.go
+++ b/gee-rpc/day5-http-debug/main/main.go
@@ -4,9 +4,9 @@ import (
 	"context"
 	"geerpc"
 	"log"
+	"net"
 	"net/http"
 	"sync"
-	"time"
 )
 
 type Foo int
@@ -18,17 +18,17 @@ func (f Foo) Sum(args Args, reply *int) error {
 	return nil
 }
 
-func startServer(addr string) {
+func startServer(addrCh chan string) {
 	var foo Foo
+	l, _ := net.Listen("tcp", ":9999")
 	_ = geerpc.Register(&foo)
 	geerpc.HandleHTTP()
-	log.Fatal(http.ListenAndServe(addr, nil))
+	addrCh <- l.Addr().String()
+	_ = http.Serve(l, nil)
 }
 
-func call() {
-	// start server may cost some time
-	time.Sleep(time.Second)
-	client, _ := geerpc.DialHTTP("tcp", ":9999")
+func call(addrCh chan string) {
+	client, _ := geerpc.DialHTTP("tcp", <-addrCh)
 	defer func() { _ = client.Close() }()
 
 	// send request & receive response
@@ -49,6 +49,7 @@ func call() {
 }
 
 func main() {
-	go call()
-	startServer(":9999")
+	ch := make(chan string)
+	go call(ch)
+	startServer(ch)
 }
diff --git a/gee-rpc/day5-http-debug/server.go b/gee-rpc/day5-http-debug/server.go
index 5be1c66..38fad20 100644
--- a/gee-rpc/day5-http-debug/server.go
+++ b/gee-rpc/day5-http-debug/server.go
@@ -254,12 +254,13 @@ func (server *Server) ServeHTTP(w http.ResponseWriter, req *http.Request) {
 // HandleHTTP registers an HTTP handler for RPC messages on rpcPath,
 // and a debugging handler on debugPath.
 // It is still necessary to invoke http.Serve(), typically in a go statement.
-func (server *Server) HandleHTTP(rpcPath, debugPath string) {
-	http.Handle(rpcPath, server)
-	http.Handle(debugPath, debugHTTP{server})
-	log.Println("rpc server debug path:", debugPath)
+func (server *Server) HandleHTTP() {
+	http.Handle(defaultRPCPath, server)
+	http.Handle(defaultDebugPath, debugHTTP{server})
+	log.Println("rpc server debug path:", defaultDebugPath)
 }
 
+// HandleHTTP is a convenient approach for default server to register HTTP handlers
 func HandleHTTP() {
-	DefaultServer.HandleHTTP(defaultRPCPath, defaultDebugPath)
+	DefaultServer.HandleHTTP()
 }
diff --git a/gee-rpc/day6-discovery/client.go b/gee-rpc/day6-discovery/client.go
new file mode 100644
index 0000000..d958696
--- /dev/null
+++ b/gee-rpc/day6-discovery/client.go
@@ -0,0 +1,324 @@
+// Copyright 2009 The Go Authors. All rights reserved.
+// Use of this source code is governed by a BSD-style
+// license that can be found in the LICENSE file.
+
+package geerpc
+
+import (
+	"bufio"
+	"context"
+	"encoding/json"
+	"errors"
+	"fmt"
+	"geerpc/codec"
+	"io"
+	"log"
+	"net"
+	"net/http"
+	"strings"
+	"sync"
+	"time"
+)
+
+// Call represents an active RPC.
+type Call struct {
+	Seq           uint64
+	ServiceMethod string      // format "<service>.<method>"
+	Args          interface{} // arguments to the function
+	Reply         interface{} // reply from the function
+	Error         error       // if error occurs, it will be set
+	Done          chan *Call  // Strobes when call is complete.
+}
+
+func (call *Call) done() {
+	call.Done <- call
+}
+
+// Client represents an RPC Client.
+// There may be multiple outstanding Calls associated
+// with a single Client, and a Client may be used by
+// multiple goroutines simultaneously.
+type Client struct {
+	cc       codec.Codec
+	opt      *Option
+	sending  sync.Mutex // protect following
+	header   codec.Header
+	mu       sync.Mutex // protect following
+	seq      uint64
+	pending  map[uint64]*Call
+	closing  bool // user has called Close
+	shutdown bool // server has told us to stop
+}
+
+var _ io.Closer = (*Client)(nil)
+
+var ErrShutdown = errors.New("connection is shut down")
+
+// Close the connection
+func (client *Client) Close() error {
+	client.mu.Lock()
+	defer client.mu.Unlock()
+	if client.closing {
+		return ErrShutdown
+	}
+	client.closing = true
+	return client.cc.Close()
+}
+
+// IsAvailable return true if the client does work
+func (client *Client) IsAvailable() bool {
+	client.mu.Lock()
+	defer client.mu.Unlock()
+	return !client.shutdown && !client.closing
+}
+
+func (client *Client) registerCall(call *Call) (uint64, error) {
+	client.mu.Lock()
+	defer client.mu.Unlock()
+	if client.closing || client.shutdown {
+		return 0, ErrShutdown
+	}
+	seq := client.seq
+	client.pending[seq] = call
+	client.seq++
+	return seq, nil
+}
+
+func (client *Client) removeCall(seq uint64) *Call {
+	client.mu.Lock()
+	defer client.mu.Unlock()
+	call := client.pending[seq]
+	delete(client.pending, seq)
+	return call
+}
+
+func (client *Client) terminateCalls(err error) {
+	client.sending.Lock()
+	defer client.sending.Unlock()
+	client.mu.Lock()
+	defer client.mu.Unlock()
+	client.shutdown = true
+	for _, call := range client.pending {
+		call.Error = err
+		call.done()
+	}
+}
+
+func (client *Client) send(call *Call) {
+	// make sure that the client will send a complete request
+	client.sending.Lock()
+	defer client.sending.Unlock()
+
+	// register this call.
+	seq, err := client.registerCall(call)
+	call.Seq = seq
+	if err != nil {
+		call.Error = err
+		call.done()
+		return
+	}
+
+	// prepare request header
+	client.header.ServiceMethod = call.ServiceMethod
+	client.header.Seq = seq
+	client.header.Error = ""
+
+	// encode and send the request
+	if err := client.cc.Write(&client.header, call.Args); err != nil {
+		call := client.removeCall(seq)
+		// call may be nil, it usually means that Write partially failed,
+		// client has received the response and handled
+		if call != nil {
+			call.Error = err
+			call.done()
+		}
+	}
+}
+
+func (client *Client) receive() {
+	var err error
+	for err == nil {
+		var h codec.Header
+		if err = client.cc.ReadHeader(&h); err != nil {
+			break
+		}
+		call := client.removeCall(h.Seq)
+		switch {
+		case call == nil:
+			// it usually means that Write partially failed
+			// and call was already removed.
+			err = client.cc.ReadBody(nil)
+		case h.Error != "":
+			call.Error = fmt.Errorf(h.Error)
+			err = client.cc.ReadBody(nil)
+			call.done()
+		default:
+			err = client.cc.ReadBody(call.Reply)
+			if err != nil {
+				call.Error = errors.New("reading body " + err.Error())
+			}
+			call.done()
+		}
+	}
+	// error occurs, so terminateCalls pending calls
+	client.terminateCalls(err)
+}
+
+// Go invokes the function asynchronously.
+// It returns the Call structure representing the invocation.
+func (client *Client) Go(serviceMethod string, args, reply interface{}, done chan *Call) *Call {
+	if done == nil {
+		done = make(chan *Call, 10)
+	} else if cap(done) == 0 {
+		log.Panic("rpc client: done channel is unbuffered")
+	}
+	call := &Call{
+		ServiceMethod: serviceMethod,
+		Args:          args,
+		Reply:         reply,
+		Done:          done,
+	}
+	client.send(call)
+	return call
+}
+
+// Call invokes the named function, waits for it to complete,
+// and returns its error status.
+func (client *Client) Call(ctx context.Context, serviceMethod string, args, reply interface{}) error {
+	call := client.Go(serviceMethod, args, reply, make(chan *Call, 1))
+	select {
+	case <-ctx.Done():
+		client.removeCall(call.Seq)
+		return errors.New("rpc client: call failed: " + ctx.Err().Error())
+	case call := <-call.Done:
+		return call.Error
+	}
+}
+
+func parseOptions(opts ...*Option) (*Option, error) {
+	// if opts is nil or pass nil as parameter
+	if len(opts) == 0 || opts[0] == nil {
+		return DefaultOption, nil
+	}
+	if len(opts) != 1 {
+		return nil, errors.New("number of options is more than 1")
+	}
+	opt := opts[0]
+	opt.MagicNumber = DefaultOption.MagicNumber
+	if opt.CodecType == "" {
+		opt.CodecType = DefaultOption.CodecType
+	}
+	return opt, nil
+}
+
+func NewClient(conn net.Conn, opt *Option) (*Client, error) {
+	f := codec.NewCodecFuncMap[opt.CodecType]
+	if f == nil {
+		err := fmt.Errorf("invalid codec type %s", opt.CodecType)
+		log.Println("rpc client: codec error:", err)
+		return nil, err
+	}
+	// send options with server
+	if err := json.NewEncoder(conn).Encode(opt); err != nil {
+		log.Println("rpc client: options error: ", err)
+		_ = conn.Close()
+		return nil, err
+	}
+	return newClientCodec(f(conn), opt), nil
+}
+
+func newClientCodec(cc codec.Codec, opt *Option) *Client {
+	client := &Client{
+		seq:     1, // seq starts with 1, 0 means invalid call
+		cc:      cc,
+		opt:     opt,
+		pending: make(map[uint64]*Call),
+	}
+	go client.receive()
+	return client
+}
+
+type clientResult struct {
+	client *Client
+	err    error
+}
+
+type dialFunc func(network, address string, opt *Option) (client *Client, err error)
+
+func dialTimeout(f dialFunc, network, address string, opts ...*Option) (*Client, error) {
+	opt, err := parseOptions(opts...)
+	if err != nil {
+		return nil, err
+	}
+	ch := make(chan clientResult)
+	go func() {
+		client, err := f(network, address, opt)
+		ch <- clientResult{client: client, err: err}
+	}()
+	if opt.ConnectTimeout == 0 {
+		result := <-ch
+		return result.client, result.err
+	}
+	select {
+	case <-time.After(opt.ConnectTimeout):
+		return nil, fmt.Errorf("rpc client: dial timeout: expect within %s", opt.ConnectTimeout)
+	case result := <-ch:
+		return result.client, result.err
+	}
+}
+
+func dial(network, address string, opt *Option) (*Client, error) {
+	conn, err := net.Dial(network, address)
+	if err != nil {
+		return nil, err
+	}
+	return NewClient(conn, opt)
+}
+
+// Dial connects to an RPC server at the specified network address
+func Dial(network, address string, opts ...*Option) (*Client, error) {
+	return dialTimeout(dial, network, address, opts...)
+}
+
+func dialHTTP(network, address string, opt *Option) (*Client, error) {
+	conn, err := net.Dial(network, address)
+	if err != nil {
+		return nil, err
+	}
+	_, _ = io.WriteString(conn, fmt.Sprintf("CONNECT %s HTTP/1.0\n\n", defaultRPCPath))
+
+	// Require successful HTTP response
+	// before switching to RPC protocol.
+	resp, err := http.ReadResponse(bufio.NewReader(conn), &http.Request{Method: "CONNECT"})
+	if err == nil && resp.Status == connected {
+		return NewClient(conn, opt)
+	}
+	if err == nil {
+		err = errors.New("unexpected HTTP response: " + resp.Status)
+	}
+	_ = conn.Close()
+	return nil, err
+}
+
+// DialHTTP connects to an HTTP RPC server at the specified network address
+// listening on the default HTTP RPC path.
+func DialHTTP(network, address string, opts ...*Option) (*Client, error) {
+	return dialTimeout(dialHTTP, network, address, opts...)
+}
+
+// XDial use a general format to represent a rpc server
+// eg, http@10.0.0.1:7001, tcp@10.0.0.1:9999, unix@/tmp/geerpc.sock
+func XDial(rpcAddr string, opts ...*Option) (*Client, error) {
+	parts := strings.Split(rpcAddr, "@")
+	if len(parts) != 2 {
+		return nil, fmt.Errorf("rpc client err: wrong format '%s', expect protocol@addr", rpcAddr)
+	}
+	protocol, addr := parts[0], parts[1]
+	switch protocol {
+	case "http":
+		return DialHTTP("tcp", addr)
+	default:
+		// tcp, unix or other transport protocol
+		return Dial(protocol, addr)
+	}
+}
diff --git a/gee-rpc/day6-discovery/client_test.go b/gee-rpc/day6-discovery/client_test.go
new file mode 100644
index 0000000..10b9817
--- /dev/null
+++ b/gee-rpc/day6-discovery/client_test.go
@@ -0,0 +1,84 @@
+package geerpc
+
+import (
+	"context"
+	"net"
+	"os"
+	"runtime"
+	"strings"
+	"testing"
+	"time"
+)
+
+type Bar int
+
+func (b Bar) Timeout(argv int, reply *int) error {
+	time.Sleep(time.Second * 2)
+	return nil
+}
+
+func startServer(addr chan string) {
+	var b Bar
+	_ = Register(&b)
+	// pick a free port
+	l, _ := net.Listen("tcp", ":0")
+	addr <- l.Addr().String()
+	Accept(l)
+}
+
+func TestClient_dialTimeout(t *testing.T) {
+	t.Parallel()
+	f := func(network, address string, opt *Option) (client *Client, err error) {
+		time.Sleep(time.Second * 2)
+		return nil, nil
+	}
+	t.Run("timeout", func(t *testing.T) {
+		_, err := dialTimeout(f, "", "", &Option{ConnectTimeout: time.Second})
+		_assert(err != nil && strings.Contains(err.Error(), "dial timeout"), "expect a timeout error")
+	})
+	t.Run("0", func(t *testing.T) {
+		_, err := dialTimeout(f, "", "", &Option{ConnectTimeout: 0})
+		_assert(err == nil, "0 means no limit")
+	})
+}
+
+func TestClient_Call(t *testing.T) {
+	t.Parallel()
+	addrCh := make(chan string)
+	go startServer(addrCh)
+	addr := <-addrCh
+	t.Run("client timeout", func(t *testing.T) {
+		client, _ := Dial("tcp", addr)
+		ctx, _ := context.WithTimeout(context.Background(), time.Second)
+		var reply int
+		err := client.Call(ctx, "Bar.Timeout", 1, &reply)
+		_assert(err != nil && strings.Contains(err.Error(), ctx.Err().Error()), "expect a timeout error")
+	})
+	t.Run("server handle timeout", func(t *testing.T) {
+		client, _ := Dial("tcp", addr, &Option{
+			HandleTimeout: time.Second,
+		})
+		var reply int
+		err := client.Call(context.Background(), "Bar.Timeout", 1, &reply)
+		_assert(err != nil && strings.Contains(err.Error(), "handle timeout"), "expect a timeout error")
+	})
+}
+
+func TestXDial(t *testing.T) {
+	if runtime.GOOS == "linux" {
+		ch := make(chan struct{})
+		addr := "/tmp/geerpc.sock"
+		go func() {
+			_ = os.Remove(addr)
+			l, err := net.Listen("unix", addr)
+			if err != nil {
+				t.Fatal("failed to listen unix socket")
+			}
+			ch <- struct{}{}
+			Accept(l)
+		}()
+		<-ch
+		_, err := XDial("unix@" + addr)
+		_assert(err == nil, "failed to connect unix socket")
+	}
+}
diff --git a/gee-rpc/day6-discovery/codec/codec.go b/gee-rpc/day6-discovery/codec/codec.go
new file mode 100644
index 0000000..ba28fba
--- /dev/null
+++ b/gee-rpc/day6-discovery/codec/codec.go
@@ -0,0 +1,34 @@
+package codec
+
+import (
+	"io"
+)
+
+type Header struct {
+	ServiceMethod string // format "Service.Method"
+	Seq           uint64 // sequence number chosen by client
+	Error         string
+}
+
+type Codec interface {
+	io.Closer
+	ReadHeader(*Header) error
+	ReadBody(interface{}) error
+	Write(*Header, interface{}) error
+}
+
+type NewCodecFunc func(io.ReadWriteCloser) Codec
+
+type Type string
+
+const (
+	GobType  Type = "application/gob"
+	JsonType Type = "application/json"
+)
+
+var NewCodecFuncMap map[Type]NewCodecFunc
+
+func init() {
+	NewCodecFuncMap = make(map[Type]NewCodecFunc)
+	NewCodecFuncMap[GobType] = NewGobCodec
+}
diff --git a/gee-rpc/day6-discovery/codec/gob.go b/gee-rpc/day6-discovery/codec/gob.go
new file mode 100644
index 0000000..808d97b
--- /dev/null
+++ b/gee-rpc/day6-discovery/codec/gob.go
@@ -0,0 +1,57 @@
+package codec
+
+import (
+	"bufio"
+	"encoding/gob"
+	"io"
+	"log"
+)
+
+type GobCodec struct {
+	conn io.ReadWriteCloser
+	buf  *bufio.Writer
+	dec  *gob.Decoder
+	enc  *gob.Encoder
+}
+
+var _ Codec = (*GobCodec)(nil)
+
+func NewGobCodec(conn io.ReadWriteCloser) Codec {
+	buf := bufio.NewWriter(conn)
+	return &GobCodec{
+		conn: conn,
+		buf:  buf,
+		dec:  gob.NewDecoder(conn),
+		enc:  gob.NewEncoder(buf),
+	}
+}
+
+func (c *GobCodec) ReadHeader(h *Header) error {
+	return c.dec.Decode(h)
+}
+
+func (c *GobCodec) ReadBody(body interface{}) error {
+	return c.dec.Decode(body)
+}
+
+func (c *GobCodec) Write(h *Header, body interface{}) (err error) {
+	defer func() {
+		_ = c.buf.Flush()
+		if err != nil {
+			_ = c.Close()
+		}
+	}()
+	if err := c.enc.Encode(h); err != nil {
+		log.Println("rpc: gob error encoding header:", err)
+		return err
+	}
+	if err := c.enc.Encode(body); err != nil {
+		log.Println("rpc: gob error encoding body:", err)
+		return err
+	}
+	return nil
+}
+
+func (c *GobCodec) Close() error {
+	return c.conn.Close()
+}
diff --git a/gee-rpc/day6-discovery/debug.go b/gee-rpc/day6-discovery/debug.go
new file mode 100644
index 0000000..ece1ffd
--- /dev/null
+++ b/gee-rpc/day6-discovery/debug.go
@@ -0,0 +1,60 @@
+// Copyright 2009 The Go Authors. All rights reserved.
+// Use of this source code is governed by a BSD-style
+// license that can be found in the LICENSE file.
+
+package geerpc
+
+import (
+	"fmt"
+	"html/template"
+	"net/http"
+)
+
+const debugText = `<html>
+	<body>
+	<title>GeeRPC Services</title>
+	{{range .}}
+	<hr>
+	Service {{.Name}}
+	<hr>
+		<table>
+		<th align=center>Method</th><th align=center>Calls</th>
+		{{range $name, $mtype := .Method}}
+			<tr>
+			<td align=left font=fixed>{{$name}}({{$mtype.ArgType}}, {{$mtype.ReplyType}}) error</td>
+			<td align=center>{{$mtype.NumCalls}}</td>
+			</tr>
+		{{end}}
+		</table>
+	{{end}}
+	</body>
+	</html>`
+
+var debug = template.Must(template.New("RPC debug").Parse(debugText))
+
+type debugHTTP struct {
+	*Server
+}
+
+type debugService struct {
+	Name   string
+	Method map[string]*methodType
+}
+
+// Runs at /debug/geerpc
+func (server debugHTTP) ServeHTTP(w http.ResponseWriter, req *http.Request) {
+	// Build a sorted version of the data.
+	var services []debugService
+	server.serviceMap.Range(func(namei, svci interface{}) bool {
+		svc := svci.(*service)
+		services = append(services, debugService{
+			Name:   namei.(string),
+			Method: svc.method,
+		})
+		return true
+	})
+	err := debug.Execute(w, services)
+	if err != nil {
+		_, _ = fmt.Fprintln(w, "rpc: error executing template:", err.Error())
+	}
+}
diff --git a/gee-rpc/day6-discovery/go.mod b/gee-rpc/day6-discovery/go.mod
new file mode 100644
index 0000000..0ec8aeb
--- /dev/null
+++ b/gee-rpc/day6-discovery/go.mod
@@ -0,0 +1,3 @@
+module geerpc
+
+go 1.13
diff --git a/gee-rpc/day6-discovery/main/main.go b/gee-rpc/day6-discovery/main/main.go
new file mode 100644
index 0000000..a71af74
--- /dev/null
+++ b/gee-rpc/day6-discovery/main/main.go
@@ -0,0 +1,55 @@
+package main
+
+import (
+	"context"
+	"geerpc"
+	"log"
+	"net"
+	"net/http"
+	"sync"
+)
+
+type Foo int
+
+type Args struct{ Num1, Num2 int }
+
+func (f Foo) Sum(args Args, reply *int) error {
+	*reply = args.Num1 + args.Num2
+	return nil
+}
+
+func startServer(addrCh chan string) {
+	var foo Foo
+	l, _ := net.Listen("tcp", ":9999")
+	_ = geerpc.Register(&foo)
+	geerpc.HandleHTTP()
+	addrCh <- l.Addr().String()
+	_ = http.Serve(l, nil)
+}
+
+func call(addrCh chan string) {
+	client, _ := geerpc.DialHTTP("tcp", <-addrCh)
+	defer func() { _ = client.Close() }()
+
+	// send request & receive response
+	var wg sync.WaitGroup
+	for i := 0; i < 5; i++ {
+		wg.Add(1)
+		go func(i int) {
+			defer wg.Done()
+			args := &Args{Num1: i, Num2: i * i}
+			var reply int
+			if err := client.Call(context.Background(), "Foo.Sum", args, &reply); err != nil {
+				log.Fatal("call Foo.Sum error:", err)
+			}
+			log.Printf("%d + %d = %d", args.Num1, args.Num2, reply)
+		}(i)
+	}
+	wg.Wait()
+}
+
+func main() {
+	ch := make(chan string)
+	go call(ch)
+	startServer(ch)
+}
diff --git a/gee-rpc/day6-discovery/server.go b/gee-rpc/day6-discovery/server.go
new file mode 100644
index 0000000..38fad20
--- /dev/null
+++ b/gee-rpc/day6-discovery/server.go
@@ -0,0 +1,266 @@
+// Copyright 2009 The Go Authors. All rights reserved.
+// Use of this source code is governed by a BSD-style
+// license that can be found in the LICENSE file.
+
+package geerpc
+
+import (
+	"encoding/json"
+	"errors"
+	"fmt"
+	"geerpc/codec"
+	"io"
+	"log"
+	"net"
+	"net/http"
+	"reflect"
+	"strings"
+	"sync"
+	"time"
+)
+
+const MagicNumber = 0x3bef5c
+
+type Option struct {
+	MagicNumber    int           // MagicNumber marks this's a geerpc request
+	CodecType      codec.Type    // client may choose different Codec to encode body
+	ConnectTimeout time.Duration // 0 means no limit
+	HandleTimeout  time.Duration
+}
+
+var DefaultOption = &Option{
+	MagicNumber:    MagicNumber,
+	CodecType:      codec.GobType,
+	ConnectTimeout: time.Second * 10,
+}
+
+// Server represents an RPC Server.
+type Server struct {
+	serviceMap sync.Map
+}
+
+// NewServer returns a new Server.
+func NewServer() *Server {
+	return &Server{}
+}
+
+// DefaultServer is the default instance of *Server.
+var DefaultServer = NewServer()
+
+// ServeConn runs the server on a single connection.
+// ServeConn blocks, serving the connection until the client hangs up.
+func (server *Server) ServeConn(conn io.ReadWriteCloser) {
+	defer func() { _ = conn.Close() }()
+	var opt Option
+	if err := json.NewDecoder(conn).Decode(&opt); err != nil {
+		log.Println("rpc server: options error: ", err)
+		return
+	}
+	if opt.MagicNumber != MagicNumber {
+		log.Printf("rpc server: invalid magic number %x", opt.MagicNumber)
+		return
+	}
+	f := codec.NewCodecFuncMap[opt.CodecType]
+	if f == nil {
+		log.Printf("rpc server: invalid codec type %s", opt.CodecType)
+		return
+	}
+	server.serveCodec(f(conn), &opt)
+}
+
+// invalidRequest is a placeholder for response argv when error occurs
+var invalidRequest = struct{}{}
+
+func (server *Server) serveCodec(cc codec.Codec, opt *Option) {
+	sending := new(sync.Mutex) // make sure to send a complete response
+	wg := new(sync.WaitGroup)  // wait until all request are handled
+	for {
+		req, err := server.readRequest(cc)
+		if err != nil {
+			if req == nil {
+				break // it's not possible to recover, so close the connection
+			}
+			req.h.Error = err.Error()
+			server.sendResponse(cc, req.h, invalidRequest, sending)
+			continue
+		}
+		wg.Add(1)
+		go server.handleRequest(cc, req, sending, wg, opt.HandleTimeout)
+	}
+	wg.Wait()
+	_ = cc.Close()
+}
+
+// request stores all information of a call
+type request struct {
+	h            *codec.Header // header of request
+	argv, replyv reflect.Value // argv and replyv of request
+	mtype        *methodType
+	svc          *service
+}
+
+func (server *Server) readRequestHeader(cc codec.Codec) (*codec.Header, error) {
+	var h codec.Header
+	if err := cc.ReadHeader(&h); err != nil {
+		if err != io.EOF && err != io.ErrUnexpectedEOF {
+			log.Println("rpc server: read header error:", err)
+		}
+		return nil, err
+	}
+	return &h, nil
+}
+
+func (server *Server) findService(serviceMethod string) (svc *service, mtype *methodType, err error) {
+	dot := strings.LastIndex(serviceMethod, ".")
+	if dot < 0 {
+		err = errors.New("rpc server: service/method request ill-formed: " + serviceMethod)
+		return
+	}
+	serviceName, methodName := serviceMethod[:dot], serviceMethod[dot+1:]
+	svci, ok := server.serviceMap.Load(serviceName)
+	if !ok {
+		err = errors.New("rpc server: can't find service " + serviceName)
+		return
+	}
+	svc = svci.(*service)
+	mtype = svc.method[methodName]
+	if mtype == nil {
+		err = errors.New("rpc server: can't find method " + methodName)
+	}
+	return
+}
+
+func (server *Server) readRequest(cc codec.Codec) (*request, error) {
+	h, err := server.readRequestHeader(cc)
+	if err != nil {
+		return nil, err
+	}
+	req := &request{h: h}
+	req.svc, req.mtype, err = server.findService(h.ServiceMethod)
+	if err != nil {
+		return req, err
+	}
+	req.argv = req.mtype.newArgv()
+	req.replyv = req.mtype.newReplyv()
+
+	// make sure that argvi is a pointer, ReadBody need a pointer as parameter
+	argvi := req.argv.Interface()
+	if req.argv.Type().Kind() != reflect.Ptr {
+		argvi = req.argv.Addr().Interface()
+	}
+	if err = cc.ReadBody(argvi); err != nil {
+		log.Println("rpc server: read body err:", err)
+		return req, err
+	}
+	return req, nil
+}
+
+func (server *Server) sendResponse(cc codec.Codec, h *codec.Header, body interface{}, sending *sync.Mutex) {
+	sending.Lock()
+	defer sending.Unlock()
+	if err := cc.Write(h, body); err != nil {
+		log.Println("rpc server: write response error:", err)
+	}
+}
+
+func (server *Server) handleRequest(cc codec.Codec, req *request, sending *sync.Mutex, wg *sync.WaitGroup, timeout time.Duration) {
+	defer wg.Done()
+	called := make(chan struct{})
+	sent := make(chan struct{})
+	go func() {
+		err := req.svc.call(req.mtype, req.argv, req.replyv)
+		called <- struct{}{}
+		if err != nil {
+			req.h.Error = err.Error()
+			server.sendResponse(cc, req.h, invalidRequest, sending)
+			sent <- struct{}{}
+			return
+		}
+		server.sendResponse(cc, req.h, req.replyv.Interface(), sending)
+		sent <- struct{}{}
+	}()
+
+	if timeout == 0 {
+		<-called
+		<-sent
+		return
+	}
+	select {
+	case <-time.After(timeout):
+		req.h.Error = fmt.Sprintf("rpc server: request handle timeout: expect within %s", timeout)
+		server.sendResponse(cc, req.h, invalidRequest, sending)
+	case <-called:
+		<-sent
+	}
+}
+
+// Accept accepts connections on the listener and serves requests
+// for each incoming connection.
+func (server *Server) Accept(lis net.Listener) {
+	for {
+		conn, err := lis.Accept()
+		if err != nil {
+			log.Println("rpc server: accept error:", err)
+			return
+		}
+		go server.ServeConn(conn)
+	}
+}
+
+// Accept accepts connections on the listener and serves requests
+// for each incoming connection.
+func Accept(lis net.Listener) { DefaultServer.Accept(lis) }
+
+// Register publishes in the server the set of methods of the
+// receiver value that satisfy the following conditions:
+//	- exported method of exported type
+//	- two arguments, both of exported type
+//	- the second argument is a pointer
+//	- one return value, of type error
+func (server *Server) Register(rcvr interface{}) error {
+	s := newService(rcvr)
+	if _, dup := server.serviceMap.LoadOrStore(s.name, s); dup {
+		return errors.New("rpc: service already defined: " + s.name)
+	}
+	return nil
+}
+
+// Register publishes the receiver's methods in the DefaultServer.
+func Register(rcvr interface{}) error { return DefaultServer.Register(rcvr) }
+
+const (
+	connected        = "200 Connected to Gee RPC"
+	defaultRPCPath   = "/_geeprc_"
+	defaultDebugPath = "/debug/geerpc"
+)
+
+// ServeHTTP implements an http.Handler that answers RPC requests.
+func (server *Server) ServeHTTP(w http.ResponseWriter, req *http.Request) {
+	if req.Method != "CONNECT" {
+		w.Header().Set("Content-Type", "text/plain; charset=utf-8")
+		w.WriteHeader(http.StatusMethodNotAllowed)
+		_, _ = io.WriteString(w, "405 must CONNECT\n")
+		return
+	}
+	conn, _, err := w.(http.Hijacker).Hijack()
+	if err != nil {
+		log.Print("rpc hijacking ", req.RemoteAddr, ": ", err.Error())
+		return
+	}
+	_, _ = io.WriteString(conn, "HTTP/1.0 "+connected+"\n\n")
+	server.ServeConn(conn)
+}
+
+// HandleHTTP registers an HTTP handler for RPC messages on rpcPath,
+// and a debugging handler on debugPath.
+// It is still necessary to invoke http.Serve(), typically in a go statement.
+func (server *Server) HandleHTTP() {
+	http.Handle(defaultRPCPath, server)
+	http.Handle(defaultDebugPath, debugHTTP{server})
+	log.Println("rpc server debug path:", defaultDebugPath)
+}
+
+// HandleHTTP is a convenient approach for default server to register HTTP handlers
+func HandleHTTP() {
+	DefaultServer.HandleHTTP()
+}
diff --git a/gee-rpc/day6-discovery/service.go b/gee-rpc/day6-discovery/service.go
new file mode 100644
index 0000000..306683c
--- /dev/null
+++ b/gee-rpc/day6-discovery/service.go
@@ -0,0 +1,99 @@
+package geerpc
+
+import (
+	"go/ast"
+	"log"
+	"reflect"
+	"sync/atomic"
+)
+
+type methodType struct {
+	method    reflect.Method
+	ArgType   reflect.Type
+	ReplyType reflect.Type
+	numCalls  uint64
+}
+
+func (m *methodType) NumCalls() uint64 {
+	return atomic.LoadUint64(&m.numCalls)
+}
+
+func (m *methodType) newArgv() reflect.Value {
+	var argv reflect.Value
+	// arg may be a pointer type, or a value type
+	if m.ArgType.Kind() == reflect.Ptr {
+		argv = reflect.New(m.ArgType.Elem())
+	} else {
+		argv = reflect.New(m.ArgType).Elem()
+	}
+	return argv
+}
+
+func (m *methodType) newReplyv() reflect.Value {
+	// reply must be a pointer type
+	replyv := reflect.New(m.ReplyType.Elem())
+	switch m.ReplyType.Elem().Kind() {
+	case reflect.Map:
+		replyv.Elem().Set(reflect.MakeMap(m.ReplyType.Elem()))
+	case reflect.Slice:
+		replyv.Elem().Set(reflect.MakeSlice(m.ReplyType.Elem(), 0, 0))
+	}
+	return replyv
+}
+
+type service struct {
+	name   string
+	typ    reflect.Type
+	rcvr   reflect.Value
+	method map[string]*methodType
+}
+
+func newService(rcvr interface{}) *service {
+	s := new(service)
+	s.rcvr = reflect.ValueOf(rcvr)
+	s.name = reflect.Indirect(s.rcvr).Type().Name()
+	s.typ = reflect.TypeOf(rcvr)
+	if !ast.IsExported(s.name) {
+		log.Fatalf("rpc server: %s is not a valid service name", s.name)
+	}
+	s.registerMethods()
+	return s
+}
+
+func (s *service) registerMethods() {
+	s.method = make(map[string]*methodType)
+	for i := 0; i < s.typ.NumMethod(); i++ {
+		method := s.typ.Method(i)
+		mType := method.Type
+		if mType.NumIn() != 3 || mType.NumOut() != 1 {
+			continue
+		}
+		if mType.Out(0) != reflect.TypeOf((*error)(nil)).Elem() {
+			continue
+		}
+		argType, replyType := mType.In(1), mType.In(2)
+		if !isExportedOrBuiltinType(argType) || !isExportedOrBuiltinType(replyType) {
+			continue
+		}
+		s.method[method.Name] = &methodType{
+			method:    method,
+			ArgType:   argType,
+			ReplyType: replyType,
+		}
+		log.Printf("rpc server: register %s.%s\n", s.name, method.Name)
+	}
+}
+
+func (s *service) call(m *methodType, argv, replyv reflect.Value) error {
+	atomic.AddUint64(&m.numCalls, 1)
+	f := m.method.Func
+	returnValues := f.Call([]reflect.Value{s.rcvr, argv, replyv})
+	if errInter := returnValues[0].Interface(); errInter != nil {
+		return errInter.(error)
+	}
+	return nil
+}
+
+func isExportedOrBuiltinType(t reflect.Type) bool {
+	return ast.IsExported(t.Name()) || t.PkgPath() == ""
+}
diff --git a/gee-rpc/day6-discovery/service_test.go b/gee-rpc/day6-discovery/service_test.go
new file mode 100644
index 0000000..c8266df
--- /dev/null
+++ b/gee-rpc/day6-discovery/service_test.go
@@ -0,0 +1,48 @@
+package geerpc
+
+import (
+	"fmt"
+	"reflect"
+	"testing"
+)
+
+type Foo int
+
+type Args struct{ Num1, Num2 int }
+
+func (f Foo) Sum(args Args, reply *int) error {
+	*reply = args.Num1 + args.Num2
+	return nil
+}
+
+// it's not a exported Method
+func (f Foo) sum(args Args, reply *int) error {
+	*reply = args.Num1 + args.Num2
+	return nil
+}
+
+func _assert(condition bool, msg string, v ...interface{}) {
+	if !condition {
+		panic(fmt.Sprintf("assertion failed: "+msg, v...))
+	}
+}
+
+func TestNewService(t *testing.T) {
+	var foo Foo
+	s := newService(&foo)
+	_assert(len(s.method) == 1, "wrong service Method, expect 1, but got %d", len(s.method))
+	mType := s.method["Sum"]
+	_assert(mType != nil, "wrong Method, Sum shouldn't nil")
+}
+
+func TestMethodType_Call(t *testing.T) {
+	var foo Foo
+	s := newService(&foo)
+	mType := s.method["Sum"]
+
+	argv := mType.newArgv()
+	replyv := mType.newReplyv()
+	argv.Set(reflect.ValueOf(Args{Num1: 1, Num2: 3}))
+	err := s.call(mType, argv, replyv)
+	_assert(err == nil && *replyv.Interface().(*int) == 4 && mType.NumCalls() == 1, "failed to call Foo.Sum")
+}
diff --git a/gee-rpc/day6-discovery/xclient/discovery.go b/gee-rpc/day6-discovery/xclient/discovery.go
new file mode 100644
index 0000000..98b58d6
--- /dev/null
+++ b/gee-rpc/day6-discovery/xclient/discovery.go
@@ -0,0 +1,57 @@
+package xclient
+
+import (
+	"math/rand"
+	"sync"
+	"time"
+)
+
+type SelectMode int
+
+const (
+	RandomSelect SelectMode = iota // select randomly
+	RobbinSelect                   // select using Robbin algorithm
+)
+
+type Discovery interface {
+	Get(mode SelectMode) string
+}
+
+var _ Discovery = (*MultiServersDiscovery)(nil)
+
+// MultiServersDiscovery is a discovery for multi servers without a registry center
+// user provides the server addresses explicitly instead
+type MultiServersDiscovery struct {
+	r       *rand.Rand   // generate random number
+	mu      sync.RWMutex // protect following
+	servers []string
+}
+
+// Update the servers of discovery dynamically if needed
+func (d *MultiServersDiscovery) Update(servers []string) {
+	d.mu.Lock()
+	defer d.mu.Unlock()
+	d.servers = servers
+}
+
+func (d *MultiServersDiscovery) Get(mode SelectMode) string {
+	d.mu.RLock()
+	defer d.mu.RUnlock()
+	if len(d.servers) == 0 {
+		return ""
+	}
+	switch mode {
+	case RandomSelect:
+		return d.servers[d.r.Intn(len(d.servers))]
+	default:
+		return ""
+	}
+}
+
+// NewMultiServerDiscovery creates a MultiServersDiscovery instance
+func NewMultiServerDiscovery(servers []string) *MultiServersDiscovery {
+	return &MultiServersDiscovery{
+		servers: servers,
+		r:       rand.New(rand.NewSource(time.Now().UnixNano())),
+	}
+}
diff --git a/gee-rpc/day6-discovery/xclient/xclient.go b/gee-rpc/day6-discovery/xclient/xclient.go
new file mode 100644
index 0000000..ff6992f
--- /dev/null
+++ b/gee-rpc/day6-discovery/xclient/xclient.go
@@ -0,0 +1,48 @@
+package xclient
+
+import (
+	"context"
+	. "geerpc"
+	"io"
+	"sync"
+)
+
+type XClient struct {
+	d       Discovery
+	mode    SelectMode
+	opt     *Option
+	clients sync.Map
+}
+
+var _ io.Closer = (*XClient)(nil)
+
+func NewXClient(d Discovery, mode SelectMode, opt *Option) *XClient {
+	return &XClient{d: d, mode: mode, opt: opt}
+}
+
+func (xc *XClient) Close() error {
+	xc.clients.Range(func(k, v interface{}) bool {
+		// I have no idea how to deal with error, just ignore it.
+		_ = v.(*Client).Close()
+		return true
+	})
+	xc.clients = sync.Map{}
+	return nil
+}
+
+// Call invokes the named function, waits for it to complete,
+// and returns its error status.
+// xc will choose a proper server.
+func (xc *XClient) Call(ctx context.Context, serviceMethod string, args, reply interface{}) error {
+	rpcAddr := xc.d.Get(xc.mode)
+	client, ok := xc.clients.Load(rpcAddr)
+	if !ok {
+		var err error
+		client, err = XDial(rpcAddr, xc.opt)
+		if err != nil {
+			return err
+		}
+		xc.clients.Store(rpcAddr, client)
+	}
+	return client.(*Client).Call(ctx, serviceMethod, args, reply)
+}

From 7cd0399e24af59a09cab4bca804dee5087a55679 Mon Sep 17 00:00:00 2001
From: gzdaijie <gzdaijie@gmail.com>
Date: Mon, 5 Oct 2020 02:16:39 +0800
Subject: [PATCH 082/122] gee-rpc day6 add discovery

---
 gee-rpc/day1-codec/codec/codec.go           |  2 +-
 gee-rpc/day2-client/codec/codec.go          |  2 +-
 gee-rpc/day3-service/codec/codec.go         |  2 +-
 gee-rpc/day4-timeout/codec/codec.go         |  2 +-
 gee-rpc/day5-http-debug/codec/codec.go      |  2 +-
 gee-rpc/day6-discovery/client.go            |  4 +-
 gee-rpc/day6-discovery/codec/codec.go       |  2 +-
 gee-rpc/day6-discovery/main/main.go         | 76 ++++++++++++++----
 gee-rpc/day6-discovery/xclient/discovery.go | 12 ++-
 gee-rpc/day6-discovery/xclient/xclient.go   | 87 +++++++++++++++++----
 10 files changed, 149 insertions(+), 42 deletions(-)

diff --git a/gee-rpc/day1-codec/codec/codec.go b/gee-rpc/day1-codec/codec/codec.go
index ba28fba..20b6ba7 100644
--- a/gee-rpc/day1-codec/codec/codec.go
+++ b/gee-rpc/day1-codec/codec/codec.go
@@ -23,7 +23,7 @@ type Type string
 
 const (
 	GobType  Type = "application/gob"
-	JsonType Type = "application/json"
+	JsonType Type = "application/json" // not implemented
 )
 
 var NewCodecFuncMap map[Type]NewCodecFunc
diff --git a/gee-rpc/day2-client/codec/codec.go b/gee-rpc/day2-client/codec/codec.go
index ba28fba..20b6ba7 100644
--- a/gee-rpc/day2-client/codec/codec.go
+++ b/gee-rpc/day2-client/codec/codec.go
@@ -23,7 +23,7 @@ type Type string
 
 const (
 	GobType  Type = "application/gob"
-	JsonType Type = "application/json"
+	JsonType Type = "application/json" // not implemented
 )
 
 var NewCodecFuncMap map[Type]NewCodecFunc
diff --git a/gee-rpc/day3-service/codec/codec.go b/gee-rpc/day3-service/codec/codec.go
index ba28fba..20b6ba7 100644
--- a/gee-rpc/day3-service/codec/codec.go
+++ b/gee-rpc/day3-service/codec/codec.go
@@ -23,7 +23,7 @@ type Type string
 
 const (
 	GobType  Type = "application/gob"
-	JsonType Type = "application/json"
+	JsonType Type = "application/json" // not implemented
 )
 
 var NewCodecFuncMap map[Type]NewCodecFunc
diff --git a/gee-rpc/day4-timeout/codec/codec.go b/gee-rpc/day4-timeout/codec/codec.go
index ba28fba..20b6ba7 100644
--- a/gee-rpc/day4-timeout/codec/codec.go
+++ b/gee-rpc/day4-timeout/codec/codec.go
@@ -23,7 +23,7 @@ type Type string
 
 const (
 	GobType  Type = "application/gob"
-	JsonType Type = "application/json"
+	JsonType Type = "application/json" // not implemented
 )
 
 var NewCodecFuncMap map[Type]NewCodecFunc
diff --git a/gee-rpc/day5-http-debug/codec/codec.go b/gee-rpc/day5-http-debug/codec/codec.go
index ba28fba..20b6ba7 100644
--- a/gee-rpc/day5-http-debug/codec/codec.go
+++ b/gee-rpc/day5-http-debug/codec/codec.go
@@ -23,7 +23,7 @@ type Type string
 
 const (
 	GobType  Type = "application/gob"
-	JsonType Type = "application/json"
+	JsonType Type = "application/json" // not implemented
 )
 
 var NewCodecFuncMap map[Type]NewCodecFunc
diff --git a/gee-rpc/day6-discovery/client.go b/gee-rpc/day6-discovery/client.go
index d958696..e9b4540 100644
--- a/gee-rpc/day6-discovery/client.go
+++ b/gee-rpc/day6-discovery/client.go
@@ -316,9 +316,9 @@ func XDial(rpcAddr string, opts ...*Option) (*Client, error) {
 	protocol, addr := parts[0], parts[1]
 	switch protocol {
 	case "http":
-		return DialHTTP("tcp", addr)
+		return DialHTTP("tcp", addr, opts...)
 	default:
 		// tcp, unix or other transport protocol
-		return Dial(protocol, addr)
+		return Dial(protocol, addr, opts...)
 	}
 }
diff --git a/gee-rpc/day6-discovery/codec/codec.go b/gee-rpc/day6-discovery/codec/codec.go
index ba28fba..20b6ba7 100644
--- a/gee-rpc/day6-discovery/codec/codec.go
+++ b/gee-rpc/day6-discovery/codec/codec.go
@@ -23,7 +23,7 @@ type Type string
 
 const (
 	GobType  Type = "application/gob"
-	JsonType Type = "application/json"
+	JsonType Type = "application/json" // not implemented
 )
 
 var NewCodecFuncMap map[Type]NewCodecFunc
diff --git a/gee-rpc/day6-discovery/main/main.go b/gee-rpc/day6-discovery/main/main.go
index a71af74..308da5c 100644
--- a/gee-rpc/day6-discovery/main/main.go
+++ b/gee-rpc/day6-discovery/main/main.go
@@ -3,10 +3,11 @@ package main
 import (
 	"context"
 	"geerpc"
+	"geerpc/xclient"
 	"log"
 	"net"
-	"net/http"
 	"sync"
+	"time"
 )
 
 type Foo int
@@ -18,38 +19,79 @@ func (f Foo) Sum(args Args, reply *int) error {
 	return nil
 }
 
+func (f Foo) Sleep(args Args, reply *int) error {
+	time.Sleep(time.Second * time.Duration(args.Num1))
+	*reply = args.Num1 + args.Num2
+	return nil
+}
+
 func startServer(addrCh chan string) {
 	var foo Foo
-	l, _ := net.Listen("tcp", ":9999")
-	_ = geerpc.Register(&foo)
-	geerpc.HandleHTTP()
+	l, _ := net.Listen("tcp", ":0")
+	server := geerpc.NewServer()
+	_ = server.Register(&foo)
 	addrCh <- l.Addr().String()
-	_ = http.Serve(l, nil)
+	server.Accept(l)
 }
 
-func call(addrCh chan string) {
-	client, _ := geerpc.DialHTTP("tcp", <-addrCh)
-	defer func() { _ = client.Close() }()
+func foo(xc *xclient.XClient, ctx context.Context, typ, serviceMethod string, args *Args) {
+	var reply int
+	var err error
+	switch typ {
+	case "call":
+		err = xc.Call(ctx, serviceMethod, args, &reply)
+	case "broadcast":
+		err = xc.Broadcast(ctx, serviceMethod, args, &reply)
+	}
+	if err != nil {
+		log.Printf("%s %s error: %v", typ, serviceMethod, err)
+	} else {
+		log.Printf("%s Foo.Sum success: %d + %d = %d", typ, args.Num1, args.Num2, reply)
+	}
+}
 
+func call(addr1, addr2 string) {
+	d := xclient.NewMultiServerDiscovery([]string{"tcp@" + addr1, "tcp@" + addr2})
+	xc := xclient.NewXClient(d, xclient.RandomSelect, nil)
+	defer func() { _ = xc.Close() }()
 	// send request & receive response
 	var wg sync.WaitGroup
 	for i := 0; i < 5; i++ {
 		wg.Add(1)
 		go func(i int) {
 			defer wg.Done()
-			args := &Args{Num1: i, Num2: i * i}
-			var reply int
-			if err := client.Call(context.Background(), "Foo.Sum", args, &reply); err != nil {
-				log.Fatal("call Foo.Sum error:", err)
-			}
-			log.Printf("%d + %d = %d", args.Num1, args.Num2, reply)
+			foo(xc, context.Background(), "call", "Foo.Sum", &Args{Num1: i, Num2: i * i})
+		}(i)
+	}
+	wg.Wait()
+}
+
+func broadcast(addr1, addr2 string) {
+	d := xclient.NewMultiServerDiscovery([]string{"tcp@" + addr1, "tcp@" + addr2})
+	xc := xclient.NewXClient(d, xclient.RandomSelect, nil)
+	var wg sync.WaitGroup
+	for i := 0; i < 5; i++ {
+		wg.Add(1)
+		go func(i int) {
+			defer wg.Done()
+			foo(xc, context.Background(), "broadcast", "Foo.Sum", &Args{Num1: i, Num2: i * i})
+			// expect 2 - 5 timeout
+			ctx, _ := context.WithTimeout(context.Background(), time.Second*2)
+			foo(xc, ctx, "broadcast", "Foo.Sleep", &Args{Num1: i, Num2: i * i})
 		}(i)
 	}
 	wg.Wait()
 }
 
 func main() {
-	ch := make(chan string)
-	go call(ch)
-	startServer(ch)
+	ch1 := make(chan string)
+	ch2 := make(chan string)
+	// start two servers
+	go startServer(ch1)
+	go startServer(ch2)
+
+	addr1 := <-ch1
+	addr2 := <-ch2
+	call(addr1, addr2)
+	broadcast(addr1, addr2)
 }
diff --git a/gee-rpc/day6-discovery/xclient/discovery.go b/gee-rpc/day6-discovery/xclient/discovery.go
index 98b58d6..7e52e3f 100644
--- a/gee-rpc/day6-discovery/xclient/discovery.go
+++ b/gee-rpc/day6-discovery/xclient/discovery.go
@@ -10,11 +10,12 @@ type SelectMode int
 
 const (
 	RandomSelect SelectMode = iota // select randomly
-	RobbinSelect                   // select using Robbin algorithm
+	RobbinSelect                   // select using Robbin algorithm, not implemented
 )
 
 type Discovery interface {
 	Get(mode SelectMode) string
+	All() []string
 }
 
 var _ Discovery = (*MultiServersDiscovery)(nil)
@@ -48,6 +49,15 @@ func (d *MultiServersDiscovery) Get(mode SelectMode) string {
 	}
 }
 
+func (d *MultiServersDiscovery) All() []string {
+	d.mu.RLock()
+	defer d.mu.RUnlock()
+	// return a copy of d.servers
+	servers := make([]string, len(d.servers), len(d.servers))
+	copy(servers, d.servers)
+	return servers
+}
+
 // NewMultiServerDiscovery creates a MultiServersDiscovery instance
 func NewMultiServerDiscovery(servers []string) *MultiServersDiscovery {
 	return &MultiServersDiscovery{
diff --git a/gee-rpc/day6-discovery/xclient/xclient.go b/gee-rpc/day6-discovery/xclient/xclient.go
index ff6992f..f3df99c 100644
--- a/gee-rpc/day6-discovery/xclient/xclient.go
+++ b/gee-rpc/day6-discovery/xclient/xclient.go
@@ -4,6 +4,7 @@ import (
 	"context"
 	. "geerpc"
 	"io"
+	"reflect"
 	"sync"
 )
 
@@ -11,38 +12,92 @@ type XClient struct {
 	d       Discovery
 	mode    SelectMode
 	opt     *Option
-	clients sync.Map
+	mu      sync.Mutex // protect following
+	clients map[string]*Client
 }
 
 var _ io.Closer = (*XClient)(nil)
 
 func NewXClient(d Discovery, mode SelectMode, opt *Option) *XClient {
-	return &XClient{d: d, mode: mode, opt: opt}
+	return &XClient{d: d, mode: mode, opt: opt, clients: make(map[string]*Client)}
 }
 
 func (xc *XClient) Close() error {
-	xc.clients.Range(func(k, v interface{}) bool {
+	xc.mu.Lock()
+	defer xc.mu.Unlock()
+	for key, client := range xc.clients {
 		// I have no idea how to deal with error, just ignore it.
-		_ = v.(*Client).Close()
-		return true
-	})
-	xc.clients = sync.Map{}
+		_ = client.Close()
+		delete(xc.clients, key)
+	}
 	return nil
 }
 
+func (xc *XClient) dial(rpcAddr string) (*Client, error) {
+	xc.mu.Lock()
+	defer xc.mu.Unlock()
+	client, ok := xc.clients[rpcAddr]
+	if ok && !client.IsAvailable() {
+		_ = client.Close()
+		delete(xc.clients, rpcAddr)
+		client = nil
+	}
+	if client == nil {
+		var err error
+		client, err = XDial(rpcAddr, xc.opt)
+		if err != nil {
+			return nil, err
+		}
+		xc.clients[rpcAddr] = client
+	}
+	return client, nil
+}
+
+func (xc *XClient) call(rpcAddr string, ctx context.Context, serviceMethod string, args, reply interface{}) error {
+	client, err := xc.dial(rpcAddr)
+	if err != nil {
+		return err
+	}
+	return client.Call(ctx, serviceMethod, args, reply)
+}
+
 // Call invokes the named function, waits for it to complete,
 // and returns its error status.
 // xc will choose a proper server.
 func (xc *XClient) Call(ctx context.Context, serviceMethod string, args, reply interface{}) error {
 	rpcAddr := xc.d.Get(xc.mode)
-	client, ok := xc.clients.Load(rpcAddr)
-	if !ok {
-		var err error
-		client, err = XDial(rpcAddr, xc.opt)
-		if err != nil {
-			return err
-		}
-		xc.clients.Store(rpcAddr, client)
+	return xc.call(rpcAddr, ctx, serviceMethod, args, reply)
+}
+
+// Broadcast invokes the named function for every server registered in discovery
+func (xc *XClient) Broadcast(ctx context.Context, serviceMethod string, args, reply interface{}) error {
+	servers := xc.d.All()
+	var wg sync.WaitGroup
+	var mu sync.Mutex
+	var e error
+	replyDone := reply == nil // if reply is nil, don't need to set value
+	ctx, cancel := context.WithCancel(ctx)
+	for _, rpcAddr := range servers {
+		wg.Add(1)
+		go func() {
+			defer wg.Done()
+			var clonedReply interface{}
+			if reply != nil {
+				clonedReply = reflect.New(reflect.ValueOf(reply).Elem().Type()).Interface()
+			}
+			err := xc.call(rpcAddr, ctx, serviceMethod, args, clonedReply)
+			mu.Lock()
+			if err != nil && e == nil {
+				e = err
+				cancel() // if any call failed, cancel unfinished calls
+			}
+			if err == nil && !replyDone {
+				reflect.ValueOf(reply).Elem().Set(reflect.ValueOf(clonedReply).Elem())
+				replyDone = true
+			}
+			mu.Unlock()
+		}()
 	}
-	return client.(*Client).Call(ctx, serviceMethod, args, reply)
+	wg.Wait()
+	return e
 }

From 366f09aa6b0bf1095a9d7c7aa380276ed403c7cf Mon Sep 17 00:00:00 2001
From: gzdaijie <gzdaijie@gmail.com>
Date: Mon, 5 Oct 2020 11:48:48 +0800
Subject: [PATCH 083/122] gee-rpc day6 add robin select for discovery

---
 gee-rpc/day6-discovery/xclient/discovery.go | 11 ++++++++---
 1 file changed, 8 insertions(+), 3 deletions(-)

diff --git a/gee-rpc/day6-discovery/xclient/discovery.go b/gee-rpc/day6-discovery/xclient/discovery.go
index 7e52e3f..d00db3d 100644
--- a/gee-rpc/day6-discovery/xclient/discovery.go
+++ b/gee-rpc/day6-discovery/xclient/discovery.go
@@ -10,7 +10,7 @@ type SelectMode int
 
 const (
 	RandomSelect SelectMode = iota // select randomly
-	RobbinSelect                   // select using Robbin algorithm, not implemented
+	RobinSelect                    // select using Robbin algorithm
 )
 
 type Discovery interface {
@@ -26,6 +26,7 @@ type MultiServersDiscovery struct {
 	r       *rand.Rand   // generate random number
 	mu      sync.RWMutex // protect following
 	servers []string
+	index   int // record the selected position for robin algorithm
 }
 
 // Update the servers of discovery dynamically if needed
@@ -36,14 +37,18 @@ func (d *MultiServersDiscovery) Update(servers []string) {
 }
 
 func (d *MultiServersDiscovery) Get(mode SelectMode) string {
-	d.mu.RLock()
-	defer d.mu.RUnlock()
+	d.mu.Lock()
+	defer d.mu.Unlock()
 	if len(d.servers) == 0 {
 		return ""
 	}
 	switch mode {
 	case RandomSelect:
 		return d.servers[d.r.Intn(len(d.servers))]
+	case RobinSelect:
+		s := d.servers[d.index]
+		d.index = (d.index + 1) % len(d.servers)
+		return s
 	default:
 		return ""
 	}

From 5a84e23349ee7f95c12be005cf4f2588f06bf550 Mon Sep 17 00:00:00 2001
From: gzdaijie <gzdaijie@gmail.com>
Date: Mon, 5 Oct 2020 12:01:04 +0800
Subject: [PATCH 084/122] gee-rpc/day6: rename Robin to RoundRobin

---
 gee-rpc/day6-discovery/xclient/discovery.go | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/gee-rpc/day6-discovery/xclient/discovery.go b/gee-rpc/day6-discovery/xclient/discovery.go
index d00db3d..b473b5d 100644
--- a/gee-rpc/day6-discovery/xclient/discovery.go
+++ b/gee-rpc/day6-discovery/xclient/discovery.go
@@ -9,8 +9,8 @@ import (
 type SelectMode int
 
 const (
-	RandomSelect SelectMode = iota // select randomly
-	RobinSelect                    // select using Robbin algorithm
+	RandomSelect     SelectMode = iota // select randomly
+	RoundRobinSelect                   // select using Robbin algorithm
 )
 
 type Discovery interface {
@@ -45,7 +45,7 @@ func (d *MultiServersDiscovery) Get(mode SelectMode) string {
 	switch mode {
 	case RandomSelect:
 		return d.servers[d.r.Intn(len(d.servers))]
-	case RobinSelect:
+	case RoundRobinSelect:
 		s := d.servers[d.index]
 		d.index = (d.index + 1) % len(d.servers)
 		return s

From 78789790bdc73851103995f29f18c4e966cbf60d Mon Sep 17 00:00:00 2001
From: gzdaijie <gzdaijie@gmail.com>
Date: Mon, 5 Oct 2020 18:07:16 +0800
Subject: [PATCH 085/122] gee-rpc/day7 add registry

---
 README.md                                     |  28 ++
 gee-rpc/day1-codec/main/main.go               |   2 +
 gee-rpc/day2-client/main/main.go              |   2 +
 gee-rpc/day3-service/main/main.go             |   2 +
 gee-rpc/day4-timeout/main/main.go             |   2 +
 gee-rpc/day5-http-debug/main/main.go          |   2 +
 .../client.go                                 |   0
 .../client_test.go                            |   0
 .../codec/codec.go                            |   0
 .../codec/gob.go                              |   0
 .../debug.go                                  |   0
 .../go.mod                                    |   0
 .../main/main.go                              |   2 +
 .../server.go                                 |   0
 .../service.go                                |   0
 .../service_test.go                           |   0
 .../xclient/discovery.go                      |  31 +-
 .../xclient/xclient.go                        |  12 +-
 gee-rpc/day7-registry/client.go               | 324 ++++++++++++++++++
 gee-rpc/day7-registry/client_test.go          |  84 +++++
 gee-rpc/day7-registry/codec/codec.go          |  34 ++
 gee-rpc/day7-registry/codec/gob.go            |  57 +++
 gee-rpc/day7-registry/debug.go                |  60 ++++
 gee-rpc/day7-registry/go.mod                  |   3 +
 gee-rpc/day7-registry/main/main.go            | 112 ++++++
 gee-rpc/day7-registry/registry/registry.go    | 123 +++++++
 gee-rpc/day7-registry/server.go               | 266 ++++++++++++++
 gee-rpc/day7-registry/service.go              |  99 ++++++
 gee-rpc/day7-registry/service_test.go         |  48 +++
 gee-rpc/day7-registry/xclient/discovery.go    |  83 +++++
 .../day7-registry/xclient/discovery_gee.go    |  74 ++++
 gee-rpc/day7-registry/xclient/xclient.go      | 109 ++++++
 32 files changed, 1546 insertions(+), 13 deletions(-)
 rename gee-rpc/{day6-discovery => day6-load-balance}/client.go (100%)
 rename gee-rpc/{day6-discovery => day6-load-balance}/client_test.go (100%)
 rename gee-rpc/{day6-discovery => day6-load-balance}/codec/codec.go (100%)
 rename gee-rpc/{day6-discovery => day6-load-balance}/codec/gob.go (100%)
 rename gee-rpc/{day6-discovery => day6-load-balance}/debug.go (100%)
 rename gee-rpc/{day6-discovery => day6-load-balance}/go.mod (100%)
 rename gee-rpc/{day6-discovery => day6-load-balance}/main/main.go (98%)
 rename gee-rpc/{day6-discovery => day6-load-balance}/server.go (100%)
 rename gee-rpc/{day6-discovery => day6-load-balance}/service.go (100%)
 rename gee-rpc/{day6-discovery => day6-load-balance}/service_test.go (100%)
 rename gee-rpc/{day6-discovery => day6-load-balance}/xclient/discovery.go (63%)
 rename gee-rpc/{day6-discovery => day6-load-balance}/xclient/xclient.go (93%)
 create mode 100644 gee-rpc/day7-registry/client.go
 create mode 100644 gee-rpc/day7-registry/client_test.go
 create mode 100644 gee-rpc/day7-registry/codec/codec.go
 create mode 100644 gee-rpc/day7-registry/codec/gob.go
 create mode 100644 gee-rpc/day7-registry/debug.go
 create mode 100644 gee-rpc/day7-registry/go.mod
 create mode 100644 gee-rpc/day7-registry/main/main.go
 create mode 100644 gee-rpc/day7-registry/registry/registry.go
 create mode 100644 gee-rpc/day7-registry/server.go
 create mode 100644 gee-rpc/day7-registry/service.go
 create mode 100644 gee-rpc/day7-registry/service_test.go
 create mode 100644 gee-rpc/day7-registry/xclient/discovery.go
 create mode 100644 gee-rpc/day7-registry/xclient/discovery_gee.go
 create mode 100644 gee-rpc/day7-registry/xclient/xclient.go

diff --git a/README.md b/README.md
index 37d366d..c2d9d02 100644
--- a/README.md
+++ b/README.md
@@ -10,6 +10,8 @@
 
 推荐先阅读 **[Go 语言简明教程](https://geektutu.com/post/quick-golang.html)**，一篇文章了解Go的基本语法、并发编程，依赖管理等内容。
 
+另外推荐 **[Go 语言笔试面试题](https://geektutu.com/post/qa-golang.html)**，加深对 Go 语言的理解。
+
 期待关注我的「[知乎专栏](https://zhuanlan.zhihu.com/geekgo)」和「[微博](http://weibo.com/geektutu)」，查看最近的文章和动态。
 
 ### 7天用Go从零实现Web框架 - Gee
@@ -50,6 +52,20 @@ gorm 准备推出完全重写的 v2 版本(目前还在开发中)，相对 gorm-
 - 第六天：[支持事务(Transaction)](https://geektutu.com/post/geeorm-day6.html) | [Code](gee-orm/day6-transaction)
 - 第七天：[数据库迁移(Migrate)](https://geektutu.com/post/geeorm-day7.html) | [Code](gee-orm/day7-migrate)
 
+
+### 7天用Go从零实现RPC框架 GeeRPC
+
+[GeeRPC](https://geektutu.com/post/geerpc.html) 是一个基于 [net/rpc](https://github.com/golang/go/tree/master/src/net/rpc) 开发的 RPC 框架
+GeeRPC 是基于 Go 语言标准库 `net/rpc` 实现的，添加了协议交换、服务注册与发现、负载均衡等功能，代码约 1k。
+
+- 第一天 - [服务端与消息编码](https://geektutu.com/post/geerpc-day1.html) | [Code](gee-rpc/day1-codec)
+- 第二天 - [支持并发与异步的客户端](https://geektutu.com/post/geerpc-day2.html) | [Code](gee-rpc/day2-client)
+- 第三天 - [服务注册(service register)](https://geektutu.com/post/geerpc-day3.html) | [Code](gee-rpc/day3-service )
+- 第四天 - [超时处理(timeout)](https://geektutu.com/post/geerpc-day4.html) | [Code](gee-rpc/day4-timeout )
+- 第五天 - [支持HTTP协议](https://geektutu.com/post/geerpc-day5.html) | [Code](gee-rpc/day5-http-debug)
+- 第六天 - [负载均衡(load balance)](https://geektutu.com/post/geerpc-day6.html) | [Code](gee-rpc/day6-load-balance)
+- 第七天 - [服务发现与注册中心(registry)](https://geektutu.com/post/geerpc-day7.html) | [Code](gee-rpc/day7-registry)
+
 ### WebAssembly 使用示例
 
 具体的实践过程记录在 [Go WebAssembly 简明教程](https://geektutu.com/post/quick-go-wasm.html)。
@@ -102,6 +118,18 @@ Xorm's desgin is easier to understand than gorm-v1, so the main designs referenc
 - Day 6 - Support Transaction | [Code](gee-orm/day6-transaction)
 - Day 7 - Migrate Database | [Code](gee-orm/day7-migrate)
 
+[GeeRPC](https://geektutu.com/post/geerpc.html) is a [net/rpc](https://github.com/golang/go/tree/master/src/net/rpc)-like RPC framework
+
+Based on golang standard library `net/rpc`, GeeRPC implements more features. eg, protocol exchange, service registration and discovery, load balance, etc.
+
+- Day 1 - Server Message Codec | [Code](gee-rpc/day1-codec)
+- Day 2 - Concurrent Client | [Code](gee-rpc/day2-client)
+- Day 3 - Service Register | [Code](gee-rpc/day3-service )
+- Day 4 - Timeout Processing | [Code](gee-rpc/day4-timeout )
+- Day 5 - Support HTTP Protocol | [Code](gee-rpc/day5-http-debug)
+- Day 6 - Load Balance | [Code](gee-rpc/day6-load-balance)
+- Day 7 - Discovery and Registry | [Code](gee-rpc/day7-registry)
+
 ## Golang WebAssembly Demo
 
 - Demo 1 - Hello World [Code](demo-wasm/hello-world)
diff --git a/gee-rpc/day1-codec/main/main.go b/gee-rpc/day1-codec/main/main.go
index 8f29531..948b763 100644
--- a/gee-rpc/day1-codec/main/main.go
+++ b/gee-rpc/day1-codec/main/main.go
@@ -7,6 +7,7 @@ import (
 	"geerpc/codec"
 	"log"
 	"net"
+	"time"
 )
 
 func startServer(addr chan string) {
@@ -28,6 +29,7 @@ func main() {
 	conn, _ := net.Dial("tcp", <-addr)
 	defer func() { _ = conn.Close() }()
 
+	time.Sleep(time.Second)
 	// send options
 	_ = json.NewEncoder(conn).Encode(geerpc.DefaultOption)
 	cc := codec.NewGobCodec(conn)
diff --git a/gee-rpc/day2-client/main/main.go b/gee-rpc/day2-client/main/main.go
index e291353..8502fe9 100644
--- a/gee-rpc/day2-client/main/main.go
+++ b/gee-rpc/day2-client/main/main.go
@@ -6,6 +6,7 @@ import (
 	"log"
 	"net"
 	"sync"
+	"time"
 )
 
 func startServer(addr chan string) {
@@ -25,6 +26,7 @@ func main() {
 	client, _ := geerpc.Dial("tcp", <-addr)
 	defer func() { _ = client.Close() }()
 
+	time.Sleep(time.Second)
 	// send request & receive response
 	var wg sync.WaitGroup
 	for i := 0; i < 5; i++ {
diff --git a/gee-rpc/day3-service/main/main.go b/gee-rpc/day3-service/main/main.go
index c526e11..0f0b668 100644
--- a/gee-rpc/day3-service/main/main.go
+++ b/gee-rpc/day3-service/main/main.go
@@ -5,6 +5,7 @@ import (
 	"log"
 	"net"
 	"sync"
+	"time"
 )
 
 type Foo int
@@ -37,6 +38,7 @@ func main() {
 	client, _ := geerpc.Dial("tcp", <-addr)
 	defer func() { _ = client.Close() }()
 
+	time.Sleep(time.Second)
 	// send request & receive response
 	var wg sync.WaitGroup
 	for i := 0; i < 5; i++ {
diff --git a/gee-rpc/day4-timeout/main/main.go b/gee-rpc/day4-timeout/main/main.go
index e5e6050..9693eb5 100644
--- a/gee-rpc/day4-timeout/main/main.go
+++ b/gee-rpc/day4-timeout/main/main.go
@@ -6,6 +6,7 @@ import (
 	"log"
 	"net"
 	"sync"
+	"time"
 )
 
 type Foo int
@@ -38,6 +39,7 @@ func main() {
 	client, _ := geerpc.Dial("tcp", <-addr)
 	defer func() { _ = client.Close() }()
 
+	time.Sleep(time.Second)
 	// send request & receive response
 	var wg sync.WaitGroup
 	for i := 0; i < 5; i++ {
diff --git a/gee-rpc/day5-http-debug/main/main.go b/gee-rpc/day5-http-debug/main/main.go
index a71af74..6499b53 100644
--- a/gee-rpc/day5-http-debug/main/main.go
+++ b/gee-rpc/day5-http-debug/main/main.go
@@ -7,6 +7,7 @@ import (
 	"net"
 	"net/http"
 	"sync"
+	"time"
 )
 
 type Foo int
@@ -31,6 +32,7 @@ func call(addrCh chan string) {
 	client, _ := geerpc.DialHTTP("tcp", <-addrCh)
 	defer func() { _ = client.Close() }()
 
+	time.Sleep(time.Second)
 	// send request & receive response
 	var wg sync.WaitGroup
 	for i := 0; i < 5; i++ {
diff --git a/gee-rpc/day6-discovery/client.go b/gee-rpc/day6-load-balance/client.go
similarity index 100%
rename from gee-rpc/day6-discovery/client.go
rename to gee-rpc/day6-load-balance/client.go
diff --git a/gee-rpc/day6-discovery/client_test.go b/gee-rpc/day6-load-balance/client_test.go
similarity index 100%
rename from gee-rpc/day6-discovery/client_test.go
rename to gee-rpc/day6-load-balance/client_test.go
diff --git a/gee-rpc/day6-discovery/codec/codec.go b/gee-rpc/day6-load-balance/codec/codec.go
similarity index 100%
rename from gee-rpc/day6-discovery/codec/codec.go
rename to gee-rpc/day6-load-balance/codec/codec.go
diff --git a/gee-rpc/day6-discovery/codec/gob.go b/gee-rpc/day6-load-balance/codec/gob.go
similarity index 100%
rename from gee-rpc/day6-discovery/codec/gob.go
rename to gee-rpc/day6-load-balance/codec/gob.go
diff --git a/gee-rpc/day6-discovery/debug.go b/gee-rpc/day6-load-balance/debug.go
similarity index 100%
rename from gee-rpc/day6-discovery/debug.go
rename to gee-rpc/day6-load-balance/debug.go
diff --git a/gee-rpc/day6-discovery/go.mod b/gee-rpc/day6-load-balance/go.mod
similarity index 100%
rename from gee-rpc/day6-discovery/go.mod
rename to gee-rpc/day6-load-balance/go.mod
diff --git a/gee-rpc/day6-discovery/main/main.go b/gee-rpc/day6-load-balance/main/main.go
similarity index 98%
rename from gee-rpc/day6-discovery/main/main.go
rename to gee-rpc/day6-load-balance/main/main.go
index 308da5c..d00f864 100644
--- a/gee-rpc/day6-discovery/main/main.go
+++ b/gee-rpc/day6-load-balance/main/main.go
@@ -92,6 +92,8 @@ func main() {
 
 	addr1 := <-ch1
 	addr2 := <-ch2
+
+	time.Sleep(time.Second)
 	call(addr1, addr2)
 	broadcast(addr1, addr2)
 }
diff --git a/gee-rpc/day6-discovery/server.go b/gee-rpc/day6-load-balance/server.go
similarity index 100%
rename from gee-rpc/day6-discovery/server.go
rename to gee-rpc/day6-load-balance/server.go
diff --git a/gee-rpc/day6-discovery/service.go b/gee-rpc/day6-load-balance/service.go
similarity index 100%
rename from gee-rpc/day6-discovery/service.go
rename to gee-rpc/day6-load-balance/service.go
diff --git a/gee-rpc/day6-discovery/service_test.go b/gee-rpc/day6-load-balance/service_test.go
similarity index 100%
rename from gee-rpc/day6-discovery/service_test.go
rename to gee-rpc/day6-load-balance/service_test.go
diff --git a/gee-rpc/day6-discovery/xclient/discovery.go b/gee-rpc/day6-load-balance/xclient/discovery.go
similarity index 63%
rename from gee-rpc/day6-discovery/xclient/discovery.go
rename to gee-rpc/day6-load-balance/xclient/discovery.go
index b473b5d..f823a7b 100644
--- a/gee-rpc/day6-discovery/xclient/discovery.go
+++ b/gee-rpc/day6-load-balance/xclient/discovery.go
@@ -1,6 +1,7 @@
 package xclient
 
 import (
+	"errors"
 	"math/rand"
 	"sync"
 	"time"
@@ -14,8 +15,10 @@ const (
 )
 
 type Discovery interface {
-	Get(mode SelectMode) string
-	All() []string
+	Refresh() error // refresh from remote registry
+	Update(servers []string) error
+	Get(mode SelectMode) (string, error)
+	GetAll() ([]string, error)
 }
 
 var _ Discovery = (*MultiServersDiscovery)(nil)
@@ -29,38 +32,46 @@ type MultiServersDiscovery struct {
 	index   int // record the selected position for robin algorithm
 }
 
+// Refresh doesn't make sense for MultiServersDiscovery, so ignore it
+func (d *MultiServersDiscovery) Refresh() error {
+	return nil
+}
+
 // Update the servers of discovery dynamically if needed
-func (d *MultiServersDiscovery) Update(servers []string) {
+func (d *MultiServersDiscovery) Update(servers []string) error {
 	d.mu.Lock()
 	defer d.mu.Unlock()
 	d.servers = servers
+	return nil
 }
 
-func (d *MultiServersDiscovery) Get(mode SelectMode) string {
+// Get a server according to mode
+func (d *MultiServersDiscovery) Get(mode SelectMode) (string, error) {
 	d.mu.Lock()
 	defer d.mu.Unlock()
 	if len(d.servers) == 0 {
-		return ""
+		return "", errors.New("rpc discovery: no available servers")
 	}
 	switch mode {
 	case RandomSelect:
-		return d.servers[d.r.Intn(len(d.servers))]
+		return d.servers[d.r.Intn(len(d.servers))], nil
 	case RoundRobinSelect:
 		s := d.servers[d.index]
 		d.index = (d.index + 1) % len(d.servers)
-		return s
+		return s, nil
 	default:
-		return ""
+		return "", errors.New("rpc discovery: not supported select mode")
 	}
 }
 
-func (d *MultiServersDiscovery) All() []string {
+// returns all servers in discovery
+func (d *MultiServersDiscovery) GetAll() ([]string, error) {
 	d.mu.RLock()
 	defer d.mu.RUnlock()
 	// return a copy of d.servers
 	servers := make([]string, len(d.servers), len(d.servers))
 	copy(servers, d.servers)
-	return servers
+	return servers, nil
 }
 
 // NewMultiServerDiscovery creates a MultiServersDiscovery instance
diff --git a/gee-rpc/day6-discovery/xclient/xclient.go b/gee-rpc/day6-load-balance/xclient/xclient.go
similarity index 93%
rename from gee-rpc/day6-discovery/xclient/xclient.go
rename to gee-rpc/day6-load-balance/xclient/xclient.go
index f3df99c..838b343 100644
--- a/gee-rpc/day6-discovery/xclient/xclient.go
+++ b/gee-rpc/day6-load-balance/xclient/xclient.go
@@ -65,15 +65,21 @@ func (xc *XClient) call(rpcAddr string, ctx context.Context, serviceMethod strin
 // and returns its error status.
 // xc will choose a proper server.
 func (xc *XClient) Call(ctx context.Context, serviceMethod string, args, reply interface{}) error {
-	rpcAddr := xc.d.Get(xc.mode)
+	rpcAddr, err := xc.d.Get(xc.mode)
+	if err != nil {
+		return err
+	}
 	return xc.call(rpcAddr, ctx, serviceMethod, args, reply)
 }
 
 // Broadcast invokes the named function for every server registered in discovery
 func (xc *XClient) Broadcast(ctx context.Context, serviceMethod string, args, reply interface{}) error {
-	servers := xc.d.All()
+	servers, err := xc.d.GetAll()
+	if err != nil {
+		return err
+	}
 	var wg sync.WaitGroup
-	var mu sync.Mutex
+	var mu sync.Mutex // protect e and replyDone
 	var e error
 	replyDone := reply == nil // if reply is nil, don't need to set value
 	ctx, cancel := context.WithCancel(ctx)
diff --git a/gee-rpc/day7-registry/client.go b/gee-rpc/day7-registry/client.go
new file mode 100644
index 0000000..e9b4540
--- /dev/null
+++ b/gee-rpc/day7-registry/client.go
@@ -0,0 +1,324 @@
+// Copyright 2009 The Go Authors. All rights reserved.
+// Use of this source code is governed by a BSD-style
+// license that can be found in the LICENSE file.
+
+package geerpc
+
+import (
+	"bufio"
+	"context"
+	"encoding/json"
+	"errors"
+	"fmt"
+	"geerpc/codec"
+	"io"
+	"log"
+	"net"
+	"net/http"
+	"strings"
+	"sync"
+	"time"
+)
+
+// Call represents an active RPC.
+type Call struct {
+	Seq           uint64
+	ServiceMethod string      // format "<service>.<method>"
+	Args          interface{} // arguments to the function
+	Reply         interface{} // reply from the function
+	Error         error       // if error occurs, it will be set
+	Done          chan *Call  // Strobes when call is complete.
+}
+
+func (call *Call) done() {
+	call.Done <- call
+}
+
+// Client represents an RPC Client.
+// There may be multiple outstanding Calls associated
+// with a single Client, and a Client may be used by
+// multiple goroutines simultaneously.
+type Client struct {
+	cc       codec.Codec
+	opt      *Option
+	sending  sync.Mutex // protect following
+	header   codec.Header
+	mu       sync.Mutex // protect following
+	seq      uint64
+	pending  map[uint64]*Call
+	closing  bool // user has called Close
+	shutdown bool // server has told us to stop
+}
+
+var _ io.Closer = (*Client)(nil)
+
+var ErrShutdown = errors.New("connection is shut down")
+
+// Close the connection
+func (client *Client) Close() error {
+	client.mu.Lock()
+	defer client.mu.Unlock()
+	if client.closing {
+		return ErrShutdown
+	}
+	client.closing = true
+	return client.cc.Close()
+}
+
+// IsAvailable return true if the client does work
+func (client *Client) IsAvailable() bool {
+	client.mu.Lock()
+	defer client.mu.Unlock()
+	return !client.shutdown && !client.closing
+}
+
+func (client *Client) registerCall(call *Call) (uint64, error) {
+	client.mu.Lock()
+	defer client.mu.Unlock()
+	if client.closing || client.shutdown {
+		return 0, ErrShutdown
+	}
+	seq := client.seq
+	client.pending[seq] = call
+	client.seq++
+	return seq, nil
+}
+
+func (client *Client) removeCall(seq uint64) *Call {
+	client.mu.Lock()
+	defer client.mu.Unlock()
+	call := client.pending[seq]
+	delete(client.pending, seq)
+	return call
+}
+
+func (client *Client) terminateCalls(err error) {
+	client.sending.Lock()
+	defer client.sending.Unlock()
+	client.mu.Lock()
+	defer client.mu.Unlock()
+	client.shutdown = true
+	for _, call := range client.pending {
+		call.Error = err
+		call.done()
+	}
+}
+
+func (client *Client) send(call *Call) {
+	// make sure that the client will send a complete request
+	client.sending.Lock()
+	defer client.sending.Unlock()
+
+	// register this call.
+	seq, err := client.registerCall(call)
+	call.Seq = seq
+	if err != nil {
+		call.Error = err
+		call.done()
+		return
+	}
+
+	// prepare request header
+	client.header.ServiceMethod = call.ServiceMethod
+	client.header.Seq = seq
+	client.header.Error = ""
+
+	// encode and send the request
+	if err := client.cc.Write(&client.header, call.Args); err != nil {
+		call := client.removeCall(seq)
+		// call may be nil, it usually means that Write partially failed,
+		// client has received the response and handled
+		if call != nil {
+			call.Error = err
+			call.done()
+		}
+	}
+}
+
+func (client *Client) receive() {
+	var err error
+	for err == nil {
+		var h codec.Header
+		if err = client.cc.ReadHeader(&h); err != nil {
+			break
+		}
+		call := client.removeCall(h.Seq)
+		switch {
+		case call == nil:
+			// it usually means that Write partially failed
+			// and call was already removed.
+			err = client.cc.ReadBody(nil)
+		case h.Error != "":
+			call.Error = fmt.Errorf(h.Error)
+			err = client.cc.ReadBody(nil)
+			call.done()
+		default:
+			err = client.cc.ReadBody(call.Reply)
+			if err != nil {
+				call.Error = errors.New("reading body " + err.Error())
+			}
+			call.done()
+		}
+	}
+	// error occurs, so terminateCalls pending calls
+	client.terminateCalls(err)
+}
+
+// Go invokes the function asynchronously.
+// It returns the Call structure representing the invocation.
+func (client *Client) Go(serviceMethod string, args, reply interface{}, done chan *Call) *Call {
+	if done == nil {
+		done = make(chan *Call, 10)
+	} else if cap(done) == 0 {
+		log.Panic("rpc client: done channel is unbuffered")
+	}
+	call := &Call{
+		ServiceMethod: serviceMethod,
+		Args:          args,
+		Reply:         reply,
+		Done:          done,
+	}
+	client.send(call)
+	return call
+}
+
+// Call invokes the named function, waits for it to complete,
+// and returns its error status.
+func (client *Client) Call(ctx context.Context, serviceMethod string, args, reply interface{}) error {
+	call := client.Go(serviceMethod, args, reply, make(chan *Call, 1))
+	select {
+	case <-ctx.Done():
+		client.removeCall(call.Seq)
+		return errors.New("rpc client: call failed: " + ctx.Err().Error())
+	case call := <-call.Done:
+		return call.Error
+	}
+}
+
+func parseOptions(opts ...*Option) (*Option, error) {
+	// if opts is nil or pass nil as parameter
+	if len(opts) == 0 || opts[0] == nil {
+		return DefaultOption, nil
+	}
+	if len(opts) != 1 {
+		return nil, errors.New("number of options is more than 1")
+	}
+	opt := opts[0]
+	opt.MagicNumber = DefaultOption.MagicNumber
+	if opt.CodecType == "" {
+		opt.CodecType = DefaultOption.CodecType
+	}
+	return opt, nil
+}
+
+func NewClient(conn net.Conn, opt *Option) (*Client, error) {
+	f := codec.NewCodecFuncMap[opt.CodecType]
+	if f == nil {
+		err := fmt.Errorf("invalid codec type %s", opt.CodecType)
+		log.Println("rpc client: codec error:", err)
+		return nil, err
+	}
+	// send options with server
+	if err := json.NewEncoder(conn).Encode(opt); err != nil {
+		log.Println("rpc client: options error: ", err)
+		_ = conn.Close()
+		return nil, err
+	}
+	return newClientCodec(f(conn), opt), nil
+}
+
+func newClientCodec(cc codec.Codec, opt *Option) *Client {
+	client := &Client{
+		seq:     1, // seq starts with 1, 0 means invalid call
+		cc:      cc,
+		opt:     opt,
+		pending: make(map[uint64]*Call),
+	}
+	go client.receive()
+	return client
+}
+
+type clientResult struct {
+	client *Client
+	err    error
+}
+
+type dialFunc func(network, address string, opt *Option) (client *Client, err error)
+
+func dialTimeout(f dialFunc, network, address string, opts ...*Option) (*Client, error) {
+	opt, err := parseOptions(opts...)
+	if err != nil {
+		return nil, err
+	}
+	ch := make(chan clientResult)
+	go func() {
+		client, err := f(network, address, opt)
+		ch <- clientResult{client: client, err: err}
+	}()
+	if opt.ConnectTimeout == 0 {
+		result := <-ch
+		return result.client, result.err
+	}
+	select {
+	case <-time.After(opt.ConnectTimeout):
+		return nil, fmt.Errorf("rpc client: dial timeout: expect within %s", opt.ConnectTimeout)
+	case result := <-ch:
+		return result.client, result.err
+	}
+}
+
+func dial(network, address string, opt *Option) (*Client, error) {
+	conn, err := net.Dial(network, address)
+	if err != nil {
+		return nil, err
+	}
+	return NewClient(conn, opt)
+}
+
+// Dial connects to an RPC server at the specified network address
+func Dial(network, address string, opts ...*Option) (*Client, error) {
+	return dialTimeout(dial, network, address, opts...)
+}
+
+func dialHTTP(network, address string, opt *Option) (*Client, error) {
+	conn, err := net.Dial(network, address)
+	if err != nil {
+		return nil, err
+	}
+	_, _ = io.WriteString(conn, fmt.Sprintf("CONNECT %s HTTP/1.0\n\n", defaultRPCPath))
+
+	// Require successful HTTP response
+	// before switching to RPC protocol.
+	resp, err := http.ReadResponse(bufio.NewReader(conn), &http.Request{Method: "CONNECT"})
+	if err == nil && resp.Status == connected {
+		return NewClient(conn, opt)
+	}
+	if err == nil {
+		err = errors.New("unexpected HTTP response: " + resp.Status)
+	}
+	_ = conn.Close()
+	return nil, err
+}
+
+// DialHTTP connects to an HTTP RPC server at the specified network address
+// listening on the default HTTP RPC path.
+func DialHTTP(network, address string, opts ...*Option) (*Client, error) {
+	return dialTimeout(dialHTTP, network, address, opts...)
+}
+
+// XDial use a general format to represent a rpc server
+// eg, http@10.0.0.1:7001, tcp@10.0.0.1:9999, unix@/tmp/geerpc.sock
+func XDial(rpcAddr string, opts ...*Option) (*Client, error) {
+	parts := strings.Split(rpcAddr, "@")
+	if len(parts) != 2 {
+		return nil, fmt.Errorf("rpc client err: wrong format '%s', expect protocol@addr", rpcAddr)
+	}
+	protocol, addr := parts[0], parts[1]
+	switch protocol {
+	case "http":
+		return DialHTTP("tcp", addr, opts...)
+	default:
+		// tcp, unix or other transport protocol
+		return Dial(protocol, addr, opts...)
+	}
+}
diff --git a/gee-rpc/day7-registry/client_test.go b/gee-rpc/day7-registry/client_test.go
new file mode 100644
index 0000000..10b9817
--- /dev/null
+++ b/gee-rpc/day7-registry/client_test.go
@@ -0,0 +1,84 @@
+package geerpc
+
+import (
+	"context"
+	"net"
+	"os"
+	"runtime"
+	"strings"
+	"testing"
+	"time"
+)
+
+type Bar int
+
+func (b Bar) Timeout(argv int, reply *int) error {
+	time.Sleep(time.Second * 2)
+	return nil
+}
+
+func startServer(addr chan string) {
+	var b Bar
+	_ = Register(&b)
+	// pick a free port
+	l, _ := net.Listen("tcp", ":0")
+	addr <- l.Addr().String()
+	Accept(l)
+}
+
+func TestClient_dialTimeout(t *testing.T) {
+	t.Parallel()
+	f := func(network, address string, opt *Option) (client *Client, err error) {
+		time.Sleep(time.Second * 2)
+		return nil, nil
+	}
+	t.Run("timeout", func(t *testing.T) {
+		_, err := dialTimeout(f, "", "", &Option{ConnectTimeout: time.Second})
+		_assert(err != nil && strings.Contains(err.Error(), "dial timeout"), "expect a timeout error")
+	})
+	t.Run("0", func(t *testing.T) {
+		_, err := dialTimeout(f, "", "", &Option{ConnectTimeout: 0})
+		_assert(err == nil, "0 means no limit")
+	})
+}
+
+func TestClient_Call(t *testing.T) {
+	t.Parallel()
+	addrCh := make(chan string)
+	go startServer(addrCh)
+	addr := <-addrCh
+	t.Run("client timeout", func(t *testing.T) {
+		client, _ := Dial("tcp", addr)
+		ctx, _ := context.WithTimeout(context.Background(), time.Second)
+		var reply int
+		err := client.Call(ctx, "Bar.Timeout", 1, &reply)
+		_assert(err != nil && strings.Contains(err.Error(), ctx.Err().Error()), "expect a timeout error")
+	})
+	t.Run("server handle timeout", func(t *testing.T) {
+		client, _ := Dial("tcp", addr, &Option{
+			HandleTimeout: time.Second,
+		})
+		var reply int
+		err := client.Call(context.Background(), "Bar.Timeout", 1, &reply)
+		_assert(err != nil && strings.Contains(err.Error(), "handle timeout"), "expect a timeout error")
+	})
+}
+
+func TestXDial(t *testing.T) {
+	if runtime.GOOS == "linux" {
+		ch := make(chan struct{})
+		addr := "/tmp/geerpc.sock"
+		go func() {
+			_ = os.Remove(addr)
+			l, err := net.Listen("unix", addr)
+			if err != nil {
+				t.Fatal("failed to listen unix socket")
+			}
+			ch <- struct{}{}
+			Accept(l)
+		}()
+		<-ch
+		_, err := XDial("unix@" + addr)
+		_assert(err == nil, "failed to connect unix socket")
+	}
+}
diff --git a/gee-rpc/day7-registry/codec/codec.go b/gee-rpc/day7-registry/codec/codec.go
new file mode 100644
index 0000000..20b6ba7
--- /dev/null
+++ b/gee-rpc/day7-registry/codec/codec.go
@@ -0,0 +1,34 @@
+package codec
+
+import (
+	"io"
+)
+
+type Header struct {
+	ServiceMethod string // format "Service.Method"
+	Seq           uint64 // sequence number chosen by client
+	Error         string
+}
+
+type Codec interface {
+	io.Closer
+	ReadHeader(*Header) error
+	ReadBody(interface{}) error
+	Write(*Header, interface{}) error
+}
+
+type NewCodecFunc func(io.ReadWriteCloser) Codec
+
+type Type string
+
+const (
+	GobType  Type = "application/gob"
+	JsonType Type = "application/json" // not implemented
+)
+
+var NewCodecFuncMap map[Type]NewCodecFunc
+
+func init() {
+	NewCodecFuncMap = make(map[Type]NewCodecFunc)
+	NewCodecFuncMap[GobType] = NewGobCodec
+}
diff --git a/gee-rpc/day7-registry/codec/gob.go b/gee-rpc/day7-registry/codec/gob.go
new file mode 100644
index 0000000..808d97b
--- /dev/null
+++ b/gee-rpc/day7-registry/codec/gob.go
@@ -0,0 +1,57 @@
+package codec
+
+import (
+	"bufio"
+	"encoding/gob"
+	"io"
+	"log"
+)
+
+type GobCodec struct {
+	conn io.ReadWriteCloser
+	buf  *bufio.Writer
+	dec  *gob.Decoder
+	enc  *gob.Encoder
+}
+
+var _ Codec = (*GobCodec)(nil)
+
+func NewGobCodec(conn io.ReadWriteCloser) Codec {
+	buf := bufio.NewWriter(conn)
+	return &GobCodec{
+		conn: conn,
+		buf:  buf,
+		dec:  gob.NewDecoder(conn),
+		enc:  gob.NewEncoder(buf),
+	}
+}
+
+func (c *GobCodec) ReadHeader(h *Header) error {
+	return c.dec.Decode(h)
+}
+
+func (c *GobCodec) ReadBody(body interface{}) error {
+	return c.dec.Decode(body)
+}
+
+func (c *GobCodec) Write(h *Header, body interface{}) (err error) {
+	defer func() {
+		_ = c.buf.Flush()
+		if err != nil {
+			_ = c.Close()
+		}
+	}()
+	if err := c.enc.Encode(h); err != nil {
+		log.Println("rpc: gob error encoding header:", err)
+		return err
+	}
+	if err := c.enc.Encode(body); err != nil {
+		log.Println("rpc: gob error encoding body:", err)
+		return err
+	}
+	return nil
+}
+
+func (c *GobCodec) Close() error {
+	return c.conn.Close()
+}
diff --git a/gee-rpc/day7-registry/debug.go b/gee-rpc/day7-registry/debug.go
new file mode 100644
index 0000000..ece1ffd
--- /dev/null
+++ b/gee-rpc/day7-registry/debug.go
@@ -0,0 +1,60 @@
+// Copyright 2009 The Go Authors. All rights reserved.
+// Use of this source code is governed by a BSD-style
+// license that can be found in the LICENSE file.
+
+package geerpc
+
+import (
+	"fmt"
+	"html/template"
+	"net/http"
+)
+
+const debugText = `<html>
+	<body>
+	<title>GeeRPC Services</title>
+	{{range .}}
+	<hr>
+	Service {{.Name}}
+	<hr>
+		<table>
+		<th align=center>Method</th><th align=center>Calls</th>
+		{{range $name, $mtype := .Method}}
+			<tr>
+			<td align=left font=fixed>{{$name}}({{$mtype.ArgType}}, {{$mtype.ReplyType}}) error</td>
+			<td align=center>{{$mtype.NumCalls}}</td>
+			</tr>
+		{{end}}
+		</table>
+	{{end}}
+	</body>
+	</html>`
+
+var debug = template.Must(template.New("RPC debug").Parse(debugText))
+
+type debugHTTP struct {
+	*Server
+}
+
+type debugService struct {
+	Name   string
+	Method map[string]*methodType
+}
+
+// Runs at /debug/geerpc
+func (server debugHTTP) ServeHTTP(w http.ResponseWriter, req *http.Request) {
+	// Build a sorted version of the data.
+	var services []debugService
+	server.serviceMap.Range(func(namei, svci interface{}) bool {
+		svc := svci.(*service)
+		services = append(services, debugService{
+			Name:   namei.(string),
+			Method: svc.method,
+		})
+		return true
+	})
+	err := debug.Execute(w, services)
+	if err != nil {
+		_, _ = fmt.Fprintln(w, "rpc: error executing template:", err.Error())
+	}
+}
diff --git a/gee-rpc/day7-registry/go.mod b/gee-rpc/day7-registry/go.mod
new file mode 100644
index 0000000..0ec8aeb
--- /dev/null
+++ b/gee-rpc/day7-registry/go.mod
@@ -0,0 +1,3 @@
+module geerpc
+
+go 1.13
diff --git a/gee-rpc/day7-registry/main/main.go b/gee-rpc/day7-registry/main/main.go
new file mode 100644
index 0000000..0776312
--- /dev/null
+++ b/gee-rpc/day7-registry/main/main.go
@@ -0,0 +1,112 @@
+package main
+
+import (
+	"context"
+	"geerpc"
+	registy "geerpc/registry"
+	"geerpc/xclient"
+	"log"
+	"net"
+	"net/http"
+	"sync"
+	"time"
+)
+
+type Foo int
+
+type Args struct{ Num1, Num2 int }
+
+func (f Foo) Sum(args Args, reply *int) error {
+	*reply = args.Num1 + args.Num2
+	return nil
+}
+
+func (f Foo) Sleep(args Args, reply *int) error {
+	time.Sleep(time.Second * time.Duration(args.Num1))
+	*reply = args.Num1 + args.Num2
+	return nil
+}
+
+func startRegistry(wg *sync.WaitGroup) {
+	l, _ := net.Listen("tcp", ":9999")
+	registy.HandleHTTP()
+	wg.Done()
+	_ = http.Serve(l, nil)
+}
+
+func startServer(registry string, wg *sync.WaitGroup) {
+	var foo Foo
+	l, _ := net.Listen("tcp", ":0")
+	server := geerpc.NewServer()
+	_ = server.Register(&foo)
+	registy.Heartbeat(registry, "tcp@"+l.Addr().String(), 0)
+	wg.Done()
+	server.Accept(l)
+}
+
+func foo(xc *xclient.XClient, ctx context.Context, typ, serviceMethod string, args *Args) {
+	var reply int
+	var err error
+	switch typ {
+	case "call":
+		err = xc.Call(ctx, serviceMethod, args, &reply)
+	case "broadcast":
+		err = xc.Broadcast(ctx, serviceMethod, args, &reply)
+	}
+	if err != nil {
+		log.Printf("%s %s error: %v", typ, serviceMethod, err)
+	} else {
+		log.Printf("%s Foo.Sum success: %d + %d = %d", typ, args.Num1, args.Num2, reply)
+	}
+}
+
+func call(registry string) {
+	d := xclient.NewGeeRegistryDiscovery(registry, 0)
+	xc := xclient.NewXClient(d, xclient.RandomSelect, nil)
+	defer func() { _ = xc.Close() }()
+	// send request & receive response
+	var wg sync.WaitGroup
+	for i := 0; i < 5; i++ {
+		wg.Add(1)
+		go func(i int) {
+			defer wg.Done()
+			foo(xc, context.Background(), "call", "Foo.Sum", &Args{Num1: i, Num2: i * i})
+		}(i)
+	}
+	wg.Wait()
+}
+
+func broadcast(registry string) {
+	d := xclient.NewGeeRegistryDiscovery(registry, 0)
+	xc := xclient.NewXClient(d, xclient.RandomSelect, nil)
+	var wg sync.WaitGroup
+	for i := 0; i < 5; i++ {
+		wg.Add(1)
+		go func(i int) {
+			defer wg.Done()
+			foo(xc, context.Background(), "broadcast", "Foo.Sum", &Args{Num1: i, Num2: i * i})
+			// expect 2 - 5 timeout
+			ctx, _ := context.WithTimeout(context.Background(), time.Second*2)
+			foo(xc, ctx, "broadcast", "Foo.Sleep", &Args{Num1: i, Num2: i * i})
+		}(i)
+	}
+	wg.Wait()
+}
+
+func main() {
+	registryAddr := "http://localhost:9999/_geerpc_/registry"
+	var wg sync.WaitGroup
+	wg.Add(1)
+	go startRegistry(&wg)
+	wg.Wait()
+
+	time.Sleep(time.Second)
+	wg.Add(2)
+	go startServer(registryAddr, &wg)
+	go startServer(registryAddr, &wg)
+	wg.Wait()
+
+	time.Sleep(time.Second)
+	call(registryAddr)
+	broadcast(registryAddr)
+}
diff --git a/gee-rpc/day7-registry/registry/registry.go b/gee-rpc/day7-registry/registry/registry.go
new file mode 100644
index 0000000..0d50b4d
--- /dev/null
+++ b/gee-rpc/day7-registry/registry/registry.go
@@ -0,0 +1,123 @@
+package registy
+
+import (
+	"log"
+	"net/http"
+	"strings"
+	"sync"
+	"time"
+)
+
+// Registry is a simple register center, provide following functions.
+// add a server and receive heartbeat to keep it alive.
+// returns all alive servers and delete dead servers sync simultaneously.
+type Registry struct {
+	timeout time.Duration
+	mu      sync.Mutex // protect following
+	servers map[string]*ServerItem
+}
+
+type ServerItem struct {
+	Addr  string
+	start time.Time
+}
+
+// New create a registry instance with timeout setting
+func New(timeout time.Duration) *Registry {
+	return &Registry{
+		servers: make(map[string]*ServerItem),
+		timeout: timeout,
+	}
+}
+
+var DefaultRegister = New(defaultTimeout)
+
+func (r *Registry) putServer(addr string) {
+	r.mu.Lock()
+	defer r.mu.Unlock()
+	s := r.servers[addr]
+	if s == nil {
+		r.servers[addr] = &ServerItem{Addr: addr, start: time.Now()}
+	} else {
+		s.start = time.Now() // if exists, update start time to keep alive
+	}
+}
+
+func (r *Registry) aliveServers() []string {
+	r.mu.Lock()
+	defer r.mu.Unlock()
+	var alive []string
+	for addr, s := range r.servers {
+		if r.timeout == 0 || s.start.Add(r.timeout).After(time.Now()) {
+			alive = append(alive, addr)
+		} else {
+			delete(r.servers, addr)
+		}
+	}
+	return alive
+}
+
+const (
+	defaultPath    = "/_geerpc_/registry"
+	defaultTimeout = time.Minute * 5
+)
+
+// Runs at /_geerpc_/registry
+func (r *Registry) ServeHTTP(w http.ResponseWriter, req *http.Request) {
+	switch req.Method {
+	case "GET":
+		// keep it simple, server is in req.Header
+		w.Header().Set("X-Geerpc-Servers", strings.Join(r.aliveServers(), ","))
+	case "POST":
+		// keep it simple, server is in req.Header
+		addr := req.Header.Get("X-Geerpc-Server")
+		if addr == "" {
+			w.WriteHeader(http.StatusInternalServerError)
+			return
+		}
+		r.putServer(addr)
+	default:
+		w.WriteHeader(http.StatusMethodNotAllowed)
+	}
+}
+
+// HandleHTTP registers an HTTP handler for Registry messages on registryPath
+func (r *Registry) HandleHTTP(registryPath string) {
+	http.Handle(registryPath, r)
+	log.Println("rpc registry path:", registryPath)
+}
+
+func HandleHTTP() {
+	DefaultRegister.HandleHTTP(defaultPath)
+}
+
+// Heartbeat send a heartbeat message every once in a while
+// it's a helper function for a server to register or send heartbeat
+func Heartbeat(registry, addr string, duration time.Duration) {
+	if duration == 0 {
+		// make sure there is enough time to send heart beat
+		// before it's removed from registry
+		duration = defaultTimeout - time.Duration(1)*time.Minute
+	}
+	var err error
+	err = sendHeartbeat(registry, addr)
+	go func() {
+		t := time.NewTicker(duration)
+		for err == nil {
+			<-t.C
+			err = sendHeartbeat(registry, addr)
+		}
+	}()
+}
+
+func sendHeartbeat(registry, addr string) error {
+	log.Println(addr, "send heart beat to registry")
+	httpClient := &http.Client{}
+	req, _ := http.NewRequest("POST", registry, nil)
+	req.Header.Set("X-Geerpc-Server", addr)
+	if _, err := httpClient.Do(req); err != nil {
+		log.Println("rpc server: heart beat err:", err)
+		return err
+	}
+	return nil
+}
diff --git a/gee-rpc/day7-registry/server.go b/gee-rpc/day7-registry/server.go
new file mode 100644
index 0000000..38fad20
--- /dev/null
+++ b/gee-rpc/day7-registry/server.go
@@ -0,0 +1,266 @@
+// Copyright 2009 The Go Authors. All rights reserved.
+// Use of this source code is governed by a BSD-style
+// license that can be found in the LICENSE file.
+
+package geerpc
+
+import (
+	"encoding/json"
+	"errors"
+	"fmt"
+	"geerpc/codec"
+	"io"
+	"log"
+	"net"
+	"net/http"
+	"reflect"
+	"strings"
+	"sync"
+	"time"
+)
+
+const MagicNumber = 0x3bef5c
+
+type Option struct {
+	MagicNumber    int           // MagicNumber marks this's a geerpc request
+	CodecType      codec.Type    // client may choose different Codec to encode body
+	ConnectTimeout time.Duration // 0 means no limit
+	HandleTimeout  time.Duration
+}
+
+var DefaultOption = &Option{
+	MagicNumber:    MagicNumber,
+	CodecType:      codec.GobType,
+	ConnectTimeout: time.Second * 10,
+}
+
+// Server represents an RPC Server.
+type Server struct {
+	serviceMap sync.Map
+}
+
+// NewServer returns a new Server.
+func NewServer() *Server {
+	return &Server{}
+}
+
+// DefaultServer is the default instance of *Server.
+var DefaultServer = NewServer()
+
+// ServeConn runs the server on a single connection.
+// ServeConn blocks, serving the connection until the client hangs up.
+func (server *Server) ServeConn(conn io.ReadWriteCloser) {
+	defer func() { _ = conn.Close() }()
+	var opt Option
+	if err := json.NewDecoder(conn).Decode(&opt); err != nil {
+		log.Println("rpc server: options error: ", err)
+		return
+	}
+	if opt.MagicNumber != MagicNumber {
+		log.Printf("rpc server: invalid magic number %x", opt.MagicNumber)
+		return
+	}
+	f := codec.NewCodecFuncMap[opt.CodecType]
+	if f == nil {
+		log.Printf("rpc server: invalid codec type %s", opt.CodecType)
+		return
+	}
+	server.serveCodec(f(conn), &opt)
+}
+
+// invalidRequest is a placeholder for response argv when error occurs
+var invalidRequest = struct{}{}
+
+func (server *Server) serveCodec(cc codec.Codec, opt *Option) {
+	sending := new(sync.Mutex) // make sure to send a complete response
+	wg := new(sync.WaitGroup)  // wait until all request are handled
+	for {
+		req, err := server.readRequest(cc)
+		if err != nil {
+			if req == nil {
+				break // it's not possible to recover, so close the connection
+			}
+			req.h.Error = err.Error()
+			server.sendResponse(cc, req.h, invalidRequest, sending)
+			continue
+		}
+		wg.Add(1)
+		go server.handleRequest(cc, req, sending, wg, opt.HandleTimeout)
+	}
+	wg.Wait()
+	_ = cc.Close()
+}
+
+// request stores all information of a call
+type request struct {
+	h            *codec.Header // header of request
+	argv, replyv reflect.Value // argv and replyv of request
+	mtype        *methodType
+	svc          *service
+}
+
+func (server *Server) readRequestHeader(cc codec.Codec) (*codec.Header, error) {
+	var h codec.Header
+	if err := cc.ReadHeader(&h); err != nil {
+		if err != io.EOF && err != io.ErrUnexpectedEOF {
+			log.Println("rpc server: read header error:", err)
+		}
+		return nil, err
+	}
+	return &h, nil
+}
+
+func (server *Server) findService(serviceMethod string) (svc *service, mtype *methodType, err error) {
+	dot := strings.LastIndex(serviceMethod, ".")
+	if dot < 0 {
+		err = errors.New("rpc server: service/method request ill-formed: " + serviceMethod)
+		return
+	}
+	serviceName, methodName := serviceMethod[:dot], serviceMethod[dot+1:]
+	svci, ok := server.serviceMap.Load(serviceName)
+	if !ok {
+		err = errors.New("rpc server: can't find service " + serviceName)
+		return
+	}
+	svc = svci.(*service)
+	mtype = svc.method[methodName]
+	if mtype == nil {
+		err = errors.New("rpc server: can't find method " + methodName)
+	}
+	return
+}
+
+func (server *Server) readRequest(cc codec.Codec) (*request, error) {
+	h, err := server.readRequestHeader(cc)
+	if err != nil {
+		return nil, err
+	}
+	req := &request{h: h}
+	req.svc, req.mtype, err = server.findService(h.ServiceMethod)
+	if err != nil {
+		return req, err
+	}
+	req.argv = req.mtype.newArgv()
+	req.replyv = req.mtype.newReplyv()
+
+	// make sure that argvi is a pointer, ReadBody need a pointer as parameter
+	argvi := req.argv.Interface()
+	if req.argv.Type().Kind() != reflect.Ptr {
+		argvi = req.argv.Addr().Interface()
+	}
+	if err = cc.ReadBody(argvi); err != nil {
+		log.Println("rpc server: read body err:", err)
+		return req, err
+	}
+	return req, nil
+}
+
+func (server *Server) sendResponse(cc codec.Codec, h *codec.Header, body interface{}, sending *sync.Mutex) {
+	sending.Lock()
+	defer sending.Unlock()
+	if err := cc.Write(h, body); err != nil {
+		log.Println("rpc server: write response error:", err)
+	}
+}
+
+func (server *Server) handleRequest(cc codec.Codec, req *request, sending *sync.Mutex, wg *sync.WaitGroup, timeout time.Duration) {
+	defer wg.Done()
+	called := make(chan struct{})
+	sent := make(chan struct{})
+	go func() {
+		err := req.svc.call(req.mtype, req.argv, req.replyv)
+		called <- struct{}{}
+		if err != nil {
+			req.h.Error = err.Error()
+			server.sendResponse(cc, req.h, invalidRequest, sending)
+			sent <- struct{}{}
+			return
+		}
+		server.sendResponse(cc, req.h, req.replyv.Interface(), sending)
+		sent <- struct{}{}
+	}()
+
+	if timeout == 0 {
+		<-called
+		<-sent
+		return
+	}
+	select {
+	case <-time.After(timeout):
+		req.h.Error = fmt.Sprintf("rpc server: request handle timeout: expect within %s", timeout)
+		server.sendResponse(cc, req.h, invalidRequest, sending)
+	case <-called:
+		<-sent
+	}
+}
+
+// Accept accepts connections on the listener and serves requests
+// for each incoming connection.
+func (server *Server) Accept(lis net.Listener) {
+	for {
+		conn, err := lis.Accept()
+		if err != nil {
+			log.Println("rpc server: accept error:", err)
+			return
+		}
+		go server.ServeConn(conn)
+	}
+}
+
+// Accept accepts connections on the listener and serves requests
+// for each incoming connection.
+func Accept(lis net.Listener) { DefaultServer.Accept(lis) }
+
+// Register publishes in the server the set of methods of the
+// receiver value that satisfy the following conditions:
+//	- exported method of exported type
+//	- two arguments, both of exported type
+//	- the second argument is a pointer
+//	- one return value, of type error
+func (server *Server) Register(rcvr interface{}) error {
+	s := newService(rcvr)
+	if _, dup := server.serviceMap.LoadOrStore(s.name, s); dup {
+		return errors.New("rpc: service already defined: " + s.name)
+	}
+	return nil
+}
+
+// Register publishes the receiver's methods in the DefaultServer.
+func Register(rcvr interface{}) error { return DefaultServer.Register(rcvr) }
+
+const (
+	connected        = "200 Connected to Gee RPC"
+	defaultRPCPath   = "/_geeprc_"
+	defaultDebugPath = "/debug/geerpc"
+)
+
+// ServeHTTP implements an http.Handler that answers RPC requests.
+func (server *Server) ServeHTTP(w http.ResponseWriter, req *http.Request) {
+	if req.Method != "CONNECT" {
+		w.Header().Set("Content-Type", "text/plain; charset=utf-8")
+		w.WriteHeader(http.StatusMethodNotAllowed)
+		_, _ = io.WriteString(w, "405 must CONNECT\n")
+		return
+	}
+	conn, _, err := w.(http.Hijacker).Hijack()
+	if err != nil {
+		log.Print("rpc hijacking ", req.RemoteAddr, ": ", err.Error())
+		return
+	}
+	_, _ = io.WriteString(conn, "HTTP/1.0 "+connected+"\n\n")
+	server.ServeConn(conn)
+}
+
+// HandleHTTP registers an HTTP handler for RPC messages on rpcPath,
+// and a debugging handler on debugPath.
+// It is still necessary to invoke http.Serve(), typically in a go statement.
+func (server *Server) HandleHTTP() {
+	http.Handle(defaultRPCPath, server)
+	http.Handle(defaultDebugPath, debugHTTP{server})
+	log.Println("rpc server debug path:", defaultDebugPath)
+}
+
+// HandleHTTP is a convenient approach for default server to register HTTP handlers
+func HandleHTTP() {
+	DefaultServer.HandleHTTP()
+}
diff --git a/gee-rpc/day7-registry/service.go b/gee-rpc/day7-registry/service.go
new file mode 100644
index 0000000..306683c
--- /dev/null
+++ b/gee-rpc/day7-registry/service.go
@@ -0,0 +1,99 @@
+package geerpc
+
+import (
+	"go/ast"
+	"log"
+	"reflect"
+	"sync/atomic"
+)
+
+type methodType struct {
+	method    reflect.Method
+	ArgType   reflect.Type
+	ReplyType reflect.Type
+	numCalls  uint64
+}
+
+func (m *methodType) NumCalls() uint64 {
+	return atomic.LoadUint64(&m.numCalls)
+}
+
+func (m *methodType) newArgv() reflect.Value {
+	var argv reflect.Value
+	// arg may be a pointer type, or a value type
+	if m.ArgType.Kind() == reflect.Ptr {
+		argv = reflect.New(m.ArgType.Elem())
+	} else {
+		argv = reflect.New(m.ArgType).Elem()
+	}
+	return argv
+}
+
+func (m *methodType) newReplyv() reflect.Value {
+	// reply must be a pointer type
+	replyv := reflect.New(m.ReplyType.Elem())
+	switch m.ReplyType.Elem().Kind() {
+	case reflect.Map:
+		replyv.Elem().Set(reflect.MakeMap(m.ReplyType.Elem()))
+	case reflect.Slice:
+		replyv.Elem().Set(reflect.MakeSlice(m.ReplyType.Elem(), 0, 0))
+	}
+	return replyv
+}
+
+type service struct {
+	name   string
+	typ    reflect.Type
+	rcvr   reflect.Value
+	method map[string]*methodType
+}
+
+func newService(rcvr interface{}) *service {
+	s := new(service)
+	s.rcvr = reflect.ValueOf(rcvr)
+	s.name = reflect.Indirect(s.rcvr).Type().Name()
+	s.typ = reflect.TypeOf(rcvr)
+	if !ast.IsExported(s.name) {
+		log.Fatalf("rpc server: %s is not a valid service name", s.name)
+	}
+	s.registerMethods()
+	return s
+}
+
+func (s *service) registerMethods() {
+	s.method = make(map[string]*methodType)
+	for i := 0; i < s.typ.NumMethod(); i++ {
+		method := s.typ.Method(i)
+		mType := method.Type
+		if mType.NumIn() != 3 || mType.NumOut() != 1 {
+			continue
+		}
+		if mType.Out(0) != reflect.TypeOf((*error)(nil)).Elem() {
+			continue
+		}
+		argType, replyType := mType.In(1), mType.In(2)
+		if !isExportedOrBuiltinType(argType) || !isExportedOrBuiltinType(replyType) {
+			continue
+		}
+		s.method[method.Name] = &methodType{
+			method:    method,
+			ArgType:   argType,
+			ReplyType: replyType,
+		}
+		log.Printf("rpc server: register %s.%s\n", s.name, method.Name)
+	}
+}
+
+func (s *service) call(m *methodType, argv, replyv reflect.Value) error {
+	atomic.AddUint64(&m.numCalls, 1)
+	f := m.method.Func
+	returnValues := f.Call([]reflect.Value{s.rcvr, argv, replyv})
+	if errInter := returnValues[0].Interface(); errInter != nil {
+		return errInter.(error)
+	}
+	return nil
+}
+
+func isExportedOrBuiltinType(t reflect.Type) bool {
+	return ast.IsExported(t.Name()) || t.PkgPath() == ""
+}
diff --git a/gee-rpc/day7-registry/service_test.go b/gee-rpc/day7-registry/service_test.go
new file mode 100644
index 0000000..c8266df
--- /dev/null
+++ b/gee-rpc/day7-registry/service_test.go
@@ -0,0 +1,48 @@
+package geerpc
+
+import (
+	"fmt"
+	"reflect"
+	"testing"
+)
+
+type Foo int
+
+type Args struct{ Num1, Num2 int }
+
+func (f Foo) Sum(args Args, reply *int) error {
+	*reply = args.Num1 + args.Num2
+	return nil
+}
+
+// it's not a exported Method
+func (f Foo) sum(args Args, reply *int) error {
+	*reply = args.Num1 + args.Num2
+	return nil
+}
+
+func _assert(condition bool, msg string, v ...interface{}) {
+	if !condition {
+		panic(fmt.Sprintf("assertion failed: "+msg, v...))
+	}
+}
+
+func TestNewService(t *testing.T) {
+	var foo Foo
+	s := newService(&foo)
+	_assert(len(s.method) == 1, "wrong service Method, expect 1, but got %d", len(s.method))
+	mType := s.method["Sum"]
+	_assert(mType != nil, "wrong Method, Sum shouldn't nil")
+}
+
+func TestMethodType_Call(t *testing.T) {
+	var foo Foo
+	s := newService(&foo)
+	mType := s.method["Sum"]
+
+	argv := mType.newArgv()
+	replyv := mType.newReplyv()
+	argv.Set(reflect.ValueOf(Args{Num1: 1, Num2: 3}))
+	err := s.call(mType, argv, replyv)
+	_assert(err == nil && *replyv.Interface().(*int) == 4 && mType.NumCalls() == 1, "failed to call Foo.Sum")
+}
diff --git a/gee-rpc/day7-registry/xclient/discovery.go b/gee-rpc/day7-registry/xclient/discovery.go
new file mode 100644
index 0000000..f823a7b
--- /dev/null
+++ b/gee-rpc/day7-registry/xclient/discovery.go
@@ -0,0 +1,83 @@
+package xclient
+
+import (
+	"errors"
+	"math/rand"
+	"sync"
+	"time"
+)
+
+type SelectMode int
+
+const (
+	RandomSelect     SelectMode = iota // select randomly
+	RoundRobinSelect                   // select using Robbin algorithm
+)
+
+type Discovery interface {
+	Refresh() error // refresh from remote registry
+	Update(servers []string) error
+	Get(mode SelectMode) (string, error)
+	GetAll() ([]string, error)
+}
+
+var _ Discovery = (*MultiServersDiscovery)(nil)
+
+// MultiServersDiscovery is a discovery for multi servers without a registry center
+// user provides the server addresses explicitly instead
+type MultiServersDiscovery struct {
+	r       *rand.Rand   // generate random number
+	mu      sync.RWMutex // protect following
+	servers []string
+	index   int // record the selected position for robin algorithm
+}
+
+// Refresh doesn't make sense for MultiServersDiscovery, so ignore it
+func (d *MultiServersDiscovery) Refresh() error {
+	return nil
+}
+
+// Update the servers of discovery dynamically if needed
+func (d *MultiServersDiscovery) Update(servers []string) error {
+	d.mu.Lock()
+	defer d.mu.Unlock()
+	d.servers = servers
+	return nil
+}
+
+// Get a server according to mode
+func (d *MultiServersDiscovery) Get(mode SelectMode) (string, error) {
+	d.mu.Lock()
+	defer d.mu.Unlock()
+	if len(d.servers) == 0 {
+		return "", errors.New("rpc discovery: no available servers")
+	}
+	switch mode {
+	case RandomSelect:
+		return d.servers[d.r.Intn(len(d.servers))], nil
+	case RoundRobinSelect:
+		s := d.servers[d.index]
+		d.index = (d.index + 1) % len(d.servers)
+		return s, nil
+	default:
+		return "", errors.New("rpc discovery: not supported select mode")
+	}
+}
+
+// returns all servers in discovery
+func (d *MultiServersDiscovery) GetAll() ([]string, error) {
+	d.mu.RLock()
+	defer d.mu.RUnlock()
+	// return a copy of d.servers
+	servers := make([]string, len(d.servers), len(d.servers))
+	copy(servers, d.servers)
+	return servers, nil
+}
+
+// NewMultiServerDiscovery creates a MultiServersDiscovery instance
+func NewMultiServerDiscovery(servers []string) *MultiServersDiscovery {
+	return &MultiServersDiscovery{
+		servers: servers,
+		r:       rand.New(rand.NewSource(time.Now().UnixNano())),
+	}
+}
diff --git a/gee-rpc/day7-registry/xclient/discovery_gee.go b/gee-rpc/day7-registry/xclient/discovery_gee.go
new file mode 100644
index 0000000..865c30e
--- /dev/null
+++ b/gee-rpc/day7-registry/xclient/discovery_gee.go
@@ -0,0 +1,74 @@
+package xclient
+
+import (
+	"log"
+	"net/http"
+	"strings"
+	"time"
+)
+
+type GeeRegistryDiscovery struct {
+	*MultiServersDiscovery
+	registry   string
+	timeout    time.Duration
+	lastUpdate time.Time
+}
+
+const defaultUpdateTimeout = time.Second * 10
+
+func (d *GeeRegistryDiscovery) Update(servers []string) error {
+	d.mu.Lock()
+	defer d.mu.Unlock()
+	d.servers = servers
+	d.lastUpdate = time.Now()
+	return nil
+}
+
+func (d *GeeRegistryDiscovery) Refresh() error {
+	d.mu.Lock()
+	defer d.mu.Unlock()
+	if d.lastUpdate.Add(d.timeout).After(time.Now()) {
+		return nil
+	}
+	log.Println("rpc registry: refresh servers from registry", d.registry)
+	resp, err := http.Get(d.registry)
+	if err != nil {
+		log.Println("rpc registry refresh err:", err)
+		return err
+	}
+	servers := strings.Split(resp.Header.Get("X-Geerpc-Servers"), ",")
+	d.servers = make([]string, 0, len(servers))
+	for _, server := range servers {
+		if strings.TrimSpace(server) != "" {
+			d.servers = append(d.servers, strings.TrimSpace(server))
+		}
+	}
+	d.lastUpdate = time.Now()
+	return nil
+}
+
+func (d *GeeRegistryDiscovery) Get(mode SelectMode) (string, error) {
+	if err := d.Refresh(); err != nil {
+		return "", err
+	}
+	return d.MultiServersDiscovery.Get(mode)
+}
+
+func (d *GeeRegistryDiscovery) GetAll() ([]string, error) {
+	if err := d.Refresh(); err != nil {
+		return nil, err
+	}
+	return d.MultiServersDiscovery.GetAll()
+}
+
+func NewGeeRegistryDiscovery(registerAddr string, timeout time.Duration) *GeeRegistryDiscovery {
+	if timeout == 0 {
+		timeout = defaultUpdateTimeout
+	}
+	d := &GeeRegistryDiscovery{
+		MultiServersDiscovery: NewMultiServerDiscovery(make([]string, 0)),
+		registry:              registerAddr,
+		timeout:               timeout,
+	}
+	return d
+}
diff --git a/gee-rpc/day7-registry/xclient/xclient.go b/gee-rpc/day7-registry/xclient/xclient.go
new file mode 100644
index 0000000..838b343
--- /dev/null
+++ b/gee-rpc/day7-registry/xclient/xclient.go
@@ -0,0 +1,109 @@
+package xclient
+
+import (
+	"context"
+	. "geerpc"
+	"io"
+	"reflect"
+	"sync"
+)
+
+type XClient struct {
+	d       Discovery
+	mode    SelectMode
+	opt     *Option
+	mu      sync.Mutex // protect following
+	clients map[string]*Client
+}
+
+var _ io.Closer = (*XClient)(nil)
+
+func NewXClient(d Discovery, mode SelectMode, opt *Option) *XClient {
+	return &XClient{d: d, mode: mode, opt: opt, clients: make(map[string]*Client)}
+}
+
+func (xc *XClient) Close() error {
+	xc.mu.Lock()
+	defer xc.mu.Unlock()
+	for key, client := range xc.clients {
+		// I have no idea how to deal with error, just ignore it.
+		_ = client.Close()
+		delete(xc.clients, key)
+	}
+	return nil
+}
+
+func (xc *XClient) dial(rpcAddr string) (*Client, error) {
+	xc.mu.Lock()
+	defer xc.mu.Unlock()
+	client, ok := xc.clients[rpcAddr]
+	if ok && !client.IsAvailable() {
+		_ = client.Close()
+		delete(xc.clients, rpcAddr)
+		client = nil
+	}
+	if client == nil {
+		var err error
+		client, err = XDial(rpcAddr, xc.opt)
+		if err != nil {
+			return nil, err
+		}
+		xc.clients[rpcAddr] = client
+	}
+	return client, nil
+}
+
+func (xc *XClient) call(rpcAddr string, ctx context.Context, serviceMethod string, args, reply interface{}) error {
+	client, err := xc.dial(rpcAddr)
+	if err != nil {
+		return err
+	}
+	return client.Call(ctx, serviceMethod, args, reply)
+}
+
+// Call invokes the named function, waits for it to complete,
+// and returns its error status.
+// xc will choose a proper server.
+func (xc *XClient) Call(ctx context.Context, serviceMethod string, args, reply interface{}) error {
+	rpcAddr, err := xc.d.Get(xc.mode)
+	if err != nil {
+		return err
+	}
+	return xc.call(rpcAddr, ctx, serviceMethod, args, reply)
+}
+
+// Broadcast invokes the named function for every server registered in discovery
+func (xc *XClient) Broadcast(ctx context.Context, serviceMethod string, args, reply interface{}) error {
+	servers, err := xc.d.GetAll()
+	if err != nil {
+		return err
+	}
+	var wg sync.WaitGroup
+	var mu sync.Mutex // protect e and replyDone
+	var e error
+	replyDone := reply == nil // if reply is nil, don't need to set value
+	ctx, cancel := context.WithCancel(ctx)
+	for _, rpcAddr := range servers {
+		wg.Add(1)
+		go func() {
+			defer wg.Done()
+			var clonedReply interface{}
+			if reply != nil {
+				clonedReply = reflect.New(reflect.ValueOf(reply).Elem().Type()).Interface()
+			}
+			err := xc.call(rpcAddr, ctx, serviceMethod, args, clonedReply)
+			mu.Lock()
+			if err != nil && e == nil {
+				e = err
+				cancel() // if any call failed, cancel unfinished calls
+			}
+			if err == nil && !replyDone {
+				reflect.ValueOf(reply).Elem().Set(reflect.ValueOf(clonedReply).Elem())
+				replyDone = true
+			}
+			mu.Unlock()
+		}()
+	}
+	wg.Wait()
+	return e
+}

From c5797482a91ec9c457cbf3b48b4538f38b684f3e Mon Sep 17 00:00:00 2001
From: gzdaijie <gzdaijie@gmail.com>
Date: Mon, 5 Oct 2020 21:15:32 +0800
Subject: [PATCH 086/122] README.md: add RPC Framework title for geerpc

---
 README.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/README.md b/README.md
index c2d9d02..ff6b021 100644
--- a/README.md
+++ b/README.md
@@ -118,6 +118,8 @@ Xorm's desgin is easier to understand than gorm-v1, so the main designs referenc
 - Day 6 - Support Transaction | [Code](gee-orm/day6-transaction)
 - Day 7 - Migrate Database | [Code](gee-orm/day7-migrate)
 
+## RPC Framework - GeeRPC
+
 [GeeRPC](https://geektutu.com/post/geerpc.html) is a [net/rpc](https://github.com/golang/go/tree/master/src/net/rpc)-like RPC framework
 
 Based on golang standard library `net/rpc`, GeeRPC implements more features. eg, protocol exchange, service registration and discovery, load balance, etc.

From b5c91b0ceefc5da0b6813f753e229d446a5ab860 Mon Sep 17 00:00:00 2001
From: gzdaijie <gzdaijie@gmail.com>
Date: Tue, 6 Oct 2020 19:27:02 +0800
Subject: [PATCH 087/122] gee-web/day6 fix formatAsDate in go 1.15 issue #19

---
 gee-web/README.md                                | 4 ++--
 gee-web/day6-template/main.go                    | 4 ++--
 gee-web/day6-template/templates/custom_func.tmpl | 2 +-
 gee-web/doc/gee-day6.md                          | 4 ++--
 4 files changed, 7 insertions(+), 7 deletions(-)

diff --git a/gee-web/README.md b/gee-web/README.md
index 6e8f19b..d56ed8d 100644
--- a/gee-web/README.md
+++ b/gee-web/README.md
@@ -168,7 +168,7 @@ type student struct {
 	Age  int8
 }
 
-func formatAsDate(t time.Time) string {
+func FormatAsDate(t time.Time) string {
 	year, month, day := t.Date()
 	return fmt.Sprintf("%d-%02d-%02d", year, month, day)
 }
@@ -177,7 +177,7 @@ func main() {
 	r := gee.New()
 	r.Use(gee.Logger())
 	r.SetFuncMap(template.FuncMap{
-		"formatAsDate": formatAsDate,
+		"FormatAsDate": FormatAsDate,
 	})
 	r.LoadHTMLGlob("templates/*")
 	r.Static("/assets", "./static")
diff --git a/gee-web/day6-template/main.go b/gee-web/day6-template/main.go
index 79b89bc..dea17b2 100644
--- a/gee-web/day6-template/main.go
+++ b/gee-web/day6-template/main.go
@@ -47,7 +47,7 @@ type student struct {
 	Age  int8
 }
 
-func formatAsDate(t time.Time) string {
+func FormatAsDate(t time.Time) string {
 	year, month, day := t.Date()
 	return fmt.Sprintf("%d-%02d-%02d", year, month, day)
 }
@@ -56,7 +56,7 @@ func main() {
 	r := gee.New()
 	r.Use(gee.Logger())
 	r.SetFuncMap(template.FuncMap{
-		"formatAsDate": formatAsDate,
+		"FormatAsDate": FormatAsDate,
 	})
 	r.LoadHTMLGlob("templates/*")
 	r.Static("/assets", "./static")
diff --git a/gee-web/day6-template/templates/custom_func.tmpl b/gee-web/day6-template/templates/custom_func.tmpl
index 2d50a8e..c267ebd 100644
--- a/gee-web/day6-template/templates/custom_func.tmpl
+++ b/gee-web/day6-template/templates/custom_func.tmpl
@@ -2,7 +2,7 @@
 <html>
 <body>
     <p>hello, {{.title}}</p>
-    <p>Date: {{.now | formatAsDate}}</p>
+    <p>Date: {{.now | FormatAsDate}}</p>
 </body>
 </html>
 
diff --git a/gee-web/doc/gee-day6.md b/gee-web/doc/gee-day6.md
index be0b0fe..a95d578 100644
--- a/gee-web/doc/gee-day6.md
+++ b/gee-web/doc/gee-day6.md
@@ -169,7 +169,7 @@ type student struct {
 	Age  int8
 }
 
-func formatAsDate(t time.Time) string {
+func FormatAsDate(t time.Time) string {
 	year, month, day := t.Date()
 	return fmt.Sprintf("%d-%02d-%02d", year, month, day)
 }
@@ -178,7 +178,7 @@ func main() {
 	r := gee.New()
 	r.Use(gee.Logger())
 	r.SetFuncMap(template.FuncMap{
-		"formatAsDate": formatAsDate,
+		"FormatAsDate": FormatAsDate,
 	})
 	r.LoadHTMLGlob("templates/*")
 	r.Static("/assets", "./static")

From d52a027256336052a79c7a8d72e8ae36e0e42921 Mon Sep 17 00:00:00 2001
From: gzdaijie <gzdaijie@gmail.com>
Date: Tue, 6 Oct 2020 19:38:27 +0800
Subject: [PATCH 088/122] gee-rpc/day7 use d.index to mode n to ensure safety

---
 gee-rpc/day7-registry/registry/registry.go | 2 ++
 gee-rpc/day7-registry/xclient/discovery.go | 9 +++++----
 2 files changed, 7 insertions(+), 4 deletions(-)

diff --git a/gee-rpc/day7-registry/registry/registry.go b/gee-rpc/day7-registry/registry/registry.go
index 0d50b4d..2c22244 100644
--- a/gee-rpc/day7-registry/registry/registry.go
+++ b/gee-rpc/day7-registry/registry/registry.go
@@ -3,6 +3,7 @@ package registy
 import (
 	"log"
 	"net/http"
+	"sort"
 	"strings"
 	"sync"
 	"time"
@@ -54,6 +55,7 @@ func (r *Registry) aliveServers() []string {
 			delete(r.servers, addr)
 		}
 	}
+	sort.Strings(alive)
 	return alive
 }
 
diff --git a/gee-rpc/day7-registry/xclient/discovery.go b/gee-rpc/day7-registry/xclient/discovery.go
index f823a7b..783ec4a 100644
--- a/gee-rpc/day7-registry/xclient/discovery.go
+++ b/gee-rpc/day7-registry/xclient/discovery.go
@@ -49,15 +49,16 @@ func (d *MultiServersDiscovery) Update(servers []string) error {
 func (d *MultiServersDiscovery) Get(mode SelectMode) (string, error) {
 	d.mu.Lock()
 	defer d.mu.Unlock()
-	if len(d.servers) == 0 {
+	n := len(d.servers)
+	if n == 0 {
 		return "", errors.New("rpc discovery: no available servers")
 	}
 	switch mode {
 	case RandomSelect:
-		return d.servers[d.r.Intn(len(d.servers))], nil
+		return d.servers[d.r.Intn(n)], nil
 	case RoundRobinSelect:
-		s := d.servers[d.index]
-		d.index = (d.index + 1) % len(d.servers)
+		s := d.servers[d.index%n] // servers could be updated, so mode n to ensure safety
+		d.index = (d.index + 1) % n
 		return s, nil
 	default:
 		return "", errors.New("rpc discovery: not supported select mode")

From 9a5edca9afd80c998347ebfe86aafe2a960f143f Mon Sep 17 00:00:00 2001
From: gzdaijie <gzdaijie@gmail.com>
Date: Tue, 6 Oct 2020 19:44:59 +0800
Subject: [PATCH 089/122] geerpc/day5 day6 day7: update the function
 description of XDial

---
 gee-rpc/day5-http-debug/client.go   | 4 +++-
 gee-rpc/day6-load-balance/client.go | 4 +++-
 gee-rpc/day7-registry/client.go     | 4 +++-
 3 files changed, 9 insertions(+), 3 deletions(-)

diff --git a/gee-rpc/day5-http-debug/client.go b/gee-rpc/day5-http-debug/client.go
index e9b4540..795a18b 100644
--- a/gee-rpc/day5-http-debug/client.go
+++ b/gee-rpc/day5-http-debug/client.go
@@ -306,7 +306,9 @@ func DialHTTP(network, address string, opts ...*Option) (*Client, error) {
 	return dialTimeout(dialHTTP, network, address, opts...)
 }
 
-// XDial use a general format to represent a rpc server
+// XDial calls different functions to connect to a RPC server
+// according the first parameter rpcAddr.
+// rpcAddr is a general format (protocol@addr) to represent a rpc server
 // eg, http@10.0.0.1:7001, tcp@10.0.0.1:9999, unix@/tmp/geerpc.sock
 func XDial(rpcAddr string, opts ...*Option) (*Client, error) {
 	parts := strings.Split(rpcAddr, "@")
diff --git a/gee-rpc/day6-load-balance/client.go b/gee-rpc/day6-load-balance/client.go
index e9b4540..795a18b 100644
--- a/gee-rpc/day6-load-balance/client.go
+++ b/gee-rpc/day6-load-balance/client.go
@@ -306,7 +306,9 @@ func DialHTTP(network, address string, opts ...*Option) (*Client, error) {
 	return dialTimeout(dialHTTP, network, address, opts...)
 }
 
-// XDial use a general format to represent a rpc server
+// XDial calls different functions to connect to a RPC server
+// according the first parameter rpcAddr.
+// rpcAddr is a general format (protocol@addr) to represent a rpc server
 // eg, http@10.0.0.1:7001, tcp@10.0.0.1:9999, unix@/tmp/geerpc.sock
 func XDial(rpcAddr string, opts ...*Option) (*Client, error) {
 	parts := strings.Split(rpcAddr, "@")
diff --git a/gee-rpc/day7-registry/client.go b/gee-rpc/day7-registry/client.go
index e9b4540..795a18b 100644
--- a/gee-rpc/day7-registry/client.go
+++ b/gee-rpc/day7-registry/client.go
@@ -306,7 +306,9 @@ func DialHTTP(network, address string, opts ...*Option) (*Client, error) {
 	return dialTimeout(dialHTTP, network, address, opts...)
 }
 
-// XDial use a general format to represent a rpc server
+// XDial calls different functions to connect to a RPC server
+// according the first parameter rpcAddr.
+// rpcAddr is a general format (protocol@addr) to represent a rpc server
 // eg, http@10.0.0.1:7001, tcp@10.0.0.1:9999, unix@/tmp/geerpc.sock
 func XDial(rpcAddr string, opts ...*Option) (*Client, error) {
 	parts := strings.Split(rpcAddr, "@")

From 03c85f7f987b62bfd85dfca78b4d2344083dca2f Mon Sep 17 00:00:00 2001
From: gzdaijie <gzdaijie@gmail.com>
Date: Tue, 6 Oct 2020 23:54:08 +0800
Subject: [PATCH 090/122] gee-rpc add doc

---
 gee-rpc/doc/geerpc.md         |  66 ++++++++++++++++++++++++++++++++++
 gee-rpc/doc/geerpc/geerpc.jpg | Bin 0 -> 32791 bytes
 2 files changed, 66 insertions(+)
 create mode 100644 gee-rpc/doc/geerpc.md
 create mode 100644 gee-rpc/doc/geerpc/geerpc.jpg

diff --git a/gee-rpc/doc/geerpc.md b/gee-rpc/doc/geerpc.md
new file mode 100644
index 0000000..9c49e6d
--- /dev/null
+++ b/gee-rpc/doc/geerpc.md
@@ -0,0 +1,66 @@
+---
+title: 7天用Go从零实现RPC框架GeeRPC
+date: 2020-10-06 16:00:00
+description: 7天用 Go语言/golang 从零实现 RPC 框架 GeeRPC 教程(7 days implement golang remote procedure call framework from scratch tutorial)，动手写 RPC 框架，参照 golang标准库 net/rpc 的实现，实现了服务端(server)、支持异步和并发的客户端(client)、消息编码与解码(message encoding and decoding)、服务注册(service register)、支持 TCP/Unix/HTTP 等多种传输协议。并在此基础上新增了协议交换(protocol exchange)、注册中心(registry)、服务发现(service discovery)、负载均衡(load balance)、超时处理(timeout processing)等特性。
+tags:
+- Go
+nav: 从零实现
+categories:
+- RPC框架 - GeeRPC
+keywords:
+- Go语言
+- 从零实现RPC框架
+- 动手写RPC框架
+- 服务注册与发现
+- 负载均衡
+image: post/geerpc/geerpc.jpg
+github: https://github.com/geektutu/7days-golang
+---
+
+![golang RPC framework](geerpc/geerpc.jpg)
+
+## 1 谈谈 RPC 框架
+
+RPC(Remote Procedure Call，远程过程调用)是一种计算机通信协议，允许调用不同进程空间的程序。RPC 的客户端和服务器可以在一台机器上，也可以在不同的机器上。程序员使用时，就像调用本地程序一样，无需关注内部的实现细节。
+
+不同的应用程序之间的通信方式有很多，比如浏览器和服务器之间广泛使用的基于 HTTP 协议的 Restful API。与 RPC 相比，Restful API 有相对统一的标准，因而更通用，兼容性更好，支持不同的语言。HTTP 协议是基于文本的，一般具备更好的可读性。但是缺点也很明显：
+
+- Restful 接口需要额外的定义，无论是客户端还是服务端，都需要额外的代码来处理，而 RPC 调用则更接近于直接调用。
+- 基于 HTTP 协议的 Restful 报文冗余，承载了过多的无效信息，而 RPC 通常使用自定义的协议格式，减少冗余报文。
+- RPC 可以采用更高效的序列化协议，将文本转为二进制传输，获得更高的性能。
+- 因为 RPC 的灵活性，所以更容易扩展和集成诸如注册中心、负载均衡等功能。
+
+## 2 RPC 框架需要解决什么问题
+
+RPC 框架需要解决什么问题？或者我们换一个问题，为什么需要 RPC 框架？
+
+我们可以想象下两台机器上，两个应用程序之间需要通信，那么首先，需要确定采用的传输协议是什么？如果这个两个应用程序位于不同的机器，那么一般会选择 TCP 协议或者 HTTP 协议；那如果两个应用程序位于相同的机器，也可以选择 Unix Socket 协议。传输协议确定之后，还需要确定报文的编码格式，比如采用最常用的 JSON 或者 XML，那如果报文比较大，还可能会选择 protobuf 等其他的编码方式，甚至编码之后，再进行压缩。接收端获取报文则需要相反的过程，先解压再解码。
+
+解决了传输协议和报文编码的问题，接下来还需要解决一系列的可用性问题，例如，连接超时了怎么办？是否支持异步请求和并发？
+
+如果服务端的实例很多，客户端并不关心这些实例的地址和部署位置，只关心自己能否获取到期待的结果，那就引出了注册中心(registry)和负载均衡(load balance)的问题。简单地说，即客户端和服务端互相不感知对方的存在，服务端启动时将自己注册到注册中心，客户端调用时，从注册中心获取到所有可用的实例，选择一个来调用。这样服务端和客户端只需要感知注册中心的存在就够了。注册中心通常还需要实现服务动态添加、删除，使用心跳确保服务处于可用状态等功能。
+
+再进一步，假设服务端是不同的团队提供的，如果没有统一的 RPC 框架，各个团队的服务提供方就需要各自实现一套消息编解码、连接池、收发线程、超时处理等“业务之外”的重复技术劳动，造成整体的低效。因此，“业务之外”的这部分公共的能力，即是 RPC 框架所需要具备的能力。
+
+## 3 关于 GeeRPC
+
+Go 语言广泛地应用于云计算和微服务，成熟的 RPC 框架和微服务框架汗牛充栋。`grpc`、`rpcx`、`go-micro` 等都是非常成熟的框架。一般而言，RPC 是微服务框架的一个子集，微服务框架可以自己实现 RPC 部分，当然，也可以选择不同的 RPC 框架作为通信基座。
+
+考虑性能和功能，上述成熟的框架代码量都比较庞大，而且通常和第三方库，例如 `protobuf`、`etcd`、`zookeeper` 等有比较深的耦合，难以直观地窥视框架的本质。GeeRPC 的目的是以最少的代码，实现 RPC 框架中最为重要的部分，帮助大家理解 RPC 框架在设计时需要考虑什么。代码简洁是第一位的，功能是第二位的。
+
+因此，GeeRPC 选择从零实现 Go 语言官方的标准库 `net/rpc`，并在此基础上，新增了协议交换(protocol exchange)、注册中心(registry)、服务发现(service discovery)、负载均衡(load balance)、超时处理(timeout processing)等特性。分七天完成，最终代码约 1000 行。
+
+## 4 目录
+
+- 第一天 - [服务端与消息编码](https://geektutu.com/post/geerpc-day1.html) | [Code](gee-rpc/day1-codec)
+- 第二天 - [支持并发与异步的客户端](https://geektutu.com/post/geerpc-day2.html) | [Code](gee-rpc/day2-client)
+- 第三天 - [服务注册(service register)](https://geektutu.com/post/geerpc-day3.html) | [Code](gee-rpc/day3-service )
+- 第四天 - [超时处理(timeout)](https://geektutu.com/post/geerpc-day4.html) | [Code](gee-rpc/day4-timeout )
+- 第五天 - [支持HTTP协议](https://geektutu.com/post/geerpc-day5.html) | [Code](gee-rpc/day5-http-debug)
+- 第六天 - [负载均衡(load balance)](https://geektutu.com/post/geerpc-day6.html) | [Code](gee-rpc/day6-load-balance)
+- 第七天 - [服务发现与注册中心(registry)](https://geektutu.com/post/geerpc-day7.html) | [Code](gee-rpc/day7-registry)
+
+## 附 推荐阅读
+
+- [Go 语言简明教程](https://geektutu.com/post/quick-golang.html)
+- [Go 语言笔试面试题](https://geektutu.com/post/qa-golang.html)
\ No newline at end of file
diff --git a/gee-rpc/doc/geerpc/geerpc.jpg b/gee-rpc/doc/geerpc/geerpc.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..5a86ebe270233a2b2aa9ef68335d66f14001c70c
GIT binary patch
literal 32791
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

literal 0
HcmV?d00001


From 298ce560a496da66c93c1d3f80e9650ee89720b8 Mon Sep 17 00:00:00 2001
From: gzdaijie <gzdaijie@gmail.com>
Date: Wed, 7 Oct 2020 00:49:17 +0800
Subject: [PATCH 091/122] gee-rpc: gob.go use err = to replace err :=

---
 gee-rpc/day1-codec/codec/gob.go        | 14 +++++++-------
 gee-rpc/day2-client/codec/gob.go       | 14 +++++++-------
 gee-rpc/day3-service/codec/gob.go      | 10 +++++-----
 gee-rpc/day4-timeout/codec/gob.go      | 10 +++++-----
 gee-rpc/day5-http-debug/codec/gob.go   | 10 +++++-----
 gee-rpc/day6-load-balance/codec/gob.go | 10 +++++-----
 gee-rpc/day7-registry/codec/gob.go     | 10 +++++-----
 7 files changed, 39 insertions(+), 39 deletions(-)

diff --git a/gee-rpc/day1-codec/codec/gob.go b/gee-rpc/day1-codec/codec/gob.go
index e4b2a67..d9ef2e6 100644
--- a/gee-rpc/day1-codec/codec/gob.go
+++ b/gee-rpc/day1-codec/codec/gob.go
@@ -41,15 +41,15 @@ func (c *GobCodec) Write(h *Header, body interface{}) (err error) {
 			_ = c.Close()
 		}
 	}()
-	if err := c.enc.Encode(h); err != nil {
-		log.Println("rpc codec: gob error encoding header:", err)
-		return err
+	if err = c.enc.Encode(h); err != nil {
+		log.Println("rpc: gob error encoding header:", err)
+		return
 	}
-	if err := c.enc.Encode(body); err != nil {
-		log.Println("rpc codec: gob error encoding body:", err)
-		return err
+	if err = c.enc.Encode(body); err != nil {
+		log.Println("rpc: gob error encoding body:", err)
+		return
 	}
-	return nil
+	return
 }
 
 func (c *GobCodec) Close() error {
diff --git a/gee-rpc/day2-client/codec/gob.go b/gee-rpc/day2-client/codec/gob.go
index e4b2a67..d9ef2e6 100644
--- a/gee-rpc/day2-client/codec/gob.go
+++ b/gee-rpc/day2-client/codec/gob.go
@@ -41,15 +41,15 @@ func (c *GobCodec) Write(h *Header, body interface{}) (err error) {
 			_ = c.Close()
 		}
 	}()
-	if err := c.enc.Encode(h); err != nil {
-		log.Println("rpc codec: gob error encoding header:", err)
-		return err
+	if err = c.enc.Encode(h); err != nil {
+		log.Println("rpc: gob error encoding header:", err)
+		return
 	}
-	if err := c.enc.Encode(body); err != nil {
-		log.Println("rpc codec: gob error encoding body:", err)
-		return err
+	if err = c.enc.Encode(body); err != nil {
+		log.Println("rpc: gob error encoding body:", err)
+		return
 	}
-	return nil
+	return
 }
 
 func (c *GobCodec) Close() error {
diff --git a/gee-rpc/day3-service/codec/gob.go b/gee-rpc/day3-service/codec/gob.go
index 808d97b..d9ef2e6 100644
--- a/gee-rpc/day3-service/codec/gob.go
+++ b/gee-rpc/day3-service/codec/gob.go
@@ -41,15 +41,15 @@ func (c *GobCodec) Write(h *Header, body interface{}) (err error) {
 			_ = c.Close()
 		}
 	}()
-	if err := c.enc.Encode(h); err != nil {
+	if err = c.enc.Encode(h); err != nil {
 		log.Println("rpc: gob error encoding header:", err)
-		return err
+		return
 	}
-	if err := c.enc.Encode(body); err != nil {
+	if err = c.enc.Encode(body); err != nil {
 		log.Println("rpc: gob error encoding body:", err)
-		return err
+		return
 	}
-	return nil
+	return
 }
 
 func (c *GobCodec) Close() error {
diff --git a/gee-rpc/day4-timeout/codec/gob.go b/gee-rpc/day4-timeout/codec/gob.go
index 808d97b..d9ef2e6 100644
--- a/gee-rpc/day4-timeout/codec/gob.go
+++ b/gee-rpc/day4-timeout/codec/gob.go
@@ -41,15 +41,15 @@ func (c *GobCodec) Write(h *Header, body interface{}) (err error) {
 			_ = c.Close()
 		}
 	}()
-	if err := c.enc.Encode(h); err != nil {
+	if err = c.enc.Encode(h); err != nil {
 		log.Println("rpc: gob error encoding header:", err)
-		return err
+		return
 	}
-	if err := c.enc.Encode(body); err != nil {
+	if err = c.enc.Encode(body); err != nil {
 		log.Println("rpc: gob error encoding body:", err)
-		return err
+		return
 	}
-	return nil
+	return
 }
 
 func (c *GobCodec) Close() error {
diff --git a/gee-rpc/day5-http-debug/codec/gob.go b/gee-rpc/day5-http-debug/codec/gob.go
index 808d97b..d9ef2e6 100644
--- a/gee-rpc/day5-http-debug/codec/gob.go
+++ b/gee-rpc/day5-http-debug/codec/gob.go
@@ -41,15 +41,15 @@ func (c *GobCodec) Write(h *Header, body interface{}) (err error) {
 			_ = c.Close()
 		}
 	}()
-	if err := c.enc.Encode(h); err != nil {
+	if err = c.enc.Encode(h); err != nil {
 		log.Println("rpc: gob error encoding header:", err)
-		return err
+		return
 	}
-	if err := c.enc.Encode(body); err != nil {
+	if err = c.enc.Encode(body); err != nil {
 		log.Println("rpc: gob error encoding body:", err)
-		return err
+		return
 	}
-	return nil
+	return
 }
 
 func (c *GobCodec) Close() error {
diff --git a/gee-rpc/day6-load-balance/codec/gob.go b/gee-rpc/day6-load-balance/codec/gob.go
index 808d97b..d9ef2e6 100644
--- a/gee-rpc/day6-load-balance/codec/gob.go
+++ b/gee-rpc/day6-load-balance/codec/gob.go
@@ -41,15 +41,15 @@ func (c *GobCodec) Write(h *Header, body interface{}) (err error) {
 			_ = c.Close()
 		}
 	}()
-	if err := c.enc.Encode(h); err != nil {
+	if err = c.enc.Encode(h); err != nil {
 		log.Println("rpc: gob error encoding header:", err)
-		return err
+		return
 	}
-	if err := c.enc.Encode(body); err != nil {
+	if err = c.enc.Encode(body); err != nil {
 		log.Println("rpc: gob error encoding body:", err)
-		return err
+		return
 	}
-	return nil
+	return
 }
 
 func (c *GobCodec) Close() error {
diff --git a/gee-rpc/day7-registry/codec/gob.go b/gee-rpc/day7-registry/codec/gob.go
index 808d97b..d9ef2e6 100644
--- a/gee-rpc/day7-registry/codec/gob.go
+++ b/gee-rpc/day7-registry/codec/gob.go
@@ -41,15 +41,15 @@ func (c *GobCodec) Write(h *Header, body interface{}) (err error) {
 			_ = c.Close()
 		}
 	}()
-	if err := c.enc.Encode(h); err != nil {
+	if err = c.enc.Encode(h); err != nil {
 		log.Println("rpc: gob error encoding header:", err)
-		return err
+		return
 	}
-	if err := c.enc.Encode(body); err != nil {
+	if err = c.enc.Encode(body); err != nil {
 		log.Println("rpc: gob error encoding body:", err)
-		return err
+		return
 	}
-	return nil
+	return
 }
 
 func (c *GobCodec) Close() error {

From 6366346ed99323cbeced9b79b942aa9a4ad18c42 Mon Sep 17 00:00:00 2001
From: gzdaijie <gzdaijie@gmail.com>
Date: Wed, 7 Oct 2020 17:35:12 +0800
Subject: [PATCH 092/122] gee-rpc client move call.Seq = seq to registerCall

---
 gee-rpc/day1-codec/main/main.go        |   1 +
 gee-rpc/day2-client/client.go          |   7 +-
 gee-rpc/day2-client/main/main.go       |   1 +
 gee-rpc/day3-service/client.go         |   7 +-
 gee-rpc/day3-service/main/main.go      |   1 +
 gee-rpc/day4-timeout/client.go         |   7 +-
 gee-rpc/day4-timeout/main/main.go      |   1 +
 gee-rpc/day5-http-debug/client.go      |   7 +-
 gee-rpc/day5-http-debug/main/main.go   |   1 +
 gee-rpc/day6-load-balance/client.go    |   7 +-
 gee-rpc/day6-load-balance/main/main.go |   1 +
 gee-rpc/day7-registry/client.go        |   7 +-
 gee-rpc/day7-registry/main/main.go     |   1 +
 gee-rpc/doc/geerpc-day1.md             | 440 +++++++++++++++++++++++++
 gee-rpc/doc/geerpc-day2.md             | 397 ++++++++++++++++++++++
 gee-rpc/doc/geerpc.md                  |   2 +-
 16 files changed, 863 insertions(+), 25 deletions(-)
 create mode 100644 gee-rpc/doc/geerpc-day1.md
 create mode 100644 gee-rpc/doc/geerpc-day2.md

diff --git a/gee-rpc/day1-codec/main/main.go b/gee-rpc/day1-codec/main/main.go
index 948b763..2bc6a8a 100644
--- a/gee-rpc/day1-codec/main/main.go
+++ b/gee-rpc/day1-codec/main/main.go
@@ -22,6 +22,7 @@ func startServer(addr chan string) {
 }
 
 func main() {
+	log.SetFlags(0)
 	addr := make(chan string)
 	go startServer(addr)
 
diff --git a/gee-rpc/day2-client/client.go b/gee-rpc/day2-client/client.go
index 3df6ec9..1c8a3cb 100644
--- a/gee-rpc/day2-client/client.go
+++ b/gee-rpc/day2-client/client.go
@@ -73,10 +73,10 @@ func (client *Client) registerCall(call *Call) (uint64, error) {
 	if client.closing || client.shutdown {
 		return 0, ErrShutdown
 	}
-	seq := client.seq
-	client.pending[seq] = call
+	call.Seq = client.seq
+	client.pending[call.Seq] = call
 	client.seq++
-	return seq, nil
+	return call.Seq, nil
 }
 
 func (client *Client) removeCall(seq uint64) *Call {
@@ -106,7 +106,6 @@ func (client *Client) send(call *Call) {
 
 	// register this call.
 	seq, err := client.registerCall(call)
-	call.Seq = seq
 	if err != nil {
 		call.Error = err
 		call.done()
diff --git a/gee-rpc/day2-client/main/main.go b/gee-rpc/day2-client/main/main.go
index 8502fe9..099eb50 100644
--- a/gee-rpc/day2-client/main/main.go
+++ b/gee-rpc/day2-client/main/main.go
@@ -21,6 +21,7 @@ func startServer(addr chan string) {
 }
 
 func main() {
+	log.SetFlags(0)
 	addr := make(chan string)
 	go startServer(addr)
 	client, _ := geerpc.Dial("tcp", <-addr)
diff --git a/gee-rpc/day3-service/client.go b/gee-rpc/day3-service/client.go
index 3df6ec9..1c8a3cb 100644
--- a/gee-rpc/day3-service/client.go
+++ b/gee-rpc/day3-service/client.go
@@ -73,10 +73,10 @@ func (client *Client) registerCall(call *Call) (uint64, error) {
 	if client.closing || client.shutdown {
 		return 0, ErrShutdown
 	}
-	seq := client.seq
-	client.pending[seq] = call
+	call.Seq = client.seq
+	client.pending[call.Seq] = call
 	client.seq++
-	return seq, nil
+	return call.Seq, nil
 }
 
 func (client *Client) removeCall(seq uint64) *Call {
@@ -106,7 +106,6 @@ func (client *Client) send(call *Call) {
 
 	// register this call.
 	seq, err := client.registerCall(call)
-	call.Seq = seq
 	if err != nil {
 		call.Error = err
 		call.done()
diff --git a/gee-rpc/day3-service/main/main.go b/gee-rpc/day3-service/main/main.go
index 0f0b668..89add53 100644
--- a/gee-rpc/day3-service/main/main.go
+++ b/gee-rpc/day3-service/main/main.go
@@ -33,6 +33,7 @@ func startServer(addr chan string) {
 }
 
 func main() {
+	log.SetFlags(0)
 	addr := make(chan string)
 	go startServer(addr)
 	client, _ := geerpc.Dial("tcp", <-addr)
diff --git a/gee-rpc/day4-timeout/client.go b/gee-rpc/day4-timeout/client.go
index b301647..45fc9e6 100644
--- a/gee-rpc/day4-timeout/client.go
+++ b/gee-rpc/day4-timeout/client.go
@@ -75,10 +75,10 @@ func (client *Client) registerCall(call *Call) (uint64, error) {
 	if client.closing || client.shutdown {
 		return 0, ErrShutdown
 	}
-	seq := client.seq
-	client.pending[seq] = call
+	call.Seq = client.seq
+	client.pending[call.Seq] = call
 	client.seq++
-	return seq, nil
+	return call.Seq, nil
 }
 
 func (client *Client) removeCall(seq uint64) *Call {
@@ -108,7 +108,6 @@ func (client *Client) send(call *Call) {
 
 	// register this call.
 	seq, err := client.registerCall(call)
-	call.Seq = seq
 	if err != nil {
 		call.Error = err
 		call.done()
diff --git a/gee-rpc/day4-timeout/main/main.go b/gee-rpc/day4-timeout/main/main.go
index 9693eb5..efcf75c 100644
--- a/gee-rpc/day4-timeout/main/main.go
+++ b/gee-rpc/day4-timeout/main/main.go
@@ -34,6 +34,7 @@ func startServer(addr chan string) {
 }
 
 func main() {
+	log.SetFlags(0)
 	addr := make(chan string)
 	go startServer(addr)
 	client, _ := geerpc.Dial("tcp", <-addr)
diff --git a/gee-rpc/day5-http-debug/client.go b/gee-rpc/day5-http-debug/client.go
index 795a18b..bdc2c0f 100644
--- a/gee-rpc/day5-http-debug/client.go
+++ b/gee-rpc/day5-http-debug/client.go
@@ -78,10 +78,10 @@ func (client *Client) registerCall(call *Call) (uint64, error) {
 	if client.closing || client.shutdown {
 		return 0, ErrShutdown
 	}
-	seq := client.seq
-	client.pending[seq] = call
+	call.Seq = client.seq
+	client.pending[call.Seq] = call
 	client.seq++
-	return seq, nil
+	return call.Seq, nil
 }
 
 func (client *Client) removeCall(seq uint64) *Call {
@@ -111,7 +111,6 @@ func (client *Client) send(call *Call) {
 
 	// register this call.
 	seq, err := client.registerCall(call)
-	call.Seq = seq
 	if err != nil {
 		call.Error = err
 		call.done()
diff --git a/gee-rpc/day5-http-debug/main/main.go b/gee-rpc/day5-http-debug/main/main.go
index 6499b53..cfd1b88 100644
--- a/gee-rpc/day5-http-debug/main/main.go
+++ b/gee-rpc/day5-http-debug/main/main.go
@@ -51,6 +51,7 @@ func call(addrCh chan string) {
 }
 
 func main() {
+	log.SetFlags(0)
 	ch := make(chan string)
 	go call(ch)
 	startServer(ch)
diff --git a/gee-rpc/day6-load-balance/client.go b/gee-rpc/day6-load-balance/client.go
index 795a18b..bdc2c0f 100644
--- a/gee-rpc/day6-load-balance/client.go
+++ b/gee-rpc/day6-load-balance/client.go
@@ -78,10 +78,10 @@ func (client *Client) registerCall(call *Call) (uint64, error) {
 	if client.closing || client.shutdown {
 		return 0, ErrShutdown
 	}
-	seq := client.seq
-	client.pending[seq] = call
+	call.Seq = client.seq
+	client.pending[call.Seq] = call
 	client.seq++
-	return seq, nil
+	return call.Seq, nil
 }
 
 func (client *Client) removeCall(seq uint64) *Call {
@@ -111,7 +111,6 @@ func (client *Client) send(call *Call) {
 
 	// register this call.
 	seq, err := client.registerCall(call)
-	call.Seq = seq
 	if err != nil {
 		call.Error = err
 		call.done()
diff --git a/gee-rpc/day6-load-balance/main/main.go b/gee-rpc/day6-load-balance/main/main.go
index d00f864..550e848 100644
--- a/gee-rpc/day6-load-balance/main/main.go
+++ b/gee-rpc/day6-load-balance/main/main.go
@@ -84,6 +84,7 @@ func broadcast(addr1, addr2 string) {
 }
 
 func main() {
+	log.SetFlags(0)
 	ch1 := make(chan string)
 	ch2 := make(chan string)
 	// start two servers
diff --git a/gee-rpc/day7-registry/client.go b/gee-rpc/day7-registry/client.go
index 795a18b..bdc2c0f 100644
--- a/gee-rpc/day7-registry/client.go
+++ b/gee-rpc/day7-registry/client.go
@@ -78,10 +78,10 @@ func (client *Client) registerCall(call *Call) (uint64, error) {
 	if client.closing || client.shutdown {
 		return 0, ErrShutdown
 	}
-	seq := client.seq
-	client.pending[seq] = call
+	call.Seq = client.seq
+	client.pending[call.Seq] = call
 	client.seq++
-	return seq, nil
+	return call.Seq, nil
 }
 
 func (client *Client) removeCall(seq uint64) *Call {
@@ -111,7 +111,6 @@ func (client *Client) send(call *Call) {
 
 	// register this call.
 	seq, err := client.registerCall(call)
-	call.Seq = seq
 	if err != nil {
 		call.Error = err
 		call.done()
diff --git a/gee-rpc/day7-registry/main/main.go b/gee-rpc/day7-registry/main/main.go
index 0776312..50b57dd 100644
--- a/gee-rpc/day7-registry/main/main.go
+++ b/gee-rpc/day7-registry/main/main.go
@@ -94,6 +94,7 @@ func broadcast(registry string) {
 }
 
 func main() {
+	log.SetFlags(0)
 	registryAddr := "http://localhost:9999/_geerpc_/registry"
 	var wg sync.WaitGroup
 	wg.Add(1)
diff --git a/gee-rpc/doc/geerpc-day1.md b/gee-rpc/doc/geerpc-day1.md
new file mode 100644
index 0000000..abfeb3c
--- /dev/null
+++ b/gee-rpc/doc/geerpc-day1.md
@@ -0,0 +1,440 @@
+---
+title: 动手写RPC框架 - GeeRPC第一天 服务端与消息编码
+date: 2020-10-06 17:00:00
+description: 7天用 Go语言/golang 从零实现 RPC 框架 GeeRPC 教程(7 days implement golang remote procedure call framework from scratch tutorial)，动手写 RPC 框架，参照 golang 标准库 net/rpc 的实现，实现了服务端(server)、支持异步和并发的客户端(client)、消息编码与解码(message encoding and decoding)、服务注册(service register)、支持 TCP/Unix/HTTP 等多种传输协议。第一天实现了一个简单的服务端和消息的编码与解码。
+tags:
+- Go
+nav: 从零实现
+categories:
+- RPC框架 - GeeRPC
+keywords:
+- Go语言
+- 从零实现RPC框架
+- Codec
+- 序列化
+- 反序列化
+image: post/geerpc/geerpc.jpg
+github: https://github.com/geektutu/7days-golang
+---
+
+![golang RPC framework](geerpc/geerpc.jpg)
+
+本文是[7天用Go从零实现RPC框架GeeRPC]的第一篇。
+
+- 使用 `encoding/gob` 实现消息的编解码(序列化与反序列化)
+- 实现一个简易的服务端，仅接受消息，不处理，代码约 200 行
+
+
+## 消息的序列化与反序列化
+
+一个典型的 RPC 调用如下：
+
+```go
+err = client.Call("Arith.Multiply", args, &reply)
+```
+
+客户端发送的请求包括服务名 `Arith`，方法名 `Multiply`，参数 `args` 三个，服务端的响应包括错误 `error`，返回值 `reply` 2 个。我们将请求和响应中的参数和返回值抽象为 body，剩余的信息放在 header 中，那么就可以抽象出数据结构 Header：
+
+[day1-codec/codec/codec.go](https://github.com/geektutu/7days-golang/tree/master/gee-rpc/day1-codec)
+
+```go
+package codec
+
+import "io"
+
+type Header struct {
+	ServiceMethod string // format "Service.Method"
+	Seq           uint64 // sequence number chosen by client
+	Error         string
+}
+```
+
+- ServiceMethod 是服务名和方法名，通常与 Go 语言中的结构体和方法相映射。
+- Seq 是请求的序号，也可以认为是某个请求的 ID，用来区分不同的请求。
+- Error 是错误信息，客户端置为空，服务端如果如果发生错误，将错误信息置于 Error 中。
+
+
+我们将和消息编解码相关的代码都防到 codec 目录中。
+
+进一步，抽象出对消息体进行编解码的接口 Codec，抽象出接口是为了实现不同的 Codec 实例：
+
+```go
+type Codec interface {
+	io.Closer
+	ReadHeader(*Header) error
+	ReadBody(interface{}) error
+	Write(*Header, interface{}) error
+}
+```
+
+紧接着，抽象出 Codec 的构造函数，客户端和服务端可以通过 Codec 的 `Type` 得到构造函数，从而创建 Codec 实例。这部分代码和工厂模式类似，与工厂模式不同的是，返回的是构造函数，而非实例。
+
+```go
+type NewCodecFunc func(io.ReadWriteCloser) Codec
+
+type Type string
+
+const (
+	GobType  Type = "application/gob"
+	JsonType Type = "application/json" // not implemented
+)
+
+var NewCodecFuncMap map[Type]NewCodecFunc
+
+func init() {
+	NewCodecFuncMap = make(map[Type]NewCodecFunc)
+	NewCodecFuncMap[GobType] = NewGobCodec
+}
+```
+
+我们定义了 2 种 Codec，`Gob` 和 `Json`，但是实际代码中只实现了 `Gob` 一种，事实上，2 者的实现非常接近，甚至只需要把 `gob` 换成 `json` 即可。
+
+首先定义 `GobCodec` 结构体，这个结构体由四部分构成，`conn` 是由构建函数传入，通常是通过 TCP 或者 Unix 建立 socket 时得到的链接实例，dec 和 enc 对应 gob 的 Decoder 和 Encoder，buf 是为了防止阻塞而创建的带缓冲的 `Writer`，一般这么做能提升性能。
+
+[day1-codec/codec/gob.go](https://github.com/geektutu/7days-golang/tree/master/gee-rpc/day1-codec)
+
+```go
+package codec
+
+import (
+	"bufio"
+	"encoding/gob"
+	"io"
+	"log"
+)
+
+type GobCodec struct {
+	conn io.ReadWriteCloser
+	buf  *bufio.Writer
+	dec  *gob.Decoder
+	enc  *gob.Encoder
+}
+
+var _ Codec = (*GobCodec)(nil)
+
+func NewGobCodec(conn io.ReadWriteCloser) Codec {
+	buf := bufio.NewWriter(conn)
+	return &GobCodec{
+		conn: conn,
+		buf:  buf,
+		dec:  gob.NewDecoder(conn),
+		enc:  gob.NewEncoder(buf),
+	}
+}
+```
+
+接着实现 `ReadHeader`、`ReadBody`、`Write` 和 `Close` 方法。
+
+```go
+func (c *GobCodec) ReadHeader(h *Header) error {
+	return c.dec.Decode(h)
+}
+
+func (c *GobCodec) ReadBody(body interface{}) error {
+	return c.dec.Decode(body)
+}
+
+func (c *GobCodec) Write(h *Header, body interface{}) (err error) {
+	defer func() {
+		_ = c.buf.Flush()
+		if err != nil {
+			_ = c.Close()
+		}
+	}()
+	if err := c.enc.Encode(h); err != nil {
+		log.Println("rpc codec: gob error encoding header:", err)
+		return err
+	}
+	if err := c.enc.Encode(body); err != nil {
+		log.Println("rpc codec: gob error encoding body:", err)
+		return err
+	}
+	return nil
+}
+
+func (c *GobCodec) Close() error {
+	return c.conn.Close()
+}
+```
+
+## 通信过程
+
+客户端与服务端的通信需要协商一些内容，例如 HTTP 报文，分为 header 和 body 2 部分，body 的格式和长度通过 header 中的 `Content-Type` 和 `Content-Length` 指定，服务端通过解析 header 就能够知道如何从 body 中读取需要的信息。对于 RPC 协议来说，这部分协商是需要自主设计的。为了提升性能，一般在报文的最开始会规划固定的字节，来协商相关的信息。比如第1个字节用来表示序列化方式，第2个字节表示压缩方式，第3-6字节表示 header 的长度，7-10 字节表示 body 的长度。
+
+对于 GeeRPC 来说，目前需要协商的唯一一项内容是消息的编解码方式。我们将这部分信息，放到结构体 `Option` 中承载。目前，已经进入到服务端的实现阶段了。
+
+[day1-codec/server.go](https://github.com/geektutu/7days-golang/tree/master/gee-rpc/day1-codec)
+
+```go
+package geerpc
+
+const MagicNumber = 0x3bef5c
+
+type Option struct {
+	MagicNumber int        // MagicNumber marks this's a geerpc request
+	CodecType   codec.Type // client may choose different Codec to encode body
+}
+
+var DefaultOption = &Option{
+	MagicNumber: MagicNumber,
+	CodecType:   codec.GobType,
+}
+```
+
+一般来说，涉及协议协商的这部分信息，需要设计固定的字节来传输的。但是为了实现上更简单，GeeRPC 客户端固定采用 JSON 编码 Option，后续的 header 和 body 的编码方式由 Option 中的 CodeType 指定，服务端首先使用 JSON 解码 Option，然后通过 Option 得 CodeType 解码剩余的内容。即报文将以这样的形式发送：
+
+```bash
+| Option{MagicNumber: xxx, CodecType: xxx} | Header{ServiceMethod ...} | Body interface{} |
+| <------      固定 JSON 编码      ------>  | <-------   编码方式由 CodeType 决定   ------->|
+```
+
+在一次连接中，Option 固定在报文的最开始，Header 和 Body 可以有多个，即报文可能是这样的。
+
+```go
+| Option | Header1 | Body1 | Header2 | Body2 | ...
+```
+
+## 服务端的实现
+
+通信过程已经定义清楚了，那么服务端的实现就比较直接了。
+
+[day1-codec/server.go](https://github.com/geektutu/7days-golang/tree/master/gee-rpc/day1-codec)
+
+```go
+// Server represents an RPC Server.
+type Server struct{}
+
+// NewServer returns a new Server.
+func NewServer() *Server {
+	return &Server{}
+}
+
+// DefaultServer is the default instance of *Server.
+var DefaultServer = NewServer()
+
+// Accept accepts connections on the listener and serves requests
+// for each incoming connection.
+func (server *Server) Accept(lis net.Listener) {
+	for {
+		conn, err := lis.Accept()
+		if err != nil {
+			log.Println("rpc server: accept error:", err)
+			return
+		}
+		go server.ServeConn(conn)
+	}
+}
+
+// Accept accepts connections on the listener and serves requests
+// for each incoming connection.
+func Accept(lis net.Listener) { DefaultServer.Accept(lis) }
+```
+
+- 首先定义了结构体 `Server`，没有任何的成员字段。
+- 实现了 `Accept` 方式，`net.Listener` 作为参数，for 循环等待 socket 连接建立，并开启子协程处理，处理过程交给了 `ServerConn` 方法。
+- DefaultServer 是一个默认的 `Server` 实例，主要为了用户使用方便。
+
+如果想启动服务，过程是非常简单的，传入 listener 即可，tcp 协议和 unix 协议都支持。
+
+```go
+lis, _ := net.Listen("tcp", ":9999")
+geerpc.Accept(lis)
+```
+
+`ServeConn` 的实现就和之前讨论的通信过程紧密相关了，首先使用 `json.NewDecoder` 反序列化得到 Option 实例，检查 MagicNumber 和 CodeType 的值是否正确。然后根据 CodeType 得到对应的消息编解码器，接下来的处理交给 `serverCodec`。
+
+```go
+// ServeConn runs the server on a single connection.
+// ServeConn blocks, serving the connection until the client hangs up.
+func (server *Server) ServeConn(conn io.ReadWriteCloser) {
+	defer func() { _ = conn.Close() }()
+	var opt Option
+	if err := json.NewDecoder(conn).Decode(&opt); err != nil {
+		log.Println("rpc server: options error: ", err)
+		return
+	}
+	if opt.MagicNumber != MagicNumber {
+		log.Printf("rpc server: invalid magic number %x", opt.MagicNumber)
+		return
+	}
+	f := codec.NewCodecFuncMap[opt.CodecType]
+	if f == nil {
+		log.Printf("rpc server: invalid codec type %s", opt.CodecType)
+		return
+	}
+	server.serveCodec(f(conn))
+}
+
+// invalidRequest is a placeholder for response argv when error occurs
+var invalidRequest = struct{}{}
+
+func (server *Server) serveCodec(cc codec.Codec) {
+	sending := new(sync.Mutex) // make sure to send a complete response
+	wg := new(sync.WaitGroup)  // wait until all request are handled
+	for {
+		req, err := server.readRequest(cc)
+		if err != nil {
+			if req == nil {
+				break // it's not possible to recover, so close the connection
+			}
+			req.h.Error = err.Error()
+			server.sendResponse(cc, req.h, invalidRequest, sending)
+			continue
+		}
+		wg.Add(1)
+		go server.handleRequest(cc, req, sending, wg)
+	}
+	wg.Wait()
+	_ = cc.Close()
+}
+```
+
+`serveCodec` 的过程非常简单。主要包含三个阶段
+
+- 读取请求 readRequest
+- 处理请求 handleRequest
+- 回复请求 sendResponse
+
+之前提到过，在一次连接中，允许接收多个请求，即多个 request header 和 request body，因此这里使用了 for 无限制地等待请求的到来，直到发生错误（例如连接被关闭，接收到的报文有问题等），这里需要注意的点有三个：
+
+- handleRequest 使用了协程并发执行请求。
+- 处理请求是并发的，但是回复请求的报文必须是逐个发送的，并发容易导致多个回复报文交织在一起，客户端无法解析。在这里使用锁(sending)保证。
+- 尽力而为，只有在 header 解析失败时，才终止循环。
+
+```go
+// request stores all information of a call
+type request struct {
+	h            *codec.Header // header of request
+	argv, replyv reflect.Value // argv and replyv of request
+}
+
+func (server *Server) readRequestHeader(cc codec.Codec) (*codec.Header, error) {
+	var h codec.Header
+	if err := cc.ReadHeader(&h); err != nil {
+		if err != io.EOF && err != io.ErrUnexpectedEOF {
+			log.Println("rpc server: read header error:", err)
+		}
+		return nil, err
+	}
+	return &h, nil
+}
+
+func (server *Server) readRequest(cc codec.Codec) (*request, error) {
+	h, err := server.readRequestHeader(cc)
+	if err != nil {
+		return nil, err
+	}
+	req := &request{h: h}
+	// TODO: now we don't know the type of request argv
+	// day 1, just suppose it's string
+	req.argv = reflect.New(reflect.TypeOf(""))
+	if err = cc.ReadBody(req.argv.Interface()); err != nil {
+		log.Println("rpc server: read argv err:", err)
+	}
+	return req, nil
+}
+
+func (server *Server) sendResponse(cc codec.Codec, h *codec.Header, body interface{}, sending *sync.Mutex) {
+	sending.Lock()
+	defer sending.Unlock()
+	if err := cc.Write(h, body); err != nil {
+		log.Println("rpc server: write response error:", err)
+	}
+}
+
+func (server *Server) handleRequest(cc codec.Codec, req *request, sending *sync.Mutex, wg *sync.WaitGroup) {
+	// TODO, should call registered rpc methods to get the right replyv
+	// day 1, just print argv and send a hello message
+	defer wg.Done()
+	log.Println(req.h, req.argv.Elem())
+	req.replyv = reflect.ValueOf(fmt.Sprintf("geerpc resp %d", req.h.Seq))
+	server.sendResponse(cc, req.h, req.replyv.Interface(), sending)
+}
+```
+
+目前还不能判断 body 的类型，因此在 readRequest 和 handleRequest 中，day1 将 body 作为字符串处理。接收到请求，打印 header，并回复 `geerpc resp ${req.h.Seq}`。这一部分后续再实现。
+
+
+## main 函数(一个简易的客户端)
+
+day1 的内容就到此为止了，在这里我们已经实现了一个消息的编解码器 `GobCodec`，并且客户端与服务端实现了简单的协议交换(protocol exchange)，即允许客户端使用不同的编码方式。同时实现了服务端的雏形，建立连接，读取、处理并回复客户端的请求。
+
+接下来，我们就在 main 函数中看看如何使用刚实现的 GeeRPC 吧。
+
+[day1-codec/main/main.go](https://github.com/geektutu/7days-golang/tree/master/gee-rpc/day1-codec)
+
+```go
+package main
+
+import (
+	"encoding/json"
+	"fmt"
+	"geerpc"
+	"geerpc/codec"
+	"log"
+	"net"
+	"time"
+)
+
+func startServer(addr chan string) {
+	// pick a free port
+	l, err := net.Listen("tcp", ":0")
+	if err != nil {
+		log.Fatal("network error:", err)
+	}
+	log.Println("start rpc server on", l.Addr())
+	addr <- l.Addr().String()
+	geerpc.Accept(l)
+}
+
+func main() {
+	addr := make(chan string)
+	go startServer(addr)
+
+	// in fact, following code is like a simple geerpc client
+	conn, _ := net.Dial("tcp", <-addr)
+	defer func() { _ = conn.Close() }()
+
+	time.Sleep(time.Second)
+	// send options
+	_ = json.NewEncoder(conn).Encode(geerpc.DefaultOption)
+	cc := codec.NewGobCodec(conn)
+	// send request & receive response
+	for i := 0; i < 5; i++ {
+		h := &codec.Header{
+			ServiceMethod: "Foo.Sum",
+			Seq:           uint64(i),
+		}
+		_ = cc.Write(h, fmt.Sprintf("geerpc req %d", h.Seq))
+		_ = cc.ReadHeader(h)
+		var reply string
+		_ = cc.ReadBody(&reply)
+		log.Println("reply:", reply)
+	}
+}
+```
+
+- 在 `startServer` 中使用了信道 `addr`，确保服务端端口监听成功，客户端再发起请求。
+- 客户端首先发送 `Option` 进行协议交换，接下来发送消息头 `h := &codec.Header{}`，和消息体 `geerpc req ${h.Seq}`。
+- 最后解析服务端的响应 `reply`，并打印出来。
+
+执行结果如下：
+
+```bash
+start rpc server on [::]:63662
+&{Foo.Sum 0 } geerpc req 0
+reply: geerpc resp 0
+&{Foo.Sum 1 } geerpc req 1
+reply: geerpc resp 1
+&{Foo.Sum 2 } geerpc req 2
+reply: geerpc resp 2
+&{Foo.Sum 3 } geerpc req 3
+reply: geerpc resp 3
+&{Foo.Sum 4 } geerpc req 4
+reply: geerpc resp 4
+```
+
+## 附 推荐阅读
+
+- [Go 语言简明教程](https://geektutu.com/post/quick-golang.html)
+- [Go 语言笔试面试题](https://geektutu.com/post/qa-golang.html)
\ No newline at end of file
diff --git a/gee-rpc/doc/geerpc-day2.md b/gee-rpc/doc/geerpc-day2.md
new file mode 100644
index 0000000..2d356e3
--- /dev/null
+++ b/gee-rpc/doc/geerpc-day2.md
@@ -0,0 +1,397 @@
+---
+title: 动手写RPC框架 - GeeRPC第二天 支持并发与异步的客户端
+date: 2020-10-07 18:00:00
+description: 7天用 Go语言/golang 从零实现 RPC 框架 GeeRPC 教程(7 days implement golang remote procedure call framework from scratch tutorial)，动手写 RPC 框架，参照 golang 标准库 net/rpc 的实现，实现了服务端(server)、支持异步和并发的客户端(client)、消息编码与解码(message encoding and decoding)、服务注册(service register)、支持 TCP/Unix/HTTP 等多种传输协议。第二天实现了一个支持异步(asynchronous)和并发(concurrent)的客户端。
+tags:
+- Go
+nav: 从零实现
+categories:
+- RPC框架 - GeeRPC
+keywords:
+- Go语言
+- 从零实现RPC框架
+- 客户端
+- 异步
+- 并发
+image: post/geerpc/geerpc.jpg
+github: https://github.com/geektutu/7days-golang
+---
+
+![golang RPC framework](geerpc/geerpc.jpg)
+
+本文是[7天用Go从零实现RPC框架GeeRPC]的第二篇。
+
+- 实现一个支持异步和并发的高性能客户端，代码约 250 行
+
+
+## Call 的设计
+
+对 `net/rpc` 而言，一个函数需要能够被远程调用，需要满足如下五个条件：
+
+- the method's type is exported.
+- the method is exported.
+- the method has two arguments, both exported (or builtin) types.
+- the method's second argument is a pointer.
+- the method has return type error.
+
+更直观一些：
+
+```go
+func (t *T) MethodName(argType T1, replyType *T2) error
+```
+
+根据上述要求，首先我们封装了结构体 Call 来承载一次 RPC 调用所需要的信息。
+
+[day2-client/client.go](https://github.com/geektutu/7days-golang/tree/master/gee-rpc/day2-client)
+
+```go
+// Call represents an active RPC.
+type Call struct {
+	Seq           uint64
+	ServiceMethod string      // format "<service>.<method>"
+	Args          interface{} // arguments to the function
+	Reply         interface{} // reply from the function
+	Error         error       // if error occurs, it will be set
+	Done          chan *Call  // Strobes when call is complete.
+}
+
+func (call *Call) done() {
+	call.Done <- call
+}
+```
+
+为了支持异步调用，Call 结构体中添加了一个字段 Done，Done 的类型是 `chan *Call`，当调用结束时，会调用 `call.done()` 通知调用方。
+
+
+## 实现 Client
+
+接下来，我们将实现 GeeRPC 客户端最核心的部分 Client。
+
+```go
+// Client represents an RPC Client.
+// There may be multiple outstanding Calls associated
+// with a single Client, and a Client may be used by
+// multiple goroutines simultaneously.
+type Client struct {
+	cc       codec.Codec
+	opt      *Option
+	sending  sync.Mutex // protect following
+	header   codec.Header
+	mu       sync.Mutex // protect following
+	seq      uint64
+	pending  map[uint64]*Call
+	closing  bool // user has called Close
+	shutdown bool // server has told us to stop
+}
+
+var _ io.Closer = (*Client)(nil)
+
+var ErrShutdown = errors.New("connection is shut down")
+
+// Close the connection
+func (client *Client) Close() error {
+	client.mu.Lock()
+	defer client.mu.Unlock()
+	if client.closing {
+		return ErrShutdown
+	}
+	client.closing = true
+	return client.cc.Close()
+}
+
+// IsAvailable return true if the client does work
+func (client *Client) IsAvailable() bool {
+	client.mu.Lock()
+	defer client.mu.Unlock()
+	return !client.shutdown && !client.closing
+}
+```
+
+Client 的字段比较复杂：
+
+- cc 是消息的编解码器，和服务端类似，用来序列化将要发送出去的请求，以及反序列化接收到的响应。
+- sending 是一个互斥锁，和服务端类似，为了保证请求的有序发送，即防止出现多个请求报文混淆。
+- header 是每个请求的消息头，header 只有在请求发送时才需要，而请求发送是互斥的，因此每个客户端只需要一个，声明在 Client 结构体中可以复用。
+- seq 用于给发送的请求编号，每个请求拥有唯一编号。
+- pending 存储未处理完的请求，键是编号，值是 Call 实例。
+- closing 和 shutdown 任意一个值置为 true，则表示 Client 处于不可用的状态，但有些许的差别，closing 是用户主动关闭的，即调用 `Close` 方法，而 shutdown 置为 true 一般是有错误发生。
+
+紧接着，实现和 Call 相关的三个方法。
+
+```go
+func (client *Client) registerCall(call *Call) (uint64, error) {
+	client.mu.Lock()
+	defer client.mu.Unlock()
+	if client.closing || client.shutdown {
+		return 0, ErrShutdown
+	}
+	call.Seq = client.seq
+	client.pending[call.Seq] = call
+	client.seq++
+	return call.Seq, nil
+}
+
+func (client *Client) removeCall(seq uint64) *Call {
+	client.mu.Lock()
+	defer client.mu.Unlock()
+	call := client.pending[seq]
+	delete(client.pending, seq)
+	return call
+}
+
+func (client *Client) terminateCalls(err error) {
+	client.sending.Lock()
+	defer client.sending.Unlock()
+	client.mu.Lock()
+	defer client.mu.Unlock()
+	client.shutdown = true
+	for _, call := range client.pending {
+		call.Error = err
+		call.done()
+	}
+}
+```
+
+- registerCall：将参数 call 添加到 client.pending 中，并更新 client.seq。
+- removeCall：根据 seq，从 client.pending 中移除对应的 call，并返回。
+- terminateCalls：服务端或客户端发生错误时调用，将 shutdown 设置为 true，且将错误信息通知所有 pending 状态的 call。
+
+对一个客户端端来说，接收响应、发送请求是最重要的 2 个功能。那么首先实现接收功能，接收到的响应有三种情况：
+
+- call 不存在，可能是请求没有发送完整，或者因为其他原因被取消，但是服务端仍旧处理了。
+- call 存在，但服务端处理出错，即 h.Error 不为空。
+- call 存在，服务端处理正常，那么需要从 body 中读取 Reply 的值。
+
+```go
+func (client *Client) receive() {
+	var err error
+	for err == nil {
+		var h codec.Header
+		if err = client.cc.ReadHeader(&h); err != nil {
+			break
+		}
+		call := client.removeCall(h.Seq)
+		switch {
+		case call == nil:
+			// it usually means that Write partially failed
+			// and call was already removed.
+			err = client.cc.ReadBody(nil)
+		case h.Error != "":
+			call.Error = fmt.Errorf(h.Error)
+			err = client.cc.ReadBody(nil)
+			call.done()
+		default:
+			err = client.cc.ReadBody(call.Reply)
+			if err != nil {
+				call.Error = errors.New("reading body " + err.Error())
+			}
+			call.done()
+		}
+	}
+	// error occurs, so terminateCalls pending calls
+	client.terminateCalls(err)
+}
+```
+
+创建 Client 实例时，首先需要完成一开始的协议交换，即发送 `Option` 信息给服务端。协商好消息的编解码方式之后，再创建一个子协程调用 `receive()` 接收响应。
+
+```go
+func NewClient(conn net.Conn, opt *Option) (*Client, error) {
+	f := codec.NewCodecFuncMap[opt.CodecType]
+	if f == nil {
+		err := fmt.Errorf("invalid codec type %s", opt.CodecType)
+		log.Println("rpc client: codec error:", err)
+		return nil, err
+	}
+	// send options with server
+	if err := json.NewEncoder(conn).Encode(opt); err != nil {
+		log.Println("rpc client: options error: ", err)
+		_ = conn.Close()
+		return nil, err
+	}
+	return newClientCodec(f(conn), opt), nil
+}
+
+func newClientCodec(cc codec.Codec, opt *Option) *Client {
+	client := &Client{
+		seq:     1, // seq starts with 1, 0 means invalid call
+		cc:      cc,
+		opt:     opt,
+		pending: make(map[uint64]*Call),
+	}
+	go client.receive()
+	return client
+}
+```
+
+还需要实现 `Dial` 函数，便于用户传入服务端地址，创建 Client 实例。为了简化用户调用，通过 `...*Option` 将 Option 实现为可选参数。
+
+```go
+func parseOptions(opts ...*Option) (*Option, error) {
+	// if opts is nil or pass nil as parameter
+	if len(opts) == 0 || opts[0] == nil {
+		return DefaultOption, nil
+	}
+	if len(opts) != 1 {
+		return nil, errors.New("number of options is more than 1")
+	}
+	opt := opts[0]
+	opt.MagicNumber = DefaultOption.MagicNumber
+	if opt.CodecType == "" {
+		opt.CodecType = DefaultOption.CodecType
+	}
+	return opt, nil
+}
+
+func dial(network, address string, opt *Option) (*Client, error) {
+	conn, err := net.Dial(network, address)
+	if err != nil {
+		return nil, err
+	}
+	return NewClient(conn, opt)
+}
+
+// Dial connects to an RPC server at the specified network address
+func Dial(network, address string, opts ...*Option) (*Client, error) {
+	opt, err := parseOptions(opts...)
+	if err != nil {
+		return nil, err
+	}
+	return dial(network, address, opt)
+}
+```
+
+此时，GeeRPC 客户端已经具备了完整的创建连接和接收响应的能力了，最后还需要实现发送请求的能力。
+
+```go
+func (client *Client) send(call *Call) {
+	// make sure that the client will send a complete request
+	client.sending.Lock()
+	defer client.sending.Unlock()
+
+	// register this call.
+	seq, err := client.registerCall(call)
+	if err != nil {
+		call.Error = err
+		call.done()
+		return
+	}
+
+	// prepare request header
+	client.header.ServiceMethod = call.ServiceMethod
+	client.header.Seq = seq
+	client.header.Error = ""
+
+	// encode and send the request
+	if err := client.cc.Write(&client.header, call.Args); err != nil {
+		call := client.removeCall(seq)
+		// call may be nil, it usually means that Write partially failed,
+		// client has received the response and handled
+		if call != nil {
+			call.Error = err
+			call.done()
+		}
+	}
+}
+
+// Go invokes the function asynchronously.
+// It returns the Call structure representing the invocation.
+func (client *Client) Go(serviceMethod string, args, reply interface{}, done chan *Call) *Call {
+	if done == nil {
+		done = make(chan *Call, 10)
+	} else if cap(done) == 0 {
+		log.Panic("rpc client: done channel is unbuffered")
+	}
+	call := &Call{
+		ServiceMethod: serviceMethod,
+		Args:          args,
+		Reply:         reply,
+		Done:          done,
+	}
+	client.send(call)
+	return call
+}
+
+// Call invokes the named function, waits for it to complete,
+// and returns its error status.
+func (client *Client) Call(serviceMethod string, args, reply interface{}) error {
+	call := <-client.Go(serviceMethod, args, reply, make(chan *Call, 1)).Done
+	return call.Error
+}
+```
+
+- `Go` 和 `Call` 是客户端暴露给用户的两个 RPC 服务调用接口，`Go` 是一个异步接口，返回 call 实例。
+- `Call` 是对 `Go` 的封装，阻塞 call.Done，等待响应返回，是一个同步接口。
+
+至此，一个支持异步和并发的 GeeRPC 客户端已经完成。
+
+## Demo
+
+第一天 GeeRPC 只实现了服务端，因此我们在 main 函数中手动模拟了整个通信过程，今天我们就将 main 函数中通信部分替换为今天的客户端吧。
+
+[day2-client/main/main.go](https://github.com/geektutu/7days-golang/tree/master/gee-rpc/day2-client)
+
+startServer 没有发生变化。
+
+```go
+func startServer(addr chan string) {
+	// pick a free port
+	l, err := net.Listen("tcp", ":0")
+	if err != nil {
+		log.Fatal("network error:", err)
+	}
+	log.Println("start rpc server on", l.Addr())
+	addr <- l.Addr().String()
+	geerpc.Accept(l)
+}
+```
+
+在 main 函数中使用了 `client.Call` 并发了 5 个 RPC 同步调用，参数和返回值的类型均为 string。
+
+```go
+func main() {
+    log.SetFlags(0)
+	addr := make(chan string)
+	go startServer(addr)
+	client, _ := geerpc.Dial("tcp", <-addr)
+	defer func() { _ = client.Close() }()
+
+	time.Sleep(time.Second)
+	// send request & receive response
+	var wg sync.WaitGroup
+	for i := 0; i < 5; i++ {
+		wg.Add(1)
+		go func(i int) {
+			defer wg.Done()
+			args := fmt.Sprintf("geerpc req %d", i)
+			var reply string
+			if err := client.Call("Foo.Sum", args, &reply); err != nil {
+				log.Fatal("call Foo.Sum error:", err)
+			}
+			log.Println("reply:", reply)
+		}(i)
+	}
+	wg.Wait()
+}
+```
+
+运行结果如下：
+
+```bash
+start rpc server on [::]:50658
+&{Foo.Sum 5 } geerpc req 3
+&{Foo.Sum 1 } geerpc req 0
+&{Foo.Sum 3 } geerpc req 1
+&{Foo.Sum 2 } geerpc req 4
+&{Foo.Sum 4 } geerpc req 2
+reply: geerpc resp 1
+reply: geerpc resp 5
+reply: geerpc resp 3
+reply: geerpc resp 2
+reply: geerpc resp 4
+```
+
+## 附 推荐阅读
+
+- [Go 语言简明教程](https://geektutu.com/post/quick-golang.html)
+- [Go 语言笔试面试题](https://geektutu.com/post/qa-golang.html)
\ No newline at end of file
diff --git a/gee-rpc/doc/geerpc.md b/gee-rpc/doc/geerpc.md
index 9c49e6d..7a6a324 100644
--- a/gee-rpc/doc/geerpc.md
+++ b/gee-rpc/doc/geerpc.md
@@ -1,7 +1,7 @@
 ---
 title: 7天用Go从零实现RPC框架GeeRPC
 date: 2020-10-06 16:00:00
-description: 7天用 Go语言/golang 从零实现 RPC 框架 GeeRPC 教程(7 days implement golang remote procedure call framework from scratch tutorial)，动手写 RPC 框架，参照 golang标准库 net/rpc 的实现，实现了服务端(server)、支持异步和并发的客户端(client)、消息编码与解码(message encoding and decoding)、服务注册(service register)、支持 TCP/Unix/HTTP 等多种传输协议。并在此基础上新增了协议交换(protocol exchange)、注册中心(registry)、服务发现(service discovery)、负载均衡(load balance)、超时处理(timeout processing)等特性。
+description: 7天用 Go语言/golang 从零实现 RPC 框架 GeeRPC 教程(7 days implement golang remote procedure call framework from scratch tutorial)，动手写 RPC 框架，参照 golang 标准库 net/rpc 的实现，实现了服务端(server)、支持异步和并发的客户端(client)、消息编码与解码(message encoding and decoding)、服务注册(service register)、支持 TCP/Unix/HTTP 等多种传输协议。并在此基础上新增了协议交换(protocol exchange)、注册中心(registry)、服务发现(service discovery)、负载均衡(load balance)、超时处理(timeout processing)等特性。
 tags:
 - Go
 nav: 从零实现

From 1498ec2a82ce9a71f6bdacb7f10bbaf523940767 Mon Sep 17 00:00:00 2001
From: gzdaijie <gzdaijie@gmail.com>
Date: Wed, 7 Oct 2020 23:08:58 +0800
Subject: [PATCH 093/122] gee-rpc: add day3 & day4 doc

---
 gee-rpc/day4-timeout/client_test.go      |   1 +
 gee-rpc/day5-http-debug/client_test.go   |   1 +
 gee-rpc/day6-load-balance/client_test.go |   1 +
 gee-rpc/day7-registry/client_test.go     |   1 +
 gee-rpc/doc/geerpc-day3.md               | 495 +++++++++++++++++++++++
 5 files changed, 499 insertions(+)
 create mode 100644 gee-rpc/doc/geerpc-day3.md

diff --git a/gee-rpc/day4-timeout/client_test.go b/gee-rpc/day4-timeout/client_test.go
index ab2fa64..c5c1d1f 100644
--- a/gee-rpc/day4-timeout/client_test.go
+++ b/gee-rpc/day4-timeout/client_test.go
@@ -45,6 +45,7 @@ func TestClient_Call(t *testing.T) {
 	addrCh := make(chan string)
 	go startServer(addrCh)
 	addr := <-addrCh
+	time.Sleep(time.Second)
 	t.Run("client timeout", func(t *testing.T) {
 		client, _ := Dial("tcp", addr)
 		ctx, _ := context.WithTimeout(context.Background(), time.Second)
diff --git a/gee-rpc/day5-http-debug/client_test.go b/gee-rpc/day5-http-debug/client_test.go
index 10b9817..bd46675 100644
--- a/gee-rpc/day5-http-debug/client_test.go
+++ b/gee-rpc/day5-http-debug/client_test.go
@@ -47,6 +47,7 @@ func TestClient_Call(t *testing.T) {
 	addrCh := make(chan string)
 	go startServer(addrCh)
 	addr := <-addrCh
+	time.Sleep(time.Second)
 	t.Run("client timeout", func(t *testing.T) {
 		client, _ := Dial("tcp", addr)
 		ctx, _ := context.WithTimeout(context.Background(), time.Second)
diff --git a/gee-rpc/day6-load-balance/client_test.go b/gee-rpc/day6-load-balance/client_test.go
index 10b9817..bd46675 100644
--- a/gee-rpc/day6-load-balance/client_test.go
+++ b/gee-rpc/day6-load-balance/client_test.go
@@ -47,6 +47,7 @@ func TestClient_Call(t *testing.T) {
 	addrCh := make(chan string)
 	go startServer(addrCh)
 	addr := <-addrCh
+	time.Sleep(time.Second)
 	t.Run("client timeout", func(t *testing.T) {
 		client, _ := Dial("tcp", addr)
 		ctx, _ := context.WithTimeout(context.Background(), time.Second)
diff --git a/gee-rpc/day7-registry/client_test.go b/gee-rpc/day7-registry/client_test.go
index 10b9817..bd46675 100644
--- a/gee-rpc/day7-registry/client_test.go
+++ b/gee-rpc/day7-registry/client_test.go
@@ -47,6 +47,7 @@ func TestClient_Call(t *testing.T) {
 	addrCh := make(chan string)
 	go startServer(addrCh)
 	addr := <-addrCh
+	time.Sleep(time.Second)
 	t.Run("client timeout", func(t *testing.T) {
 		client, _ := Dial("tcp", addr)
 		ctx, _ := context.WithTimeout(context.Background(), time.Second)
diff --git a/gee-rpc/doc/geerpc-day3.md b/gee-rpc/doc/geerpc-day3.md
new file mode 100644
index 0000000..7a0c4af
--- /dev/null
+++ b/gee-rpc/doc/geerpc-day3.md
@@ -0,0 +1,495 @@
+---
+title: 动手写RPC框架 - GeeRPC第三天 服务注册(service register)
+date: 2020-10-07 19:00:00
+description: 7天用 Go语言/golang 从零实现 RPC 框架 GeeRPC 教程(7 days implement golang remote procedure call framework from scratch tutorial)，动手写 RPC 框架，参照 golang 标准库 net/rpc 的实现，实现了服务端(server)、支持异步和并发的客户端(client)、消息编码与解码(message encoding and decoding)、服务注册(service register)、支持 TCP/Unix/HTTP 等多种传输协议。第三天实现了服务注册，即将 Go 语言结构体通过反射映射为服务。
+tags:
+- Go
+nav: 从零实现
+categories:
+- RPC框架 - GeeRPC
+keywords:
+- Go语言
+- 从零实现RPC框架
+- 反射
+- 服务
+image: post/geerpc/geerpc.jpg
+github: https://github.com/geektutu/7days-golang
+---
+
+![golang RPC framework](geerpc/geerpc.jpg)
+
+本文是[7天用Go从零实现RPC框架GeeRPC]的第三篇。
+
+- 通过反射实现服务注册功能
+- 在服务端实现服务调用，代码约 150 行
+
+## 结构体映射为服务
+
+RPC 框架的一个基础能力是：像调用本地程序一样调用远程服务。那如何将程序映射为服务呢？那么对 Go 来说，这个问题就变成了如何将结构体的方法映射为服务。
+
+对 `net/rpc` 而言，一个函数需要能够被远程调用，需要满足如下五个条件：
+
+- the method's type is exported. -- 方法所属类型是导出的。
+- the method is exported. -- 方式是导出的。
+- the method has two arguments, both exported (or builtin) types. -- 两个入参，均为导出或内置类型。
+- the method's second argument is a pointer. -- 第二个入参必须是一个指针。
+- the method has return type error. -- 返回值为 error 类型。
+
+更直观一些：
+
+```go
+func (t *T) MethodName(argType T1, replyType *T2) error
+```
+
+假设客户端发过来一个请求，包含 ServiceMethod 和 Argv。
+
+```json
+{
+    "ServiceMethod"： "T.MethodName"
+    "Argv"："0101110101..." // 序列化之后的字节流
+}
+```
+
+通过 "T.MethodName" 可以确定调用的是类型 T 的 MethodName，如果硬编码实现这个功能，很可能是这样：
+
+```go
+switch req.ServiceMethod {
+    case "T.MethodName":
+        t := new(t)
+        reply := new(T2)
+        var argv T1
+        gob.NewDecoder(conn).Decode(&argv)
+        err := t.MethodName(argv, reply)
+        server.sendMessage(reply, err)
+    case "Foo.Sum":
+        f := new(Foo)
+        ...
+}
+```
+
+也就是说，如果使用硬编码的方式来实现结构体与服务的映射，那么每暴露一个方法，就需要编写等量的代码。那有没有什么方式，能够将这个映射过程自动化呢？可以借助反射。
+
+通过反射，我们能够非常容易地获取某个结构体的所有方法，并且能够通过方法，获取到该方法所有的参数类型与返回值。例如：
+
+```go
+func main() {
+	var wg sync.WaitGroup
+	typ := reflect.TypeOf(&wg)
+	for i := 0; i < typ.NumMethod(); i++ {
+		method := typ.Method(i)
+		argv := make([]string, 0, method.Type.NumIn())
+        returns := make([]string, 0, method.Type.NumIn())
+        // j 从 1 开始，第 0 个入参是 wg 自己。
+		for j := 1; j < method.Type.NumIn(); j++ {
+			argv = append(argv, method.Type.In(j).Name())
+		}
+		for j := 0; j < method.Type.NumOut(); j++ {
+			returns = append(returns, method.Type.Out(j).Name())
+		}
+		log.Printf("func (w *%s) %s(%s) %s",
+			typ.Elem().Name(),
+			method.Name,
+			strings.Join(argv, ","),
+			strings.Join(returns, ","))
+    }
+}
+```
+
+运行的结果是：
+
+```go
+func (w *WaitGroup) Add(int)
+func (w *WaitGroup) Done()
+func (w *WaitGroup) Wait()
+```
+
+## 通过反射实现 service
+
+前面两天我们完成了客户端和服务端，客户端相对来说功能是比较完整的，但是服务端的功能并不完整，仅仅将请求的 header 打印了出来，并没有真正地处理。那今天的主要目的是补全这部分功能。首先通过反射实现结构体与服务的映射关系，代码独立放置在 `service.go` 中。
+
+[day3-service/service.go](https://github.com/geektutu/7days-golang/tree/master/gee-rpc/day3-service)
+
+第一步，定义结构体 methodType：
+
+```go
+type methodType struct {
+	method    reflect.Method
+	ArgType   reflect.Type
+	ReplyType reflect.Type
+	numCalls  uint64
+}
+
+func (m *methodType) NumCalls() uint64 {
+	return atomic.LoadUint64(&m.numCalls)
+}
+
+func (m *methodType) newArgv() reflect.Value {
+	var argv reflect.Value
+	// arg may be a pointer type, or a value type
+	if m.ArgType.Kind() == reflect.Ptr {
+		argv = reflect.New(m.ArgType.Elem())
+	} else {
+		argv = reflect.New(m.ArgType).Elem()
+	}
+	return argv
+}
+
+func (m *methodType) newReplyv() reflect.Value {
+	// reply must be a pointer type
+	replyv := reflect.New(m.ReplyType.Elem())
+	switch m.ReplyType.Elem().Kind() {
+	case reflect.Map:
+		replyv.Elem().Set(reflect.MakeMap(m.ReplyType.Elem()))
+	case reflect.Slice:
+		replyv.Elem().Set(reflect.MakeSlice(m.ReplyType.Elem(), 0, 0))
+	}
+	return replyv
+}
+```
+
+每一个 methodType 实例包含了一个方法的完整信息。包括
+
+- method：方法本身
+- ArgType：第一个参数的类型
+- ReplyType：第二个参数的类型
+- numCalls：后续统计方法调用次数时会用到
+
+另外，我们还实现了 2 个方法 `newArgv` 和 `newReplyv`，用于创建对应类型的实例。`newArgv` 方法有一个小细节，指针类型和值类型创建实例的方式有细微区别。
+
+第二步，定义结构体 service：
+
+```go
+type service struct {
+	name   string
+	typ    reflect.Type
+	rcvr   reflect.Value
+	method map[string]*methodType
+}
+```
+
+service 的定义也是非常简洁的，name 即映射的结构体的名称，比如 `T`，比如 `WaitGroup`；typ 是结构体的类型；rcvr 即结构体的实例本身，保留 rcvr 是因为在调用时需要 rcvr 作为第 0 个参数；method 是 map 类型，存储映射的结构体的所有符合条件的方法。
+
+接下来，完成构造函数 `newService`，入参是任意需要映射为服务的结构体实例。
+
+```go
+func newService(rcvr interface{}) *service {
+	s := new(service)
+	s.rcvr = reflect.ValueOf(rcvr)
+	s.name = reflect.Indirect(s.rcvr).Type().Name()
+	s.typ = reflect.TypeOf(rcvr)
+	if !ast.IsExported(s.name) {
+		log.Fatalf("rpc server: %s is not a valid service name", s.name)
+	}
+	s.registerMethods()
+	return s
+}
+
+func (s *service) registerMethods() {
+	s.method = make(map[string]*methodType)
+	for i := 0; i < s.typ.NumMethod(); i++ {
+		method := s.typ.Method(i)
+		mType := method.Type
+		if mType.NumIn() != 3 || mType.NumOut() != 1 {
+			continue
+		}
+		if mType.Out(0) != reflect.TypeOf((*error)(nil)).Elem() {
+			continue
+		}
+		argType, replyType := mType.In(1), mType.In(2)
+		if !isExportedOrBuiltinType(argType) || !isExportedOrBuiltinType(replyType) {
+			continue
+		}
+		s.method[method.Name] = &methodType{
+			method:    method,
+			ArgType:   argType,
+			ReplyType: replyType,
+		}
+		log.Printf("rpc server: register %s.%s\n", s.name, method.Name)
+	}
+}
+
+func isExportedOrBuiltinType(t reflect.Type) bool {
+	return ast.IsExported(t.Name()) || t.PkgPath() == ""
+}
+```
+
+`registerMethods` 过滤出了符合条件的方法：
+
+- 两个导出或内置类型的入参（反射时为 3 个，第 0 个是自身，类似于 python 的 self，java 中的 this）
+- 返回值有且只有 1 个，类型为 error
+
+最后，我们还需要实现 `call` 方法，即能够通过反射值调用方法。
+
+```go
+func (s *service) call(m *methodType, argv, replyv reflect.Value) error {
+	atomic.AddUint64(&m.numCalls, 1)
+	f := m.method.Func
+	returnValues := f.Call([]reflect.Value{s.rcvr, argv, replyv})
+	if errInter := returnValues[0].Interface(); errInter != nil {
+		return errInter.(error)
+	}
+	return nil
+}
+```
+
+## service 的测试用例
+
+为了保证 service 实现的正确性，我们为 service.go 写了几个测试用例。
+
+[day3-service/service_test.go](https://github.com/geektutu/7days-golang/tree/master/gee-rpc/day3-service)
+
+定义结构体 Foo，实现 2 个方法，导出方法 Sum 和 非导出方法 sum。
+
+```go
+type Foo int
+
+type Args struct{ Num1, Num2 int }
+
+func (f Foo) Sum(args Args, reply *int) error {
+	*reply = args.Num1 + args.Num2
+	return nil
+}
+
+// it's not a exported Method
+func (f Foo) sum(args Args, reply *int) error {
+	*reply = args.Num1 + args.Num2
+	return nil
+}
+
+func _assert(condition bool, msg string, v ...interface{}) {
+	if !condition {
+		panic(fmt.Sprintf("assertion failed: "+msg, v...))
+	}
+}
+```
+
+测试 newService 和 call 方法。
+
+```go
+func TestNewService(t *testing.T) {
+	var foo Foo
+	s := newService(&foo)
+	_assert(len(s.method) == 1, "wrong service Method, expect 1, but got %d", len(s.method))
+	mType := s.method["Sum"]
+	_assert(mType != nil, "wrong Method, Sum shouldn't nil")
+}
+
+func TestMethodType_Call(t *testing.T) {
+	var foo Foo
+	s := newService(&foo)
+	mType := s.method["Sum"]
+
+	argv := mType.newArgv()
+	replyv := mType.newReplyv()
+	argv.Set(reflect.ValueOf(Args{Num1: 1, Num2: 3}))
+	err := s.call(mType, argv, replyv)
+	_assert(err == nil && *replyv.Interface().(*int) == 4 && mType.NumCalls() == 1, "failed to call Foo.Sum")
+}
+```
+
+## 集成到服务端
+
+通过反射结构体已经映射为服务，但请求的处理过程还没有完成。从接收到请求到回复还差以下几个步骤：第一步，根据入参类型，将请求的 body 反序列化；第二步，调用 `service.call`，完成方法调用；第三步，将 reply 序列化为字节流，构造响应报文，返回。
+
+回到代码本身，补全之前在 `server.go` 中遗留的 2 个 TODO 任务 `readRequest` 和 `handleRequest` 即可。
+
+在这之前，我们还需要为 Server 实现一个方法 `Register`。
+
+[day3-service/server.go](https://github.com/geektutu/7days-golang/tree/master/gee-rpc/day3-service)
+
+```go
+// Server represents an RPC Server.
+type Server struct {
+	serviceMap sync.Map
+}
+
+// Register publishes in the server the set of methods of the
+func (server *Server) Register(rcvr interface{}) error {
+	s := newService(rcvr)
+	if _, dup := server.serviceMap.LoadOrStore(s.name, s); dup {
+		return errors.New("rpc: service already defined: " + s.name)
+	}
+	return nil
+}
+
+// Register publishes the receiver's methods in the DefaultServer.
+func Register(rcvr interface{}) error { return DefaultServer.Register(rcvr) }
+```
+
+配套实现 `findService` 方法，即通过 `ServiceMethod` 从 serviceMap 中找到对应的 service
+
+```go
+func (server *Server) findService(serviceMethod string) (svc *service, mtype *methodType, err error) {
+	dot := strings.LastIndex(serviceMethod, ".")
+	if dot < 0 {
+		err = errors.New("rpc server: service/method request ill-formed: " + serviceMethod)
+		return
+	}
+	serviceName, methodName := serviceMethod[:dot], serviceMethod[dot+1:]
+	svci, ok := server.serviceMap.Load(serviceName)
+	if !ok {
+		err = errors.New("rpc server: can't find service " + serviceName)
+		return
+	}
+	svc = svci.(*service)
+	mtype = svc.method[methodName]
+	if mtype == nil {
+		err = errors.New("rpc server: can't find method " + methodName)
+	}
+	return
+}
+```
+
+`findService` 的实现看似比较繁琐，但是逻辑还是非常清晰的。因为 ServiceMethod 的构成是 "Service.Method"，因此先将其分割成 2 部分，第一部分是 Service 的名称，第二部分即方法名。现在 serviceMap 中找到对应的 service 实例，再从 service 实例的 method 中，找到对应的 methodType。
+
+准备工具已经就绪，我们首先补全 readRequest 方法：
+
+```go
+// request stores all information of a call
+type request struct {
+	h            *codec.Header // header of request
+	argv, replyv reflect.Value // argv and replyv of request
+	mtype        *methodType
+	svc          *service
+}
+
+func (server *Server) readRequest(cc codec.Codec) (*request, error) {
+	h, err := server.readRequestHeader(cc)
+	if err != nil {
+		return nil, err
+	}
+	req := &request{h: h}
+	req.svc, req.mtype, err = server.findService(h.ServiceMethod)
+	if err != nil {
+		return req, err
+	}
+	req.argv = req.mtype.newArgv()
+	req.replyv = req.mtype.newReplyv()
+
+	// make sure that argvi is a pointer, ReadBody need a pointer as parameter
+	argvi := req.argv.Interface()
+	if req.argv.Type().Kind() != reflect.Ptr {
+		argvi = req.argv.Addr().Interface()
+	}
+	if err = cc.ReadBody(argvi); err != nil {
+		log.Println("rpc server: read body err:", err)
+		return req, err
+	}
+	return req, nil
+}
+```
+
+readRequest 方法中最重要的部分，即通过 `newArgv()` 和 `newReplyv()` 两个方法创建出两个入参实例，然后通过 `cc.ReadBody()` 将请求报文反序列化为第一个入参 argv，在这里同样需要注意 argv 可能是值类型，也可能是指针类型，所以处理方式有点差异。
+
+接下来补全 handleRequest 方法：
+
+```go
+func (server *Server) handleRequest(cc codec.Codec, req *request, sending *sync.Mutex, wg *sync.WaitGroup) {
+	defer wg.Done()
+	err := req.svc.call(req.mtype, req.argv, req.replyv)
+	if err != nil {
+		req.h.Error = err.Error()
+		server.sendResponse(cc, req.h, invalidRequest, sending)
+		return
+	}
+	server.sendResponse(cc, req.h, req.replyv.Interface(), sending)
+}
+```
+
+相对于 readRequest，handleRequest 的实现非常简单，通过 `req.svc.call` 完成方法调用，将 replyv 传递给 sendResponse 完成序列化即可。
+
+到这里，今天的所有内容已经实现完成，成功在服务端实现了服务注册与调用。
+
+## Demo
+
+最后，还是需要写一个可执行程序(main)验证今天的成果。
+
+[day3-service/main/main.go](https://github.com/geektutu/7days-golang/tree/master/gee-rpc/day3-service)
+
+第一步，定义结构体 Foo 和方法 Sum
+
+```go
+package main
+
+import (
+	"geerpc"
+	"log"
+	"net"
+	"sync"
+	"time"
+)
+
+type Foo int
+
+type Args struct{ Num1, Num2 int }
+
+func (f Foo) Sum(args Args, reply *int) error {
+	*reply = args.Num1 + args.Num2
+	return nil
+}
+```
+
+第二步，注册 Foo 到 Server 中，并启动 RPC 服务
+
+```go
+func startServer(addr chan string) {
+	var foo Foo
+	if err := geerpc.Register(&foo); err != nil {
+		log.Fatal("register error:", err)
+	}
+	// pick a free port
+	l, err := net.Listen("tcp", ":0")
+	if err != nil {
+		log.Fatal("network error:", err)
+	}
+	log.Println("start rpc server on", l.Addr())
+	addr <- l.Addr().String()
+	geerpc.Accept(l)
+}
+```
+
+第三步，构造参数，发送 RPC 请求，并打印结果。
+
+```go
+func main() {
+	log.SetFlags(0)
+	addr := make(chan string)
+	go startServer(addr)
+	client, _ := geerpc.Dial("tcp", <-addr)
+	defer func() { _ = client.Close() }()
+
+	time.Sleep(time.Second)
+	// send request & receive response
+	var wg sync.WaitGroup
+	for i := 0; i < 5; i++ {
+		wg.Add(1)
+		go func(i int) {
+			defer wg.Done()
+			args := &Args{Num1: i, Num2: i * i}
+			var reply int
+			if err := client.Call("Foo.Sum", args, &reply); err != nil {
+				log.Fatal("call Foo.Sum error:", err)
+			}
+			log.Printf("%d + %d = %d", args.Num1, args.Num2, reply)
+		}(i)
+	}
+	wg.Wait()
+}
+```
+
+运行结果如下：
+
+```bash
+rpc server: register Foo.Sum
+start rpc server on [::]:57509
+1 + 1 = 2
+2 + 4 = 6
+3 + 9 = 12
+0 + 0 = 0
+4 + 16 = 20
+```
+
+## 附 推荐阅读
+
+- [Go 语言简明教程](https://geektutu.com/post/quick-golang.html)
+- [Go 语言笔试面试题](https://geektutu.com/post/qa-golang.html)
\ No newline at end of file

From 28f1449d61d14db1936b8def0ce7d7a076b66a48 Mon Sep 17 00:00:00 2001
From: gzdaijie <gzdaijie@gmail.com>
Date: Thu, 8 Oct 2020 01:05:16 +0800
Subject: [PATCH 094/122] gee-rpc: if client is nil, close the connection

---
 gee-rpc/day2-client/client.go            | 20 ++++++------
 gee-rpc/day3-service/client.go           | 21 +++++++------
 gee-rpc/day4-timeout/client.go           | 39 ++++++++++++------------
 gee-rpc/day4-timeout/client_test.go      | 11 ++++---
 gee-rpc/day5-http-debug/client.go        | 38 +++++++++++------------
 gee-rpc/day5-http-debug/client_test.go   | 11 ++++---
 gee-rpc/day6-load-balance/client.go      | 38 +++++++++++------------
 gee-rpc/day6-load-balance/client_test.go | 11 ++++---
 gee-rpc/day7-registry/client.go          | 38 +++++++++++------------
 gee-rpc/day7-registry/client_test.go     | 11 ++++---
 gee-rpc/doc/geerpc-day2.md               | 20 ++++++------
 11 files changed, 135 insertions(+), 123 deletions(-)

diff --git a/gee-rpc/day2-client/client.go b/gee-rpc/day2-client/client.go
index 1c8a3cb..4af2ebf 100644
--- a/gee-rpc/day2-client/client.go
+++ b/gee-rpc/day2-client/client.go
@@ -226,19 +226,21 @@ func newClientCodec(cc codec.Codec, opt *Option) *Client {
 	return client
 }
 
-func dial(network, address string, opt *Option) (*Client, error) {
-	conn, err := net.Dial(network, address)
+// Dial connects to an RPC server at the specified network address
+func Dial(network, address string, opts ...*Option) (client *Client, err error) {
+	opt, err := parseOptions(opts...)
 	if err != nil {
 		return nil, err
 	}
-	return NewClient(conn, opt)
-}
-
-// Dial connects to an RPC server at the specified network address
-func Dial(network, address string, opts ...*Option) (*Client, error) {
-	opt, err := parseOptions(opts...)
+	conn, err := net.Dial(network, address)
 	if err != nil {
 		return nil, err
 	}
-	return dial(network, address, opt)
+	// close the connection if client is nil
+	defer func() {
+		if client == nil {
+			_ = conn.Close()
+		}
+	}()
+	return NewClient(conn, opt)
 }
diff --git a/gee-rpc/day3-service/client.go b/gee-rpc/day3-service/client.go
index 1c8a3cb..77c9436 100644
--- a/gee-rpc/day3-service/client.go
+++ b/gee-rpc/day3-service/client.go
@@ -209,7 +209,6 @@ func NewClient(conn net.Conn, opt *Option) (*Client, error) {
 	// send options with server
 	if err := json.NewEncoder(conn).Encode(opt); err != nil {
 		log.Println("rpc client: options error: ", err)
-		_ = conn.Close()
 		return nil, err
 	}
 	return newClientCodec(f(conn), opt), nil
@@ -226,19 +225,21 @@ func newClientCodec(cc codec.Codec, opt *Option) *Client {
 	return client
 }
 
-func dial(network, address string, opt *Option) (*Client, error) {
-	conn, err := net.Dial(network, address)
+// Dial connects to an RPC server at the specified network address
+func Dial(network, address string, opts ...*Option) (client *Client, err error) {
+	opt, err := parseOptions(opts...)
 	if err != nil {
 		return nil, err
 	}
-	return NewClient(conn, opt)
-}
-
-// Dial connects to an RPC server at the specified network address
-func Dial(network, address string, opts ...*Option) (*Client, error) {
-	opt, err := parseOptions(opts...)
+	conn, err := net.Dial(network, address)
 	if err != nil {
 		return nil, err
 	}
-	return dial(network, address, opt)
+	// close the connection if client is nil
+	defer func() {
+		if client == nil {
+			_ = conn.Close()
+		}
+	}()
+	return NewClient(conn, opt)
 }
diff --git a/gee-rpc/day4-timeout/client.go b/gee-rpc/day4-timeout/client.go
index 45fc9e6..29af7aa 100644
--- a/gee-rpc/day4-timeout/client.go
+++ b/gee-rpc/day4-timeout/client.go
@@ -207,18 +207,17 @@ func parseOptions(opts ...*Option) (*Option, error) {
 	return opt, nil
 }
 
-func NewClient(conn net.Conn, opt *Option) (*Client, error) {
+func NewClient(conn net.Conn, opt *Option) (client *Client, err error) {
 	f := codec.NewCodecFuncMap[opt.CodecType]
 	if f == nil {
-		err := fmt.Errorf("invalid codec type %s", opt.CodecType)
+		err = fmt.Errorf("invalid codec type %s", opt.CodecType)
 		log.Println("rpc client: codec error:", err)
-		return nil, err
+		return
 	}
 	// send options with server
-	if err := json.NewEncoder(conn).Encode(opt); err != nil {
+	if err = json.NewEncoder(conn).Encode(opt); err != nil {
 		log.Println("rpc client: options error: ", err)
-		_ = conn.Close()
-		return nil, err
+		return
 	}
 	return newClientCodec(f(conn), opt), nil
 }
@@ -239,16 +238,26 @@ type clientResult struct {
 	err    error
 }
 
-type dialFunc func(network, address string, opt *Option) (client *Client, err error)
+type newClientFunc func(conn net.Conn, opt *Option) (client *Client, err error)
 
-func dialTimeout(f dialFunc, network, address string, opts ...*Option) (*Client, error) {
+func dialTimeout(f newClientFunc, network, address string, opts ...*Option) (client *Client, err error) {
 	opt, err := parseOptions(opts...)
 	if err != nil {
 		return nil, err
 	}
+	conn, err := net.Dial(network, address)
+	if err != nil {
+		return nil, err
+	}
+	// close the connection if client is nil
+	defer func() {
+		if client == nil {
+			_ = conn.Close()
+		}
+	}()
 	ch := make(chan clientResult)
 	go func() {
-		client, err := f(network, address, opt)
+		client, err := f(conn, opt)
 		ch <- clientResult{client: client, err: err}
 	}()
 	if opt.ConnectTimeout == 0 {
@@ -257,21 +266,13 @@ func dialTimeout(f dialFunc, network, address string, opts ...*Option) (*Client,
 	}
 	select {
 	case <-time.After(opt.ConnectTimeout):
-		return nil, fmt.Errorf("rpc client: dial timeout: expect within %s", opt.ConnectTimeout)
+		return nil, fmt.Errorf("rpc client: connect timeout: expect within %s", opt.ConnectTimeout)
 	case result := <-ch:
 		return result.client, result.err
 	}
 }
 
-func dial(network, address string, opt *Option) (*Client, error) {
-	conn, err := net.Dial(network, address)
-	if err != nil {
-		return nil, err
-	}
-	return NewClient(conn, opt)
-}
-
 // Dial connects to an RPC server at the specified network address
 func Dial(network, address string, opts ...*Option) (*Client, error) {
-	return dialTimeout(dial, network, address, opts...)
+	return dialTimeout(NewClient, network, address, opts...)
 }
diff --git a/gee-rpc/day4-timeout/client_test.go b/gee-rpc/day4-timeout/client_test.go
index c5c1d1f..4488455 100644
--- a/gee-rpc/day4-timeout/client_test.go
+++ b/gee-rpc/day4-timeout/client_test.go
@@ -26,16 +26,19 @@ func startServer(addr chan string) {
 
 func TestClient_dialTimeout(t *testing.T) {
 	t.Parallel()
-	f := func(network, address string, opt *Option) (client *Client, err error) {
+	l, _ := net.Listen("tcp", ":0")
+
+	f := func(conn net.Conn, opt *Option) (client *Client, err error) {
+		_ = conn.Close()
 		time.Sleep(time.Second * 2)
 		return nil, nil
 	}
 	t.Run("timeout", func(t *testing.T) {
-		_, err := dialTimeout(f, "", "", &Option{ConnectTimeout: time.Second})
-		_assert(err != nil && strings.Contains(err.Error(), "dial timeout"), "expect a timeout error")
+		_, err := dialTimeout(f, "tcp", l.Addr().String(), &Option{ConnectTimeout: time.Second})
+		_assert(err != nil && strings.Contains(err.Error(), "connect timeout"), "expect a timeout error")
 	})
 	t.Run("0", func(t *testing.T) {
-		_, err := dialTimeout(f, "", "", &Option{ConnectTimeout: 0})
+		_, err := dialTimeout(f, "tcp", l.Addr().String(), &Option{ConnectTimeout: 0})
 		_assert(err == nil, "0 means no limit")
 	})
 }
diff --git a/gee-rpc/day5-http-debug/client.go b/gee-rpc/day5-http-debug/client.go
index bdc2c0f..b8b57f7 100644
--- a/gee-rpc/day5-http-debug/client.go
+++ b/gee-rpc/day5-http-debug/client.go
@@ -242,16 +242,26 @@ type clientResult struct {
 	err    error
 }
 
-type dialFunc func(network, address string, opt *Option) (client *Client, err error)
+type newClientFunc func(conn net.Conn, opt *Option) (client *Client, err error)
 
-func dialTimeout(f dialFunc, network, address string, opts ...*Option) (*Client, error) {
+func dialTimeout(f newClientFunc, network, address string, opts ...*Option) (client *Client, err error) {
 	opt, err := parseOptions(opts...)
 	if err != nil {
 		return nil, err
 	}
+	conn, err := net.Dial(network, address)
+	if err != nil {
+		return nil, err
+	}
+	// close the connection if client is nil
+	defer func() {
+		if client == nil {
+			_ = conn.Close()
+		}
+	}()
 	ch := make(chan clientResult)
 	go func() {
-		client, err := f(network, address, opt)
+		client, err := f(conn, opt)
 		ch <- clientResult{client: client, err: err}
 	}()
 	if opt.ConnectTimeout == 0 {
@@ -260,30 +270,19 @@ func dialTimeout(f dialFunc, network, address string, opts ...*Option) (*Client,
 	}
 	select {
 	case <-time.After(opt.ConnectTimeout):
-		return nil, fmt.Errorf("rpc client: dial timeout: expect within %s", opt.ConnectTimeout)
+		return nil, fmt.Errorf("rpc client: connect timeout: expect within %s", opt.ConnectTimeout)
 	case result := <-ch:
 		return result.client, result.err
 	}
 }
 
-func dial(network, address string, opt *Option) (*Client, error) {
-	conn, err := net.Dial(network, address)
-	if err != nil {
-		return nil, err
-	}
-	return NewClient(conn, opt)
-}
-
 // Dial connects to an RPC server at the specified network address
 func Dial(network, address string, opts ...*Option) (*Client, error) {
-	return dialTimeout(dial, network, address, opts...)
+	return dialTimeout(NewClient, network, address, opts...)
 }
 
-func dialHTTP(network, address string, opt *Option) (*Client, error) {
-	conn, err := net.Dial(network, address)
-	if err != nil {
-		return nil, err
-	}
+// NewHTTPClient new a Client instance via HTTP as transport protocol
+func NewHTTPClient(conn net.Conn, opt *Option) (*Client, error) {
 	_, _ = io.WriteString(conn, fmt.Sprintf("CONNECT %s HTTP/1.0\n\n", defaultRPCPath))
 
 	// Require successful HTTP response
@@ -295,14 +294,13 @@ func dialHTTP(network, address string, opt *Option) (*Client, error) {
 	if err == nil {
 		err = errors.New("unexpected HTTP response: " + resp.Status)
 	}
-	_ = conn.Close()
 	return nil, err
 }
 
 // DialHTTP connects to an HTTP RPC server at the specified network address
 // listening on the default HTTP RPC path.
 func DialHTTP(network, address string, opts ...*Option) (*Client, error) {
-	return dialTimeout(dialHTTP, network, address, opts...)
+	return dialTimeout(NewHTTPClient, network, address, opts...)
 }
 
 // XDial calls different functions to connect to a RPC server
diff --git a/gee-rpc/day5-http-debug/client_test.go b/gee-rpc/day5-http-debug/client_test.go
index bd46675..3b13cb0 100644
--- a/gee-rpc/day5-http-debug/client_test.go
+++ b/gee-rpc/day5-http-debug/client_test.go
@@ -28,16 +28,19 @@ func startServer(addr chan string) {
 
 func TestClient_dialTimeout(t *testing.T) {
 	t.Parallel()
-	f := func(network, address string, opt *Option) (client *Client, err error) {
+	l, _ := net.Listen("tcp", ":0")
+
+	f := func(conn net.Conn, opt *Option) (client *Client, err error) {
+		_ = conn.Close()
 		time.Sleep(time.Second * 2)
 		return nil, nil
 	}
 	t.Run("timeout", func(t *testing.T) {
-		_, err := dialTimeout(f, "", "", &Option{ConnectTimeout: time.Second})
-		_assert(err != nil && strings.Contains(err.Error(), "dial timeout"), "expect a timeout error")
+		_, err := dialTimeout(f, "tcp", l.Addr().String(), &Option{ConnectTimeout: time.Second})
+		_assert(err != nil && strings.Contains(err.Error(), "connect timeout"), "expect a timeout error")
 	})
 	t.Run("0", func(t *testing.T) {
-		_, err := dialTimeout(f, "", "", &Option{ConnectTimeout: 0})
+		_, err := dialTimeout(f, "tcp", l.Addr().String(), &Option{ConnectTimeout: 0})
 		_assert(err == nil, "0 means no limit")
 	})
 }
diff --git a/gee-rpc/day6-load-balance/client.go b/gee-rpc/day6-load-balance/client.go
index bdc2c0f..b8b57f7 100644
--- a/gee-rpc/day6-load-balance/client.go
+++ b/gee-rpc/day6-load-balance/client.go
@@ -242,16 +242,26 @@ type clientResult struct {
 	err    error
 }
 
-type dialFunc func(network, address string, opt *Option) (client *Client, err error)
+type newClientFunc func(conn net.Conn, opt *Option) (client *Client, err error)
 
-func dialTimeout(f dialFunc, network, address string, opts ...*Option) (*Client, error) {
+func dialTimeout(f newClientFunc, network, address string, opts ...*Option) (client *Client, err error) {
 	opt, err := parseOptions(opts...)
 	if err != nil {
 		return nil, err
 	}
+	conn, err := net.Dial(network, address)
+	if err != nil {
+		return nil, err
+	}
+	// close the connection if client is nil
+	defer func() {
+		if client == nil {
+			_ = conn.Close()
+		}
+	}()
 	ch := make(chan clientResult)
 	go func() {
-		client, err := f(network, address, opt)
+		client, err := f(conn, opt)
 		ch <- clientResult{client: client, err: err}
 	}()
 	if opt.ConnectTimeout == 0 {
@@ -260,30 +270,19 @@ func dialTimeout(f dialFunc, network, address string, opts ...*Option) (*Client,
 	}
 	select {
 	case <-time.After(opt.ConnectTimeout):
-		return nil, fmt.Errorf("rpc client: dial timeout: expect within %s", opt.ConnectTimeout)
+		return nil, fmt.Errorf("rpc client: connect timeout: expect within %s", opt.ConnectTimeout)
 	case result := <-ch:
 		return result.client, result.err
 	}
 }
 
-func dial(network, address string, opt *Option) (*Client, error) {
-	conn, err := net.Dial(network, address)
-	if err != nil {
-		return nil, err
-	}
-	return NewClient(conn, opt)
-}
-
 // Dial connects to an RPC server at the specified network address
 func Dial(network, address string, opts ...*Option) (*Client, error) {
-	return dialTimeout(dial, network, address, opts...)
+	return dialTimeout(NewClient, network, address, opts...)
 }
 
-func dialHTTP(network, address string, opt *Option) (*Client, error) {
-	conn, err := net.Dial(network, address)
-	if err != nil {
-		return nil, err
-	}
+// NewHTTPClient new a Client instance via HTTP as transport protocol
+func NewHTTPClient(conn net.Conn, opt *Option) (*Client, error) {
 	_, _ = io.WriteString(conn, fmt.Sprintf("CONNECT %s HTTP/1.0\n\n", defaultRPCPath))
 
 	// Require successful HTTP response
@@ -295,14 +294,13 @@ func dialHTTP(network, address string, opt *Option) (*Client, error) {
 	if err == nil {
 		err = errors.New("unexpected HTTP response: " + resp.Status)
 	}
-	_ = conn.Close()
 	return nil, err
 }
 
 // DialHTTP connects to an HTTP RPC server at the specified network address
 // listening on the default HTTP RPC path.
 func DialHTTP(network, address string, opts ...*Option) (*Client, error) {
-	return dialTimeout(dialHTTP, network, address, opts...)
+	return dialTimeout(NewHTTPClient, network, address, opts...)
 }
 
 // XDial calls different functions to connect to a RPC server
diff --git a/gee-rpc/day6-load-balance/client_test.go b/gee-rpc/day6-load-balance/client_test.go
index bd46675..3b13cb0 100644
--- a/gee-rpc/day6-load-balance/client_test.go
+++ b/gee-rpc/day6-load-balance/client_test.go
@@ -28,16 +28,19 @@ func startServer(addr chan string) {
 
 func TestClient_dialTimeout(t *testing.T) {
 	t.Parallel()
-	f := func(network, address string, opt *Option) (client *Client, err error) {
+	l, _ := net.Listen("tcp", ":0")
+
+	f := func(conn net.Conn, opt *Option) (client *Client, err error) {
+		_ = conn.Close()
 		time.Sleep(time.Second * 2)
 		return nil, nil
 	}
 	t.Run("timeout", func(t *testing.T) {
-		_, err := dialTimeout(f, "", "", &Option{ConnectTimeout: time.Second})
-		_assert(err != nil && strings.Contains(err.Error(), "dial timeout"), "expect a timeout error")
+		_, err := dialTimeout(f, "tcp", l.Addr().String(), &Option{ConnectTimeout: time.Second})
+		_assert(err != nil && strings.Contains(err.Error(), "connect timeout"), "expect a timeout error")
 	})
 	t.Run("0", func(t *testing.T) {
-		_, err := dialTimeout(f, "", "", &Option{ConnectTimeout: 0})
+		_, err := dialTimeout(f, "tcp", l.Addr().String(), &Option{ConnectTimeout: 0})
 		_assert(err == nil, "0 means no limit")
 	})
 }
diff --git a/gee-rpc/day7-registry/client.go b/gee-rpc/day7-registry/client.go
index bdc2c0f..b8b57f7 100644
--- a/gee-rpc/day7-registry/client.go
+++ b/gee-rpc/day7-registry/client.go
@@ -242,16 +242,26 @@ type clientResult struct {
 	err    error
 }
 
-type dialFunc func(network, address string, opt *Option) (client *Client, err error)
+type newClientFunc func(conn net.Conn, opt *Option) (client *Client, err error)
 
-func dialTimeout(f dialFunc, network, address string, opts ...*Option) (*Client, error) {
+func dialTimeout(f newClientFunc, network, address string, opts ...*Option) (client *Client, err error) {
 	opt, err := parseOptions(opts...)
 	if err != nil {
 		return nil, err
 	}
+	conn, err := net.Dial(network, address)
+	if err != nil {
+		return nil, err
+	}
+	// close the connection if client is nil
+	defer func() {
+		if client == nil {
+			_ = conn.Close()
+		}
+	}()
 	ch := make(chan clientResult)
 	go func() {
-		client, err := f(network, address, opt)
+		client, err := f(conn, opt)
 		ch <- clientResult{client: client, err: err}
 	}()
 	if opt.ConnectTimeout == 0 {
@@ -260,30 +270,19 @@ func dialTimeout(f dialFunc, network, address string, opts ...*Option) (*Client,
 	}
 	select {
 	case <-time.After(opt.ConnectTimeout):
-		return nil, fmt.Errorf("rpc client: dial timeout: expect within %s", opt.ConnectTimeout)
+		return nil, fmt.Errorf("rpc client: connect timeout: expect within %s", opt.ConnectTimeout)
 	case result := <-ch:
 		return result.client, result.err
 	}
 }
 
-func dial(network, address string, opt *Option) (*Client, error) {
-	conn, err := net.Dial(network, address)
-	if err != nil {
-		return nil, err
-	}
-	return NewClient(conn, opt)
-}
-
 // Dial connects to an RPC server at the specified network address
 func Dial(network, address string, opts ...*Option) (*Client, error) {
-	return dialTimeout(dial, network, address, opts...)
+	return dialTimeout(NewClient, network, address, opts...)
 }
 
-func dialHTTP(network, address string, opt *Option) (*Client, error) {
-	conn, err := net.Dial(network, address)
-	if err != nil {
-		return nil, err
-	}
+// NewHTTPClient new a Client instance via HTTP as transport protocol
+func NewHTTPClient(conn net.Conn, opt *Option) (*Client, error) {
 	_, _ = io.WriteString(conn, fmt.Sprintf("CONNECT %s HTTP/1.0\n\n", defaultRPCPath))
 
 	// Require successful HTTP response
@@ -295,14 +294,13 @@ func dialHTTP(network, address string, opt *Option) (*Client, error) {
 	if err == nil {
 		err = errors.New("unexpected HTTP response: " + resp.Status)
 	}
-	_ = conn.Close()
 	return nil, err
 }
 
 // DialHTTP connects to an HTTP RPC server at the specified network address
 // listening on the default HTTP RPC path.
 func DialHTTP(network, address string, opts ...*Option) (*Client, error) {
-	return dialTimeout(dialHTTP, network, address, opts...)
+	return dialTimeout(NewHTTPClient, network, address, opts...)
 }
 
 // XDial calls different functions to connect to a RPC server
diff --git a/gee-rpc/day7-registry/client_test.go b/gee-rpc/day7-registry/client_test.go
index bd46675..3b13cb0 100644
--- a/gee-rpc/day7-registry/client_test.go
+++ b/gee-rpc/day7-registry/client_test.go
@@ -28,16 +28,19 @@ func startServer(addr chan string) {
 
 func TestClient_dialTimeout(t *testing.T) {
 	t.Parallel()
-	f := func(network, address string, opt *Option) (client *Client, err error) {
+	l, _ := net.Listen("tcp", ":0")
+
+	f := func(conn net.Conn, opt *Option) (client *Client, err error) {
+		_ = conn.Close()
 		time.Sleep(time.Second * 2)
 		return nil, nil
 	}
 	t.Run("timeout", func(t *testing.T) {
-		_, err := dialTimeout(f, "", "", &Option{ConnectTimeout: time.Second})
-		_assert(err != nil && strings.Contains(err.Error(), "dial timeout"), "expect a timeout error")
+		_, err := dialTimeout(f, "tcp", l.Addr().String(), &Option{ConnectTimeout: time.Second})
+		_assert(err != nil && strings.Contains(err.Error(), "connect timeout"), "expect a timeout error")
 	})
 	t.Run("0", func(t *testing.T) {
-		_, err := dialTimeout(f, "", "", &Option{ConnectTimeout: 0})
+		_, err := dialTimeout(f, "tcp", l.Addr().String(), &Option{ConnectTimeout: 0})
 		_assert(err == nil, "0 means no limit")
 	})
 }
diff --git a/gee-rpc/doc/geerpc-day2.md b/gee-rpc/doc/geerpc-day2.md
index 2d356e3..bf4db48 100644
--- a/gee-rpc/doc/geerpc-day2.md
+++ b/gee-rpc/doc/geerpc-day2.md
@@ -243,21 +243,23 @@ func parseOptions(opts ...*Option) (*Option, error) {
 	return opt, nil
 }
 
-func dial(network, address string, opt *Option) (*Client, error) {
-	conn, err := net.Dial(network, address)
+// Dial connects to an RPC server at the specified network address
+func Dial(network, address string, opts ...*Option) (client *Client, err error) {
+	opt, err := parseOptions(opts...)
 	if err != nil {
 		return nil, err
 	}
-	return NewClient(conn, opt)
-}
-
-// Dial connects to an RPC server at the specified network address
-func Dial(network, address string, opts ...*Option) (*Client, error) {
-	opt, err := parseOptions(opts...)
+	conn, err := net.Dial(network, address)
 	if err != nil {
 		return nil, err
 	}
-	return dial(network, address, opt)
+	// close the connection if client is nil
+	defer func() {
+		if client == nil {
+			_ = conn.Close()
+		}
+	}()
+	return NewClient(conn, opt)
 }
 ```
 

From 9f58ccc1c9cb44a3fd7c5fe2e1216c3ce529e72f Mon Sep 17 00:00:00 2001
From: gzdaijie <gzdaijie@gmail.com>
Date: Thu, 8 Oct 2020 01:37:53 +0800
Subject: [PATCH 095/122] gee-rpc/day4: add doc

---
 gee-rpc/day2-client/client.go       |   2 +-
 gee-rpc/day3-service/client.go      |   2 +-
 gee-rpc/day4-timeout/client.go      |   4 +-
 gee-rpc/day5-http-debug/client.go   |   4 +-
 gee-rpc/day6-load-balance/client.go |   4 +-
 gee-rpc/day7-registry/client.go     |   4 +-
 gee-rpc/doc/geerpc-day4.md          | 268 ++++++++++++++++++++++++++++
 7 files changed, 278 insertions(+), 10 deletions(-)
 create mode 100644 gee-rpc/doc/geerpc-day4.md

diff --git a/gee-rpc/day2-client/client.go b/gee-rpc/day2-client/client.go
index 4af2ebf..41cff0f 100644
--- a/gee-rpc/day2-client/client.go
+++ b/gee-rpc/day2-client/client.go
@@ -238,7 +238,7 @@ func Dial(network, address string, opts ...*Option) (client *Client, err error)
 	}
 	// close the connection if client is nil
 	defer func() {
-		if client == nil {
+		if err != nil {
 			_ = conn.Close()
 		}
 	}()
diff --git a/gee-rpc/day3-service/client.go b/gee-rpc/day3-service/client.go
index 77c9436..5beef93 100644
--- a/gee-rpc/day3-service/client.go
+++ b/gee-rpc/day3-service/client.go
@@ -237,7 +237,7 @@ func Dial(network, address string, opts ...*Option) (client *Client, err error)
 	}
 	// close the connection if client is nil
 	defer func() {
-		if client == nil {
+		if err != nil {
 			_ = conn.Close()
 		}
 	}()
diff --git a/gee-rpc/day4-timeout/client.go b/gee-rpc/day4-timeout/client.go
index 29af7aa..bc3602a 100644
--- a/gee-rpc/day4-timeout/client.go
+++ b/gee-rpc/day4-timeout/client.go
@@ -245,13 +245,13 @@ func dialTimeout(f newClientFunc, network, address string, opts ...*Option) (cli
 	if err != nil {
 		return nil, err
 	}
-	conn, err := net.Dial(network, address)
+	conn, err := net.DialTimeout(network, address, opt.ConnectTimeout)
 	if err != nil {
 		return nil, err
 	}
 	// close the connection if client is nil
 	defer func() {
-		if client == nil {
+		if err != nil {
 			_ = conn.Close()
 		}
 	}()
diff --git a/gee-rpc/day5-http-debug/client.go b/gee-rpc/day5-http-debug/client.go
index b8b57f7..1a62b1e 100644
--- a/gee-rpc/day5-http-debug/client.go
+++ b/gee-rpc/day5-http-debug/client.go
@@ -249,13 +249,13 @@ func dialTimeout(f newClientFunc, network, address string, opts ...*Option) (cli
 	if err != nil {
 		return nil, err
 	}
-	conn, err := net.Dial(network, address)
+	conn, err := net.DialTimeout(network, address, opt.ConnectTimeout)
 	if err != nil {
 		return nil, err
 	}
 	// close the connection if client is nil
 	defer func() {
-		if client == nil {
+		if err != nil {
 			_ = conn.Close()
 		}
 	}()
diff --git a/gee-rpc/day6-load-balance/client.go b/gee-rpc/day6-load-balance/client.go
index b8b57f7..1a62b1e 100644
--- a/gee-rpc/day6-load-balance/client.go
+++ b/gee-rpc/day6-load-balance/client.go
@@ -249,13 +249,13 @@ func dialTimeout(f newClientFunc, network, address string, opts ...*Option) (cli
 	if err != nil {
 		return nil, err
 	}
-	conn, err := net.Dial(network, address)
+	conn, err := net.DialTimeout(network, address, opt.ConnectTimeout)
 	if err != nil {
 		return nil, err
 	}
 	// close the connection if client is nil
 	defer func() {
-		if client == nil {
+		if err != nil {
 			_ = conn.Close()
 		}
 	}()
diff --git a/gee-rpc/day7-registry/client.go b/gee-rpc/day7-registry/client.go
index b8b57f7..1a62b1e 100644
--- a/gee-rpc/day7-registry/client.go
+++ b/gee-rpc/day7-registry/client.go
@@ -249,13 +249,13 @@ func dialTimeout(f newClientFunc, network, address string, opts ...*Option) (cli
 	if err != nil {
 		return nil, err
 	}
-	conn, err := net.Dial(network, address)
+	conn, err := net.DialTimeout(network, address, opt.ConnectTimeout)
 	if err != nil {
 		return nil, err
 	}
 	// close the connection if client is nil
 	defer func() {
-		if client == nil {
+		if err != nil {
 			_ = conn.Close()
 		}
 	}()
diff --git a/gee-rpc/doc/geerpc-day4.md b/gee-rpc/doc/geerpc-day4.md
new file mode 100644
index 0000000..be573e4
--- /dev/null
+++ b/gee-rpc/doc/geerpc-day4.md
@@ -0,0 +1,268 @@
+---
+title: 动手写RPC框架 - GeeRPC第四天 超时处理(timeout)
+date: 2020-10-07 23:00:00
+description: 7天用 Go语言/golang 从零实现 RPC 框架 GeeRPC 教程(7 days implement golang remote procedure call framework from scratch tutorial)，动手写 RPC 框架，参照 golang 标准库 net/rpc 的实现，实现了服务端(server)、支持异步和并发的客户端(client)、消息编码与解码(message encoding and decoding)、服务注册(service register)、支持 TCP/Unix/HTTP 等多种传输协议。第四天为RPC框架提供了处理超时的能力(timeout processing)。
+tags:
+- Go
+nav: 从零实现
+categories:
+- RPC框架 - GeeRPC
+keywords:
+- Go语言
+- 从零实现RPC框架
+- 连接超时
+image: post/geerpc/geerpc.jpg
+github: https://github.com/geektutu/7days-golang
+---
+
+![golang RPC framework](geerpc/geerpc.jpg)
+
+本文是[7天用Go从零实现RPC框架GeeRPC]的第四篇。
+
+- 增加连接超时的处理机制
+- 增加服务端处理超时的处理机制，代码约 100 行
+
+## 为什么需要超时处理机制
+
+超时处理是 RPC 框架一个比较基本的能力，如果缺少超时处理机制，无论是服务端还是客户端都容易因为网络或其他错误导致挂死，资源耗尽，这些问题的出现大大地降低了服务的可用性。因此，我们需要在 RPC 框架中加入超时处理的能力。
+
+纵观整个远程调用的过程，需要客户端处理超时的地方有：
+
+- 与服务端建立连接，导致的超时
+- 发送请求到服务端，写报文导致的超时
+- 等待服务端处理时，等待处理导致的超时（比如服务端已挂死，迟迟不响应）
+- 从服务端接收响应时，读报文导致的超时
+
+需要服务端处理超时的地方有：
+
+- 读取客户端请求报文时，读报文导致的超时
+- 发送响应报文时，写报文导致的超时
+- 调用映射服务的方法时，处理报文导致的超时
+
+
+GeeRPC 在 3 个地方添加了超时处理机制。分别是：
+
+1）客户端创建连接时
+2）客户端 `Client.Call()` 整个过程导致的超时（包含发送报文，等待处理，接收报文所有阶段）
+3）服务端处理报文，即 `Server.handleRequest` 超时。
+
+## 创建连接超时
+
+为了实现上的简单，将超时设定放在了 Option 中。ConnectTimeout 默认值为 10s，HandleTimeout 默认值为 0，即不设限。
+
+```go
+type Option struct {
+	MagicNumber    int           // MagicNumber marks this's a geerpc request
+	CodecType      codec.Type    // client may choose different Codec to encode body
+	ConnectTimeout time.Duration // 0 means no limit
+	HandleTimeout  time.Duration
+}
+
+var DefaultOption = &Option{
+	MagicNumber:    MagicNumber,
+	CodecType:      codec.GobType,
+	ConnectTimeout: time.Second * 10,
+}
+```
+
+客户端连接超时，只需要为 Dial 添加一层超时处理的外壳即可。
+
+[day4-timeout/client.go](https://github.com/geektutu/7days-golang/tree/master/gee-rpc/day4-timeout)
+
+```go
+type clientResult struct {
+	client *Client
+	err    error
+}
+
+type newClientFunc func(conn net.Conn, opt *Option) (client *Client, err error)
+
+func dialTimeout(f newClientFunc, network, address string, opts ...*Option) (client *Client, err error) {
+	opt, err := parseOptions(opts...)
+	if err != nil {
+		return nil, err
+	}
+	conn, err := net.DialTimeout(network, address, opt.ConnectTimeout)
+	if err != nil {
+		return nil, err
+	}
+	// close the connection if client is nil
+	defer func() {
+		if err != nil {
+			_ = conn.Close()
+		}
+	}()
+	ch := make(chan clientResult)
+	go func() {
+		client, err := f(conn, opt)
+		ch <- clientResult{client: client, err: err}
+	}()
+	if opt.ConnectTimeout == 0 {
+		result := <-ch
+		return result.client, result.err
+	}
+	select {
+	case <-time.After(opt.ConnectTimeout):
+		return nil, fmt.Errorf("rpc client: connect timeout: expect within %s", opt.ConnectTimeout)
+	case result := <-ch:
+		return result.client, result.err
+	}
+}
+
+// Dial connects to an RPC server at the specified network address
+func Dial(network, address string, opts ...*Option) (*Client, error) {
+	return dialTimeout(NewClient, network, address, opts...)
+}
+```
+
+在这里实现了一个超时处理的外壳 `dialTimeout`，这个壳将 NewClient 作为入参，在 2 个地方添加了超时处理的机制。
+
+1) 将 `net.Dial` 替换为 `net.DialTimeout`，如果连接创建超时，将返回错误。
+2）使用子协程执行 NewClient，执行完成后则通过信道 ch 发送结果，如果 `time.After()` 信道先接收到消息，则说明 NewClient 执行超时，返回错误。
+
+## Client.Call 超时
+
+`Client.Call` 的超时处理机制，使用 context 包实现，控制权交给用户，控制更为灵活。
+
+```go
+// Call invokes the named function, waits for it to complete,
+// and returns its error status.
+func (client *Client) Call(ctx context.Context, serviceMethod string, args, reply interface{}) error {
+	call := client.Go(serviceMethod, args, reply, make(chan *Call, 1))
+	select {
+	case <-ctx.Done():
+		client.removeCall(call.Seq)
+		return errors.New("rpc client: call failed: " + ctx.Err().Error())
+	case call := <-call.Done:
+		return call.Error
+	}
+}
+```
+
+用户可以使用 `context.WithTimeout` 创建具备超时检测能力的 context 对象来控制。例如：
+
+```go
+ctx, _ := context.WithTimeout(context.Background(), time.Second)
+var reply int
+err := client.Call(ctx, "Foo.Sum", &Args{1, 2}, &reply)
+...
+```
+
+## 服务端处理超时
+
+这一部分的实现与客户端很接近，使用 `time.After()` 结合 `select+chan` 完成。
+
+[day4-timeout/server.go](https://github.com/geektutu/7days-golang/tree/master/gee-rpc/day4-timeout)
+
+```go
+func (server *Server) handleRequest(cc codec.Codec, req *request, sending *sync.Mutex, wg *sync.WaitGroup, timeout time.Duration) {
+	defer wg.Done()
+	called := make(chan struct{})
+	sent := make(chan struct{})
+	go func() {
+		err := req.svc.call(req.mtype, req.argv, req.replyv)
+		called <- struct{}{}
+		if err != nil {
+			req.h.Error = err.Error()
+			server.sendResponse(cc, req.h, invalidRequest, sending)
+			sent <- struct{}{}
+			return
+		}
+		server.sendResponse(cc, req.h, req.replyv.Interface(), sending)
+		sent <- struct{}{}
+	}()
+
+	if timeout == 0 {
+		<-called
+		<-sent
+		return
+	}
+	select {
+	case <-time.After(timeout):
+		req.h.Error = fmt.Sprintf("rpc server: request handle timeout: expect within %s", timeout)
+		server.sendResponse(cc, req.h, invalidRequest, sending)
+	case <-called:
+		<-sent
+	}
+}
+```
+
+这里需要确保 `sendResponse` 仅调用一次，因此将整个过程拆分为 `called` 和 `sent` 两个阶段，在这段代码中只会发生如下两种情况：
+
+1) called 信道接收到消息，代表处理没有超时，继续执行 sendResponse。
+2) `time.After()` 先于 called 接收到消息，说明处理已经超时，called 和 sent 都将被阻塞。在 `case <-time.After(timeout)` 处调用 `sendResponse`。
+
+## 测试用例
+
+第一个测试用例，用于测试连接超时。NewClient 函数耗时 2s，ConnectionTimeout 分别设置为 1s 和 0 两种场景。
+
+[day4-timeout/client_test.go](https://github.com/geektutu/7days-golang/tree/master/gee-rpc/day4-timeout)
+
+```go
+func TestClient_dialTimeout(t *testing.T) {
+	t.Parallel()
+	l, _ := net.Listen("tcp", ":0")
+
+	f := func(conn net.Conn, opt *Option) (client *Client, err error) {
+		_ = conn.Close()
+		time.Sleep(time.Second * 2)
+		return nil, nil
+	}
+	t.Run("timeout", func(t *testing.T) {
+		_, err := dialTimeout(f, "tcp", l.Addr().String(), &Option{ConnectTimeout: time.Second})
+		_assert(err != nil && strings.Contains(err.Error(), "connect timeout"), "expect a timeout error")
+	})
+	t.Run("0", func(t *testing.T) {
+		_, err := dialTimeout(f, "tcp", l.Addr().String(), &Option{ConnectTimeout: 0})
+		_assert(err == nil, "0 means no limit")
+	})
+}
+```
+
+第二个测试用例，用于测试处理超时。`Bar.Timeout` 耗时 2s，场景一：客户端设置超时时间为 1s，服务端无限制；场景二，服务端设置超时时间为1s，客户端无限制。
+
+```go
+type Bar int
+
+func (b Bar) Timeout(argv int, reply *int) error {
+	time.Sleep(time.Second * 2)
+	return nil
+}
+
+func startServer(addr chan string) {
+	var b Bar
+	_ = Register(&b)
+	// pick a free port
+	l, _ := net.Listen("tcp", ":0")
+	addr <- l.Addr().String()
+	Accept(l)
+}
+
+func TestClient_Call(t *testing.T) {
+	t.Parallel()
+	addrCh := make(chan string)
+	go startServer(addrCh)
+	addr := <-addrCh
+	time.Sleep(time.Second)
+	t.Run("client timeout", func(t *testing.T) {
+		client, _ := Dial("tcp", addr)
+		ctx, _ := context.WithTimeout(context.Background(), time.Second)
+		var reply int
+		err := client.Call(ctx, "Bar.Timeout", 1, &reply)
+		_assert(err != nil && strings.Contains(err.Error(), ctx.Err().Error()), "expect a timeout error")
+	})
+	t.Run("server handle timeout", func(t *testing.T) {
+		client, _ := Dial("tcp", addr, &Option{
+			HandleTimeout: time.Second,
+		})
+		var reply int
+		err := client.Call(context.Background(), "Bar.Timeout", 1, &reply)
+		_assert(err != nil && strings.Contains(err.Error(), "handle timeout"), "expect a timeout error")
+	})
+}
+```
+
+## 附 推荐阅读
+
+- [Go 语言简明教程](https://geektutu.com/post/quick-golang.html)
+- [Go 语言笔试面试题](https://geektutu.com/post/qa-golang.html)
\ No newline at end of file

From e871cb3b8bc9037c33f37e867a81dc272bb978cd Mon Sep 17 00:00:00 2001
From: gzdaijie <gzdaijie@gmail.com>
Date: Thu, 8 Oct 2020 12:39:49 +0800
Subject: [PATCH 096/122] gee-rpc: doc add day5 day6 day7

---
 gee-rpc/day6-load-balance/main/main.go        |   3 +-
 .../day6-load-balance/xclient/discovery.go    |  14 +-
 gee-rpc/day7-registry/main/main.go            |  11 +-
 gee-rpc/day7-registry/registry/registry.go    |  36 +-
 gee-rpc/day7-registry/xclient/discovery.go    |   5 +-
 gee-rpc/doc/geerpc-day1.md                    |   4 +-
 gee-rpc/doc/geerpc-day2.md                    |   2 +-
 gee-rpc/doc/geerpc-day3.md                    |   2 +-
 gee-rpc/doc/geerpc-day4.md                    |   2 +-
 gee-rpc/doc/geerpc-day5.md                    | 374 +++++++++++++++
 gee-rpc/doc/geerpc-day5/geerpc_debug.png      | Bin 0 -> 5823 bytes
 gee-rpc/doc/geerpc-day6.md                    | 438 ++++++++++++++++++
 gee-rpc/doc/geerpc-day7.md                    | 395 ++++++++++++++++
 gee-rpc/doc/geerpc-day7/registry.jpg          | Bin 0 -> 19887 bytes
 14 files changed, 1251 insertions(+), 35 deletions(-)
 create mode 100644 gee-rpc/doc/geerpc-day5.md
 create mode 100644 gee-rpc/doc/geerpc-day5/geerpc_debug.png
 create mode 100644 gee-rpc/doc/geerpc-day6.md
 create mode 100644 gee-rpc/doc/geerpc-day7.md
 create mode 100644 gee-rpc/doc/geerpc-day7/registry.jpg

diff --git a/gee-rpc/day6-load-balance/main/main.go b/gee-rpc/day6-load-balance/main/main.go
index 550e848..2a476b7 100644
--- a/gee-rpc/day6-load-balance/main/main.go
+++ b/gee-rpc/day6-load-balance/main/main.go
@@ -46,7 +46,7 @@ func foo(xc *xclient.XClient, ctx context.Context, typ, serviceMethod string, ar
 	if err != nil {
 		log.Printf("%s %s error: %v", typ, serviceMethod, err)
 	} else {
-		log.Printf("%s Foo.Sum success: %d + %d = %d", typ, args.Num1, args.Num2, reply)
+		log.Printf("%s %s success: %d + %d = %d", typ, serviceMethod, args.Num1, args.Num2, reply)
 	}
 }
 
@@ -69,6 +69,7 @@ func call(addr1, addr2 string) {
 func broadcast(addr1, addr2 string) {
 	d := xclient.NewMultiServerDiscovery([]string{"tcp@" + addr1, "tcp@" + addr2})
 	xc := xclient.NewXClient(d, xclient.RandomSelect, nil)
+	defer func() { _ = xc.Close() }()
 	var wg sync.WaitGroup
 	for i := 0; i < 5; i++ {
 		wg.Add(1)
diff --git a/gee-rpc/day6-load-balance/xclient/discovery.go b/gee-rpc/day6-load-balance/xclient/discovery.go
index f823a7b..70d1cbb 100644
--- a/gee-rpc/day6-load-balance/xclient/discovery.go
+++ b/gee-rpc/day6-load-balance/xclient/discovery.go
@@ -2,6 +2,7 @@ package xclient
 
 import (
 	"errors"
+	"math"
 	"math/rand"
 	"sync"
 	"time"
@@ -49,15 +50,16 @@ func (d *MultiServersDiscovery) Update(servers []string) error {
 func (d *MultiServersDiscovery) Get(mode SelectMode) (string, error) {
 	d.mu.Lock()
 	defer d.mu.Unlock()
-	if len(d.servers) == 0 {
+	n := len(d.servers)
+	if n == 0 {
 		return "", errors.New("rpc discovery: no available servers")
 	}
 	switch mode {
 	case RandomSelect:
-		return d.servers[d.r.Intn(len(d.servers))], nil
+		return d.servers[d.r.Intn(n)], nil
 	case RoundRobinSelect:
-		s := d.servers[d.index]
-		d.index = (d.index + 1) % len(d.servers)
+		s := d.servers[d.index%n] // servers could be updated, so mode n to ensure safety
+		d.index = (d.index + 1) % n
 		return s, nil
 	default:
 		return "", errors.New("rpc discovery: not supported select mode")
@@ -76,8 +78,10 @@ func (d *MultiServersDiscovery) GetAll() ([]string, error) {
 
 // NewMultiServerDiscovery creates a MultiServersDiscovery instance
 func NewMultiServerDiscovery(servers []string) *MultiServersDiscovery {
-	return &MultiServersDiscovery{
+	d := &MultiServersDiscovery{
 		servers: servers,
 		r:       rand.New(rand.NewSource(time.Now().UnixNano())),
 	}
+	d.index = d.r.Intn(math.MaxInt32 - 1)
+	return d
 }
diff --git a/gee-rpc/day7-registry/main/main.go b/gee-rpc/day7-registry/main/main.go
index 50b57dd..1797707 100644
--- a/gee-rpc/day7-registry/main/main.go
+++ b/gee-rpc/day7-registry/main/main.go
@@ -3,7 +3,7 @@ package main
 import (
 	"context"
 	"geerpc"
-	registy "geerpc/registry"
+	"geerpc/registry"
 	"geerpc/xclient"
 	"log"
 	"net"
@@ -29,17 +29,17 @@ func (f Foo) Sleep(args Args, reply *int) error {
 
 func startRegistry(wg *sync.WaitGroup) {
 	l, _ := net.Listen("tcp", ":9999")
-	registy.HandleHTTP()
+	registry.HandleHTTP()
 	wg.Done()
 	_ = http.Serve(l, nil)
 }
 
-func startServer(registry string, wg *sync.WaitGroup) {
+func startServer(registryAddr string, wg *sync.WaitGroup) {
 	var foo Foo
 	l, _ := net.Listen("tcp", ":0")
 	server := geerpc.NewServer()
 	_ = server.Register(&foo)
-	registy.Heartbeat(registry, "tcp@"+l.Addr().String(), 0)
+	registry.Heartbeat(registryAddr, "tcp@"+l.Addr().String(), 0)
 	wg.Done()
 	server.Accept(l)
 }
@@ -56,7 +56,7 @@ func foo(xc *xclient.XClient, ctx context.Context, typ, serviceMethod string, ar
 	if err != nil {
 		log.Printf("%s %s error: %v", typ, serviceMethod, err)
 	} else {
-		log.Printf("%s Foo.Sum success: %d + %d = %d", typ, args.Num1, args.Num2, reply)
+		log.Printf("%s %s success: %d + %d = %d", typ, serviceMethod, args.Num1, args.Num2, reply)
 	}
 }
 
@@ -79,6 +79,7 @@ func call(registry string) {
 func broadcast(registry string) {
 	d := xclient.NewGeeRegistryDiscovery(registry, 0)
 	xc := xclient.NewXClient(d, xclient.RandomSelect, nil)
+	defer func() { _ = xc.Close() }()
 	var wg sync.WaitGroup
 	for i := 0; i < 5; i++ {
 		wg.Add(1)
diff --git a/gee-rpc/day7-registry/registry/registry.go b/gee-rpc/day7-registry/registry/registry.go
index 2c22244..29d23a8 100644
--- a/gee-rpc/day7-registry/registry/registry.go
+++ b/gee-rpc/day7-registry/registry/registry.go
@@ -1,4 +1,4 @@
-package registy
+package registry
 
 import (
 	"log"
@@ -9,10 +9,10 @@ import (
 	"time"
 )
 
-// Registry is a simple register center, provide following functions.
+// GeeRegistry is a simple register center, provide following functions.
 // add a server and receive heartbeat to keep it alive.
 // returns all alive servers and delete dead servers sync simultaneously.
-type Registry struct {
+type GeeRegistry struct {
 	timeout time.Duration
 	mu      sync.Mutex // protect following
 	servers map[string]*ServerItem
@@ -23,17 +23,22 @@ type ServerItem struct {
 	start time.Time
 }
 
+const (
+	defaultPath    = "/_geerpc_/registry"
+	defaultTimeout = time.Minute * 5
+)
+
 // New create a registry instance with timeout setting
-func New(timeout time.Duration) *Registry {
-	return &Registry{
+func New(timeout time.Duration) *GeeRegistry {
+	return &GeeRegistry{
 		servers: make(map[string]*ServerItem),
 		timeout: timeout,
 	}
 }
 
-var DefaultRegister = New(defaultTimeout)
+var DefaultGeeRegister = New(defaultTimeout)
 
-func (r *Registry) putServer(addr string) {
+func (r *GeeRegistry) putServer(addr string) {
 	r.mu.Lock()
 	defer r.mu.Unlock()
 	s := r.servers[addr]
@@ -44,7 +49,7 @@ func (r *Registry) putServer(addr string) {
 	}
 }
 
-func (r *Registry) aliveServers() []string {
+func (r *GeeRegistry) aliveServers() []string {
 	r.mu.Lock()
 	defer r.mu.Unlock()
 	var alive []string
@@ -59,13 +64,8 @@ func (r *Registry) aliveServers() []string {
 	return alive
 }
 
-const (
-	defaultPath    = "/_geerpc_/registry"
-	defaultTimeout = time.Minute * 5
-)
-
 // Runs at /_geerpc_/registry
-func (r *Registry) ServeHTTP(w http.ResponseWriter, req *http.Request) {
+func (r *GeeRegistry) ServeHTTP(w http.ResponseWriter, req *http.Request) {
 	switch req.Method {
 	case "GET":
 		// keep it simple, server is in req.Header
@@ -83,14 +83,14 @@ func (r *Registry) ServeHTTP(w http.ResponseWriter, req *http.Request) {
 	}
 }
 
-// HandleHTTP registers an HTTP handler for Registry messages on registryPath
-func (r *Registry) HandleHTTP(registryPath string) {
+// HandleHTTP registers an HTTP handler for GeeRegistry messages on registryPath
+func (r *GeeRegistry) HandleHTTP(registryPath string) {
 	http.Handle(registryPath, r)
 	log.Println("rpc registry path:", registryPath)
 }
 
 func HandleHTTP() {
-	DefaultRegister.HandleHTTP(defaultPath)
+	DefaultGeeRegister.HandleHTTP(defaultPath)
 }
 
 // Heartbeat send a heartbeat message every once in a while
@@ -113,7 +113,7 @@ func Heartbeat(registry, addr string, duration time.Duration) {
 }
 
 func sendHeartbeat(registry, addr string) error {
-	log.Println(addr, "send heart beat to registry")
+	log.Println(addr, "send heart beat to registry", registry)
 	httpClient := &http.Client{}
 	req, _ := http.NewRequest("POST", registry, nil)
 	req.Header.Set("X-Geerpc-Server", addr)
diff --git a/gee-rpc/day7-registry/xclient/discovery.go b/gee-rpc/day7-registry/xclient/discovery.go
index 783ec4a..70d1cbb 100644
--- a/gee-rpc/day7-registry/xclient/discovery.go
+++ b/gee-rpc/day7-registry/xclient/discovery.go
@@ -2,6 +2,7 @@ package xclient
 
 import (
 	"errors"
+	"math"
 	"math/rand"
 	"sync"
 	"time"
@@ -77,8 +78,10 @@ func (d *MultiServersDiscovery) GetAll() ([]string, error) {
 
 // NewMultiServerDiscovery creates a MultiServersDiscovery instance
 func NewMultiServerDiscovery(servers []string) *MultiServersDiscovery {
-	return &MultiServersDiscovery{
+	d := &MultiServersDiscovery{
 		servers: servers,
 		r:       rand.New(rand.NewSource(time.Now().UnixNano())),
 	}
+	d.index = d.r.Intn(math.MaxInt32 - 1)
+	return d
 }
diff --git a/gee-rpc/doc/geerpc-day1.md b/gee-rpc/doc/geerpc-day1.md
index abfeb3c..51db1fb 100644
--- a/gee-rpc/doc/geerpc-day1.md
+++ b/gee-rpc/doc/geerpc-day1.md
@@ -19,7 +19,7 @@ github: https://github.com/geektutu/7days-golang
 
 ![golang RPC framework](geerpc/geerpc.jpg)
 
-本文是[7天用Go从零实现RPC框架GeeRPC]的第一篇。
+本文是[7天用Go从零实现RPC框架GeeRPC](https://geektutu.com/post/geerpc.html)的第一篇。
 
 - 使用 `encoding/gob` 实现消息的编解码(序列化与反序列化)
 - 实现一个简易的服务端，仅接受消息，不处理，代码约 200 行
@@ -54,7 +54,7 @@ type Header struct {
 - Error 是错误信息，客户端置为空，服务端如果如果发生错误，将错误信息置于 Error 中。
 
 
-我们将和消息编解码相关的代码都防到 codec 目录中。
+我们将和消息编解码相关的代码都防到 codec 子目录中，在此之前，还需要在根目录下使用 `go mod init geerpc` 初始化项目，方便后续子 package 之间的引用。
 
 进一步，抽象出对消息体进行编解码的接口 Codec，抽象出接口是为了实现不同的 Codec 实例：
 
diff --git a/gee-rpc/doc/geerpc-day2.md b/gee-rpc/doc/geerpc-day2.md
index bf4db48..ff2ce20 100644
--- a/gee-rpc/doc/geerpc-day2.md
+++ b/gee-rpc/doc/geerpc-day2.md
@@ -19,7 +19,7 @@ github: https://github.com/geektutu/7days-golang
 
 ![golang RPC framework](geerpc/geerpc.jpg)
 
-本文是[7天用Go从零实现RPC框架GeeRPC]的第二篇。
+本文是[7天用Go从零实现RPC框架GeeRPC](https://geektutu.com/post/geerpc.html)的第二篇。
 
 - 实现一个支持异步和并发的高性能客户端，代码约 250 行
 
diff --git a/gee-rpc/doc/geerpc-day3.md b/gee-rpc/doc/geerpc-day3.md
index 7a0c4af..d1a6982 100644
--- a/gee-rpc/doc/geerpc-day3.md
+++ b/gee-rpc/doc/geerpc-day3.md
@@ -18,7 +18,7 @@ github: https://github.com/geektutu/7days-golang
 
 ![golang RPC framework](geerpc/geerpc.jpg)
 
-本文是[7天用Go从零实现RPC框架GeeRPC]的第三篇。
+本文是[7天用Go从零实现RPC框架GeeRPC](https://geektutu.com/post/geerpc.html)的第三篇。
 
 - 通过反射实现服务注册功能
 - 在服务端实现服务调用，代码约 150 行
diff --git a/gee-rpc/doc/geerpc-day4.md b/gee-rpc/doc/geerpc-day4.md
index be573e4..b249d2e 100644
--- a/gee-rpc/doc/geerpc-day4.md
+++ b/gee-rpc/doc/geerpc-day4.md
@@ -17,7 +17,7 @@ github: https://github.com/geektutu/7days-golang
 
 ![golang RPC framework](geerpc/geerpc.jpg)
 
-本文是[7天用Go从零实现RPC框架GeeRPC]的第四篇。
+本文是[7天用Go从零实现RPC框架GeeRPC](https://geektutu.com/post/geerpc.html)的第四篇。
 
 - 增加连接超时的处理机制
 - 增加服务端处理超时的处理机制，代码约 100 行
diff --git a/gee-rpc/doc/geerpc-day5.md b/gee-rpc/doc/geerpc-day5.md
new file mode 100644
index 0000000..5b1797d
--- /dev/null
+++ b/gee-rpc/doc/geerpc-day5.md
@@ -0,0 +1,374 @@
+---
+title: 动手写RPC框架 - GeeRPC第五天 支持HTTP协议
+date: 2020-10-08 11:00:00
+description: 7天用 Go语言/golang 从零实现 RPC 框架 GeeRPC 教程(7 days implement golang remote procedure call framework from scratch tutorial)，动手写 RPC 框架，参照 golang 标准库 net/rpc 的实现，实现了服务端(server)、支持异步和并发的客户端(client)、消息编码与解码(message encoding and decoding)、服务注册(service register)、支持 TCP/Unix/HTTP 等多种传输协议。第五天支持了 HTTP 协议，并且提供了一个简单的 DEBUG 页面。
+tags:
+- Go
+nav: 从零实现
+categories:
+- RPC框架 - GeeRPC
+keywords:
+- Go语言
+- 从零实现RPC框架
+- HTTP
+- debug
+image: post/geerpc/geerpc.jpg
+github: https://github.com/geektutu/7days-golang
+---
+
+![golang RPC framework](geerpc/geerpc.jpg)
+
+本文是[7天用Go从零实现RPC框架GeeRPC](https://geektutu.com/post/geerpc.html)的第五篇。
+
+- 支持 HTTP 协议
+- 基于 HTTP 实现一个简单的 Debug 页面，代码约 150 行。
+
+## 支持 HTTP 协议需要做什么？
+
+Web 开发中，我们经常使用 HTTP 协议中的 HEAD、GET、POST 等方式发送请求，等待响应。但 RPC 的消息格式与标准的 HTTP 协议并不兼容，在这种情况下，就需要一个协议的转换过程。HTTP 协议的 CONNECT 方法恰好提供了这个能力，CONNECT 一般用于代理服务。
+
+假设浏览器与服务器之间的 HTTPS 通信都是加密的，浏览器通过代理服务器发起 HTTPS 请求时，由于请求的站点地址和端口号都是加密保存在 HTTPS 请求报文头中的，代理服务器如何知道往哪里发送请求呢？为了解决这个问题，浏览器通过 HTTP 明文形式向代理服务器发送一个 CONNECT 请求告诉代理服务器目标地址和端口，代理服务器接收到这个请求后，会在对应端口与目标站点建立一个 TCP 连接，连接建立成功后返回 HTTP 200 状态码告诉浏览器与该站点的加密通道已经完成。接下来代理服务器仅需透传浏览器和服务器之间的加密数据包即可，代理服务器无需解析 HTTPS 报文。
+
+举一个简单例子：
+
+1) 浏览器向代理服务器发送 CONNECT 请求。
+
+```bash
+CONNECT geektutu.com:443 HTTP/1.0
+```
+
+2) 代理服务器返回 HTTP 200 状态码表示连接已经建立。
+
+```bash
+HTTP/1.0 200 Connection Established
+```
+
+3) 之后浏览器和服务器开始 HTTPS 握手并交换加密数据，代理服务器只负责传输彼此的数据包，并不能读取具体数据内容（代理服务器也可以选择安装可信根证书解密 HTTPS 报文）。
+
+事实上，这个过程其实是通过代理服务器将 HTTP 协议转换为 HTTPS 协议的过程。对 RPC 服务端来，需要做的是将 HTTP 协议转换为 RPC 协议，对客户端来说，需要新增通过 HTTP CONNECT 请求创建连接的逻辑。
+
+
+## 服务端支持 HTTP 协议
+
+那通信过程应该是这样的：
+
+1) 客户端向 RPC 服务器发送 CONNECT 请求
+
+```bash
+CONNECT 10.0.0.1:9999/_geerpc_ HTTP/1.0
+```
+
+2) RPC 服务器返回 HTTP 200 状态码表示连接建立。
+
+```bash
+HTTP/1.0 200 Connected to Gee RPC
+```
+
+3) 客户端使用创建好的连接发送 RPC 报文，先发送 Option，再发送 N 个请求报文，服务端处理 RPC 请求并响应。
+
+在 `server.go` 中新增如下的方法：
+
+[day5-http-debug/server.go](https://github.com/geektutu/7days-golang/tree/master/gee-rpc/day5-http-debug)
+
+```go
+const (
+	connected        = "200 Connected to Gee RPC"
+	defaultRPCPath   = "/_geeprc_"
+	defaultDebugPath = "/debug/geerpc"
+)
+
+// ServeHTTP implements an http.Handler that answers RPC requests.
+func (server *Server) ServeHTTP(w http.ResponseWriter, req *http.Request) {
+	if req.Method != "CONNECT" {
+		w.Header().Set("Content-Type", "text/plain; charset=utf-8")
+		w.WriteHeader(http.StatusMethodNotAllowed)
+		_, _ = io.WriteString(w, "405 must CONNECT\n")
+		return
+	}
+	conn, _, err := w.(http.Hijacker).Hijack()
+	if err != nil {
+		log.Print("rpc hijacking ", req.RemoteAddr, ": ", err.Error())
+		return
+	}
+	_, _ = io.WriteString(conn, "HTTP/1.0 "+connected+"\n\n")
+	server.ServeConn(conn)
+}
+
+// HandleHTTP registers an HTTP handler for RPC messages on rpcPath.
+// It is still necessary to invoke http.Serve(), typically in a go statement.
+func (server *Server) HandleHTTP() {
+	http.Handle(defaultRPCPath, server)
+}
+
+// HandleHTTP is a convenient approach for default server to register HTTP handlers
+func HandleHTTP() {
+	DefaultServer.HandleHTTP()
+}
+```
+
+`defaultDebugPath` 是为后续 DEBUG 页面预留的地址。
+
+在 Go 语言中处理 HTTP 请求是非常简单的一件事，Go 标准库中 `http.Handle` 的实现如下：
+
+```go
+package http
+// Handle registers the handler for the given pattern
+// in the DefaultServeMux.
+// The documentation for ServeMux explains how patterns are matched.
+func Handle(pattern string, handler Handler) { DefaultServeMux.Handle(pattern, handler) }
+```
+
+第一个参数是支持通配的字符串 pattern，在这里，我们固定传入 `/_geeprc_`，第二个参数是 Handler 类型，Handler 是一个接口类型，定义如下：
+
+```go
+type Handler interface {
+    ServeHTTP(w ResponseWriter, r *Request)
+}
+```
+
+也就是说，只需要实现接口 Handler 即可作为一个 HTTP Handler 处理 HTTP 请求。接口 Handler 只定义了一个方法 `ServeHTTP`，实现该方法即可。
+
+> 关于 http.Handler 的更多信息，推荐阅读 [Go语言动手写Web框架 - Gee第一天 http.Handler](https://geektutu.com/post/gee-day1.html)
+
+## 客户端支持 HTTP 协议
+
+服务端已经能够接受 CONNECT 请求，并返回了 200 状态码 `HTTP/1.0 200 Connected to Gee RPC`，客户端要做的，发起 CONNECT 请求，检查返回状态码即可成功建立连接。
+
+[day5-http-debug/client.go](https://github.com/geektutu/7days-golang/tree/master/gee-rpc/day5-http-debug)
+
+```go
+// NewHTTPClient new a Client instance via HTTP as transport protocol
+func NewHTTPClient(conn net.Conn, opt *Option) (*Client, error) {
+	_, _ = io.WriteString(conn, fmt.Sprintf("CONNECT %s HTTP/1.0\n\n", defaultRPCPath))
+
+	// Require successful HTTP response
+	// before switching to RPC protocol.
+	resp, err := http.ReadResponse(bufio.NewReader(conn), &http.Request{Method: "CONNECT"})
+	if err == nil && resp.Status == connected {
+		return NewClient(conn, opt)
+	}
+	if err == nil {
+		err = errors.New("unexpected HTTP response: " + resp.Status)
+	}
+	return nil, err
+}
+
+// DialHTTP connects to an HTTP RPC server at the specified network address
+// listening on the default HTTP RPC path.
+func DialHTTP(network, address string, opts ...*Option) (*Client, error) {
+	return dialTimeout(NewHTTPClient, network, address, opts...)
+}
+```
+
+通过 HTTP CONNECT 请求建立连接之后，后续的通信过程就交给 NewClient 了。
+
+为了简化调用，提供了一个统一入口 `XDial`
+
+```go
+// XDial calls different functions to connect to a RPC server
+// according the first parameter rpcAddr.
+// rpcAddr is a general format (protocol@addr) to represent a rpc server
+// eg, http@10.0.0.1:7001, tcp@10.0.0.1:9999, unix@/tmp/geerpc.sock
+func XDial(rpcAddr string, opts ...*Option) (*Client, error) {
+	parts := strings.Split(rpcAddr, "@")
+	if len(parts) != 2 {
+		return nil, fmt.Errorf("rpc client err: wrong format '%s', expect protocol@addr", rpcAddr)
+	}
+	protocol, addr := parts[0], parts[1]
+	switch protocol {
+	case "http":
+		return DialHTTP("tcp", addr, opts...)
+	default:
+		// tcp, unix or other transport protocol
+		return Dial(protocol, addr, opts...)
+	}
+}
+```
+
+添加一个测试用例试一试，这个测试用例使用了 unix 协议创建 socket 连接，适用于本机内部的通信，使用上与 TCP 协议并无区别。
+
+[day5-http-debug/client_test.go](https://github.com/geektutu/7days-golang/tree/master/gee-rpc/day5-http-debug)
+
+```go
+func TestXDial(t *testing.T) {
+	if runtime.GOOS == "linux" {
+		ch := make(chan struct{})
+		addr := "/tmp/geerpc.sock"
+		go func() {
+			_ = os.Remove(addr)
+			l, err := net.Listen("unix", addr)
+			if err != nil {
+				t.Fatal("failed to listen unix socket")
+			}
+			ch <- struct{}{}
+			Accept(l)
+		}()
+		<-ch
+		_, err := XDial("unix@" + addr)
+		_assert(err == nil, "failed to connect unix socket")
+	}
+}
+```
+
+
+## 实现简单的 DEBUG 页面
+
+支持 HTTP 协议的好处在于，RPC 服务仅仅使用了监听端口的 `/_geerpc` 路径，在其他路径上我们可以提供诸如日志、统计等更为丰富的功能。接下来我们在 `/debug/geerpc` 上展示服务的调用统计视图。
+
+[day5-http-debug/debug.go](https://github.com/geektutu/7days-golang/tree/master/gee-rpc/day5-http-debug)
+
+```go
+package geerpc
+
+import (
+	"fmt"
+	"html/template"
+	"net/http"
+)
+
+const debugText = `<html>
+	<body>
+	<title>GeeRPC Services</title>
+	{{range .}}
+	<hr>
+	Service {{.Name}}
+	<hr>
+		<table>
+		<th align=center>Method</th><th align=center>Calls</th>
+		{{range $name, $mtype := .Method}}
+			<tr>
+			<td align=left font=fixed>{{$name}}({{$mtype.ArgType}}, {{$mtype.ReplyType}}) error</td>
+			<td align=center>{{$mtype.NumCalls}}</td>
+			</tr>
+		{{end}}
+		</table>
+	{{end}}
+	</body>
+	</html>`
+
+var debug = template.Must(template.New("RPC debug").Parse(debugText))
+
+type debugHTTP struct {
+	*Server
+}
+
+type debugService struct {
+	Name   string
+	Method map[string]*methodType
+}
+
+// Runs at /debug/geerpc
+func (server debugHTTP) ServeHTTP(w http.ResponseWriter, req *http.Request) {
+	// Build a sorted version of the data.
+	var services []debugService
+	server.serviceMap.Range(func(namei, svci interface{}) bool {
+		svc := svci.(*service)
+		services = append(services, debugService{
+			Name:   namei.(string),
+			Method: svc.method,
+		})
+		return true
+	})
+	err := debug.Execute(w, services)
+	if err != nil {
+		_, _ = fmt.Fprintln(w, "rpc: error executing template:", err.Error())
+	}
+}
+```
+
+在这里，我们将返回一个 HTML 报文，这个报文将展示注册所有的 service 的每一个方法的调用情况。
+
+将 debugHTTP 实例绑定到地址 `/debug/geerpc`。
+
+```go
+func (server *Server) HandleHTTP() {
+	http.Handle(defaultRPCPath, server)
+	http.Handle(defaultDebugPath, debugHTTP{server})
+	log.Println("rpc server debug path:", defaultDebugPath)
+}
+```
+
+## Demo
+
+OK，我们已经迫不及待地想看看最终的效果了。
+
+[day5-http-debug/main/main.go](https://github.com/geektutu/7days-golang/tree/master/gee-rpc/day5-http-debug)
+
+和之前的例子相比较，将 startServer 中的 `geerpc.Accept()` 替换为了 `geerpc.HandleHTTP()`，端口固定为 9999。
+
+```go
+type Foo int
+
+type Args struct{ Num1, Num2 int }
+
+func (f Foo) Sum(args Args, reply *int) error {
+	*reply = args.Num1 + args.Num2
+	return nil
+}
+
+func startServer(addrCh chan string) {
+	var foo Foo
+	l, _ := net.Listen("tcp", ":9999")
+	_ = geerpc.Register(&foo)
+	geerpc.HandleHTTP()
+	addrCh <- l.Addr().String()
+	_ = http.Serve(l, nil)
+}
+```
+
+客户端将 `Dial` 替换为 `DialHTTP`，其余地方没有发生改变。
+
+```go
+func call(addrCh chan string) {
+	client, _ := geerpc.DialHTTP("tcp", <-addrCh)
+	defer func() { _ = client.Close() }()
+
+	time.Sleep(time.Second)
+	// send request & receive response
+	var wg sync.WaitGroup
+	for i := 0; i < 5; i++ {
+		wg.Add(1)
+		go func(i int) {
+			defer wg.Done()
+			args := &Args{Num1: i, Num2: i * i}
+			var reply int
+			if err := client.Call(context.Background(), "Foo.Sum", args, &reply); err != nil {
+				log.Fatal("call Foo.Sum error:", err)
+			}
+			log.Printf("%d + %d = %d", args.Num1, args.Num2, reply)
+		}(i)
+	}
+	wg.Wait()
+}
+
+func main() {
+	log.SetFlags(0)
+	ch := make(chan string)
+	go call(ch)
+	startServer(ch)
+}
+```
+
+main 函数中，我们在最后调用 `startServer`，服务启动后将一直等待。
+
+运行结果如下：
+
+```bash
+main$ go run .
+rpc server: register Foo.Sum
+rpc server debug path: /debug/geerpc
+3 + 9 = 12
+2 + 4 = 6
+4 + 16 = 20
+0 + 0 = 0
+1 + 1 = 2
+```
+
+服务已经启动，此时我们如果在浏览器中访问 `localhost:9999/debug/geerpc`，将会看到：
+
+![geerpc services debug](geerpc-day5/geerpc_debug.png)
+
+## 附 推荐阅读
+
+- [Go 语言简明教程](https://geektutu.com/post/quick-golang.html)
+- [Go 语言笔试面试题](https://geektutu.com/post/qa-golang.html)
\ No newline at end of file
diff --git a/gee-rpc/doc/geerpc-day5/geerpc_debug.png b/gee-rpc/doc/geerpc-day5/geerpc_debug.png
new file mode 100644
index 0000000000000000000000000000000000000000..b60e390d981df024ca3ae4a69d67cf7e891a4cc0
GIT binary patch
literal 5823
zcmbW4cUTkKw!p_olwO3R2vV#>K?72PfC&U?3K9e<0ttxpCen;j1A>ASMLHM*3aCi$
zB~dv>k)~2Y2aO~uB|@a65MGY=yRY5%zIVR&$LyIkvu4d+d$01FJE-$!V#0F5004+t
zn4h@-03a~`x=L^de=Hk~5#pb=g<dd20#*I{zVihEZzC%s0I1Cn;ky5&DRkA`DHH(2
zyZ$=1y$!Co0sy=1EY29&T}LlY^;93GTztFCGnS2e5Q~eYo;_V#qAa!l@GGQx`r`Ql
z)k8Zn1)NR&WQ5daO!EY5mIWoZe>xRt21+u(DX5(GF+!aSYo3Te*bQB}$#}Nu*p8-$
z%ug~m&Cj(pPiIgsk)G)--F&eP0DPqQ9>g7x;ZMi}!XHvlamCkpTr6{pj?v1%8~7^1
zc?~R*S;o<nl8S?>$Zbt4Zw9>+0luVqArYju@@uS~_L1=VWtZ97)szy5U%3h7Wxy`M
zN{K=A4}!+s5=hGUIVoZFo_g<rK8al>HZtK{zQz?Ox<egtM#jWuXc&Tg^+(7&Cw83M
zy}s4E)ufaGpA)&of8@{_u}c^pSor4oj2@*;EfT>E30+T6f?4C?tHx{AYn<wtXv{i?
zLS$<nXR*Ev%zO-q*IJ0aKbO49P?deR<>?k3m-K@dyJgMn$M7CuR~v)1Nxb2i5BKq&
zd3Wn+1V~EBiRvbC@P0{i;~R5i2AhzqLYQUnJ}XJ=7Ug~KFJrNLNQ2tcjw?l$(sFCW
z#JQf@-23=-DN#ju6T+~O%~^Bd(t1cwjAkWB%uX6~niZeJRqNubd-OS1TNgAFxld?M
znh_f0MM6wiDQgbX`jLx@Mf_}gzUt0o!_YxQ#UE)B^~*{y#`JCS%ykm0yK*_B5Z|%B
z7{i4Tr#d(`dPHb*C1sj3DyuTrw7M!$8Dbj!)2p2bD@@Z4!iPJ}KdJa*#GarmA+S8P
zOt6sDwNuaZf^yUjTd}+moK~g5Zv)H4H!GrVZ;#)1^J%m|LhDv@yw=U=V?TeS(Wurj
z=)1Y@C(oC)){n_h=fmF^8`Z&|uN+w@2%3BV3vNj35D|t0XI{AnL`^HZ8dhlae)PH_
zN^nyfMGg55e?irh8A|RuAp0&RNkw3nxL*uoeao<1sL>y*EVw2m`Y>v(mG!yyEL!B9
zE#S*uzA6M<SXR$BEi2|7`~0VI{IHg%W6Q+Ww@q3jw;!F%!jj2_VxPq7<!;KUSL)$V
zZVJ*VdY>=J2#?4L;-YsZkl2N!;mw>fmwJW@xY1B@K~MG_!ZjfJdgXlwflpkfihw;N
z)AveVue3yU?o?jv#{1lHuW<@2R%XD%k~ufgXXZX>9Snn-Fpu<9CE~6)RX?!SGi^4@
zoqx*-?4}EKH7>Kusv{R!R9?%|d@F6gUJt6O)npKl+|YJ>vEfpk)yT?Z&CeSLgp}Pm
z_vaonohL3U>?uB>R;tiko9^m-j&6miePDD1V~PmYJ@Q%iUC56v$7r~N2Y-_S{Uacb
zq5NgpD~ha7!|eUD(onfk)gxYc)Kfi=IUw6JMT!c3Dd(MSsfvL&kh8OsLF?_qU#X^*
zVz5HmafO-wt@kfGOd**`#pxLoZTFkM)~mIGHygI50?#><vp|8n2&WvaPK$$SuE9fj
zZ^;gdPv&**YG0mt$H7k3J;sJxO<51ZSl6clzw=Bu6Jqnt*!N8>WH|*D|JF-m?1_St
z!Pm}@pQSL?^~cF!g~qbC2TDUK@6NRtN)D{MGlL?kAbt}C3c|?JeA`_IA`WYDP91*b
z=I|Qsnq+YG?w#_fBeIT4MVE$`xGz+|7e03*;geNrGCtC2a+TE?)4a1YdCVgQjw37e
zs7!;sjy0!EsSH1#q8xvSCsoX<{!?a~m!{6Nj{)JRDKl~I&(8!wp$kre=7puI#Zb{6
zP~7t{*J01F`4jS;5BhV1@m0{kx>BZnLbj5<TK(~2715pnf*ls!aNl!m!qld{Dj^Y+
z@9nVr7B1qUs}Lt_?^j*&%tcx0vMg-VshuM`%k7gz!4~yts(w|&zHQ@LGXadRRI_zs
z!XtTa(ZagZ%j{2{bAuP(!!895jUOsWdOX-dlOmJW&^KXYIz`0%yJ?IBoc)C8>N0k+
zCWY*nB;XKokeLQmgH?UF`XXuEexHD;v61Iqd!M5@+MeiQa&V-59bWH+MwNuVeQ5PQ
z(uS@>Q(8%cYbshP(M{PJu;;L6w{Ni@i3ub}MN4LRFgsy9M^bXlIl@>*zTQ-xYX`jI
z7AQJ8Gx}&PT3;N@Dvf6L$5IH&inQ19n{AgbAC4s0&k^=l*DhCK$zsm~dIyb-PFdOU
z-88B3^}hzGP-0v@Z6YOH5l;C6m8;U0UC@-geH5c5`kKl+I@qt#IA&cO)JwH?V4HNE
zm9{Ei8kQa}+=w8!eOkNnWF}Iu`q1t~P$1GN%kpeNH!4d`9+SA^`O~q!aqYU8OT}IR
z&M9&Cbu6EMKho1!(1|fMz>js5_dXwdz?sQzl?WL&j*sR>Nvb#Vea56B;~hQJM<bOb
z>+qPHtmbf1GB5YfjhT}hZ=gJi#8g_%q=s#|Jii5r@b545B-lend9fB@Bo(pdYwLK+
zK^@HA>OMWc*Gucik*^*sF3;=GDXULrEX?J7Cs1F=QZTU>O|2bL+HEEG?xy8>vAp!6
zV|F@MYAPzi^eNo??nDB)CyO?jw%!9Ni0ptD9~q}zepq>@c`nE1ye+&j?_@PXrCY;i
zJ=|@xZDtB9F9`0w3Ulp9dvjxAj)-2^ZW8E_Y8>xqtFC)SS@25|6f>KOIn13PZ6%9~
zP?K?87u?4@%Fe@RV@z!9-dfJv)N!{=ghu9l_s@9vG*1b-k~WG+X(oPiupEqbQdi)8
znvgHG7!U$))&#k}SsQ9PEKg4`35irFa2u&;TS=o>d1x_emu(X6*A+O7Sw_E^C`+60
ziR;$NetFN*HmKA;ojC4+;z1L>!`~^i=&XOp>$=hQohp}4DJXNaSGwJBKk#`n?&oH@
zIzGIJ84c}6m;^dG-vZs+nb32<XjU>_d4nFyqAcBszj!i8Dc&$K{4PJ_WHP)ukeMl4
z`BX;Kdd4q?f_eAANlS8{h``X3+#M;@sKn!aT3Swll@?h_RoACChs;MyDz=Y|5DfVN
z9qx2Ubl)*afx4L$g#^izLxS&Mo1UX^d_kfYqA}w0SUuKS<nh<WxG0PvTH0LlL;23d
zfs+Aj)$M-ApY(;TMwWkaV>%pI5q>Gbv_AVue-(9*d1P>@P7pkF!%u|(B(F|UX0!@P
z7u&h_sgvbknebEDr-{|XV>Nz-*xcQOxJ%Z2<`_%e1MQWN`inWV`CQ{f<Gne<N0cAe
z`NCLE6v-{*v{sT0A2e<rMQ+=D&p{}|i+e8FdH6r0j6Lx>J75HnV9D2e(JTlay+a?s
z!|>5O6Xr&@G!n!In0vbkd~kvw`80(}1OdP!K|bCYx^f1#*pL503`oisi~suUUzm&k
zzRYhUnlh7Z;i>#rN-CsP`9f=GIriu5HoglcHY#=<@ZW^?@7n+ElmENf--@c@;Pt}P
zc}jsl1v-ugfR{wEWZca?ePfMH8j;~6E|W~^+R|0REN`*iN2&BcCIFl_*Oo~%#l}!1
zP=z$Eu+G`$>SR#^0I0M+EVI%6t5AN6Gi=JI#z%6(I(@AMaJ-CgRNObkcJIE`rB-nS
zX+HNTe?Xrrn(D`&`qTaK8e7>J1Bb`XX?*S`51~**FWuk_JKrB+e3RWjvv5s>C)E<y
zJgFz-DkZ?agD<qAW<E^mrTHSeGP=&{FB}LcRhmgodw=7kE%FtuY{7VZa;heb_;hd^
zP@}UQqqV?TNM_t-deLd~a`h5mmhCowG)%2hHTau{81W>Uf|$&ly3s{k%Vrqw&8$;7
zW?Q};aJ#hw8K0%q`}p%nL4y)}1fm+by4ucF3;3EchmG0zAe|wJLbDH(@PT)JGWh|9
zn0RH52W<p4JlrL){MWoc`alHPS2L%&Ib<h0pSa<6x|)FxGoA6R9;H4qxw&y!Kk8!F
z8P!DGhA*yHT2%X&uApVHI1r~@uus_T(`<bi+ExsFT!Ak4M2Gg6Fivn=uz2-BI=;Yy
z;PzTN?zeBIOr+7sbyrP=R*r%&c(G{Z>@2rR1o*Dy1cAg1Scx7@szsq@c5*n<rGG62
zG8?6ARmr`E#;Pn7xQ<smIc3HaPXdv8BiQu^Tx9pZgsS>-15w|3jO_@xFLBou)1?n)
z#zvz#0rEXmjc`2x81bI9h!5Tf$&dWZ3UkVn6#{#eI+#KvdA=si#Hc7obYO?OfsAfd
zYX<b@KQ_-0q8s?BcN?I4IE*OFkG9#N53FPSJczS3raxEa|6QCHE3U?&06<s!Zz$Xr
zh)0bu0KmmFO#h$xluwu)dEv}Y0~wQIN50TstlyWgQ{s1i=@GuH{@o1wTRAf;J9Rp^
z%C&uD#3?jnKw=`R&&tW#nF1}~#K?-z^A<H@i35dc@}FE>*6DL)@*tqy5aRfVWZtgV
z9@yCP?e&X4PJCmwgnRbkQCAJxLbFF$u80^Aa$B77ei^mQWKg~Pbh}Ug7vJ59xR}$4
zIBLCbe|so~Uq@cbNeS<UAmcw4b!mB1m?G@3M4U%9{P3}dhZ^Y_D8MaE5G)e5=llHP
zn<-4uph#?s4_=!Nn<qT-Zy~gaM2*|ASN1ClfyWx`vmg&I4WY4DBAXZab(8sq@Dbjx
zLA`^Fs4PzgQA4}1+ts%d+~VOfE?R}(=u2PZ3$7Z#g}{wvGdbw5<;gfrkG2-6H)78q
z{)PS~q4^MaB-J`O#ZC5@-`XJ3XioE=26Sa683n#u5QNLOC#Q1v{0fLcR0hA_yvD|I
z+@Fbn1H-NMw^2pAzL*B<<nyK?W{OI}-!KPVj-2f8itFq9H7Op0PC^=mRna;MfH+zH
zj2fP<@9~LDRxH4^k4m6FsQz){$7V+(DpPzwY1M%am2>F4x6F2{!V(^-%ZiuZ!d2x|
zD!sHg$Y0nb+`{^YnpARBKH(8*K5V7z6ReJ_pi6M8g2-5&@>;gVKlVz(*&|$CSgkwb
z^pLMWQ*U4{ze?NNf2NZH7P|I?okK912+D<sAQvZydGpb6d*rJtQ&=DWpEfa(ilyYv
zUlvA(&?K2^X~5EizvF`7Ws^(KN$>b>Uw4do6;v1+buVM-K-TvoNw}}~t~E?v+gx5V
z>$%IgECe3(%vfQTL$7h?TAcA|L;_R-d~AFNKPI03V@q3X$YMhQFE?*t3S;whsy7bc
zwR5X%EXBYtVm3`Lf^It{;;^Ra<vM=;1@qoL4`pQV*{Ef@IFQ7T7<FT#p>I@uO?{c$
z-0wKM@vkQ1L-b^jr<M|PNu%(5+0zr!(vEb;XIpB&tapsx_n6dPS4af)?~Tj<-K+kO
z#_=Cb?Oznt$y@i7dE9`3O(`WFTM=;4=40pLzy=z$?m!hEda$-jn2WJ<*~HXlEvgML
zbqI#^v~}kU#$0sH$Pw1_JFZeMfqmr1C`n$J|G4Z#QpjE_tFG=4*u9N`{nZ?y#6+B{
z&Y>-p*!qD!Bjf33EUGkb-$`KKXd<enN+f&QLSfZJQ;V#*{?#*$^97&Y5*X04wa8oC
zepf;G_0Rf=`Iw-(SpM{L{gIHL8Es}K?3RM6S1L~Vfu>673*m|Wy1WwEB>FtRns3aR
z8(S!LCWR;MDEB<={*yzw81c4%1h04z{G+%EkI8Z9G+r91{hn?%sXn;c#0hJjDML45
z&dFKL4O>KtZ!$K+##pI^vDXyeFW*p0sd4KbxrZMNa%OK*7L`twEf2~&u&~SXfz2V(
zWyKAhp)KK$=~95WH#-Zrb|4RyJlcVhlsE@nv1f|)l0TQ9qov8CYL_-HL+ATrt?5VQ
zN*jqE;+TP&hbG(>N>5VuzphPbZVisvyf#^Lr8V#>Wcx>8YR4&jUFENi5v0*IUKjk3
z`=7c*qh|P4`_m%Q#-!84foE@rM)5iFyP*g7ahld5RDz3OfbOF^{LU$F9kVP-yM+sA
zySiV=S6Q!`_3P2eV9(Q7Tk~&PAEQ_XH1-b;{uq?aTDHj!w`-n}VC3j~BFx@J+?xAN
zG@1C)@4i=f#mnB(yJ+yCzK-!kfD&~f&%ViXO=GoZv0MUwl*1&+FUNWl)>`3!xs@n5
zy&b|yy%^z+-y>WnQcQBA@1cdEBW<c&7y6Rye484{(hLmDYFg{qeCS|WBB=PtM5I5F
z5M5Vr2Hv?9jS+h?nts+J{H^A65&?xeMJgWeh`H`FogJ7TZRtEhADCW?7TWKQ;4ksD
zdZf_@*Z}Wxco9LlQ*+SstJUGH&N`x>W=czRwO!OseQ$iCcIS+u!$Eh?vM>AW*E+eD
zqS_<xS&JLk_UQM=)aoM?X^MmPZTMU%;Y*DJ^1#BY64ax*RE9<pDAakS?EV(I-JDWj
zgBmllnY58uv?X?yG+DjQke_VIPg$&3;GmI4ybXkdzC>t-uj;0#>jj8Uvl{j^2)Nl`
zAoJDgJd})uK%kFlCc2oMT=auY2G&-#ZIr&}=atiICezw=QKXU?)p>alun9F|uBWoH
zba%&V9g6(hAo+74;*q<ACv`^B@v;U<uX<4^L@-N3-w@IgNpgt@Y~SW4aU>Dcs%!rc
zIK(fiQfbfvg43I>_pD32*SVNHCb_Do2l_rcm3AE>II(B3Fj&$e>s=xFPui}vsm&$%
zv#Tdy{<_1avl$^#Ty8^MRS-MExoz<eT1<u(Wm}K2(HvJ~io6n<a}43JG@4CUpUGis
ztiFX$lwH%8kP;pbw1giV;elTAETb++7TDO?C#1?fc;FJpqy^~Qs`Lf3I=rYAE(@tx
zliG(LB%`{2VQsr(t1E-mWrpM~9`b$E7+$g9@=iy7u$?;T&=I5nTa%433=vo5c;CWZ
z;gm8<2Wj-42eG^B=P2o`vl_=U99oa>6a>Exj&*P@QUUV(S@Q|!KA-4q6ybCqd)+Td
zu`9Q_2`O>_91{+TfR6{pv8L$0p^;z72eGM&q&tI(Dboto0foS<fC2{M)8~hCNSU1T
z<}50~lonkh7DEug>}>i;nIf&NXUZ`QOJgvw0Q$}Ce~T*qhrfh>DX9NXw*OyC^ouf9
Z?EbrkF_8`@sC?Uig~|CdRY*77zX6|I*hByT

literal 0
HcmV?d00001

diff --git a/gee-rpc/doc/geerpc-day6.md b/gee-rpc/doc/geerpc-day6.md
new file mode 100644
index 0000000..87f5877
--- /dev/null
+++ b/gee-rpc/doc/geerpc-day6.md
@@ -0,0 +1,438 @@
+---
+title: 动手写RPC框架 - GeeRPC第六天 负载均衡(load balance)
+date: 2020-10-08 14:00:00
+description: 7天用 Go语言/golang 从零实现 RPC 框架 GeeRPC 教程(7 days implement golang remote procedure call framework from scratch tutorial)，动手写 RPC 框架，参照 golang 标准库 net/rpc 的实现，实现了服务端(server)、支持异步和并发的客户端(client)、消息编码与解码(message encoding and decoding)、服务注册(service register)、支持 TCP/Unix/HTTP 等多种传输协议。第六天实现了2种简单的负载均衡(load balance)算法，随机选择和 Round Robin 轮询调度算法。
+tags:
+- Go
+nav: 从零实现
+categories:
+- RPC框架 - GeeRPC
+keywords:
+- Go语言
+- 从零实现RPC框架
+- 负载均衡
+- 轮询调度
+image: post/geerpc/geerpc.jpg
+github: https://github.com/geektutu/7days-golang
+---
+
+![golang RPC framework](geerpc/geerpc.jpg)
+
+本文是[7天用Go从零实现RPC框架GeeRPC](https://geektutu.com/post/geerpc.html)的第六篇。
+
+- 通过随机选择和 Round Robin 轮询调度算法实现服务端负载均衡，代码约 250 行
+
+## 负载均衡策略
+
+假设有多个服务实例，每个实例提供相同的功能，为了提高整个系统的吞吐量，每个实例部署在不同的机器上。客户端可以选择任意一个实例进行调用，获取想要的结果。那如何选择呢？取决了负载均衡的策略。对于 RPC 框架来说，我们可以很容易地想到这么几种策略：
+
+- 随机选择策略 - 从服务列表中随机选择一个。
+- 轮询算法(Round Robin) - 依次调度不同的服务器，每次调度执行 i = (i + 1) mode n。
+- 加权轮询(Weight Round Robin) - 在轮询算法的基础上，为每个服务实例设置一个权重，高性能的机器赋予更高的权重，也可以根据服务实例的当前的负载情况做动态的调整，例如考虑最近5分钟部署服务器的 CPU、内存消耗情况。
+- 哈希/一致性哈希策略 - 依据请求的某些特征，计算一个 hash 值，根据 hash 值将请求发送到对应的机器。一致性 hash 还可以解决服务实例动态添加情况下，调度抖动的问题。一致性哈希的一个典型应用场景是分布式缓存服务。感兴趣可以阅读[动手写分布式缓存 - GeeCache第四天 一致性哈希(hash)](https://geektutu.com/post/geecache-day4.html)
+- ...
+
+## 服务发现
+
+负载均衡的前提是有多个服务实例，那我们首先实现一个最基础的服务发现模块 Discovery。为了与通信部分解耦，这部分的代码统一放置在 xclient 子目录下。
+
+定义 2 个类型：
+
+- SelectMode 代表不同的负载均衡策略，简单起见，GeeRPC 仅实现 Random 和 RoundRobin 两种策略。
+- Discovery 是一个接口类型，包含了服务发现所需要的最基本的接口。
+    - Refresh() 从注册中心更新服务列表
+    - Update(servers []string) 手动更新服务列表
+    - Get(mode SelectMode) 根据负载均衡策略，选择一个服务实例
+    - GetAll() 返回所有的服务实例
+
+[day6-load-balance/xclient/discovery.go](https://github.com/geektutu/7days-golang/tree/master/gee-rpc/day6-load-balance)
+
+```go
+package xclient
+
+import (
+	"errors"
+	"math"
+	"math/rand"
+	"sync"
+	"time"
+)
+
+type SelectMode int
+
+const (
+	RandomSelect     SelectMode = iota // select randomly
+	RoundRobinSelect                   // select using Robbin algorithm
+)
+
+type Discovery interface {
+	Refresh() error // refresh from remote registry
+	Update(servers []string) error
+	Get(mode SelectMode) (string, error)
+	GetAll() ([]string, error)
+}
+```
+
+紧接着，我们实现一个不需要注册中心，服务列表由手工维护的服务发现的结构体：MultiServersDiscovery
+
+```go
+// MultiServersDiscovery is a discovery for multi servers without a registry center
+// user provides the server addresses explicitly instead
+type MultiServersDiscovery struct {
+	r       *rand.Rand   // generate random number
+	mu      sync.RWMutex // protect following
+	servers []string
+	index   int // record the selected position for robin algorithm
+}
+
+// NewMultiServerDiscovery creates a MultiServersDiscovery instance
+func NewMultiServerDiscovery(servers []string) *MultiServersDiscovery {
+	d := &MultiServersDiscovery{
+		servers: servers,
+		r:       rand.New(rand.NewSource(time.Now().UnixNano())),
+	}
+	d.index = d.r.Intn(math.MaxInt32 - 1)
+	return d
+}
+```
+
+- r 是一个产生随机数的实例，初始化时使用时间戳设定随机数种子，避免每次产生相同的随机数序列。
+- index 记录 Round Robin 算法已经轮询到的位置，为了避免每次从 0 开始，初始化时随机设定一个值。
+
+然后，实现 Discovery 接口
+
+```go
+var _ Discovery = (*MultiServersDiscovery)(nil)
+
+// Refresh doesn't make sense for MultiServersDiscovery, so ignore it
+func (d *MultiServersDiscovery) Refresh() error {
+	return nil
+}
+
+// Update the servers of discovery dynamically if needed
+func (d *MultiServersDiscovery) Update(servers []string) error {
+	d.mu.Lock()
+	defer d.mu.Unlock()
+	d.servers = servers
+	return nil
+}
+
+// Get a server according to mode
+func (d *MultiServersDiscovery) Get(mode SelectMode) (string, error) {
+	d.mu.Lock()
+	defer d.mu.Unlock()
+	n := len(d.servers)
+	if n == 0 {
+		return "", errors.New("rpc discovery: no available servers")
+	}
+	switch mode {
+	case RandomSelect:
+		return d.servers[d.r.Intn(n)], nil
+	case RoundRobinSelect:
+		s := d.servers[d.index%n] // servers could be updated, so mode n to ensure safety
+		d.index = (d.index + 1) % n
+		return s, nil
+	default:
+		return "", errors.New("rpc discovery: not supported select mode")
+	}
+}
+
+// returns all servers in discovery
+func (d *MultiServersDiscovery) GetAll() ([]string, error) {
+	d.mu.RLock()
+	defer d.mu.RUnlock()
+	// return a copy of d.servers
+	servers := make([]string, len(d.servers), len(d.servers))
+	copy(servers, d.servers)
+	return servers, nil
+}
+```
+
+## 支持负载均衡的客户端
+
+接下来，我们向用户暴露一个支持负载均衡的客户端 XClient。
+
+[day6-load-balance/xclient/xclient.go](https://github.com/geektutu/7days-golang/tree/master/gee-rpc/day6-load-balance)
+
+```go
+package xclient
+
+import (
+	"context"
+	. "geerpc"
+	"io"
+	"reflect"
+	"sync"
+)
+
+type XClient struct {
+	d       Discovery
+	mode    SelectMode
+	opt     *Option
+	mu      sync.Mutex // protect following
+	clients map[string]*Client
+}
+
+var _ io.Closer = (*XClient)(nil)
+
+func NewXClient(d Discovery, mode SelectMode, opt *Option) *XClient {
+	return &XClient{d: d, mode: mode, opt: opt, clients: make(map[string]*Client)}
+}
+
+func (xc *XClient) Close() error {
+	xc.mu.Lock()
+	defer xc.mu.Unlock()
+	for key, client := range xc.clients {
+		// I have no idea how to deal with error, just ignore it.
+		_ = client.Close()
+		delete(xc.clients, key)
+	}
+	return nil
+}
+```
+
+XClient 的构造函数需要传入三个参数，服务发现实例 Discovery、负载均衡模式 SelectMode 以及协议选项 Option。为了尽量地复用已经创建好的 Socket 连接，使用 clients 保存创建成功的 Client 实例，并提供 Close 方法在结束后，关闭已经建立的连接。
+
+接下来，实现客户端最基本的功能 `Call`。
+
+```go
+func (xc *XClient) dial(rpcAddr string) (*Client, error) {
+	xc.mu.Lock()
+	defer xc.mu.Unlock()
+	client, ok := xc.clients[rpcAddr]
+	if ok && !client.IsAvailable() {
+		_ = client.Close()
+		delete(xc.clients, rpcAddr)
+		client = nil
+	}
+	if client == nil {
+		var err error
+		client, err = XDial(rpcAddr, xc.opt)
+		if err != nil {
+			return nil, err
+		}
+		xc.clients[rpcAddr] = client
+	}
+	return client, nil
+}
+
+func (xc *XClient) call(rpcAddr string, ctx context.Context, serviceMethod string, args, reply interface{}) error {
+	client, err := xc.dial(rpcAddr)
+	if err != nil {
+		return err
+	}
+	return client.Call(ctx, serviceMethod, args, reply)
+}
+
+// Call invokes the named function, waits for it to complete,
+// and returns its error status.
+// xc will choose a proper server.
+func (xc *XClient) Call(ctx context.Context, serviceMethod string, args, reply interface{}) error {
+	rpcAddr, err := xc.d.Get(xc.mode)
+	if err != nil {
+		return err
+	}
+	return xc.call(rpcAddr, ctx, serviceMethod, args, reply)
+}
+```
+
+我们将复用 Client 的能力封装在方法 `dial` 中，dial 的处理逻辑如下：
+
+1) 检查 `xc.clients` 是否有缓存的 Client，如果有，检查是否是可用状态，如果是则返回缓存的 Client，如果不可用，则从缓存中删除。
+2) 如果步骤 1) 没有返回缓存的 Client，则说明需要创建新的 Client，缓存并返回。
+
+另外，我们为 XClient 添加一个常用功能：`Broadcast`。
+
+```go
+// Broadcast invokes the named function for every server registered in discovery
+func (xc *XClient) Broadcast(ctx context.Context, serviceMethod string, args, reply interface{}) error {
+	servers, err := xc.d.GetAll()
+	if err != nil {
+		return err
+	}
+	var wg sync.WaitGroup
+	var mu sync.Mutex // protect e and replyDone
+	var e error
+	replyDone := reply == nil // if reply is nil, don't need to set value
+	ctx, cancel := context.WithCancel(ctx)
+	for _, rpcAddr := range servers {
+		wg.Add(1)
+		go func() {
+			defer wg.Done()
+			var clonedReply interface{}
+			if reply != nil {
+				clonedReply = reflect.New(reflect.ValueOf(reply).Elem().Type()).Interface()
+			}
+			err := xc.call(rpcAddr, ctx, serviceMethod, args, clonedReply)
+			mu.Lock()
+			if err != nil && e == nil {
+				e = err
+				cancel() // if any call failed, cancel unfinished calls
+			}
+			if err == nil && !replyDone {
+				reflect.ValueOf(reply).Elem().Set(reflect.ValueOf(clonedReply).Elem())
+				replyDone = true
+			}
+			mu.Unlock()
+		}()
+	}
+	wg.Wait()
+	return e
+}
+```
+
+Broadcast 将请求广播到所有的服务实例，如果任意一个实例发生错误，则返回其中一个错误；如果调用成功，则返回其中一个的结果。有以下几点需要注意：
+
+1) 为了提升性能，请求是并发的。
+2) 并发情况下需要使用互斥锁保证 error 和 reply 能被正确赋值。
+3) 借助 context.WithCancel 确保有错误发生时，快速失败。
+
+## Demo
+
+又到了 Demo 环节，我们还是借助一个简单的 Demo 验证今天的成果吧。
+
+首先，启动 RPC 服务的代码还是类似的，Sum 是正常的方法，Sleep 用于验证 XClient 的超时机制能否正常运作。
+
+[day6-load-balance/main/main.go](https://github.com/geektutu/7days-golang/tree/master/gee-rpc/day6-load-balance)
+
+```go
+package main
+
+import (
+	"context"
+	"geerpc"
+	"geerpc/xclient"
+	"log"
+	"net"
+	"sync"
+	"time"
+)
+
+type Foo int
+
+type Args struct{ Num1, Num2 int }
+
+func (f Foo) Sum(args Args, reply *int) error {
+	*reply = args.Num1 + args.Num2
+	return nil
+}
+
+func (f Foo) Sleep(args Args, reply *int) error {
+	time.Sleep(time.Second * time.Duration(args.Num1))
+	*reply = args.Num1 + args.Num2
+	return nil
+}
+
+func startServer(addrCh chan string) {
+	var foo Foo
+	l, _ := net.Listen("tcp", ":0")
+	server := geerpc.NewServer()
+	_ = server.Register(&foo)
+	addrCh <- l.Addr().String()
+	server.Accept(l)
+}
+```
+
+封装一个方法 `foo`，便于在 `Call` 或 `Broadcast` 之后统一打印成功或失败的日志。
+
+```go
+func foo(xc *xclient.XClient, ctx context.Context, typ, serviceMethod string, args *Args) {
+	var reply int
+	var err error
+	switch typ {
+	case "call":
+		err = xc.Call(ctx, serviceMethod, args, &reply)
+	case "broadcast":
+		err = xc.Broadcast(ctx, serviceMethod, args, &reply)
+	}
+	if err != nil {
+		log.Printf("%s %s error: %v", typ, serviceMethod, err)
+	} else {
+		log.Printf("%s %s success: %d + %d = %d", typ, serviceMethod, args.Num1, args.Num2, reply)
+	}
+}
+```
+
+call 调用单个服务实例，broadcast 调用所有服务实例
+
+```go
+func call(addr1, addr2 string) {
+	d := xclient.NewMultiServerDiscovery([]string{"tcp@" + addr1, "tcp@" + addr2})
+	xc := xclient.NewXClient(d, xclient.RandomSelect, nil)
+	defer func() { _ = xc.Close() }()
+	// send request & receive response
+	var wg sync.WaitGroup
+	for i := 0; i < 5; i++ {
+		wg.Add(1)
+		go func(i int) {
+			defer wg.Done()
+			foo(xc, context.Background(), "call", "Foo.Sum", &Args{Num1: i, Num2: i * i})
+		}(i)
+	}
+	wg.Wait()
+}
+
+func broadcast(addr1, addr2 string) {
+	d := xclient.NewMultiServerDiscovery([]string{"tcp@" + addr1, "tcp@" + addr2})
+	xc := xclient.NewXClient(d, xclient.RandomSelect, nil)
+	defer func() { _ = xc.Close() }()
+	var wg sync.WaitGroup
+	for i := 0; i < 5; i++ {
+		wg.Add(1)
+		go func(i int) {
+			defer wg.Done()
+			foo(xc, context.Background(), "broadcast", "Foo.Sum", &Args{Num1: i, Num2: i * i})
+			// expect 2 - 5 timeout
+			ctx, _ := context.WithTimeout(context.Background(), time.Second*2)
+			foo(xc, ctx, "broadcast", "Foo.Sleep", &Args{Num1: i, Num2: i * i})
+		}(i)
+	}
+	wg.Wait()
+}
+
+
+func main() {
+	log.SetFlags(0)
+	ch1 := make(chan string)
+	ch2 := make(chan string)
+	// start two servers
+	go startServer(ch1)
+	go startServer(ch2)
+
+	addr1 := <-ch1
+	addr2 := <-ch2
+
+	time.Sleep(time.Second)
+	call(addr1, addr2)
+	broadcast(addr1, addr2)
+}
+```
+
+运行结果如下：
+
+```go
+rpc server: register Foo.Sleep
+rpc server: register Foo.Sum
+rpc server: register Foo.Sleep
+rpc server: register Foo.Sum
+call Foo.Sum success: 4 + 16 = 20
+call Foo.Sum success: 0 + 0 = 0
+call Foo.Sum success: 3 + 9 = 12
+call Foo.Sum success: 2 + 4 = 6
+call Foo.Sum success: 1 + 1 = 2
+broadcast Foo.Sum success: 3 + 9 = 12
+broadcast Foo.Sum success: 1 + 1 = 2
+broadcast Foo.Sum success: 0 + 0 = 0
+broadcast Foo.Sum success: 4 + 16 = 20
+broadcast Foo.Sum success: 2 + 4 = 6
+broadcast Foo.Sleep success: 0 + 0 = 0
+broadcast Foo.Sleep success: 1 + 1 = 2
+broadcast Foo.Sleep error: rpc client: call failed: context deadline exceeded
+broadcast Foo.Sleep error: rpc client: call failed: context deadline exceeded
+broadcast Foo.Sleep error: rpc client: call failed: context deadline exceeded
+```
+
+## 附 推荐阅读
+
+- [Go 语言简明教程](https://geektutu.com/post/quick-golang.html)
+- [Go 语言笔试面试题](https://geektutu.com/post/qa-golang.html)
\ No newline at end of file
diff --git a/gee-rpc/doc/geerpc-day7.md b/gee-rpc/doc/geerpc-day7.md
new file mode 100644
index 0000000..32105ef
--- /dev/null
+++ b/gee-rpc/doc/geerpc-day7.md
@@ -0,0 +1,395 @@
+---
+title: 动手写RPC框架 - GeeRPC第六天 服务发现与注册中心(registry)
+date: 2020-10-08 16:00:00
+description: 7天用 Go语言/golang 从零实现 RPC 框架 GeeRPC 教程(7 days implement golang remote procedure call framework from scratch tutorial)，动手写 RPC 框架，参照 golang 标准库 net/rpc 的实现，实现了服务端(server)、支持异步和并发的客户端(client)、消息编码与解码(message encoding and decoding)、服务注册(service register)、支持 TCP/Unix/HTTP 等多种传输协议。第七天实现了一个简单的注册中心(registry)，具备超时移除、接收心跳(heartbeat)等能力，并且实现了一个简单的服务发现(server discovery)模块。
+tags:
+- Go
+nav: 从零实现
+categories:
+- RPC框架 - GeeRPC
+keywords:
+- Go语言
+- 从零实现RPC框架
+- 注册中心
+- 服务发现
+image: post/geerpc/geerpc.jpg
+github: https://github.com/geektutu/7days-golang
+---
+
+![golang RPC framework](geerpc/geerpc.jpg)
+
+本文是[7天用Go从零实现RPC框架GeeRPC](https://geektutu.com/post/geerpc.html)的第七篇。
+
+- 实现一个简单的注册中心，支持服务注册、接收心跳等功能
+- 客户端实现基于注册中心的服务发现机制，代码约 250 行
+
+## 注册中心的位置
+
+![geerpc registry](geerpc-day7/registry.jpg)
+
+注册中心的位置如上图所示。注册中心的好处在于，客户端和服务端都只需要感知注册中心的存在，而无需感知对方的存在。更具体一些：
+
+1) 服务端启动后，向注册中心发送注册消息，注册中心得知该服务已经启动，处于可用状态。一般来说，服务端还需要定期向注册中心发送心跳，证明自己还活着。
+2) 客户端向注册中心询问，当前哪天服务是可用的，注册中心将可用的服务列表返回客户端。
+3) 客户端根据注册中心得到的服务列表，选择其中一个发起调用。
+
+如果没有注册中心，就像 GeeRPC 第六天实现的一样，客户端需要硬编码服务端的地址，而且没有机制保证服务端是否处于可用状态。当然注册中心的功能还有很多，比如配置的动态同步、通知机制等。比较常用的注册中心有 [etcd](https://github.com/etcd-io/etcd)、[zookeeper](https://github.com/apache/zookeeper)、[consul](https://github.com/hashicorp/consul)，一般比较出名的微服务或者 RPC 框架，这些主流的注册中心都是支持的。
+
+
+## Gee Registry
+
+主流的注册中心 etcd、zookeeper 等功能强大，与这类注册中心的对接代码量是比较大的，需要实现的接口很多。GeeRPC 选择自己实现一个简单的支持心跳保活的注册中心。
+
+GeeRegistry 的代码独立放置在子目录 registry 中。
+
+首先定义 GeeRegistry 结构体，默认超时时间设置为 5 min，也就是说，任何注册的服务超过 5 min，即视为不可用状态。
+
+[day7-registry/registry/registry.go](https://github.com/geektutu/7days-golang/tree/master/gee-rpc/day7-registry)
+
+```go
+// GeeRegistry is a simple register center, provide following functions.
+// add a server and receive heartbeat to keep it alive.
+// returns all alive servers and delete dead servers sync simultaneously.
+type GeeRegistry struct {
+	timeout time.Duration
+	mu      sync.Mutex // protect following
+	servers map[string]*ServerItem
+}
+
+type ServerItem struct {
+	Addr  string
+	start time.Time
+}
+
+const (
+	defaultPath    = "/_geerpc_/registry"
+	defaultTimeout = time.Minute * 5
+)
+
+// New create a registry instance with timeout setting
+func New(timeout time.Duration) *GeeRegistry {
+	return &GeeRegistry{
+		servers: make(map[string]*ServerItem),
+		timeout: timeout,
+	}
+}
+
+var DefaultGeeRegister = New(defaultTimeout)
+```
+
+为 GeeRegistry 实现添加服务实例和返回服务列表的方法。
+
+- putServer：添加服务实例，如果服务已经存在，则更新 start。
+- aliveServers：返回可用的服务列表，如果存在超时的服务，则删除。
+
+```go
+func (r *GeeRegistry) putServer(addr string) {
+	r.mu.Lock()
+	defer r.mu.Unlock()
+	s := r.servers[addr]
+	if s == nil {
+		r.servers[addr] = &ServerItem{Addr: addr, start: time.Now()}
+	} else {
+		s.start = time.Now() // if exists, update start time to keep alive
+	}
+}
+
+func (r *GeeRegistry) aliveServers() []string {
+	r.mu.Lock()
+	defer r.mu.Unlock()
+	var alive []string
+	for addr, s := range r.servers {
+		if r.timeout == 0 || s.start.Add(r.timeout).After(time.Now()) {
+			alive = append(alive, addr)
+		} else {
+			delete(r.servers, addr)
+		}
+	}
+	sort.Strings(alive)
+	return alive
+}
+```
+
+为了实现上的简单，GeeRegistry 采用 HTTP 协议提供服务，且所有的有用信息都承载在 HTTP Header 中。
+
+- Get：返回所有可用的服务列表，通过自定义字段 X-Geerpc-Servers 承载。
+- Post：添加服务实例或发送心跳，通过自定义字段 X-Geerpc-Server 承载。
+
+```go
+// Runs at /_geerpc_/registry
+func (r *GeeRegistry) ServeHTTP(w http.ResponseWriter, req *http.Request) {
+	switch req.Method {
+	case "GET":
+		// keep it simple, server is in req.Header
+		w.Header().Set("X-Geerpc-Servers", strings.Join(r.aliveServers(), ","))
+	case "POST":
+		// keep it simple, server is in req.Header
+		addr := req.Header.Get("X-Geerpc-Server")
+		if addr == "" {
+			w.WriteHeader(http.StatusInternalServerError)
+			return
+		}
+		r.putServer(addr)
+	default:
+		w.WriteHeader(http.StatusMethodNotAllowed)
+	}
+}
+
+// HandleHTTP registers an HTTP handler for GeeRegistry messages on registryPath
+func (r *GeeRegistry) HandleHTTP(registryPath string) {
+	http.Handle(registryPath, r)
+	log.Println("rpc registry path:", registryPath)
+}
+
+func HandleHTTP() {
+	DefaultGeeRegister.HandleHTTP(defaultPath)
+}
+```
+
+另外，提供 Heartbeat 方法，便于服务启动时定时向注册中心发送心跳，默认周期比注册中心设置的过期时间少 1 min。
+
+```go
+// Heartbeat send a heartbeat message every once in a while
+// it's a helper function for a server to register or send heartbeat
+func Heartbeat(registry, addr string, duration time.Duration) {
+	if duration == 0 {
+		// make sure there is enough time to send heart beat
+		// before it's removed from registry
+		duration = defaultTimeout - time.Duration(1)*time.Minute
+	}
+	var err error
+	err = sendHeartbeat(registry, addr)
+	go func() {
+		t := time.NewTicker(duration)
+		for err == nil {
+			<-t.C
+			err = sendHeartbeat(registry, addr)
+		}
+	}()
+}
+
+func sendHeartbeat(registry, addr string) error {
+	log.Println(addr, "send heart beat to registry", registry)
+	httpClient := &http.Client{}
+	req, _ := http.NewRequest("POST", registry, nil)
+	req.Header.Set("X-Geerpc-Server", addr)
+	if _, err := httpClient.Do(req); err != nil {
+		log.Println("rpc server: heart beat err:", err)
+		return err
+	}
+	return nil
+}
+```
+
+## GeeRegistryDiscovery
+
+在 xclient 中对应实现 Discovery。
+
+[day7-registry/xclient/discovery_gee.go](https://github.com/geektutu/7days-golang/tree/master/gee-rpc/day7-registry)
+
+```go
+package xclient
+
+type GeeRegistryDiscovery struct {
+	*MultiServersDiscovery
+	registry   string
+	timeout    time.Duration
+	lastUpdate time.Time
+}
+
+const defaultUpdateTimeout = time.Second * 10
+
+func NewGeeRegistryDiscovery(registerAddr string, timeout time.Duration) *GeeRegistryDiscovery {
+	if timeout == 0 {
+		timeout = defaultUpdateTimeout
+	}
+	d := &GeeRegistryDiscovery{
+		MultiServersDiscovery: NewMultiServerDiscovery(make([]string, 0)),
+		registry:              registerAddr,
+		timeout:               timeout,
+	}
+	return d
+}
+```
+
+- GeeRegistryDiscovery 嵌套了 MultiServersDiscovery，很多能力可以复用。
+- registry 即注册中心的地址
+- timeout 服务列表的过期时间
+- lastUpdate 是代表最后从注册中心更新服务列表的时间，默认 10s 过期，即 10s 之后，需要从注册中心更新新的列表。
+
+实现 Update 和 Refresh 方法，超时重新获取的逻辑在 Refresh 中实现：
+
+```go
+func (d *GeeRegistryDiscovery) Update(servers []string) error {
+	d.mu.Lock()
+	defer d.mu.Unlock()
+	d.servers = servers
+	d.lastUpdate = time.Now()
+	return nil
+}
+
+func (d *GeeRegistryDiscovery) Refresh() error {
+	d.mu.Lock()
+	defer d.mu.Unlock()
+	if d.lastUpdate.Add(d.timeout).After(time.Now()) {
+		return nil
+	}
+	log.Println("rpc registry: refresh servers from registry", d.registry)
+	resp, err := http.Get(d.registry)
+	if err != nil {
+		log.Println("rpc registry refresh err:", err)
+		return err
+	}
+	servers := strings.Split(resp.Header.Get("X-Geerpc-Servers"), ",")
+	d.servers = make([]string, 0, len(servers))
+	for _, server := range servers {
+		if strings.TrimSpace(server) != "" {
+			d.servers = append(d.servers, strings.TrimSpace(server))
+		}
+	}
+	d.lastUpdate = time.Now()
+	return nil
+}
+```
+
+`Get` 和 `GetAll` 与 MultiServersDiscovery 相似，唯一的不同在于，GeeRegistryDiscovery 需要先调用 Refresh 确保服务列表没有过期。
+
+```go
+func (d *GeeRegistryDiscovery) Get(mode SelectMode) (string, error) {
+	if err := d.Refresh(); err != nil {
+		return "", err
+	}
+	return d.MultiServersDiscovery.Get(mode)
+}
+
+func (d *GeeRegistryDiscovery) GetAll() ([]string, error) {
+	if err := d.Refresh(); err != nil {
+		return nil, err
+	}
+	return d.MultiServersDiscovery.GetAll()
+}
+```
+
+## Demo
+
+最后，依旧通过简单的 Demo 验证今天的成果。
+
+添加函数 startRegistry，稍微修改 startServer，添加调用注册中心的 `Heartbeat` 方法的逻辑，定期向注册中心发送心跳保活。
+
+[day7-registry/main/main.go](https://github.com/geektutu/7days-golang/tree/master/gee-rpc/day7-registry)
+
+```go
+func startRegistry(wg *sync.WaitGroup) {
+	l, _ := net.Listen("tcp", ":9999")
+	registry.HandleHTTP()
+	wg.Done()
+	_ = http.Serve(l, nil)
+}
+
+func startServer(registryAddr string, wg *sync.WaitGroup) {
+	var foo Foo
+	l, _ := net.Listen("tcp", ":0")
+	server := geerpc.NewServer()
+	_ = server.Register(&foo)
+	registry.Heartbeat(registryAddr, "tcp@"+l.Addr().String(), 0)
+	wg.Done()
+	server.Accept(l)
+}
+```
+
+接下来，将 call 和 broadcast 的 MultiServersDiscovery 替换为 GeeRegistryDiscovery，不再需要硬编码服务列表。
+
+```go
+func call(registry string) {
+	d := xclient.NewGeeRegistryDiscovery(registry, 0)
+	xc := xclient.NewXClient(d, xclient.RandomSelect, nil)
+	defer func() { _ = xc.Close() }()
+	// send request & receive response
+	var wg sync.WaitGroup
+	for i := 0; i < 5; i++ {
+		wg.Add(1)
+		go func(i int) {
+			defer wg.Done()
+			foo(xc, context.Background(), "call", "Foo.Sum", &Args{Num1: i, Num2: i * i})
+		}(i)
+	}
+	wg.Wait()
+}
+
+func broadcast(registry string) {
+	d := xclient.NewGeeRegistryDiscovery(registry, 0)
+	xc := xclient.NewXClient(d, xclient.RandomSelect, nil)
+	defer func() { _ = xc.Close() }()
+	var wg sync.WaitGroup
+	for i := 0; i < 5; i++ {
+		wg.Add(1)
+		go func(i int) {
+			defer wg.Done()
+			foo(xc, context.Background(), "broadcast", "Foo.Sum", &Args{Num1: i, Num2: i * i})
+			// expect 2 - 5 timeout
+			ctx, _ := context.WithTimeout(context.Background(), time.Second*2)
+			foo(xc, ctx, "broadcast", "Foo.Sleep", &Args{Num1: i, Num2: i * i})
+		}(i)
+	}
+	wg.Wait()
+}
+```
+
+最后在 main 函数中，将所有的逻辑串联起来，确保注册中心启动后，再启动 RPC 服务端，最后客户端远程调用。
+
+```go
+func main() {
+	log.SetFlags(0)
+	registryAddr := "http://localhost:9999/_geerpc_/registry"
+	var wg sync.WaitGroup
+	wg.Add(1)
+	go startRegistry(&wg)
+	wg.Wait()
+
+	time.Sleep(time.Second)
+	wg.Add(2)
+	go startServer(registryAddr, &wg)
+	go startServer(registryAddr, &wg)
+	wg.Wait()
+
+	time.Sleep(time.Second)
+	call(registryAddr)
+	broadcast(registryAddr)
+}
+```
+
+运行结果如下：
+
+```go
+rpc registry path: /_geerpc_/registry
+rpc server: register Foo.Sleep
+rpc server: register Foo.Sum
+tcp@[::]:56276 send heart beat to registry http://localhost:9999/_geerpc_/registry
+rpc server: register Foo.Sleep
+rpc server: register Foo.Sum
+tcp@[::]:56277 send heart beat to registry http://localhost:9999/_geerpc_/registry
+rpc registry: refresh servers from registry http://localhost:9999/_geerpc_/registry
+call Foo.Sum success: 3 + 9 = 12
+call Foo.Sum success: 4 + 16 = 20
+call Foo.Sum success: 1 + 1 = 2
+call Foo.Sum success: 0 + 0 = 0
+call Foo.Sum success: 2 + 4 = 6
+rpc registry: refresh servers from registry http://localhost:9999/_geerpc_/registry
+broadcast Foo.Sum success: 4 + 16 = 20
+broadcast Foo.Sum success: 1 + 1 = 2
+broadcast Foo.Sum success: 3 + 9 = 12
+broadcast Foo.Sum success: 0 + 0 = 0
+broadcast Foo.Sum success: 2 + 4 = 6
+broadcast Foo.Sleep success: 0 + 0 = 0
+broadcast Foo.Sleep success: 1 + 1 = 2
+broadcast Foo.Sleep error: rpc client: call failed: context deadline exceeded
+broadcast Foo.Sleep error: rpc client: call failed: context deadline exceeded
+broadcast Foo.Sleep error: rpc client: call failed: context deadline exceeded
+```
+
+到这里，七天用 Go 从零实现 RPC 框架的教程也结束了。我们用七天时间参照 golang 标准库 net/rpc，实现了服务端以及支持并发的客户端，并且支持选择不同的序列化与反序列化方式；为了防止服务挂死，在其中一些关键部分添加了超时处理机制；支持 TCP、Unix、HTTP 等多种传输协议；支持多种负载均衡模式，最后还实现了一个简易的服务注册和发现中心。
+
+## 附 推荐阅读
+
+- [Go 语言简明教程](https://geektutu.com/post/quick-golang.html)
+- [Go 语言笔试面试题](https://geektutu.com/post/qa-golang.html)
\ No newline at end of file
diff --git a/gee-rpc/doc/geerpc-day7/registry.jpg b/gee-rpc/doc/geerpc-day7/registry.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..726113206ba4748acadab290e033a96fcad8b230
GIT binary patch
literal 19887
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

literal 0
HcmV?d00001


From e8f6f7ee0c1147c67277e6b585834d2ef59f53ce Mon Sep 17 00:00:00 2001
From: gzdaijie <gzdaijie@gmail.com>
Date: Thu, 8 Oct 2020 17:38:47 +0800
Subject: [PATCH 097/122] gee-rpc/doc fix day7 title

---
 gee-rpc/doc/geerpc-day7.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/gee-rpc/doc/geerpc-day7.md b/gee-rpc/doc/geerpc-day7.md
index 32105ef..ad4f502 100644
--- a/gee-rpc/doc/geerpc-day7.md
+++ b/gee-rpc/doc/geerpc-day7.md
@@ -1,5 +1,5 @@
 ---
-title: 动手写RPC框架 - GeeRPC第六天 服务发现与注册中心(registry)
+title: 动手写RPC框架 - GeeRPC第七天 服务发现与注册中心(registry)
 date: 2020-10-08 16:00:00
 description: 7天用 Go语言/golang 从零实现 RPC 框架 GeeRPC 教程(7 days implement golang remote procedure call framework from scratch tutorial)，动手写 RPC 框架，参照 golang 标准库 net/rpc 的实现，实现了服务端(server)、支持异步和并发的客户端(client)、消息编码与解码(message encoding and decoding)、服务注册(service register)、支持 TCP/Unix/HTTP 等多种传输协议。第七天实现了一个简单的注册中心(registry)，具备超时移除、接收心跳(heartbeat)等能力，并且实现了一个简单的服务发现(server discovery)模块。
 tags:

From fa606012192b1d40ff1ef1fecc725fcc150fbeed Mon Sep 17 00:00:00 2001
From: ImgBotApp <ImgBotHelp@gmail.com>
Date: Fri, 16 Oct 2020 05:15:39 +0000
Subject: [PATCH 098/122] [ImgBot] Optimize images

*Total -- 135.49kb -> 117.71kb (13.13%)

/gee-rpc/doc/geerpc-day5/geerpc_debug.png -- 5.69kb -> 3.86kb (32.08%)
/gee-cache/doc/geecache-day4/hash.jpg -- 21.63kb -> 18.50kb (14.46%)
/gee-cache/doc/geecache-day5/dist_nodes.jpg -- 21.31kb -> 18.29kb (14.14%)
/gee-cache/doc/geecache-day7/protobuf.jpg -- 20.87kb -> 17.97kb (13.89%)
/gee-cache/doc/geecache-day6/singleflight.jpg -- 22.16kb -> 19.16kb (13.55%)
/gee-cache/doc/geecache-day6/singleflight_logo.jpg -- 9.13kb -> 8.17kb (10.52%)
/gee-cache/doc/geecache-day4/hash_logo.jpg -- 9.86kb -> 8.87kb (10.01%)
/gee-cache/doc/geecache-day7/protobuf_logo.jpg -- 9.16kb -> 8.25kb (9.85%)
/gee-cache/doc/geecache-day5/dist_nodes_logo.jpg -- 10.54kb -> 9.52kb (9.71%)
/gee-cache/doc/geecache-day1/lru_logo.jpg -- 5.15kb -> 5.10kb (0.89%)

Signed-off-by: ImgBotApp <ImgBotHelp@gmail.com>
---
 gee-cache/doc/geecache-day1/lru_logo.jpg      | Bin 5272 -> 5225 bytes
 gee-cache/doc/geecache-day4/hash.jpg          | Bin 22150 -> 18947 bytes
 gee-cache/doc/geecache-day4/hash_logo.jpg     | Bin 10096 -> 9085 bytes
 gee-cache/doc/geecache-day5/dist_nodes.jpg    | Bin 21817 -> 18731 bytes
 .../doc/geecache-day5/dist_nodes_logo.jpg     | Bin 10792 -> 9744 bytes
 gee-cache/doc/geecache-day6/singleflight.jpg  | Bin 22694 -> 19619 bytes
 .../doc/geecache-day6/singleflight_logo.jpg   | Bin 9351 -> 8367 bytes
 gee-cache/doc/geecache-day7/protobuf.jpg      | Bin 21374 -> 18405 bytes
 gee-cache/doc/geecache-day7/protobuf_logo.jpg | Bin 9376 -> 8452 bytes
 gee-rpc/doc/geerpc-day5/geerpc_debug.png      | Bin 5823 -> 3955 bytes
 10 files changed, 0 insertions(+), 0 deletions(-)

diff --git a/gee-cache/doc/geecache-day1/lru_logo.jpg b/gee-cache/doc/geecache-day1/lru_logo.jpg
index 7ab49f44e6a6e2b1483a5ef88ed3bce9b98de4bd..306b014ea4889c97efe15f4baa41134889fdd64f 100644
GIT binary patch
delta 5087
zcmV<56CmuEDd{MX7Xm{7ky=3m+W<q6SwaE8k(?@j0tE&H1OLPTK@b1|0|NpB1P28L
z1_uBD000310s{mE5e6X#5<wF&QE@UeHbP-?a}*UKBQ+L8fs&IXQdE(lu@@#oQ(|MH
z|HJ?q0RRC70RR91000000000000IC30|W&I|HJ?*5dZ=M009F80s#XB00000009C3
z0}%v&5+N}K6G2fFBO(<taWg_vVuAnK01N{G00I#M5dc2`a3Kg>Ea)JFAuSse5QHZY
zpoQnCs)CpUJh8?ca5<g=`2FW@AHP$7S*k^*#{jCFf^0$9neIZvou!R?T-P-B5OTBW
z-VhOl_U<7Aqjm^VywlZF)8n?DDD#pz-W&dZ>D5_?3L??u&q5cA?>k}r{-64-LAl$9
z@6_MbYLoHq{{Vr2EkoO9wF}7|eGG>UtAL+`jVsjB*ZQ|L!_5h%!Q~8owehl0u`U2-
z1z{}lLm84swTuJ2oFD*}=^l0#;N728FB!R8dRNo`09C8)6+|;Lo+%pk{{VO#jg*al
zO^fAY3l#PSeUPWYU|!JDNeu&X=WG;U9RLXA<jD)jYwg4L`fuvBePF19pg6%aQh;!I
zUJ8)YYK<yDf*ohs3li<{0V^dC@1_>P2trZdgdr%PgdsP~a|9s?hyccdf~5$Rfia9u
z@mK=|7sgbRd@;48^5Y5D#h+0@^^#(LUsm<h@R5HOW!~gkC9Knc8!Z_B0M^yLAZIvQ
zO*jYK)ITFu^>fz%EPwMfDLR4)F~xAg`)*tA6z1xad|2<c{H{}adhOyh{{ZQc6Agj~
z1Na)gJhZ&TVZK>j=7tx<-Twd+fIq~m32f1NZfk8U&!CCVb3r79zjq?KJ207lXpT>r
zULtp7d7yh*eg`Y4vuhjGwsyJmI(T}q<uvbHI<vl(S5l6~K+;A6M9mYUnn)jxXx+$u
zI73;hk~;wn`jvs%YHYWvd(|6ipm&>AgNR<s)}ICy!Emm*;^9?BG8iM~!tZ#6?8SG}
za>_Ld`HD0B!df;TYF36p2#gYc(UKL5;it3AZ~jhI;{e7!04oc_FK6TV+^>3=Utw}X
z$FpoAF#$MQeL=mRvpfD-TadKZ@6qdio0cUR?+yEx?KrZfMHDVzC4(v1!f*r^5F6bp
zOGC7O#X7i8wLQn{E`yj9@w|LW6<AHAM-eAI>J*R^E?D*kX#5Bv2u!|zA;Abjc+f%*
zc|uGu#@&Jtgx@jGkpv+~PQ4(-<6>`%KBC|Cl44I*<mckgsJH!On3vVPbsQ}`S(C{h
zv`by5KSiPW0^Y3_oc$Ju<O_Pa+sEy2e&&T8s}m94lbl%Zw|uTnKB+s!gT1@ua<}P&
z_X8s2mI`8eFIfw+1|%7O{tC!i^*x3wWg{P37<*a1>b5%ty~jBV>m?ma8fASmgn!<`
z-sN%Yv<)*pyBHr4`+L{6ih4<-rI)pl&B8#<Go+eXos7A}pEAB6asupRmECE56H|I)
zDjy&ez~R_KU1`RskYO_yU^C`)yey!X?KL&UxNDh(+3^qAitmws%cZv4sV%h3rKT8Q
z3!CB}ven;B%OP#|c|iXF+FfMIWo#aR@(RLm%h~AucdGW?m^_t*;ilFGe9l@PrawTz
zD)C3{CNUP8{{Z?uXVY@r5(3lT%SE26C%!i<4k#^nBzQAQ-|Uq(A6NWStA!q-<MonS
z5&2;{xK1-qar(=DqUHAEOxj27CO8lg+;{Fm<&Tmks`n5=5TD{GAqY(#9`Qmw;)He%
z@svRbLWn}n@InxYJi$HoCpfdb6dze8CG~Djek<)yL-mqylFWA;E~|h?;{h^n(BR~?
zT6gqXACN8f6<nm%+Jcra$Y)?^7yz|>j=0p>AD++URBrTt*Lw>BC4}VSiDxi!5^swG
zduPbyuF^WD`(1p3nxXA1a@lcQjN3j(D7f@DACjSrYpyR@?GtUumJ&$yjaFRRDXtn`
z3VzMJ&xbh!s;v<b+e6GT`HlYob!=>#T4*pq{H1@?E$Apgk#W>8?j=>Nqnd`QT4{DM
zJhTPdXdOg<`&GzO%H!D2k04h;#JxX)+pG-uNR%PZZz*q0$H1vnjzu7E#1{TH32^}r
zXFGAqd^&=;O?3mO(-#Jg@ey7f2dD+k+S++s1n~vh)l$b*OEeE4vPR&nKKyP+{>#O>
z>&Z`mA)LKN-{hUVF}bzWkD@rtX<eu-6*haEw9g!WjU<-6-OF1^S64*-+L}`v!rpMa
zng9e!D8{=by)7<oS0$}(Fi=@1=R3+U)TD=r8kvz6IK%KIi<7!t?sr+cYUz2&_gk}7
z3V05db$kOSyO2uc)-i>w9H+Q$o%}1OdnhZU9c2kGO9b_GG19>kocTNzqtjMjx-E3D
z5;>ZG&&Ba7etm#c7hrLfi6n`=X~^A5lex%Hxv|`tq&o;92u<@85QHTjPrOthb@NaW
zx$guSC_;rCF(pHe+bGFdCIcgQ_?!;8(^Z$)DTFcrSp22f;g#rq^&j#p1cjqVIjgUx
zR(b`8Os~K2%Ju#spUSfwFunf(ijVn9f2qoUllq;yG7sY{PHCMHa<*OJsg`z@wRC#t
zOIF`aA*Oh5X3`Eq@A_d*N`<+WHG$-Uh3Uy(o5MTUEOV+@KzR2P%G(2}E!42PcSjxy
z_mWD4+@4XnK#yHPXNKiR9m<AUSAZJ!9Q+DMOT!DhUm%KhhG%Sq{lXIC^6aT{Gt#Yp
z6FPfEY70%q3Z_*sj%+w`ryIG*X4ogvUqp0K@^3Z}#6qsHqG+$0c7pXy*wiyQ8#yMf
zTsXYbIr37tPR@-DRt2Ou6$Bi7RNQ`LwXcJcC!tA|WA;N;4*MMCZs<6Bf2zTqhLglf
zGOTHK<x7rE`>SWwTcF^B_@lO&$LYO)8*Z_)oB<@x8@#Tt^WbFVW`&t$_FJWzS*;Zp
zu#!l^fP^SVXi!2Blz1TsN+~0~%M~v4judav69Ud40y0X1T0JKQ`L07!>iRnzZf4Td
zJJDe1l2;vJdAJu5Ib?lWv}oX)GC=%*n=EvfItbia>X`okm@lMt^fK(qh{^eXf~ba9
zxx|^|F8H{G^p07gJk6R$yT_Q7Z~9<8wn90ETo#bwmXP7_QmaLuTHdXW1@rc>e{`qL
zpTE-IC|gqiE$Bg1c{~=UPRkYF*Mlbc2vD=-i6~H|D4>KPD4>KWN<5VtxZ}Y}$r^yn
z0fOfQ;H$OuriOW7lhSJT+4Z%5w(D5hXuTwb)Zl&lSF+yl=nvWm*3aUops@OsR^#qw
z%Mx-u5VGH@hb)T5BgmJ$sE~vqM!kkd_<|6G@j(beQ9%eoQQ$k>m7~;Gc3LfSRXB`}
z;I~_pl;WMkGttokd3PmW;?wR}C2Jd{BD%J&dfDWtnnLHi?n?UGt<`sb8m7}y$ISEZ
zbPK_qvC&v=9$6uyv%ywd`LnbYw|#?)S7H3JP(?Psp4&P5e+uI4TP1B_=057qyM?g2
zBlcS7hj<X1=vd>_><4Af#z|Z)dLrpP*X)%MmPEt5llIqZrnOSGngNE5$pgHVu>b>*
z21<vXMmgR13M+Y5a!4D04JuUcGRpG4u9cpZL}Sh1Bu1mx*J_HV(^Ih1HH7@da8lM+
zRr<+aA^0ma`fE4^$Pzc?GPVVl(Y3UWAPSg|lfhn)K>&`udMbR%ikSTg<YSXBN9(${
zs+mP!Qu!G214&BnPU%w0b|vKkKqDjF3R{8$xv~gaJI(5r)kgY%ncd0&*mWy4YIc5*
zC8J`6-J6#=tr>9uc#^!%uA*tds)TvGD(83C7ki}7?B{e5^kC|_H_s{0X(=u}+u>^0
z>3Y4+8BO_Ea7%j~L=yVBSpNVcmG{qfRYs(|+~~PqO<f}!)Q#1N(RT~A%GlZKVaEFs
zp|^wVvYw!O!duOMg9wOiP5SL(-tg<%2#V3_QqR9Dcj}{0UR!6b`$-$O-CIEk<8+Ue
zlt~M0v{KIuew?gn@FxguRWrzIXN;c!;7Y3%_xp{;qF2;ZyDs!u;Jj4V8v0Y(K~&~E
zbp>Z9rf!{<$14EQE!TH?68A)Ex8CWU1wsDN5x~z>!vJT0bFdq%o2YuN=^|T86t3)z
z&vN*_cw^5ztZ$jZU27e7+f&UQ9`m^+>u)z|*$bwrk?tpEE42E1I0T#qLfnkp64ZUV
zjGPLne}lsGvCVJ<I3FUa05!25ep%a}c(i~QUt!mGTTHC&+-f3Hzoz1nt_gs=tvE!o
zekvD^-&sw6aixl;2?1n-xNm~Jizdq52@EBW`UXG|{))fxGXnJpJ`TcvG;A`HoKv=v
z`fAa;ShV;o7WrF{54IwGo4zLaI4fJH%O7N*b3g2bQ-?Tq$8w+iKGYFaPz!U2Y|soX
zA5d0w+|iOABLGM-l!YV^KN81b-U(dR9<H8~G<uSMNK=48&sFA*u9@>X7R=tzZdud?
zg~qlD3MuO6KY}nylvd$@RUnwm%Z72fi$u^~Dk7}UVIxoDc<KW6Q(1I{vJleRXFsWX
zu#@-Qad)}Q{>o>;0PYR<g3!|2uUCBbaLXWfyhh7rx-SSC%P;{bwY|<R#xAy?((a>t
z)Gvg8PCeE+DS-l5$l1($PFF=$qi<ADKBjnE$koo4f<bb>PfJulIx<7$!7Gy1*lIr2
zYM`G!n=+ByM7uh={UtMGB06k>6N5*W4KZzS?=Y(Use^{1x$_VD<!AA0QOZB&OKyY*
zX1a=wTa8>a@#MNs^a=57;nj``W(tVJvJf+WmZg6WUmJBR1g-ZrR!@Fs5#Bq~`i~{+
za27uu6^59ye+=!PdB-$QA^>-ZGb!U_Ol&Ot4Ql`ay~qct2OcP3z*$yu9>SVWnQPiW
z4oa=5i+=sB80x(Cdt0uz7%3T_%s!I!YJb;j7W0RG(7?J)=;8GPr>16_!Mipy2M(-%
zEu`$o{KDT)l_D;7_uFpObZ!|C94l-|=2e?r`%iHB!lT0ES!0nW<kArV6D<cb;MFwF
z9b$OGu(ztQLu{;^xMi$3^HtA9`$<jmIXv~iKX6oXj=3qhXd94#$D}c<c2=sYm)1)y
zOU_>Nlb(sKqHOjksfA^H(8(rtYsyf6v=07+EtD3Uq|r6;Qq1W74Jz}fT1Fg|y}}&!
z*<`9eW-6k5FMTf~hew56Z#1w`U1}kP;zo_ybC#^#WW9rtK|Vf0pxCcullOGqWu-+$
zXuaClPR!Z-GBdbYbABqQJDR{8Jj!vTXAZ5mN^8{bnwD6YT0JJGqR90VU%9G(c3<Oz
z)7(Jp8Wx`OYliDVH6(+)94))M&`XDQ>Z06H!wEAksS=}IZPga4>1n574q@1@jV)D0
z9HMw6ER#9eS<OSGt@rwJ*;~l|j|nGs&{w(#IK>H`G3fFxhK^+x))mN^txGFt*}Jy!
zKDrnKDxhP7QC-Cfx#KORfCJ)xQtn$l);*m=F!Bmvvt4C4Wem<g0E^n<b#)AaTG97C
z6!+VmJ;U!F+2%~;!#fnwy5Gh3Mpw%iA<T&OtD3WL^5tAvC1Ehb?>F8~dQCTMqqUoB
z8Tk(wc|MT}8!h991ON<>Ev%=^svnui!U@S%D@kAMEwn%dOJH#HflFI|?t!~eODpME
zXM~@?7`cX6uYvrc-!43qjb&FR7lOXxpBoxl_gB!=P#b+4#GL)_2{1BK3YUksLq$<j
zG-N;BkE+oPBd7^K*kwkKMOBqogln<z$L5ZA{IzTPNlC<eGwE)|v=7Os$#L*0#ieN`
zq_I##D@c1{!OHhtE!1~^T36FmN6gX=Pk~ug@>O{!>txScHF=V#)78&QG&98PO4p2e
z6y~<^K7_&<RSU$RZn+EB4=&Vid8KKd4|A8&0dg+0U8D4^^AqH?AMvivtd&5vzQQ&i
z#Q2?E1aZJcIXH1Cu}f10ToKI!`I_P06<Vdz*Xp;3+eIh`sR{po0HdrGwp)K=S3f(J
zcPg$r;Zxwt2-f65>VMa2*7t{g(Ll1l>1*9h+NM~j<#QZX<3wq@wFT-a>S?570<_oG
zc$g1-kc!{k41VLm-jb}^@7imJ&J~$19NpjMkh;T7UF$FPv(wW#(YeZ(rrayAmNL&N
zNvsLZXuoMGK1VBm9eAV_mg<^vH**R`>1{Q7rM^<jB_rCv6@zoI?+o~(=Uffy>R|EF
zy}XqIs*Utj6H`bqVsQgKQv*lqcH0;!D#MEkU~1hJO?e%(KbKIGHTp{ZLP&KZ-mfnr
zyQ&Jr10ibN8$gd5jeDo!hdr@(z%C)2QIOn;k^%NF{*u9ewp*LKt@7u|bvBI$dbquh
znVp1PdG;w3<Dw8>;y$|(qCf3ddMm9snwD;6xMSiL#c8beYFjNEDd1<!Lfoti`Z|st
z+cYT{vL1gDg_C>A6hv&0NG=-=z5xWBVG2}u>)aS6MEJTIcbvK=lnPi`xQ&hS*?o|t
z7g_fMphzcwZ-`O8Ldgk>J4pZ;F&NL6f`TK)>;cO(A`au`1}^xSa~uuSZ{nd!A9ByQ
zSU#Yz$voZLtdY|Rls5HjT0W!)5W)h*(L#58V=FWyZL~L&0H8A#HLW1VG2@gSw>zwn
zglz2N%rF3fal(@!4Fe@YFcWn)0kIVZKsXB}2uw*vOvsr*?Ih$k!C}fs0I55vL`h&f
z#eo0<9H+;*1)%y^cbX88v640qsq+y;JECgLfy!K^2u+UOS}uY0CC})g2tf*e|Jf<s
Bo9h4o

delta 5134
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

diff --git a/gee-cache/doc/geecache-day4/hash.jpg b/gee-cache/doc/geecache-day4/hash.jpg
index e579467c46b7619e74cb476ad84054a15bbd7c9f..5134f55a9507a9746c21cc5f3950c4446926d65d 100644
GIT binary patch
literal 18947
zcmdRVRdijsvfwc@Gcz+YGsVoz%n)<T%oN*+nPX<A7-ME;ikUgFJty6rzJ1?&cg@Vl
ze9TrYX{$<5g3>P4mfn`$wgAYok}{G25D*Z65zqnNRsmuFFi_B60DQoK009jF0S*oU
z3k3xU4G#+s4+jeehk%HRjDU!O2nUCZiHw4Vj)8#zkA#JdiH?nmj)DHG5D+k69&iX4
z2nZN-1ULlr|Lf=ND*y!=L?4V841^Q_iUI<L0`k@mAOL^>K*50Qf&hL$AfOPCP~c$D
zFhDXM5dVw(n+6O)z(K))3Eox!@L)h9G8i%t_mFoch)0bYNR6qct!yrl`d1)25=~2A
zT9^Ot!8E8+O0F#U{|*4A|ETppzk>f~(*HFj;IABbT_;jgS6rI=c!!X$PQdoHnjL$1
zO*IeV@OzlzoWh&o905R*hxkne0%O9Kacmrt$7|Od<>{^RC&>X&hsS=C6QtkapYK<)
zvT+%%0syFgl?#qN0-h`XM}+fCs!H|Tf_q~=|D-W_a7eUv?8>L!`wU60_`5eFl(`<E
zoax|E_k<vU7?y1;w!-(!ljesJ?<TLl^m8A=@~VaM#m7ncQAyi)H$PlXzk1z;PgRS2
z>n?onMm}%S-LJZ@Y-deo+56BQv^+@dd)YiXdQ(2wCe~kV&R};L*39YN2f0>mz8iJx
zsP2|K$1hRuem6Ar_~KvO{!Dh$e5934#eV7<e(;(#(JgaU_Oxj=;C?vz+4iX_HtZFw
z-S_=^!|jI;pGvHb{5=SAevJV*xu`g~s0gSM#Xo>5&vml+(@Su?yZy(Hr`$p+cdl^w
zmCahmt_3BDa~!@mL>g?fv8#$sd!1a`>654F6$0-TKU&V-3;bLMD?M3WdvAPE@smqw
z)yWSn>7;&%T_Jj3x3<V_LUY>A#SP&i$Key5v5P0ahfdRm>3S=uGu}pc>++rh{`)W2
zS(<G=Bb9S8Y3;4sCTl<PZ{%-Z+KS=M3i5Iv94GX@GYDn90mNV3FEDvNyWUED7rZKd
zAUs;D&i`JJ_F#apJkGZ|@q><0YR#SCOSj_948a>9^WSDIK=`j={htE(?A|Z-?tHpJ
zqe=^IZox%+J%6U64gD<~|1K(j$8_e+Ie!U}S&E3cM54;^H|n5~XgZ@(QWSHoivK1{
z|CB6fXiybm05K{w00;nSVgRHLmx(S{GQpBWS(X<`l`?(2zb2f{s@t8hsfZiTkR_iR
z68~;NQ-{UKl6zT}wfF=$sd>Vvsjar9)0m*u=aUd&K*C=Dog@O}ANlu0{?!(#`k`63
z&6pIg!{=@>q?4GV$+q}lN3QhermTYZLh4JMHtV^IcBI1M5s5_ni2ch2pLV?OF(>hI
z9GaJEmYKphyB*msZ+ups?$Ii5=r&xxM%E7f*++l+Bq+ZY6bQ3Am=qXs(qT#^%0DNT
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

literal 22150
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

diff --git a/gee-cache/doc/geecache-day4/hash_logo.jpg b/gee-cache/doc/geecache-day4/hash_logo.jpg
index 95778c9636dd2739189edb4c4cc89c1415f9f95b..c9cab999fc3595ef77d05d9772989e8d3c8a8d8e 100644
GIT binary patch
literal 9085
zcmb7pWmH_t(&!%C-Q5Z95`qm5!QCZ5a0nLMLy$mlcXuZcoZ#*fBuEAe65Q>Z<lOJ9
zyWU&x$E&KnS5H^Vp028{>gwn3&l>=if{eTj00MykQz!z@D}W>b3j_0qpa2IYcqDju
zI5>C|L_`E6G!!&6R1{QHbPOCUbPQ|^R8%YiENomne0+Q~OhO_8JR%%Ce7rw{fMB70
z;NX$r;gRvsQPJ`Kzu~zDz(xYvL9DPK8UO|x1d9!N?gPjG5C8-F=X3uB5CSYbA`Bc7
zluHV&|HJ*42LK>g7&v$Y#OGxI4HnA8g2jT?En!-oocvd#|Fei71#!C2HQKTg2MC0A
z2qPv^kpKl#s#RaXA7`D<K(HNh-(Aypd!11dmJlHTH1DNjynCl0T46MGG<Und<kWa<
z^JHh0<(MNfdij{)YcF(vsa`d1qQ2{a(zHh!(9qwSL@GAkF_DESHSaz1+jX3H^~5MW
zV~WLB#l8BbX&wKL&*Ar|sQ0B^he1H}mz?UQ15#UJHaFkBxg|$lT0XIwGxTgjCtioo
zCelR*Nk?n@tv}gOyk6bbl%R%<>dE+Ih3X0F3gCSdaA?9$_P$1cA4K59Yni@?PEZ%R
zAl8)GGb*s6$mmd8*^s|cG9X~+raz#$%s<yAQ}d>GlxO4nPA|#YTe%Zu8E$T_gx}7^
z++0yn7CYv|L<2HhaZwiL6sh0qx#}&<CFwjVc8Q6JhKB|+ee?8H>0zK`?C5E~!0EPE
zP&2ylirw4r88Dm1bGyC5h>g1C$o`VoCKHxDY?bMi%w7Uc|DwVZ!2VA^RqAc*Ut8W@
zw6nva*;1Fr8r}<sz66Tv#x=#<HznpnBee*+qxdeP5LP>$)`CM9-Ws-J#$Q`GDzr1y
z6xs3@XH@1;L1LEdG?+Dbf46&L=a^*@aXpnicoe<<ak9kX^JFjGnxn(DZxVgmS#tHe
zI%}prKWMxSk?!aLg0;NyM+?9>K`)?$>rrrl;@!kDPiQrKeb4s0Yjf_%v|@X6y5Kwi
zGZ6m_sPwtTgvpyXnA;TGvAom?$#DDZvv5j+C*Yfzs{r?hyokC105;Ec<x<3lbLO(!
zSBxEU`18843w>5aX2=_p8yCZ8s-^$I4{P;I96GZE5#-OzI6(sXN);GcC)W3WYRTG4
z&(J>;;PLxb{%70(sGf6T0U$UK3_Mh|;h~M701Nt~<^VPpE<Tkw4jutDCm$j$FTW}s
z0~h!mRQZvhMgf9{c?NQ79a&n@o;1=cJ>J<E+g2lG)Yvi{^cX3Ag^ebPA7{tT#f>t(
zPZPj5qFY918P{5)lzA!FLLXUyVD~ZymD$$at0Gze-`8w(Ae>0+i*&sK$~P%8ZwfzY
zcb;7oEz^Q*I;zNcY2#TP;uWP2&p-eVk*|)vd0`Da8dc9HOMvsMB^6!d9TK;sLt=!A
z^U2L%*$Ju<711-WB^z_(SWmJzp5`Q_Ul=1fSz0=HS844zy46^V!BpHoglzzMWEMbu
z-}&>?gB_L(zflfP`Hpa>jLFriw1`&XB3mGfg6A)UuB$AgA!3yM%y*$C_pdR)_h}jj
z5Ir0p)*4q4aivpM$)k1-dwD&a650gOUaH93=9zvq&4(h~Se6$am3}Vs>pR}HDn~-k
zz_Mr9igW+kUKC~jOUjz6?PtJY)5w*fMrAC#!2TS=sh_zuOL&2yc}S?zHY%h@rl!FH
z{M``eUBMPvWUBU0fYm|C;)}p`g$-L~LPXqWN$qcwwJk0CcQLUp%(m62n)j~>z9(qk
zB5Fk&@RW?#wz>_UxzNY1WMtPA4#}h&;1CS#>{jf{fG5lT_Ta`yB586`$>3gXA~5n+
z%5ETL6MqH}Nx(EjX@<K|1HQqh>&<>nRhL~0>mMIiPS<a>rMc9`-z^40QkNCdlow@^
zO0-7aW)Gr<LlTF;!Yo^wi(Cluk~pyvnFMNa12IMv0(R*!@_2dNl0}+46P$L=BbJGj
z7EZ)EN=Er5<8NeD8K={TWonz{30HiaD6+k=6eGW-$O(ukMD`znTZT$2wQl#+mMFCw
z)Xg3|f9fHsBzK4hA;`FT?=Q2MZYAMB&XD`gKx*18;}^R4$y_xRma<n{O(@xzaS|Mc
zS^iWKyzL@OMwzX`1gVX>+xh+`n3oBfLI=cgiTc4QC)L#XKd&5CS<a_rM>t|)noX@$
zcF=ggoNnz;wN<7Cew;ECPgIg*<ish<RpPIrti7~fmkx`O$^g&lWk&mK9QrWiQ^=O+
zeSRsl@A=N|jWD7%FAh2RST-XyV??PrQ$)pN;xj<;>4H2Sp=Jt_*h=pfM1wqGyt2ON
zd4bw4`u&XHRkUfLmHYCs83a=Oqf2{wtqqfs!ermSY|)ES18SAL*idf+3kx7Yt@0li
z1cHHu1F)&#ak#K>@u+Ax!Djfh+|Fu2adqE#RHrvjPXAga)M1H%p2k3GwIxLEIs0@m
zUw;erMtw+uZ$^#$a`Ox3h8)GRkE23e`M4)BiP}Ju)f<<*zp*6nq$J%kj1GsCu(r!p
z7LNMbfRd9DpR{_;f;s|~zvC4N%a~|WT<w=*pP5`Rk0RANQ^#*-xv1V)k9wG7`1yFG
zdkmxk0usDIgTO))y5*;5An;xjjzPF2Lqq$O)39Lk`Q0p+*_AWX6ri_}5Oief=zp<l
zZSzKQVGS$Kegz*n_3*WW63xoAzbDjKyyWypVzUZP%1XoC=?DoV9t4|28dNxE3Of&m
z34YimVefGT%JZhGktQFYUM(Y2S*@ii=!P+I(1IihpX@eIKNQi^_89!I%OsJqwsz#u
z{V|%k_0)JsGzGQ6!kWQGtC(y3zV|;z*y>qXnNl)8ch(h{tJrcE;-wH?oT}{OSd^Go
ze60yrIJj3nrX=it|BGBlt*!Ug|6yv5uCVa;o%BaU$|450#ExZ{2hC^&bpbu!-JpB@
zHiH#{wL=buHs9DnR+bk8l(t^mo%N6~hRoFSNyLR3tfv>Y>hanVPnFqXo42ZSMTmI6
z4=XY;RYuwj?g^H(2@{S@uoK$+4_BN@@K-2q%{`_EzevvkYb9%{%r9$+p8<p~$bL;=
zPgImHr8{uNHOFdKd@r+~fi#OE!Aa(<w@<~(env&{t?5~kixRhf#uvO3nVRf7%!)Ka
ztJy+q+cp#Qs8ln!2hs?O&2sX>>am`Dd}e5g*}g+VYkT<cxdpDjv=Q;?Ny%#S#(9@j
z<J6Z?9G||F)AX^7&4#XZNP6<y``M^8#raHyZ#693X{6glkj5#>DI{3Bs^`eb%$@6}
zw&_&ddfVLo;Nqhhk+h2R(H@warpvgnwc1)43-tFq-Y@BX^$b82oEaN{fq@282+-j0
zAGZU70bsFlsJU>#a9B|N=EhTlS2YXD`>WP4f7Lo8yt?XAG}PS}(p)MOS4y5s6%|9X
zPsHd-JTJNyLpZ|XC%>jw{DD1~EtxjgJWJKYL$<1-onPq3$M5g64CMSoVjfcBFAETk
zNk-i-7MpLdD;rxmh;ep3%0ej6RK>r&Ow0%%3ng{J{;nMv*1S(zWt%j3|M~Tbp2kYr
zVnZ>8$9%Yb<Cj#YN`uNTN#KE{Y=VLMDkXBQ0V1jV#)-Hw1(wQfsXd*7lIRj?KD&YQ
zJiUq4UL{Ljb8BA_D^lfn3x2^Yk`tMik$DJ7pVXPHVQp?MkD75$4`v9-{^6pWMtO|=
zVr+BtN>=NZB2{4CTflkyzhE`V^A|*m{YX<e9>X1B!<|G*jPlpB&5iCN9IIl6-%Xrm
zG!8+=VriN^vv-DWDb3g&dq*0Q)`ue)w7&}`QmoULtgsmwMC7Kfv6rhTW^J5aS}B`T
zZz)XeGN^mpvWc#XVL!O6K7w&?iY6+%Ik~oV#AqM=+`a$GOadAzz(B)zcnny?e_{pb
zrUbxY<KR+r(WseWaf6+|!Q)ZU@`y{Qy9Ncv<<)V%Il-rs)NqNPRyBQB|IZc$0uaQY
z!9z@sYWx>+oHz}ltiy6Ye^rSfg^#&6j><oC;qJ&9iEqTwhNoP@C~f-^6jssbixXTU
zr^FpDbn{sh7Q1cASG<GmTCt)G4HEQMlw}#6Rbl)vyI)_yE4C@W`z1oLC)Td9p>h-Q
z#?gHq-x7qHY01OLx$q1uYMQmDQv~yJCQ+ZXrjsUE%dIJT^m62zQ428tSQY3QQ7~{I
zyC%#Hgz!WwF*Idhyg}Rb)n`*bIr?GDS(5mZemmaU(1l3Bio`2L%aIvVKw)tg#f%3@
z!xFUuqMW(e;-!-ysLA3YM8&s0^LYJ`{uDEV%e?zZPZzw2K4V5evI@ySRy5C>>ztG)
z#zuXufs|H$t}i;ZhW3-8y2}2-zdgFBc<yH%I3L~{jkB5lhlKR|#9&0;zBZd(He|Uc
z2t4Msf?mns$?qt}GItiu%qZ%mmZrj)jdGaFi1){@6WvMW_z>kRb@GzcBbgS_feD<p
z-l`Wfn{hRo#1l7-`bC>7t?g#YkWDr1nUSlW>Qsm3z-o+g%K28bGHH{lMioWOH4+{~
z8N1i5dF+s%^UzlB&l(SCE-f|{T=&LgXBc4WJsGKcTCSuP#c=Uv7Z%xvQfiXEuFTIa
zq2H@raqhj0(x_1lvs|}tVclukr&5t;O}0zdIvZU_xl+FR7MEpTZI~J9O`VqJo;2Ea
zU@IiWvh->N7w*=8-@Da^dZrAXF!q<g8*;l!1>uh;O;ea;KQ(?HhU$pn?R4I_F6Y#4
zzpjESlYW16Nn{g-HKkB7j?n7fSHYH{Sv=s=@Umxnp?4M|KSNrRQtr1`Z!bNf#Xj!{
zaZ0wrG}rj+h_yF*71i?2DDs=Si8uGuWF&U=_=j0XVIpPsNGW4?CYPMkI<GqRvs<%A
zdfWF8SI+i6K9=57sFP6T?uY&&#Tiz(F4LlX!6T>jISJpg*g3p~UyGa9!{eZu%b4%g
z$6%ZV1blpVry2{UN;LiQ{dMJ`9&fd@;)D0!$B14tIpCZP^Px9U4V!A0sXKM~c{+b+
zd<ek>lg+=ds-!td<X@9_fC&UUb{|MBe3<HaYnd)p1kYw~;r+AbTF7Yk(H%)@IX1mW
zo}ZRF<w;VM5f!5|$xfGB7r$IH<9OYe%uJh(4P}?ETir5_qsn34$Tz|c7A3N^d9j`}
zwf>%^LElYMLrw-|1wb#q=+^P(Ov~AwDRg)I=&MXX?#H}P7jZ9S&{<)qnw_&qqzGxV
zLq#nPVGp<J+caC8sj`E44U?##;dfuw`+=AhWu95-`nU#zv$&SawxYuC6?MxeF4pRC
zn`yMM+L;V@<Xq(CbtH#0nfqf!RTd}hy*DN^%v}|iOHbh``dZbDk_1t_ltxSwc#udI
z{V$A<Uo?5Ypl?Xy#fRL6vG>~PuEBW;xtGfFiT$9E$}Z4dkq58ljn*zF3j~o`t7Gm^
zxKO?`RN*Dc)Ak9BWN~;kDD{E~%og+7*S^_#t^I-Ig`og8DFwYDZ^$}vkr3cDZNs|(
zhn*0yDrLX3+|v1u^^*Hm<{V!rJEn(a7yTsF>Fybr%%l%ZXA@qd;UM|FHH;!6!9$Qu
z+cV5e>xrG(c#7Tb7|OD*Xz#^q?Yr4DAT4Vw%UB#;#UEeLEpcDNvYM>1nz&bz1i=%S
zlH{o>4tIMSvX_Mv)hOhNOFor$W}km2>9-Kjg62Q$k~t`BiYQ@L)`Wg2#4Oh5ged2d
zUSc<)-K8d+5dFHaOk!SNNSrFw?rRFY`Vu`g(~9<1Ut{BdO8VEj{e)>`VPE7Hf-`4_
zL-(k`Wx`d$y=2nw>e@L(=@j-bCym1US@x8gGav|Q9~(tkNv3ek_)ro?Di537XftO(
z<i|jr$+#ES{j-?O>{-8A8IM6|ldpvu_VTt8hO$m5QsYznrt?>=@%_ADJhEjw1}8*$
zhHV=ZUHd#c3h-YkaHh4mq=<{lVDmQX=4VL4E*ON=V}+KV0faJoC!gIroT~;u7}umQ
zb_+uwqUbWdw3c5eO3SRXD<LXg6olQvn<k5!nr{Wb3K|L*H@5o}@9sQ9ZYD2hCnzWr
znoqODGM_l0u>lJf00TXdLNi9tv*_R80E7)tb76ti%$$Sb@~Ak)ztx?bLWACaPorYg
zQ28Be<uU>i<P)h6lYMlm;Cze^-hBvgG8;yjpF@P~BJgme@^ZUML!=5(6Qa3EztXt8
zB35fGhXwEUl}K9W#l?NU<Da-MEqR5Yp;gu`ZYt#nzcjSRQ{34jrCb>i{2f$mVX>LZ
znjFfO>pun$N>8W_(lK0g$Ed9eC${$?)~0Cu8ow!#Z7y~4B7bXXzNl5afnNe~Dbi{$
z70eGe6MNX*ZhVbSOIw!WL`b8`2++P%M|HzJh9#WS8qLfVKgg3Bg~zqH8&sumU+;m(
zFs?nIY5Or4?CFh{_O@s?{1c3R?o_dElh-n!{RV5wf-$?{Q|9*sX%7fUybniVo8A>2
zaKy&_A=f~Kg)jF3)-cEddl?rcRu?qpb;R)shBQ`A{qc%GDpt0VhuKtHX^aLZj+#US
zQ8;fY$g|@&iQ=zLUc$Gv82mIRYGV8JbX0Fi`pB`}_X|3X<t*Ormgpr348;GQC3yx$
z4sC%|9Gkii!BmOh+=D{m!WUGf&%j%wH8I2@a_W+&w0n81d`TC9R2U){W)%Cx(kN;Q
zFsjfC|7YM0CU;|g^>yLnRYNT%(lQh2eB>zWy`VID_+j&hF8%sGb>QV=QH1?Kf9Xzb
zjjjz_=ws|Jq&!PYw>T8SmkoyG&4CYNfjGF_wDN|i;hNZ!7QaA_7~TMbP#gLfNb#er
zTnRN=C=+=mVuD(ps+n#Ul7^cDx8Aks=h$f0%J^4aj7e74%bV}tL?D+Y_{o(5NApy4
zDY;cEx3AtlVjL6Z2`rl9^Rb>F?qF<gd%?Wah6fip)fXd4DgfeB$j~K-tz58DI?ZKi
z3_UCb)dG1`d)$dL^1W95_V72E1|994L*(M(d=|EHLaFo!{$-YTkhFqs{J3Wzb~_YK
z+9=7Xdj>8FM)h+a?hfdOQgJD2x$HS1KZ!E(+M0=lHwE+A)YhA4Kv65TJRb9D^PdU5
z%wVbg>r5)G<EHGazYHk~(Ogmw=S&!Wx8d)TB8zu+Txmk0n$oxz%WSEgado^pyJsXg
zcH*f2=R>pQfFYAg0$M@_4O}}K;|YFUs(EzT`4$E^q?Rgi7{vEJ9j7KAPAitx5H?8<
z&1vt4<Ao(5Z;jqLZ}>rCJP)vy)#&vG1G#2|)&wC1=M==RWjhgrHXtdP1!^14_q`A7
zw}Img%orG+iey426Qher4`_l-RQ<h%I5fp4h{Hs-ZB%?=jiYtwaHw`+O&=-PX3kzA
z#fBt%D@(1y5E1UT_R#_3K<GEBqTJxtl_5ZLda3l<7();eI7sG+p$GSbwETfdv{UT}
zp)j!_RZy<M^rVE(%G!C5>@QKa*wTcbxEoMGK#B;3T<=y9%T}~-3DLX70WexSgJ@tN
zP=hYv=;waJz#2#jKO6{>TJR!^8U9$Jm}aRhYi|&bV_Ia}f$&jIX(G^339fQAgp^|=
zC5?!goBk{35W;UF+^wK9!zQ_{4Yo+Tt{5x?7=4H%U>4%lOgd%G3GNoE++aVE8&Umf
zE^#}f1q4qc0J$F}(#DU(Xnm#L6QO(uEN6(9Rl7ms6~S8uXcQy_Ou1$ouz?su*gJaX
zY^@&}F&siCV%#uecYR^kur9H%P;Qw?KPyWRMg8#MAxHlVzrR)eLD8MYfi5sD#tr>)
z<ThQ2yfN7EV^H9wsJQ0QFHMY3-!wfeWC_Z%@&h?kh2G!dOoVM=s=Xk>j#lLn(>D$|
zd0hNwwa8p8Uv+s^s1T|BXZgtdH+ds&d<I1Vnt%LnW*hi(B*VHt?)-m~=>2imA1?aS
z;4{#9KWFOO_*PN9!$e}f2sY`oH=^<&%5R-q?0Vdt5G==giio<#vmyaQM~x%~9kda3
zrE@pu>KQohyqQ(voza3k1NYOkO1v6M(1QjPpMHz_%nk<p^WzyfpA<e{Sy#BVx`P%b
z#h{NMG)<5M?F20fpF>|FV*lwl_NM~sLtbG2$=^e74nT1K?L(k01dGZ!D324GHc_4a
zucQgqGk|7ld%?fiW7m&*s$%iJ6=C8oAZsHL|56Ix4*{=Gf(>GLT;l7tu_c$oSX4m8
zY~#5oR+scydLSgl=IJpRf7;eS_4pac@_2LP(h62BPGr0c55>|ViK8Gl^57yvBP(nb
zV>8-EV322GI48pJK0Xlkz|#Nb@cn|wiU}(#Z{M|DkjqvA6j~aW=Sj3BPE@93^0odz
zeP=~(?qce=ZW7n9McoRo!RW_%$2Q6myur3+hkK>kIW>Q*d+>>K_(t&@){Eeop3z0G
zQToXqa`^_|61!wL`7K0eyp!3j0sMJ&=J8jFK^R_dovHyTJ2!!*G6GyjiTwEL>Gp~c
z96yzNtB;U4EmNdxDkrvGx*+32)N9wD>=-!mj1XF;2!N*^MVOuJRRqjOX^dVQ-=B@f
zDTeRkRd9$}cc${(>!{q`QLZsZhxgjFS&9~8F?>LO@7&dvv^my&+KmWdQdbM>1@oOo
z115+}OvSm5l)Fe|wk1eh;$iB7_3$YDvgj#SY4=}LN@6BOot@o|vUHlR*EaE0@vQB=
zXH*X}dfKrNQ?WX|oYjf=bwq1rbfRqKV}B(@hE51MF-;n}@wGR<t<y|%WKuM!<X7y3
z1lR@oAV?#972wHI>q+NocvIea?gh=82%32gecg^R7XGS)OUU+BL?Gj0&1rQl0RMN0
z9z98~KgLqK8K+x+-|VGF!czE+vlP*QFIOPzN*D>cU>)<YNX$N;@0|`}mJkFh`sJn0
zA?2L;I&1qqRQ>t@Mr^3gK|>b==*7{0k{ZyI9hVvys&t&rK__u}s&&(w|7J9>o`}Kr
z&7f-RvlrycIi7i4_-LJYoM-Lg^5z?r-a$v`_}XEkTN2v=-7P9_$VKk1?%z?xb!&6r
z&j2i1%u%~JXGVOg-LmzEj-(DHptm|QY}b+BURa>5t?g7Oc3H~D_j@(M7E>9u=}9IW
zbB}mlSjF`FZ~7>^KZ1!pSh8;-xzBRhSIYwxVbH(BGmj#Y^KfTq=d`Bqz(*5PJIKf&
z7A>xXeexl6x(%0iXku!Y97H~_8teBtdt&Rm9@zi!47fTBH~Y@dKS+g?IU1d}Sl^qt
zqBa!~J9hkDPaFRDxlhmYl}A^*<R<vKQcKU6XVF=;UFLG&%%|Utpt8eb@jj81R`$*N
zMcPhFg~!UrBVt3CQ1#|p+T4}JA6b3n8yORPe5E>t92?6v?5I*&^PU_7+l{YV<U8iN
zQu}ZNGiTi7oWb3iWtH0_OqY0M^xKTIgQW^2iojrLrH?d{{#zYUM76NQ?z`NL!17YL
zIOWi<AK#-nqaY_7gbk<CBvTp}9}AA${*@gI)}IXn3IIIpKPlJ0LFeC?6Dqy96LHf#
z)pvE@PN)CM4|)Y62Hi894p)#Qm_bIUHN=|JGwmhM0LN&QTJRfJJbPKW)7wSSj`*Fy
znKpY_NPiH$ndS+paTk|0HlHDA<=`~EacvCFBRbPgB$g)60aSQ&KzAh20IRzzEA)`l
z_z^Kb*?=kMyc~>cMfQZ6V?69?{>!L|_5#WD8|-UKnQ$<vrcrK+q^D-@a_0%@*lGUu
zlvB#LvED`NL*IzcO@zdIm1Li2j@97iQM5E}6u;6a3wacy=5e6_xQ@fQWx;Vf_Sz&H
zgt_QN%;X!D+mh2qGM8(ZskC%~w!2-ZYt{is)s?jpq41`qfoT=7SlEG>sr;tQ8h8o}
z+yf6KQWJ;VNW>s!Yr7F<j1=;B4mN(SHUlH!;&DKfl#BpcWF9?Mqc*yULSWwy88Ez>
z!faq+8khB$6Xpt};~C(!1TC>{PwKLrups2JmYTeEJ*^tT18IsHZl$d`6ijQ7xkwmn
z>DzS)3)+ws>S80P+LL^t`5r>2j}e*Asab>&EXsnUe>ipDejc^}8~bk2VY<LTNrP3E
zH-iBgPS!d%=HEZ!H%65)8N#UR-c-m7L?2X93Jr|NMZomEV5YjDGVpN<*Tx-?%J@E6
z_JPpr#Nzl=L;_t^h^>5SPMgS~I-c<{yUw0(LkPE!C|)3y-`>lQqVWL6aio(hxCf33
zMRph*V+KLEdXmT^S9U)d8Jro!o(m)=4>ergzm$y+Dw8J94WmC2WdB6K3_o>5$L-h6
zB^8OP9P33GL@!QkT<678$Gm<a_MTI}nE=(43NDVJZZEKc&<zblmOfL)s}ai5<&;S#
zMco}U+JoE2Nco`~giRi?zQM8?AqOVNe%Ogg`9<-<MF>KziWsh@(5+@sG&-29AX5yS
zZ?VifDYZuyFAUswx*%(FP1MHPi8>c(bmIeLm}ZTvfSl$mVPv+~<NC`sgwXl|l_Jq+
zfY=qMfmiFQZS8vP6s7@8nv*g<9eO7btuMdYa`wI}-W*K?lTbGbSw^S;$;DH%$w_MW
zW*5)-n2Y^qIj#2(M2zG;&J&tfZWsZ6jRtFatfE?HE!Q`}cA`ohR*OGTD{uL)Kfmpa
zLW)gq+V!WndpKJLF9VwSaToEyDJ-8eOLUN|1mo$wOhJpwpKWt_tgB3gLAi}0N<^F<
zL3z^NN%eXA%xb^|>r12$@kK+U;)1S~YspJ=5oWM0kjf`4#CcKQ-MJAI!)hUyEJFuL
zefDX_7FOjKJ$&+?nTCGhY92K`QMw{AG;FOb1pJh%w^;dH*AVDKYS+C#FuDu3;G;<n
zkC2S1_t1@5?t9y#MG(k*&XIK#8wb8ZWCt*em$jZu|IV?jfMUq*{jOu|P9FR^X;4|C
zBF7}09Xjk<z*hI4Ve97%f4PO4A=5N|{j{kml8hH8{;H2jEyO~WOX&gmaQMG)^w;p=
zpXU!gO89X97mC4MSzK9~%;!&0$>a@sui-Mon)Rl&>^`N{3%|&r2%I7TkcdUnL=|%w
zK!@w3eNn0>hRg%EgI<J{$xN0ht|VE?E0wU_KC|I<A)D`Df+(;D<CI*Jde5Aqe*!;*
zMJ(#@w%Ufy{BKcG{Ia=#d|~Z+4#wk1@{Q$Rn+JIK;yy0IFVEL#hoj!Vfhi@>8lIIq
zS##;y3~+SuO&xrTTpRt<!j;U}voAXDWwj&Qq9g5a!q)Jaf0uv5|Ak!*kzjYCbHq3t
zD)nx-lSEJK^lDa4ht;5BdG!PLuN2UW-(H8xTZ({B@4J>go@BDa+5-Gn`0C1@fo($S
zh4Cx0T2fP&?sa~ygtv>cccM`X85pyo18p~qqapB|*tVSHMyG2Mcl=WvZx~u{dyQo`
z18DgqiepYGWyaR+UxvpQ@4efCWTLKWl;!Oq-Sgy~-aOTQY`v|PZ=IjM$f?wE8S1+0
zI!!U1cquR|JG9~1<1g<%+OOQfU|fx#Sh8C2IeL`One`;2*02AuZgNzt($VQbLRs+T
zb^Du%>iO*@o$+xqtW#lsN!`b(O~Hz1fOLQp_C#(HU1c2*ngrKC^UsxYX_I&wghK%d
zUT|Mwp902pTVp*Cu5gxB+X6p%yPr-7<)qi#AstzGElj;WJK1%CJQ6y3-n5IkoDr*|
dYv^3DF9%#+<m5a9Edn-oD`4Zv`GDu8{{dwthkpP7

literal 10096
zcmd6NcT`hN*Y80<igW=*no5=CL+`{!mnt0r6%i=`>757)NPp<k6-1;)I?|gUT?oAe
z2)!ktga9cwzR&%>d)IrvwQl+APR`C+le5pv{ATa7OZE_Fh|2(zj)t}dKt@IeJR^Mo
z;ymyWAis3!&qZn!q>GZ8l9Gagl9r0<GBq779o-e$D_7_lSeWP;m>I5IVPa=uzRJqR
z#zx0@?K(T_brx1O)<1)gk&~XGproOsq+zAMLeKht-H06kGd0jcCPq$n8@R+wM$Sw|
z>;ZTIfQ*u~+CK~a?~UvdX^oeusA*`gkQnNifJ<cL<d-PO|E!wC9YVSfP%u-n+>*S1
z`Kr-#s@oo{QejD-srepMb+Q?cq4=d=c!tx^vR}K-aYH~*NcfJ3jI5lzf}+yHN9r1y
zTG~2KOiazpEiA3<Upl;UeC_1y<?Z9^=N}OG?tMgL)Q9Mp<doF3^o)<0Sp|h(ioO<q
zD=Dq6sjaJTX#COC)!p;6x9?Z~z&LDTa%y^Jc5Y=Av9`XkxwXB6K0G=;!JJ~x&i~*d
z1IYh@^`FT84Hq*B*Ch%Hatf+HxX3Q~k%*j`g7TK+WtRI!RL?!G-j)iZW_^(KxvG<f
zPudv8_QG?FmYrW_MF9N=+P{$fp8*U1e?s=3!2SoWIe?Cwj3hjAW&i|izb=TurxJK+
zg$v&P|3_u)H$tY${J4wK%1;}NUuwF8IkowgSss*z8vuE#cjO8x2i^-9>-=TzUND)q
zRe9D%?tdoJzE8fA4dvskzx+`CDWr6<9W{>}Z?ukeDnAeiU*!-#xcwsep%kn4vp1%x
zhtw)efo3MV<7Gbj+VeG!_j;Bk{blk5Q$OV`j5!lB9(fz7yS|BFHM&RnhuF5}?smE?
zI<DA$Mwm>x79`C4u$FhTWLjyE3pFR~JUbXTl&3w)>dg)G$w}otv&k=k$8@}SV^pN_
zNYPa5NE2)x!n^s+NL@*IDL|!h@=Hkhg~`i(qjZI1^5h`1;i4Zs1#A0kzH%|bpZ+e0
z5e5okyp39p)ajhZ^+YKWWH=n{f0Hd-7|vN$7hV%A{13(^B5)1Ik9K@pJ5xvRr*lF7
zC54*Bp!TQW)3U#=YYG)Ks4A3$=&|lbXx}>bFWYiNz-2;0KEM!ZvRJ3fWARqOI6$>b
zc&b<-NULArv@OcvF}q;ALu84LPGMaEOb-s0pDy;2idjTM!hN7*&K^$Z`x!HCYwz`w
z&PoIgYlIaw_(~hN{mVrf2c%<CZD4<u=@ii>q**lfyJgkbeiJT;DZE)wi<2xM0$tjx
zHbUA*ZKIfrMsV<cb4%;NHD4*|xJ?eWso>{WQzAf{Z&~%7FhQ8SFm2D@2+8lCKVs{Z
zmkabM7qHC{>5UCNuG9T}?BsyWnz8ygqj9`l`{kh49V~y5)M2C^C>M*eI<>@_fAgP|
zwH7X{moOWiPk*EU9?nlA0!<&4t6So`a;=WH_;-|TijH0`qps(48AsmW8j<u2dYz6m
zYacqw5-zA$xI~h`zo@NrEFy7l6Qwh6YkmDd#h|SGnQYHXUZqD8Rf-(9_|#vRFma?F
z7FDa6LZNDR=j?Fy*sEWh=lE|QuE{8+)~6Q^`QDb-w!cR+$fxWO0OBJ{3A0npmf3ue
ztLf~S(R%(AFZ8ZZc&u;r`&ip;R{XHUB+@qnf^}=cdJ}=##2zPyr0E`8otg~lbh)0J
zql+AIIgFkLt)5d#Zgpr-ua`jD_vXnH-Do!(zOI|E1Qw%JL=pn??@zOhD3|O1+GC!?
zRhPec2=Uw9w|f}+>n}@dY<rK#qNsXB-|G@q{V!5I{CE^!72U1Ma?R=v!(3-3?IPGT
zG~>jpe^Bj5k7WcMgT1XAgMsg{liYaISZ&2Q>s5?JIvIBa5r{huGGG~s)ROs}ex&*B
zg(<q*lTTH2P{jvD1gx=M<wW4suJ0gMT=QxkJDhG1COpHj8OKD8xcTzcbPo~Ozl?>h
zzEzvY7x)D9+;qFRk6&ThL!Jh=e%x>1E?a7MeFcjQTltv^>6uy70gvJ(XH?+0p#DlF
z|2VxH6ZXc=&INmEwQcEJLH^|pqP@!=lizE(IiB03czSM{I}fYoWx$#gh`^1|fsCaa
zu>DFgAMD+slrt~Y#rD}}b+Ps}di>e*&hc-(3Af<ya#u%Ziw(zGt`Pwmp7_ccY{C?$
z?~g|7=d}UOQo~m+KNseeB(OX{(cE&G0=e|P#5xs6_!`dD-Vd)Li%OB~JmCPAPszs%
z@ky(?iIF$TjlZP}O*)uqt2u}~kK&_>^Fb_3=W_W<KAV!9Xf1NFbb&$+)$+bROd3_r
z)8$guH#tlFv3}5Or;crIs7%*7+g)ks$~9j#nXa}P1{XV})AAe{wt6P@77LLlW`3vH
z1GtisvhA4KIJQHXVYer|?Krl1L~EtRTMBwjq<Z!$yG1GyZcK+-iu+4-1bUo9Es7_j
z%s<EuRy2W=FFBABs4^0B?XSY}yO|k&!gW+G#HCmf0oFDKe_zH+>If)>oq^nkLjq=M
zEt&bs*|S~?s<W4zTHv08k>zVtQ+c;rRU8G(5SPajqKns-wimE-if-grlbU7}G>ZIx
z4is$)kFW>zvahEa!z<fw=SPKJQfo%VKsXqg>RMb}y!^daoEjzH{{r9}49!aW2-RKk
z6?kVel55*sX>qC8VFgY<*T1e;;>=j<7`I0Sgr!l`2={mJhf}rURER)|9?9Z;*C-(Z
zpGR$<pxO}<QI5+c!So2QoC}h1Q0Snzp8tAkqh}>+*)uh3&*TNfb+%ts7C(C1t0#MX
z$3(yF28m1H4PFG8>1kAw?}qL<8*ZEy30zYZ`*Pxu09~n8Ok@p~8pna4TV|Lx>2cY3
zPLm((eWo=@mf$z`EHa-IO=<b5kcVU=qB|gJ>|M=qHR{DJxxAZI%`nHB7Hyv`Qwo02
z#~WtdfBTZZOD8ZCHjMmHL<XlN>Twwe3)Yk1f@IkFNG(ydp)vARYar*6X^ILH?fzQs
zLJ(v3#+3_!#pHYBT9Y(F4a2Hl_QfJtXIVa@x}o$EarfpUYwK5mKPYJfLS5p!O}f4f
z&MJ!P8$Zoy7Me5&!s)*Br}_}eUT!N3!zr)mxy|<)FLqSN#&U=8frmIO${INzMDizf
zGpGihwZHPZ(pSXG<sTAki{N_{P@mF!z!2Ph7)Jz3w@KPiHDTp}27Ta9>zGU*W?xkP
zs7p8|(A~oA@Umi$R)|1kD8F;cg8!uhJ-0s7WG~<I)WNowsozs?DFEN;E=z_>{`4{J
zS;aSZKLIxil*YNuBYl%?WK_y|NMPGIzKSr%x#$&f=sP_S)m876@=TAvn9@v|!-|{*
z2RW_iX<I*TPbP?RG*lkZ_!@Eo@!fRSpDl+|D=0$s(fNCw0V_edD(b7Eg5N)CO$Vlb
z$+vH)r8N|G6q|LFc#t670ONnPqXw$RrlH|oN|SjX=PX@zuYc8ev!Q9(H=;$3^@ZXt
zH@DAA&Ir9{Ql=2xOQrKoR>@&eVv!0sRjaFbtRZ2#Wo(c%BC*rI(_XpB!ztFky(~><
zA6s!l_V%ZV9QSMByGJ#?ZCO^El<0>Tzlk>9*W|X<lj0|f91j9u8hIv3NLNwHh0YWK
zjfajKyb@%5TZwO%u8iT>R$O*N_<GpYgtVa?Ywgu09m-79(dMD~K~VJZW}bD2BtH?T
zwizENFqEm#ew(t<$*5@C_MR^AnSBum^MD8>yOcm?Z0+z@>HTL0CU>8UXp|%Sm0j!h
zPp#2vaDh&T87?^e6B^Bo`7tl^l;CU|3EZ^xK3Lvy)Q$y5S%BrckiX#VW#<vSFwfk;
zM>(FWEjIgslL#0@9O59awK0(VG7wI!60SUE=dL6Dp4Cyp5$^sA$H`$9?|fMDAfqOB
zPTp<KFA!N-JPWClizxArTEXOli=3tdbGvquevMgnj5ivweyXCS>DA&mWkcixDm1G$
zoU2Rk0>1eNnO4;%j>0{>9K<}ng4f8!27vyXA$mbXpwIooc}6!Q^_+8)346x1t9Al4
z;;Yg(pK!%#(GGZ}a^qb_)K~~(O9E(Q54Y%p2{G?)U<uqJ5=>WibN*^$rxW!~VS^5~
zoC~chk>k{<5Ht<m-TZv<)kpJA2FqC9?G}XXaRnR2>dC3Q=%QU^78i0~`^zXa_yr1+
z>C&(-U(b#ib62oIdWcjSJWm#713B)?8#wLN!J~ON#_N8Kj1^Z5{8$Rzsq)o$ipEhv
zAKKXMQ?3NTZv+RR+Tx3cF+pV&YD_{zAWx)5fAl5?he+vgT)0PE+?0ImG4wqzEfT7t
z2>Ilqc6+kCr6DL<Vu(3@r~In7+eb1B-p0VNl==Gjz@+ZqMH>3JhUyr1zcTQbq!s(W
zu3KfMgRaFFQBj(w>G%jxhFY|leCE(G-VI6bOZPwRuxjW|WRgoN7rTuZuuRqskna<b
zyXU}99v8{=*0VV7S>EnFeE!jAi=8D2^sAKRLGS}f@f^RAHkWX+v$WYuIZSV8`1o#e
zg^d#?#?<leP>0^I?8nKvcTDDWhrWNapzRq75Rhjc4L+Y-yt}ITE>wADtBnW!vuHiz
zLkc@)F23wJj}xun`g~W--we|a-c2>6OS3(>qEqXwj~nKntD77T^qyEQPF`1Vg<lIR
zhq+|TYIvr;SV#sd3IvtS+D`A5thaHawo%2s`3z2x=P+Yt=P9uUU#Wn<2P)A`X>Pc`
za9-0DL6Ch$)ZA$=L3-@K3Nxra2HxxOQ>rZdE8+Ugz?*kM8(w)-<Ox~`HOnB>h8-zB
z;Z>3T!kJh%*IzRGbnfvzhB29Cpu_vwz#y_gfujRS1YCQcsoZS-c<17|Xi7N5BU}?|
zH*`K_S}ZctB2!{uehq1ju9^%h(j`yXs70r$&X`6l7i~KXH(OQsxzvqHW1CT;CfFxz
zt-DJPOP#K<P_yjFNd8I&i`OCgJ8oH1Nb=rQ;3qFzfxk_x#NE#Ceb^)Jeq(N7iCe+S
zjqbS=Ab<9*a-`XRH1H(<!<%B9ltY3E?_KTjf%LVKMc@~XhBqFxvWd$APvgU74e$(s
zqr2Fs$he%=^(Se~;zpAMs6*AT$dlsBC4+Q3-;Q(_Q*2;*P$8e4#9P?=7a&rsJ%ySa
zsld15Gu9UCpeY!Tvce<q?9sIgY_GCuK2_+@bemvplWse+)7+~%R$bw-iL+_u%TK>G
z8s3jp@pWT_vhB22U&E!?=n}dPiNMxJmu@29$iZU}AIj^Otm!K+keQRbxp#<1!1Dr-
z!(bH+2_H!jHnEbOT7#l}{L|&n>1)St&Ytu<&smQiH^|erY4);iYN|G~KG^dNgueAz
z<m*lLH`e7-Ypkhg>U8T&H|}6{un(&(yF6$Q;O5`lJFalY*i9Vk2?7MZaeg${McfVf
z?Dg!wKP7)}e%5?^U6@McJJf!n{1|p&>}343RNy!2NZ0vZX8^9B32%_L;j<^&33+|e
z3W;xOw5zNASZ{sr^QnFRW9q6A`HWupsyJL`+ulQ=DRsL`hi6lI{1meO>BXT~jZpUs
zN!e|k24t>6k>C%rtVMB$$_z8Nfw^k<Pa-f&1PE*fkrj3B`^bF*rG0R4e$|=6fU?`@
zNBBao<Wfs`TPq$4S<BjP$6Sjg0*{96ZkZRRy%2fvrnJc1&o{X5x&zh~Dx1zp#bY7-
zb8deJ*0x_&w-Bs=?O!#B*ziBj{G2!7)uhYWbC-dj<`GU?e_4uwk%NkyOHK9X^;5Pj
zvm*UkE|K1?Gglt@s~J-kabgRCP0(G_wS$nWkc*c)o=z)bEwWDTAz_)75>^(`eV}IA
zV(5h(!dB7+fp;-L*Ahgl8?Cu*gEHN6I@+6u-e=fU<diIEFa&x1P4Crs%4)x0u1a_L
zMtE{DW31-X?ndCu65p^i4J`e3vs-qHYjVv&d3teE@xFmrr|cE@<<|{rLeaht%K-C1
zo-i%PKB2IiyJu&12`WM5xJOg-CR4?hj`LNwqji3=5CI?7l&};2^OUEUKWJFDp1qj~
zI2w=0AI47yUQJx38<j5FlQhjKY%NcN`@Mu7{n#btw?yDIFV>21qkbIp9a4?Uu4_7K
zo85Gz-fiF^g(?umQD-%#(BB|bsfw)E7sxXr;2baw_Sp=n>F+hV=B83lAeo1gHPUpM
z7@4-ukr<Hq`sv*u8{}CA;rm9uEnytf-qvtewy>_k#R?t<$EjiS?N_)Zk6Z1#Zpg>f
zB9s>j;9XxW)*MWgZPGfft0UY3kG9&G2$DN$O5+u^x?rWg?j_FJ)WOS{U;C<p_Lnrs
z=F>Y&jnetUA0XcLHGUbbDm%|*blJ}d**^_Bt=oqrC1N&Se9t#B1?x{$8|g3RByYI%
z*UYFWU)&=C&u{`6ouC;tNT!pI3kF#a?#p?pTp!?AoC)(&*v}e7ng84uy8nA$rXr{#
z@LJ4^8gpHj*l&jVpT9WX${jnD8h#7xW6!?+OI_}gMI|S%V{@0Fp%+=*AH0-2iv^xw
zJ=Wq8?5S?K<*TqsajW*s*<cN9S$VKda_3$9y6>>sW63!u4D-j8I4;loLPBJkpUB@z
z&BC#|=u=ayrITQe*z-y6XaT1<7Ok;g2_}q5XTTd8N`rbSul1Qz*1N-|V(dI7A@8D^
z=g%j4^MW#sdt16>^XmfTzb;m|SPx8TLP~H}KN9<V34*AR42Kn=aL^sF40b|OWIZ<E
zlQ4s|FHOfqsRnJhGQB1y0fu|%oZ><R7;vES-4EH6_#Wr2%btLy#xo^!TZ>N2KtSjX
zXZgs1LGz%%CFF*$(dyHwci&d55y8U>Kg+gDV`H_q>UB?)euUm!fCoRULOU$R7wCb#
zTtGABCY=m3mnhXK>c{H;Qbxe)yg?jo(vYr2LLU)`24M^^kX#~g*VZp{!<7g;_lVEK
zy9{kr5Xv<3*c5%js}D8FhpQ^%U6o4?rh;K+R&^Cf7ie0d9qM$SjO0tR>?lamJR>+1
zO+x3}W*c}s{yvyp&&zYvTR_yi<YA4_v8Gs~08iKbmA3EAFXiQG(mCdHSf7Pzti>%S
zWRl)_dNxMND32U2@9btcWVh;f&E9~luvxsdPF%pVaVyRGIoyFCFDrr1Dp+G;rMV8Z
z7!@_Z!DC)W_VtI~oUYD_c>sk+5>7KEYh|mT>5g#(wTSm*GNCE&l{BXvudPMgBdDU=
zUPgMq0G6j64Z*x60udD}WniHTs*Ah*&DK!m{XE|{3C$ks(9@$FOeN<^J1Id}vBkpl
z(Nr@8I0ht*=N&#gMaHKfpCLGFV0B(HW-_Q$CnN7$oa%7Bzyse^={PrOPOcE=j51Ek
z*^t~?ow-1sSTrL-9Ug}Z`GT$N`nA=N<to|7awSn&fZwlQ+5BBQrN^()3b21RCN`zV
z?6(ag^=n^((4!fjsW6AE+hlXU4>$`Qg!sf}RLlCR4uty}%k%6aooTvP#@rjgC$`0p
z6jEf1MaJV_<(dzR^R-s^6t4T~TFeq0zXm&EM~T3dpbK6CDbAh+%@X`@tpQ7pnKk%`
zUb&!?if^FTV6~e*<fzSVJ5(x-%KBtsgK1CZ2)<c&6RP&grPt%ne4p2`j`}iZ-tqfo
zyX|&E-#i4JxYQpTmmwz_q}OAyrYSYC+C`I=xliHDb*fKRWsBovUF~eUL+Dq+7&CZg
zW_5aUeZSEHJ3+ZU$$`A2E#)BXsyoD<2=wG%2wi|k8Dj=idFV(E^1ZQlG_-ER|BqER
zgPRr<)5a)uS_be%Y+yGv>Um5#<6jji&;F3DX@#CzoDczKk{z6f)4V_#U>K9u=d9-N
z&HLFkYad7U^DK7Pj~9D`RudTrzd<t~8izkT`5RU?R)2UrHaQsf^DMVFycb85U$wmB
zS<P;$K9A(gNXgK5125r6Mo(g;F>Uj67YlhKn8eO`_dba9Oz8jK?sf;up^I^%@EhAp
zH!pZGQ8T#FV~G49yiLxa^<A9XsQ%;-V!<fU!z#o$#)tQAAKD#yvgXmUd1H!);cKcI
z{k7(b3m0fmUOoa8o7LWPH(Ci4EyFE>(4X8BpAx=V=iB5v^U~LiiKW@*9i9DaSCpPl
zF`_S;Af%d}S>Ug0;C@X+=Al`PG~fK?Gu^(w9|LY2uU?V2`Zq-4G)w#+TGvk=$L3c%
zv;U0qay9Q=7wM*>Ry5-)4poF2PC%STxox+*=B~k91p&r->$#05VbcslIVTtGX#xH@
zSKOEiHN@2|<>u;%K%iQ;$SU<uv$BNViT9;Cheq$M(ql~sJ-HR$&9Wt1cJ)Hh6^OA~
z5aS*5ru1caBb~fPOnGe5G@T6!vYl-{Xc}ZS1;weCK6O^gU1*q|rf<{UaII3y>tF!5
z0O0ziZ-@o+&u_a_cz9&2n|F6cvsbxh9RuRfNr_@M$p%3J4iMFuVZ?+{OJEFC-N(yM
zbLfY%B|F92Q?BEUzZ<D2-Y&hLV12Tww-uSY?`uJyv%EPKjzhc|b%v^QoyV?OEM2kZ
zQy7sRx$`)>HcxV4Gp0hF3omAz@@Vy5;9sg(8N_Y!cW*;zN++Idj`u9?S+HE@prcl$
zmSNwKQrI=!`mDc5wpeCSlkz~}gfwHBVd|X)kF=(1y1=K+cfT=TNW;JRwIe-zf3%M4
z;>iZDw9ta8=B92Vi$=hKsz|%qgx9{NTmiVq)3Za^HI64fPk2FkBGiZK&kfz|d-Gq5
z!tWvPDU#v_MrY`sF^oJG-6y_l871GN`tfA})S`5L`b`m2nD2bm_uhH|%xL5Oj<9&b
zYT20K8q$UKbn>-@6d<KVuFx;z&czkS6Q%0h$`;%)@BA|-|9Adig&=xIq?Ppt9Ncv(
z#@^?lMeTN<N>$R(NH=pYtiL`Q*E#)WJFoSQZUooglGB1^W17l=wSvgc_M!I`5kEft
zQdKuE$X9FlK2`cN{y&6Zu6!FI{B`W<Dz~~^3@P%N6DFH@^7<2%kzT=DZgq9rQB=yx
za897N6{d*gse$~cJ4L?7)r-jptDTsQr0r*anM$6RDg@7Nu&c36`Dm%^s)`)0g3h+N
z=uO=ACA`mY+1UZ*n}qeAAltT_i5AnZPF^k2PeajaIFG)j>=Gv{%>)_8$aR*(F~V9B
z9&3%yKdAH2<RVPCCRUboOB#lbm?x_}D+~#gP3#!fM_4vSZX9riNU@(uv>grQ?-d1_
zM-jNNLES+-^9H)nL}0UZ6KPwQC&i5QQE>$^z9<_Qe_FaZdhQn`8*figkr^EPMPmB$
zCOEB~s>^`wDP%}`kO)*}7@3dBn6p+LUI?FC1xr2<g{RFPA#r!|*&w484FpPYqh_q#
zY8j}#a99ZMmE=GKe%rSFT~K7d<13dz_dImavEOe>Udei|r6Fs?;B3=_XD*?wwz)3m
zkScP6zcG;z(9g40d8G$JSqpw4A4Gqy3dc*IeI^270zR<55+?!so}Z{;E2n|DN`G}*
zSTLw`ml^pTCgILU%GHxPhSIiq7_j0hfj!VwR&8<d_DM~y?BtDBxeGg(jA}YeCuz?v
znHq5sZEDWp_}bYqd}VerHt*J9zO=KIDJD^H@Io|O5wyK3XH{nRg#X+zM$94VR4Jkm
zkL6EjVO%u`gLPVUg=7b3IgD&J5CMDM5a+EIt%d8!HHuzh$ri#FR&HoTD-n?pKVC7V
z7%(ei>K{d6+PPC}NdE2X*gb}VY;{07gmplK@*Dox{j1SEXHW>|cB-M)aiBa*_)~=@
zvM@v{2C(FZmR9f|;zX~KQWVOV7Q55kHE5dX0)YX0NdHi$;kUcMA#%S>7jh0}3uyeM
zC?L@{^JYUZ_s019IrEv$#NcGes5VclP?s%N#>249Oj2Ae4}XVcshGi<^%+ds5?JvF
zJW0S|pv8*7!=1^db<OQmC(9#BHfL_71GM~42d~?ZP=(o2n&rF^y_83oLkLU@GtDa#
z%9(rkS<TkXOe#jW;_*MV6_FvOki~_d)w&;fe-v75QYzJcVw|-Y6d`8@RYWI73c)th
z@!SVDeU}a)H{77wc{F=#voZ$mLU@@(u=;KO4_n(C8blyesmVv|EGf-O%62a;Q3_=}
z$opX*1L0YNoch8DssVPWI42?izi{j)0>S+@d1)(yyo~sQbr5nbIiv^5h%G^AwLGu9
zZP|{~6+7iOhJ?%`>jGsU0Y*Ba57)d(QJ>$X-2nycCEWe9<>vLFhX3rnS>fqeTc$eM
zza)ZNnn-2&x8LW43;v^s_otBe4^{9oI2mK#*};xyY!JyCrUud%(Wkj(O0Ck%5^0#x
zt4r|qg_^pVe59(q<>AkEzOg~!CT!!wp;N6fKE1TxS8~Zac&H|DUaKWj(^@d`wdS-1
z$H8ba(x2i1jeQf-Ad7sIA&An&Rsx^c;_w9<xTM?s(Rh5l;xkC)_k9)5UsTIq2yAGJ
zfeHzWd>980i|ngS@c`rBXanZZg?8=(wHr&pPf^e=J@)w(@#e?`gjJL8gv8B-t0RX9
zkGG5*o5g|Wh-HJH@mDd)SoH#bxPJZNo~)LIwgYGgb0jL`*&EVH;W58!7bDMG=iW2Q
zj-wk_qbVA$>x(ohsBMTGpJ+XqqgrHZIK+#dTwvI-vZcY)_#74am3F4P8I=PtXL*z)
z@79t2MI0oGe1|^Zn#&WUBA>v(R3tnWry|4ss2sB6pj?2FjkZlf>qz1=!9r-UZnljR
z<n!WDJw@K^4R1C&-8kPpRwF&giO+a|;gp%o37q*ggu3mT|GQP*=vcY@!dY2l@_RSe
zke_y#TvXY7lAYw}g(ofm1$`@nj3uR$UG$6uHnpPlCQfnn_S#$F8dtcgS+q89hKx;k
z@7fs?V7%0op)!Oa!d;Za$8Da^kguPs7rV~Jl=N8gU!ckIW}&@AfQc}{%XSP3pKd4f
z*-U^vge_PuSlP|7PE?F5`h{dB>UZZja=mKvEMHfYJ`oe-$)z>Y_6E6yUdKH`P4__~
zv&>_?X($h(%DOkyTmSl{IWX3^H_-9!Kr{nw9yQ-Rm(T-|;%M`aD)L9-SlYXk;1Ljq
zU;I-ygS6`6tq^9g&wn3bwAp2!V3+d;+S0K3uGO!TbOOH&xIC8C<oI@~;N{9Mva&FK
znzYQzE)(E0O1{IR+nxy~q!G>qf*0+cX+;bDBE4ZJhx%n-+mcF`W<a=ReG~*PZU+ua
zPY^mvWc|IKBa%isKXAer_Fo<yxI?l~=cF(4Et1J%EXY&`)M6Z1fpZLU76TjneG&^r
zE{Z_lqPE<2_i)sSgD8?YZU_+YSS`A!+41*OnVFR6D==?zx>i!+RDa5h?>DjtRhf>M
z)>|>)P<uy6^k~z4<pyd=JG5xhFEEb2AQ;3Y+;Eeg)6^~uX2U{AC5o&4t2Uw?1a6qh
z!#e^eL8>Cu2mPuBA4`%ADqWgZe;lJn;?QN;TZWMOc}VW_T{w&QvxpRfpFNA@iH-SI
zho&6;bA59reb2WwGy7T9gm+^3G4&$dYxpDk@s{?UrN4fwa5!i1+?w`=GtRXy<UeVR
zS>(l!O71MRuTnMmWw{^6{wP}+o#(~8LBo3!dFQYV-A7i=N!|9`85onJ07h`#my6~S
z)8X%pcf@4A{79tb(C3rO{yD$674q&g?gff5M)rES420X?-K0IUUZ5zi%3W-fup>Hc
zW0!m`zbA>df6}g1SvyG206IHwnRpJ)M_td&Yd5H+_Y6|D7FE7Ttk<S9>Nth?EKd3!
zIDg#4>ig*R+id9zMWR_(cZ~Gr%|dvW_tkw=FOgivdO>9$=D9_lFjjh*m(#^?SM3%`
zGfH;RjETa0E<J<d^h%;;5)E&z#|_30mBGqBO?Q|0@LQmE+eCW={`LVVZ`m4jD!4qY
zZpC7drSvuMI$dv?jx!tgms&@C;Qmh!Ue>$ms!~@Vh%8$WgUdrBG$F-_V^-lu%0*I6
z){&~cMYi>X?cpYYjQ5niw%afzD>W_ouVKmKLUq_zq@WQrJ5+owByp9eiZHJU!XKB|
zX_=4Oalr=Bn->_5>8WSy$Qm?*P@){OZjFM@omBJMP@|!LH12;@!U5re>YJpK3BdnM
zqFV-G?xZs4B}i3(Z1Ab=De5vrx^vnIKe$1vPNaz@vfW+Gx9K(}0$^LmuVd<L2;RyF
zRwFHmArSNS_>yZD#gSYHc30E@bx=}PKd&dZ;m7^hX}tNyH0tz&AnF7*$P$p$wEr5v
zi;(8wDvB>hGY97TrJ}`9CWTR1r{+&$CqlWgv072X89G_&yKVH<dqkkkg@s;ZV^uHu
zDiN60=7Ty;som=TW~uG&?y{EY?{wwhrzcydX2hM6(gXvIK>sB%XSI=J{oOYOF`~!U
zHIr4MHav5RB}iS7Xxg(~L^Bci>6^c2(P#HydIZGjc%*h~5qf$v0)$?ioR7dJCagL^
zst!*buc)({e-G7RHBtxuo#g*`LKCKc{2lqf+#v98ogni)q~C^>OFeucos`%jOVJ`H
zcC$MqfBin+A`x_}`bpx2b6NysrDofcMm8}TNt(kyYX6oxt0CFHlbuAcVe^G!kGKyJ
z_yI~Hxp9fP^Mtnh(;ERT>SbDe67GVV1WFsMX_;e}hY9?9%+Z~H#Y4xVgH-<nMxp0_
L!leJIL!A9@i&ZT!

diff --git a/gee-cache/doc/geecache-day5/dist_nodes.jpg b/gee-cache/doc/geecache-day5/dist_nodes.jpg
index ff04b0dce174e46fa57009f5425a4daf7b06fcf8..1f9865ec2347dc266db2a7cf71bad5d460bb7585 100644
GIT binary patch
literal 18731
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
YsamS0=(qXY2LBo24m_IQRR8}b0J~l7%K!iX

literal 21817
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
YiaC@p_;Bmol0{)ZB;BX<fwSFz1IVQ$+5i9m

diff --git a/gee-cache/doc/geecache-day5/dist_nodes_logo.jpg b/gee-cache/doc/geecache-day5/dist_nodes_logo.jpg
index 82aadb3cc98f60058093c7f5bf5f4e0f4ee7d076..eb129ea01f09c75d59f27d68efc6f45be1f43c5a 100644
GIT binary patch
literal 9744
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

literal 10792
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
U=l|qI^h<xUB*1^s;3Llc518X}@c;k-

diff --git a/gee-cache/doc/geecache-day6/singleflight.jpg b/gee-cache/doc/geecache-day6/singleflight.jpg
index 09d0d88de986c79c2b3e8585d8418d6b8fc73380..5a0d1a59b1957237baf8a8ec5d677a130bdf0221 100644
GIT binary patch
literal 19619
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

literal 22694
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

diff --git a/gee-cache/doc/geecache-day6/singleflight_logo.jpg b/gee-cache/doc/geecache-day6/singleflight_logo.jpg
index a53fb410020fe1f00e0219b0ca0b5a488c9b9bf2..4da1facc0f344b6cf3e2dc509319e0245734522b 100644
GIT binary patch
literal 8367
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
aE8lJJf$1^-fV=g@;$26mkA%+s?0*3>LPiPz

literal 9351
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
Bj;8<s

diff --git a/gee-cache/doc/geecache-day7/protobuf.jpg b/gee-cache/doc/geecache-day7/protobuf.jpg
index ee96320b0ee08ee29d2f6dcf73db60b1fcc50a56..85bc3365155d8ad42c33b0d0797bd5058f96655a 100644
GIT binary patch
literal 18405
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

literal 21374
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
N1yEk205ku;2>=MDH9`OY

diff --git a/gee-cache/doc/geecache-day7/protobuf_logo.jpg b/gee-cache/doc/geecache-day7/protobuf_logo.jpg
index cacd9628408559325a6c74adddb4d6146711ac37..e97f835dc5dadd39c70b7c9fcfe774080f0a10e5 100644
GIT binary patch
literal 8452
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%0AW|g28Y9Vr20<9R{7=|yparr5S<SA@
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

literal 9376
zcmd6McUV)=w&y`WK$<{65e!I?rXW>%P^3#QL8^*?fYeAYQIIN#f`HVB^j-r(C?X~F
zUZnS4LrbWcc<-G%GjHA>@6BJc&skr-ea_B4`?vPmtK$FQ=YZ?#%4*605fKsaoNxj7
zNk9=GzH;U7O=u*9o0OcCl!S!z8X4JDa;j@oRFu~!DXD4buT#^|(NI!eXSz<u0Agfh
zq@ulXlL>T_9>fUxI|&gn;Xfp#6r`jSAZki#(0{w(e*tvlKpoLNVj>RU3LOzK9TC0-
zU;_XmQo?HgF8E)K=n7$tSINjJu2B*OAg=>gh=_@=kP!b}HDR<r;XOb?M@oN3_|a7c
z-4|pWt{{>3U((4rAD1;T>J991iN16Tq`1a(<0kVh?z=p^eEeeK5)UP%q!phiDXXZe
zsp}gU8bOVpnOMEDwy}L}XAgVp?&0a>?GyANI3zSIJR&CcYg~N7x5T6$8JStxIk|cH
z<rS64s_LILwZEHNTHDa=9i4+i!y}_(f5s=~7Z#V6S60{7H!%ALheyX)+{x)*Ttooz
zKVkhF*?+)AN5FN3goK!c>@O~&E1m=*rXwM}BYc(qkuKQ_R|XD|_vE0*U((B(C^$v+
z_84Ef4P0a55}W77{Dt-pWdAi_f&Wj){tfJZ;hF%bh=~ZBM@$Dmfc4iuA}+pOvR&i-
z@$UamDsFCukk?r+k~8@WHDh6>l`jp_p0h_NNwR0O8=A33*J|486-lcfam5^XNbljE
zDvOwXvv*702F)%dq6bXn@9sI(%yl(67Og`~-b5O6YBE#Yovkms++5_0<H<c@j54HX
z%k=)fQx{pFTM(L@Wg;kInw{jZ^gDt#U-%kt(Jm#9wnbh%!6rOodV{jD%kD>H*q2h8
z(a-Y+b3uVBCgHuHF|i4a?wJs9)m{5kaw)Y#wQ4L^_bq`ejAwH+gV*)+vA4b-$)|#!
zwbRnQq@Y~k6F>newz6#ME4jg{2GL@-9NOLYj!KcY`S)C6)`qlqUMPVKQ|6W2;WYBB
z_LdAs9fw8yz8bz^juXpCm~ow4Yds=EtCXMHo5m(P(GNqBJu2!ouV)t87BuW`ai}vX
z^Q*@YwW%;)sW5!Lvd*)6-(=s`pfqm&v1Hz(d^bm)0c7oo4~Vew{ma*Qi<6rW)aNP~
z%5B76^!lvx8MqIE#h@z!wj2FJV8~h@11;AaupLTB)Ca`BV9#&BzRXjuzJ30sd%%3O
zW={qkaJ%wMb2Vfq3A{3#)nVzzVZ-j5CJ;<@^9nipKKZV`7E-$Na0!u7Q_Mpe(S&5x
z<a<<K6Kk17kT#?wfyv*m{DXD^nElvC0|el9@K;lRCNF|I4+17Ri#>PSrgLYfq<Uqb
z)X&-qd88f-8SkJht@5+!>u-r+7}<w;0-yuq<C6oYq##`r)^sJtb)A5|v<J>)7G9q=
zCa5I_C&r6=>Zh`tz})67AAoI1HungG{qG_l1IKNyxI>iy2BFr)n#%&UzBu#oH^`Cg
z@ry~YgA&MS70^`z{Urw27{sO|G`>L+Q&%mWS~5{t&rc`Q_D8s`wd|H8THxLGr)5Bj
zB*HfAQrHU*EF^>pLYs#in2y6tO#Nk)Ri3^4$bR*6>w)kxEXIJLO%#d;tV?cB;-GEV
zTjq!Bj<$s@Wn9tk<ok253bFmy2WdU{WriQJQOn=;W5#F>&oBobyC=98O2;GY6D;0x
z6;Q9~)>Z5myJe8D(n~?apEYkH<&eccYNQ(2An28Vg1{)xFE0YVuY6yHyjd6M#RIlV
zwhoT@Dm;smC2aQ6PAM}&)gzZ^n?A<EiPU735O`wfw@ym>>n<&Obyi6udpS*N?s8X$
zEHHQLU(8c89WD%N%qICpF4B}O2PmfOOb@NJO$i^(PH3NLT!Nf~;Z?AUvf~2ns-1BJ
zWNYvQ0b4#BKdbX`HDO~oD(EU9#R(YfMF)yCGTDhtG8*r`9SS&B*Mr<=WULmt))dWt
zbC{k+G!Q-f)-GRHXXR^rd{t^q<(R+rqrIJ5l3NCtIPPadIa+F(8i@yZKqSW-2`aKK
z!Va)W`#r%q<ef{VwU+QyHV(OyM;@C*MWW_YuhN=Pv5KV4h1}#xaW}F31+5yo?^I{H
z;4jp4Fssrq*mhDOHTPvDPhgowdTEjUI?HlFniwu&!Td3V${08KTVg`+y)_)P?o5*`
zUeEzjAPXn1IgyaOsXOK@3(Y%+4IklTRkF?2(ufA?ta8l$6!$1EsyaSaXqx&u6}6u|
zYGf8kza8k^+Q<A+Jx)q2r3R@bJ?UtP3cv&JL)f@Ga%3&|Q>=OQk3BwQK((yBAKol^
zJvec{xY|>e_ndjOayG&Q8su*LD}LX2a+}Gy#$qbQ;t97;eqoBpCusHq?R394xUxJP
zr5PUhz}B>SNjEK^79u${*@jxSeZ)iKrqEo%NoDHFwNmEZ7<no1aY5*VIGky%bj@wu
zO?2y1o3XX8ooUzCuV20);w+tnd;MXicmUi$wVB3?dD0-X*GYTbt~OIw{r8}f6`1ph
z(IZ4Ev!O9#pMKi|b=Yc&(&Dxg^b+iFF?r(_xLF9T66#$uqB^Ub&+qiGT$9f<5w-3S
zeH%m8Qo?{MQHj<V6;C{3xw(3#j+Qifad+_hZrcv=LuRy`Kvndda%z_B=nOY5Xny;K
z9+a*qQ}1M%#mQBeTeeuZg9J8~?QIu8@0IY>QPA9}>F~Dn>7|^k#jHqv%kK2&QpfLC
zrP}26dwda*b)uQ)_q@b}XwJC_Olh)4sv-32s(f4NnFNp(EL7*HFe8PBG(d5r)?H8y
z-wSSs>9e}3!Rc39jS}A8Mo?3xf`y7CCoR^G*tC%@({Z;ZDb%4;2O9)8G`~_d=S<g>
zVWDz+yLC|IeoB(JDEEZaZ*MPVu2O+&=Dw$anOICfua(NsVr&~&wEvtF?#h<vXzeM@
z<RnGay+K6sPTiUHNbW*=!Fu~s&>|$r)8rxw`9YUi&(}-!`b1Yb=~FPEy2KCbC++br
z*=F9u1Fg_m5c0PAnBwq}rab13#QvYj4!3+JE+Z0l8TsdEGUi_2q}8lXMPbJ}Fr8XQ
z)O{0=@`kiGhh=_{_gw+i7B{_LO7Yyxwa|!DzXtUyNZi<J1ZUxaap$LwHx_Bb-eQvk
zLMuyuzR!MNt-S2SVczK*6dAPsbVUA2&mshjt5jQXWYHY8X{@P14y3uquV>gji(68X
zic*hzu3#0yOq|8DmG#0k%kSCfR`J3Eb5pyD=6jkWw{1T>fIOx)!ufo}1Jt&#{ZHcl
zI-jI(C$KHNF5Eyfnq={f=ev5Adm;(vxb#8OaA&EcpE((CADtc_OuWnYzGH#wq^W&s
zpTwX%%jW5B)XH8~>UVz&ip+@TEn(^8lNKs(T;46NH1#R~@c@<~pic<y;7S|nXPV*l
z(V`+M6E*0#G|>#adNM9^^1SAb0uM=$#n?QxidOYSmY=t+G*RBvgo$`%q3ixVVec?G
zwN44S>uGIuV;Y#87R0p;y{L!t5?`_{@+3+m5cA{1bU$BF(Cu}6rg_BgLgU)=v<#PD
zj+DrF-MZNsTZ?Lxs5%tSYOYbHPms7Pk`$-@xz><tA%h2$P@xHXGnrJe=7$GxbX&^Q
z{z7NW@a}m$-~>OjXm~s7t|ngp@=P~LGCh9ZTM#S>Dzxuy4bxHk#XR>4W2to6W_ch9
zpF~`am8d*K{n9#HKgn3ei7UBMGm^P`k7LcsD^3bn6Sn#mXKy$_=qphIsW8KlLZ|yn
zF~<U3;ev)bPg*TkdAcrEntobwy`Kf0A%Z77TWO=^9}H9$>8w|kidAb02lZa;d5ykm
zTmD5agI#nIkTJi=ll3gNiy1Gh^@w>jH?<zW6SLh!swf*Bxtjm3nU&6Dww#$~!6I9&
zL;7hQ9+-UX@F|NQ=QYyimMhM}h1@{;aO1$+R2IY{c|jfKY6~12HR}3W5?Uf=W!RLW
z5!C6;8QzPuBQ|mzPm4U)usA4!T4Jr)(W#%&_ggDEcBM*-lWaGar99J3RBvszVz}SV
zBPlwvPCLtsgL3%3Gff8j4HC?LxeU90APq6S2obPE<Iq-HXf%84sNmw+tKp*iN9!hD
zncNeqRw>a!Yjlr^{s1!2oXcSg`Y~DEg(4Qy0kN(gm|C*tC*IW|4&SVMV3l4@GN2%x
zy8jdd<^S`oGmbw_Z&mZ)ncWYp;o$*FYJE<mwzPF&52vR6N9~dRYOGsbW~xeOP0<e{
z69FO7t^kg6?ooM`thnjns@hLq{G-b^j6`mPJbv^%^YepN<@sT{b{;aeC+I!T-*kRV
z3EG+tPag4qh;7|;B%k@QCP|9j7a{SQ9S&e@^%{rFU%QAuyiIIYY3lE^Kc6%+3I)G`
zG<ruS`$Te*LZ(IDxp)=bzdPvfdo1U0TZBSfV3}L9D2ds6N~rovnH#J$q)jxC+SRDU
zr2dxM*KPZhYNLv6!3lqKb>Oe(`{zz~<L*I3(^w|lB&L2$jHV@R&Ms;wp=6Vr*+`Mv
z%$p{MCYncI`VW1>?<APl!Ue}iXblBWT-j{Qzw|_!1yXw~kG*47pQ0M~Y$M(xSkN}_
zi=PiIS<1oE7<E$^-f2-@adDyeB^Mo3$c=$)bu2)r?U?9!!tXg%&HPD0yX^3&QSiF_
zI<eQeA|)(xL}F+;4*%^l7F_qNa5HHo!83hb;?(R*hkO2$(frH~mQ{Mv&fusHry$le
z2cMr4>xQ}cS?yaH*1L`+{yxSFzn6?D`Y1x;>Gcd3miZ&})RX;YHii<W%C!;DO_<`b
z@bj*PeRB4T$Uqr9P*N<^jHrm}3)?DoT*O!evqjv|+kdU*#vKEYQ{8>VmBA;;E&zD-
z_y}#~<(k^hu;W7gZJm!bWRi35hD=d;tM<7V!U2VIfe;+gURSF$PwR!mqE5e1<(auq
z-`Nwau86WI)t9JG0nY+#*xr8m1dC|PvKuN1&$|^t&5M$eIYT*M?efNhn{-;1Pi$@#
z-yRE!Gd|$q`jM(!Q$I3pZl2|^v*iY%lBb*UdxXi(nn$6AewhDJycf$ro>GA3P#*Zq
zN<#^LB*#xn>nCzKgR2k<gjd!@3+`-;ZO<rgop30kZ05(h)=`nzR$sPeHpX?6oNdL0
zf{!*4<j#&Ol~ojh6&=hUVSL17E+J~7Q?S@snI`Zx%vHph&h*AZllw;vsTUb=7a{8p
zg;X(IS=ZVFjCg#`^EGJPu8yM3%8sn~Q}&lHCSpwdG##8SL!-1qOGoa69E(kBA14l_
z#7(caW|lZIC5&n7M-5$48uPSK?q0PAb5|oj4N7Ky+E^jg_1NLyU{qv3iB3`gVmuC4
zqjfH_&WST|u{w@cI+&>VL|FFv)8nMu?T-(n6ItGRf4=_ej{Y6()3ULftdJJSiHv~d
z8Ra_slmrwo*0`@%IeSK;ga<OR3u6i_8AD=IlY@^fpl5i1Ce$n^xNASM_bV^Y%`qKZ
zW^w(FdFn;i>#Br_n)zW}C4b!$(!W86phSf54lnv==5*Yj59|-vBZG!-ZJ*0wD$w8?
zNQqG}Cu;uzpixwP2bd#0P;>-06X#^PN@77)Q%0~Xt#YJl&PK7vi?W|7tSO}<)>rXB
z9P&gIYKgI_UdW5rv@)t69;e`~hEj8&Q*7;HgL|*KkUcW7pvNUIL|+Lpr!}c553Wdd
zd-8edh~pvYBP_9ax7Czxw5wWw=Hk}W4Iu{s|5h~H$6(K}C_8>cPxmf%W(6HyXI<>o
zd$27%Q{bMbN-1)0pZ?2E+jclshm{6I6Vz{n4sH;_p_@EHhE&IjpCj9tC?5B*S`9EM
zG(qMhiy`2JSoyZtbY&fbsT=(3)-Th)S=o(xg&D;p&!}tdj?8TJj~-oUw<KgA7!5li
z1yWH@s$pW01u-6xvF~HF$XF33qkB0mB_J<O`?aL$>8}DPrpfbmA}OvD&95C?DU0Gg
zR#SSme@4`!q!h<H`OwI?$n`~6g92G4>2iJF4z=l1)bx38Xe;8npUPr99thv5aL-jj
zc~yH(0&nPkKKZHOqT0^9bUHFQ`_V#p*ze&*5NttUz4G_9N=KePj?a&vvAgA;Rr$Lg
zvA(Ri=S$c?{(vH-EU=Pw)kp1LlV{qu`=rxm{05Djlb{Y2V+L<$#Bi|-kT6Rtf=?Kv
zd)a>m#si#KIzn(eJ?p9rL;9Q=PTyD*imHQTRwY_3$h2>DelYkPZX!-hq?^K|K&FsM
zH1V_BH{!-h=H9TG0V`vCXJ->@-|cJVCASXr<98DYh&B(TAykB@uLVpqTI}vGpcivn
zYx$PcPPSp{5>->O>t_iyYm&5v^Q34kOcgTA3wf^T;JfVLELM?R!bfAF(9}DK@}8Np
zB9?twnp<#eFzFm;UwAm}aVTost*#r9C!ln2-y+7h!^62@rMF^{+SU@onsl*}&Nups
zw{4$FVJ<&d4|Qdmop;G9>+Qo?RzL4tJG-2&1>fQK!lCa9^<9L!bBPhHHN{L3;V;&D
zr~0)fUsp=xBwFRxoJk)<%hVO|2~>}aZ=7SVt=BPQI9uSf0poap{4(R1w(1Qb;&Nq8
zK6aYK4llAK=M=%jj4D3ZtHj%Hb}yw{6yN$$@YqSjRBUUkhtvtD*fuft4k_hMeGR+y
z(CzVaZ`sUP-e<;<(qBfPX>~@7pyivrf+EnTNrw44x%qmrk@0ysHucO72E)bfsam@_
zb+NrDRN`uqX1XUz*hUf{iqR&HSgYg1ShmiPS4*5qpkNM;flM=+6;BeSWb_m|Yq(-7
zsg_R1c$A*3>*s-=wTh2t*x&5d0%sIF&dlIJX=d*hptNgXCSynly(LSJsZPysan%-s
z`P0D%W-%aoFC8^WRyThK%cfa+Kg~H>+1Ju_qjbG6F3D#cHgisY=5pWgNByz|s1|Ap
z|B4&$Tf0thPpjK;dG*v&;Xg_4X?Gc4<wGhnPa4jqMuyIx71>F5PaxxqyzTP3yARA2
zWdu5(RZHyCc2feXgapAT#<tax3AaGYX)@;IRHRB&6np(Q&awIJYewThB9cHaaA3{T
zzaQe01|{peK+WGo-T7w4sbyegqE25wCR)*eg>H^Dnx;MsyyU_~&+kq`=Glhf6_?``
zeHSfm&f_TOS^Y>Sr!?d}IAfh9Z3t8$y5(U<*4-;D<u87Jx<Vm;+3i~4G36Qw<%@Pz
zmTToBNQBv7pz{Euh6q|WJ9n@|vh{9Z=3vG2Gx0_}2Z7C0i5-CgnQ%wJmogb?6xXEL
zbeca0#Engz+hK}UDzZ0XHxIhJvqPA&G9oiyW!!NVa%yudZiZd?Bj*r-{+Yd#BQ2IM
z)63T=7P)3s=4Jd-r+_zms61AE)Akis`8Z?I-@y=L@0GNH?HQwgopZxNk4pB%<J;*T
zm@=<68mS)e155*Qaa!xXqIvz9`;<!<y*3}`@2fV%<lo(GR+(2yF@JS<zCm7V_K)JY
zgqW?!<;WH-(H#C5d*>we-DjTuv&qA}8Q_IT--w~SP7p!E5>U$kJ&VJ-bv_X#N>)A7
z^h?{XjOmG|U_(id=UC~9eHe6fwNoGdxaEl)e=Y$FLYPn<L^aFh*MndiLSL-B?ng#0
zO7=-+iQFCZLc`Mdks#P%nYt!JIMLcK?A%af7!3{4;oSmVZG;AcXW4Vro39?QAF}tG
z=C&^uL4O3xye0D}dfBT<zBo+yV$oxr9M?9ZHS>E{g3@ReCt|(sM>TWi_KB0p55u;#
zzxj0|T#ndM1?SY5SAQPnpP%XWAz3HFtKvGkfb{YQJ`!FTE`7Qu!>oT_2s#owCB;(^
z*8|J2KZkPpjeqA*Lc2HWHQiBG1Hdb>E|+_on={{6CqDV-YK{}ff7Db-B+LC?B|~6^
zVr+e(z^q~V^LC(voobP5pw7kZfe-6Z{-NOkv10*~8~ia`ure8)n}4Xc>R(McRcd;>
zmHkc)3F~3&BPBuGa<aP<JO^av&DlPOS%M%p1+-aGi4yDfMt^ccaMTIO>Zg?;_9I4%
z2*1;rW|IP@htayqm<|4VMzgJtkw21^U}5f{30|UM{ny{gbTxmxyR9S<0k|_V`a*td
zhf27v4>(MGRdbb{m8+xoZ_(a0VsywCNK(mq*JOYmF_=HF{br1VJ{w^_C_F6a3c~}d
znJ(hGsLGn5)qN+&l?udJ0^PRHDNGMzl$h1K*W-HDa)v>JH=MGv?7)%(X)Iqgx>U|$
zRIu~T$MD*bR#w=VZn=DI4pr-;GbszzlfbB>wNVJMxJ;DI0!#8w$HR8hrP{MT5qNpr
zx&<2!Hor@~<?ARX$b$#cu!wq}QLlED`C&}yxm-kvfSOwY0<u2CIw~HG+Zz%R;v@|E
z(zI`M&PE|?=!yp(^a)+onk!j888FjBcWq^?+wHZImjpm<`x^JM{S5JdeAO%tgjC+0
zhes4%UPg-{j(U|6@W3OV)5j5U(RqI+%!Gr_?jyKoji=U~%lBs-q#&!QExz{Br-M7A
z0_|XyZ!rsylT|L?n4dy)=S&00u<5ObYgqVU-%98uN!*w=I4d(Qn&C#XxLppvNX<N>
zujbxmL7_@R^V6ET=u00JVi9Pjm&{xxW|O`#OqZ*&3J(~vx;bei9Zqh;pY|V{YVxa;
z1*mdH?{FKMS*NDwrBR038VP!ZcKY??*+C~{lZCd5-z?#QoUn2GBLAnc>uJ1Y@oZBY
zOwri680kGoxICFQsRPBa<Gx*jOxo;4r2kPtdc<*byn6R?ce&d0jBPtq%kt~oyrU_<
z(ha^!9eLfqlA@TKJ)l5CkRCuf!Vv`Y9P0DtGG$-~8WNR=axV^@vvnVF4y?^S{Sk;{
zYlu4R<Ry9)(~w^o+qGAyZF|ndkAcsY#55R`z;H5)?c&t@vybW$x*Dra?&E>=O2d^!
z_NA{VwinIclHNL~GuT;LU6tEc!vk_$K8FYjFE?`<vNYR^^VtB}IrVC*dDGhvLtmUe
zHX6%$NrDGFkegivMw@YL*}7S_-5|r<x0|SzS;n~T@C)3cO)gKMuatx)!(;~@(Bzyn
z^Bcf9d3Js{@vbrMBxJ@P{IeKS@L(P5>AD*+x<YU<2qIl!(5V}(ud0`F2^u%4TWyoS
ziO^0nJ@owfe$uz&+^)9%t`|>5?5hE}I>h0i91;{3!<mtj$Z~<(SRbxfQ8s+t;ahGb
z+tuWJFMzXp{M`2o9+;lg#vLuge+%c}0r)n8=i-3d!v`9A&ku6^@hcu^j8VhV*FhF?
zqBt-iKf`VC0OnrB)EBi2taHQ2+Q7xK5^oXhm)?TkAv6Y=7pvux^?$i;F@B=(PxhNc
z&nll<gRcJFl;i_nJss8m@SISG2z>nSGQhve0hNAISsDw}aP6TNo}V-l4Q2awcxF5b
zHxB#W)j}s_wS5V>RJY!-m+-oyDBCWk^JtZOKQ<TUX+@_wpF~MO6$IbX0$yzTn7)V{
zQ*+Lz)iFCzSA-xJ$-%|SBAdS1#Y=dT!Z~A+7wT9Z6CXRj=`FbPLPI0I>cjcLBN9v(
zJ6m8Z4%%wPUs>}K{`8fX>PT`5a#=&MRaWWD?cDPx&cPc4``t((X6pQ*YUh?rl>Pdo
z&d(qhZJDm9HbB-kEp>A<`aOh6OnX9Oo+*6MUwX2O5Hh{sCNNZVvb%7giy2EohjuOs
z;GGH>X=IQ!-4j*C-A#}f12Zc}49>7<=wZiRv%NK%?K&(O+x=rYH=4J{dF-+`8*;AD
zV1W|Q%$@z!0?+7?*%7{ErOg#zGB47uTZ&8&FkuN0+S}`Qr!T_;d0%%v{u$-=QEBBx
zA6r)<S}LfZ$z$~)2syE(0O!Ph17Sho$x>Y<aXc_Grnap3%y?+bPbvMJ182TK8y0Z)
z-b6t3tFZ=kx|%X9BYeX1cZrjd9~!dVg<1XG01P$UcOdwQVi26cX+r$k8zj?Ze+b3R
zdv5J&oGI_ID!M~O{u*ab{WxlHLuaD6#$UBonLfdnNg-XHl&eqH#nk;jwp{hKX=FK9
zJk#-m_Fqz3oRf~F$!OAQyV|<i!C&j^RjV#fAKS>u(72|!CY^Lvd|m1rF8${7mQRVh
z|DpzGg<)v61UKBWv$)^Sb)yzsLYv5R*nEdgKzXr3;0o=}V#`(wHfLIU8M^a!o0A1_
z++yRNI$_D10gM+3?6Jo0w>d_|9imLNLKOSPxr|4&7X#t^r_cre@{S)$d>gTRMGr<;
zZ8E0jdrChSgu*mtRNna+4=j(#(&l;#URqb5LeJLX4&43Ub8sOz38!qVL%KNWRJp+S
zIUd;GmTAHRen|hSt0t0&URiy`c$a*`9}xn>@+7=JB7pyk{%WeVY+VJ~ABjqUe1tU!
zIOY4QL%ccJXgjGbq&O<r*!VV&Fk_LIyFc+B2Sn&s^yTzY96BOlr!Q~5{lLlq1rE1Z
z&$P(S%ATB3!E!6Tz#UlJFn<^<`|6bTRIcshe&Wx|eQ3wab?I<*p4}695lOqBeRj9+
zM(sffxyjITZJzMACB!(-rx>ctgpsYoTuv0%k^IYSHTjz2&4|?@w6thjv2*&P%Sp#e
z_s|kQRb(KOCgcXgTN?QVe}@hOTOJ2CJN?_CSzuc(9b88Kz1WFA1+=l)o@n)bJiy@9
ztgvUDZ{`(hKI8|nCmdgYtz&_=aI7r4zy}Y6fv0Ee8V3beN<txT;N#6`_$^tu!@?|W
zk6peBb)<*oxPH%)T-9jo&Q2Co;`dx;>0r!?EU&d><b?ALXV3Iwno!KgU-G=eFG~l`
z-RJA|E^YqA$NRL_RY1;iOU&H^G}dNI(XCNh7aX-i_rxR#+H~VUH@FJ^>!pX!g?ztw
z$JX|n!rdMDaV}vM;^~VqPs7QYd@IDf)W}0_&veN&mKObwc}fo*pB=)3kc`8Jl(u*v
zJ_5xy9{kcPW3KO=pJS0?AuhBD%sS?7tUzaJZ(_zUB`61e!WH1&@>-swW^a3Rt<ftQ
z`~C95M=m=0@Z--*-}i6uz*KUOIpb?J`PUnXYtKb*8S>>Cc*G2(N)nMVw)p8Z7$3G1
zjL|1MuXCv)Y8CXUW~S|{g%#}`WjBZJqo|jT&bq!`2pkD~%4CT8v6j7_k!rITdNAsS
zR&rgUa)TqT+U^(<=7T<SWW@v6!7TqfmU4bDZ6P#bcN}f`EGVI&uSGIV_K%Wa_dG8_
zZx5WPJoty;{U@?WklFTkKO%U6|D8(G<w+aQbto=dmqrezeP@3$pZAfO=U|1B2{k2y
zVp)Sm4}VW;jSHlATCx%d8W~Uv(p6$dJvdj%(eN&R&CorLT`VkuG}mSqPdbWCCQi8v
z=csQvST@hFCpV92-&0#r-b7|#OCr0y+~OrFT9h{YXY^Ytn)E(_9j48-gmiJ93->wL
zB+U8kZWQArx+*SD3RT4llEWpqwDEvB*Qa`fF)s9Ox;1xweMyY<e5MeJu^mbZ24!dG
zOUW^>FM5^bo=L086cMsQCH*hJs{3q-oo*>Lgl;~Uz-q~-T|B@z0WY(<?N4bbdG3hl
z#)Wz`P6dMS0NNAkbYnqYCOqpB-8G$ZAEay1bi(_uqVfMM9{=Na`masY`KLuxp#6tI
z1pZ+L|J^y-wydb1O|&bXgu59NM602orC<bZo5ylV@BdQvJfuSlvYl_lhzCOYvf8;u
z<$3CKl^7S;DuY3~3WUP<|4Du|n8&-@i0jC)%cV<|i#?RXhV%)UW#S5ksfd%crY;$Q
oWAvOiDnd}S>IeK5=+61;8VL+R?)}S0I{WJ}z57o(#Q5?50m^}6&;S4c

diff --git a/gee-rpc/doc/geerpc-day5/geerpc_debug.png b/gee-rpc/doc/geerpc-day5/geerpc_debug.png
index b60e390d981df024ca3ae4a69d67cf7e891a4cc0..55a396d27e073cbc9f66a64ea41f49c4a3547f37 100644
GIT binary patch
literal 3955
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
IGcVk~0EfL{2><{9

literal 5823
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
Z?EbrkF_8`@sC?Uig~|CdRY*77zX6|I*hByT


From 3024e8b3af5959b6aa720e94b0d59566e049f62e Mon Sep 17 00:00:00 2001
From: Dai Jie <gzdaijie@163.com>
Date: Mon, 19 Oct 2020 00:36:21 +0800
Subject: [PATCH 099/122] README.md: change the title apps to programs

---
 README.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/README.md b/README.md
index ff6b021..48e5228 100644
--- a/README.md
+++ b/README.md
@@ -1,4 +1,4 @@
-# 7 days golang apps from scratch
+# 7 days golang programs from scratch
 
 <details>
 <summary><strong>README 中文版本</strong></summary>
@@ -78,7 +78,7 @@ GeeRPC 是基于 Go 语言标准库 `net/rpc` 实现的，添加了协议交换
 </div>
 </details>
 
-What can I write in 7 days? A gin-like web framework? A distributed cache like groupcache? Or a simple Python interpreter? Hope this repo can give you the answer.
+What can be accomplished in 7 days? A gin-like web framework? A distributed cache like groupcache? Or a simple Python interpreter? Hope this repo can give you the answer.
 
 ## Web Framework - Gee
 
@@ -137,4 +137,4 @@ Based on golang standard library `net/rpc`, GeeRPC implements more features. eg,
 - Demo 1 - Hello World [Code](demo-wasm/hello-world)
 - Demo 2 - Register Functions [Code](demo-wasm/register-functions)
 - Demo 3 - Manipulate DOM [Code](demo-wasm/manipulate-dom)
-- Demo 4 - Callback [Code](demo-wasm/callback)
\ No newline at end of file
+- Demo 4 - Callback [Code](demo-wasm/callback)

From 9ddb657d0b944f7ffe00b81cc68f8b0f9c0b82bf Mon Sep 17 00:00:00 2001
From: gzdaijie <gzdaijie@gmail.com>
Date: Mon, 19 Oct 2020 01:26:01 +0800
Subject: [PATCH 100/122] README.md: add badges

---
 README.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/README.md b/README.md
index 48e5228..aa0c66a 100644
--- a/README.md
+++ b/README.md
@@ -1,5 +1,9 @@
 # 7 days golang programs from scratch
 
+[![CodeSize](https://img.shields.io/github/languages/code-size/geektutu/7days-golang)](https://github.com/geektutu/7days-golang)
+[![LICENSE](https://img.shields.io/badge/license-MIT-green)](https://mit-license.org/)
+[![HitCount](https://hits.dwyl.com/geektutu/7days-golang.svg)](http://github.com/geektutu/7days-golang)
+
 <details>
 <summary><strong>README 中文版本</strong></summary>
 <div>

From c0e1f0915e8a0feadd7dc1bc3034fd376841695d Mon Sep 17 00:00:00 2001
From: gzdaijie <gzdaijie@gmail.com>
Date: Sun, 25 Oct 2020 18:41:12 +0800
Subject: [PATCH 101/122] add 7days-golang questions

---
 questions/7days-golang-q1.md                  | 201 ++++++++++++++++++
 questions/7days-golang-q1/7days-golang-qa.jpg | Bin 0 -> 72108 bytes
 2 files changed, 201 insertions(+)
 create mode 100644 questions/7days-golang-q1.md
 create mode 100644 questions/7days-golang-q1/7days-golang-qa.jpg

diff --git a/questions/7days-golang-q1.md b/questions/7days-golang-q1.md
new file mode 100644
index 0000000..f1e241b
--- /dev/null
+++ b/questions/7days-golang-q1.md
@@ -0,0 +1,201 @@
+---
+title: Go 接口型函数的使用场景
+date: 2099-10-25 12:30:00
+description: Go 语言/golang 中函数式接口或接口型函数的实现与价值，什么是接口型函数，为什么不直接将函数作为参数，而是封装为一个接口。Go 语言标准库 net/http 中是如何使用接口型函数的。
+tags:
+- Go
+nav: 从零实现
+categories:
+- 7days-golang Q & A
+keywords:
+- 函数式接口
+- 接口型函数
+- net/http
+image: post/7days-golang-q1/7days-golang-qa.jpg
+github: https://github.com/geektutu/7days-golang
+---
+
+![7days-golang 有价值的问题](7days-golang-q1/7days-golang-qa.jpg)
+
+## 问题
+
+在 [动手写分布式缓存 - GeeCache第二天 单机并发缓存](https://geektutu.com/post/geecache-day2.html) 这篇文章中，有一个接口型函数的实现：
+
+```go
+// A Getter loads data for a key.
+type Getter interface {
+	Get(key string) ([]byte, error)
+}
+
+// A GetterFunc implements Getter with a function.
+type GetterFunc func(key string) ([]byte, error)
+
+// Get implements Getter interface function
+func (f GetterFunc) Get(key string) ([]byte, error) {
+	return f(key)
+}
+```
+
+这里呢，定义了一个接口 `Getter`，只包含一个方法 `Get(key string) ([]byte, error)`，紧接着定义了一个函数类型 `GetterFunc`，GetterFunc 参数和返回值与 Getter 中 Get 方法是一致的。而且 GetterFunc 还定义了 Get 方式，并在 Get 方法中调用自己，这样就实现了接口 Getter。所以 GetterFunc 是一个实现了接口的函数类型，简称为接口型函数。
+
+这个接口型函数的实现就引起了好几个童鞋的关注。接口型函数只能应用于接口内部只定义了一个方法的情况，例如接口 Getter 内部有且只有一个方法 Get。既然只有一个方法，为什么还要多此一举，封装为一个接口呢？定义参数的时候，直接用 GetterFunc 这个函数类型不就好了，让用户直接传入一个函数作为参数，不更简单吗？
+
+所以呢，接口型函数的价值什么？
+
+
+## 价值
+
+我们想象这么一个使用场景，`GetFromSource` 的作用是从某数据源获取结果，接口类型 Getter 是其中一个参数，代表某数据源：
+
+```go
+func GetFromSource(getter Getter, key string) []byte {
+	buf, err := getter.Get(key)
+	if err == nil {
+		return buf
+	}
+	return nil
+}
+```
+
+我们可以有多种方式调用该函数：
+
+- 方式一：GetterFunc 类型的函数作为参数
+
+```go
+GetFromSource(GetterFunc(func(key string) ([]byte, error) {
+	return []byte(key), nil
+}), "hello")
+```
+
+支持匿名函数，也支持普通的函数：
+
+```go
+func test(key string) ([]byte, error) {
+	return []byte(key), nil
+}
+
+func main() {
+    GetFromSource(GetterFunc(test), "hello")
+}
+```
+
+将 test 强制类型转换为 GetterFunc，GetterFunc 实现了接口 Getter，是一个合法参数。这种方式适用于逻辑较为简单的场景。
+
+
+- 方式二：实现了 Getter 接口的结构体作为参数
+
+```go
+type DB struct{ url string}
+
+func (db *DB) Query(sql string, args ...string) string {
+	// ...
+	return "hello"
+}
+
+func (db *DB) Get(key string) ([]byte, error) {
+	// ...
+	v := db.Query("SELECT NAME FROM TABLE WHEN NAME= ?", key)
+	return []byte(v), nil
+}
+
+func main() {
+	GetFromSource(new(DB), "hello")
+}
+```
+
+DB 实现了接口 Getter，也是一个合法参数。这种方式适用于逻辑较为复杂的场景，如果对数据库的操作需要很多信息，地址、用户名、密码，还有很多中间状态需要保持，比如超时、重连、加锁等等。这种情况下，更适合封装为一个结构体作为参数。
+
+这样，既能够将普通的函数类型（需类型转换）作为参数，也可以将结构体作为参数，使用更为灵活，可读性也更好，这就是接口型函数的价值。
+
+## 使用场景
+
+这个特性在 groupcache 等大量的 Go 语言开源项目中被广泛使用，标准库中用得也不少，`net/http` 的 Handler 和 HandlerFunc 就是一个典型。
+
+我们先看一下 Handler 的定义：
+
+```go
+type Handler interface {
+	ServeHTTP(ResponseWriter, *Request)
+}
+type HandlerFunc func(ResponseWriter, *Request)
+
+func (f HandlerFunc) ServeHTTP(w ResponseWriter, r *Request) {
+	f(w, r)
+}
+```
+
+> 摘自 Go 语言源代码 [net/http/server.go](https://github.com/golang/go/blob/master/src/net/http/server.go)
+
+我们可以 `http.Handle` 来映射请求路径和处理函数，Handle 的定义如下：
+
+```go
+func Handle(pattern string, handler Handler)
+```
+
+第二个参数是即接口类型 Handler，我们可以这么用。
+
+```go
+func home(w http.ResponseWriter, r *http.Request) {
+	w.WriteHeader(http.StatusOK)
+	_, _ = w.Write([]byte("hello, index page"))
+}
+
+func main() {
+	http.Handle("/home", http.HandlerFunc(home))
+	_ = http.ListenAndServe("localhost:8000", nil)
+}
+```
+
+通常，我们还会使用另外一个函数 `http.HandleFunc`，HandleFunc 的定义如下：
+
+```go
+func HandleFunc(pattern string, handler func(ResponseWriter, *Request))
+```
+
+第二个参数是一个普通的函数类型，那可以直接将 home 传递给 HandleFunc：
+
+```go
+func main() {
+	http.HandleFunc("/home", home)
+	_ = http.ListenAndServe("localhost:8000", nil)
+}
+```
+
+那如果我们看过 HandleFunc 的内部实现的话，就会知道两种写法是完全等价的，内部将第二种写法转换为了第一种写法。
+
+```go
+func (mux *ServeMux) HandleFunc(pattern string, handler func(ResponseWriter, *Request)) {
+	if handler == nil {
+		panic("http: nil handler")
+	}
+	mux.Handle(pattern, HandlerFunc(handler))
+}
+```
+
+如果你仔细观察，会发现 `http.ListenAndServe` 的第二个参数也是接口类型 `Handler`，我们使用了标准库 `net/http` 内置的路由，因此呢，传入的值是 nil。那如果这个地方我们传入的是一个实现了 `Handler` 接口的结构体呢？就可以完全托管所有的 HTTP 请求，后续怎么路由，怎么处理，请求前后增加什么功能，都可以自定义了。慢慢地，就变成了一个功能丰富的 Web 框架了。如果你感兴趣呢，可以阅读 [7天用Go从零实现Web框架Gee教程](https://geektutu.com/post/gee.html)。
+
+## 其他语言类似特性
+
+如果有 Java 编程经验的同学可能比较有感触。Java 1.5 中是不支持直接传入函数的，参数要么是接口，要么是对象。举一个最简单的例子，列表自定义排序时，需要实现一个匿名的 Comparator 类，重写 compare 方法。
+
+```java
+Collections.sort(list, new Comparator<Integer>(){
+    @Override
+    public int compare(Integer o1, Integer o2) {
+        return o2 - o1;
+    }
+});
+```
+
+Java 1.8 中引入了大量的函数式编程的特性，其中 lambda 表达式和函数式接口就是一个很好的简化 Java 写法的特性。Java 1.8 中，上述的例子可以简化为：
+
+```java
+Collections.sort(list, (Integer o1, Integer o2) -> o2 - o1 );
+```
+
+即从需要构造一个匿名对象简化为只需要一个 lambda 函数表达式，可以认为是面向对象与函数式编程的一种结合。同样地，这种写法只支持只定义了一个方法的接口类型。正是这种结合，可以达到实现相同代码，代码量更少的目的。
+
+## 附 参考
+
+- [7days-golang 有价值的问题讨论汇总贴](https://github.com/geektutu/7days-golang/issues/24)
+- [GeeCache第二天 单机并发缓存 - Github 评论区](https://github.com/geektutu/geektutu-blog/issues/64)
\ No newline at end of file
diff --git a/questions/7days-golang-q1/7days-golang-qa.jpg b/questions/7days-golang-q1/7days-golang-qa.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..c783be82584089b064c09395727426aa1e7aa9fb
GIT binary patch
literal 72108
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

literal 0
HcmV?d00001


From c79596f9acf25e3eae1090a03b19c6fdff2abff7 Mon Sep 17 00:00:00 2001
From: gzdaijie <gzdaijie@gmail.com>
Date: Sun, 25 Oct 2020 18:53:35 +0800
Subject: [PATCH 102/122] modified geecache-day2 & add refer to 7days-golang Q
 & A

---
 gee-cache/doc/geecache-day2.md | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/gee-cache/doc/geecache-day2.md b/gee-cache/doc/geecache-day2.md
index 7f75af8..ead3b38 100644
--- a/gee-cache/doc/geecache-day2.md
+++ b/gee-cache/doc/geecache-day2.md
@@ -238,6 +238,9 @@ func (f GetterFunc) Get(key string) ([]byte, error) {
 
 - 定义接口 Getter 和 回调函数 `Get(key string)([]byte, error)`，参数是 key，返回值是 []byte。
 - 定义函数类型 GetterFunc，并实现 Getter 接口的 `Get` 方法。
+- 函数类型实现某一个接口，称之为接口型函数，方便使用者在调用时既能够传入函数作为参数，也能够传入实现了该接口的结构体作为参数。
+
+> 了解接口型函数的使用场景，可以参考 [Go 接口型函数的使用场景 - 7days-golang Q & A](https://geektutu.com/post/7days-golang-q1.html)
 
 我们可以写一个测试用例来保证回调函数能够正常工作。
 

From 2f2be0cec01a082e41444cf231f49309d07ff37c Mon Sep 17 00:00:00 2001
From: gzdaijie <gzdaijie@gmail.com>
Date: Tue, 3 Nov 2020 23:53:26 +0800
Subject: [PATCH 103/122] support book for blog

---
 gee-cache/doc/geecache-day1.md | 2 ++
 gee-cache/doc/geecache-day2.md | 2 ++
 gee-cache/doc/geecache-day3.md | 2 ++
 gee-cache/doc/geecache-day4.md | 2 ++
 gee-cache/doc/geecache-day5.md | 2 ++
 gee-cache/doc/geecache-day6.md | 2 ++
 gee-cache/doc/geecache-day7.md | 2 ++
 gee-cache/doc/geecache.md      | 2 ++
 gee-orm/doc/geeorm-day1.md     | 2 ++
 gee-orm/doc/geeorm-day2.md     | 2 ++
 gee-orm/doc/geeorm-day3.md     | 2 ++
 gee-orm/doc/geeorm-day4.md     | 2 ++
 gee-orm/doc/geeorm-day5.md     | 2 ++
 gee-orm/doc/geeorm-day6.md     | 2 ++
 gee-orm/doc/geeorm-day7.md     | 2 ++
 gee-orm/doc/geeorm.md          | 2 ++
 gee-rpc/doc/geerpc-day1.md     | 2 ++
 gee-rpc/doc/geerpc-day2.md     | 2 ++
 gee-rpc/doc/geerpc-day3.md     | 2 ++
 gee-rpc/doc/geerpc-day4.md     | 2 ++
 gee-rpc/doc/geerpc-day5.md     | 2 ++
 gee-rpc/doc/geerpc-day6.md     | 2 ++
 gee-rpc/doc/geerpc-day7.md     | 2 ++
 gee-rpc/doc/geerpc.md          | 2 ++
 gee-web/doc/gee-day1.md        | 2 ++
 gee-web/doc/gee-day2.md        | 2 ++
 gee-web/doc/gee-day3.md        | 2 ++
 gee-web/doc/gee-day4.md        | 2 ++
 gee-web/doc/gee-day5.md        | 2 ++
 gee-web/doc/gee-day6.md        | 2 ++
 gee-web/doc/gee-day7.md        | 2 ++
 gee-web/doc/gee.md             | 2 ++
 questions/7days-golang-q1.md   | 4 +++-
 33 files changed, 67 insertions(+), 1 deletion(-)

diff --git a/gee-cache/doc/geecache-day1.md b/gee-cache/doc/geecache-day1.md
index 2f096d9..0bdcf75 100644
--- a/gee-cache/doc/geecache-day1.md
+++ b/gee-cache/doc/geecache-day1.md
@@ -15,6 +15,8 @@ keywords:
 - 缓存失效
 image: post/geecache-day1/lru_logo.jpg
 github: https://github.com/geektutu/7days-golang
+book: 七天用Go从零实现系列
+book_title: Day1 LRU 缓存淘汰策略
 ---
 
 
diff --git a/gee-cache/doc/geecache-day2.md b/gee-cache/doc/geecache-day2.md
index ead3b38..0aa3dde 100644
--- a/gee-cache/doc/geecache-day2.md
+++ b/gee-cache/doc/geecache-day2.md
@@ -15,6 +15,8 @@ keywords:
 - sync.Mutex
 image: post/geecache-day2/concurrent_cache_logo.jpg
 github: https://github.com/geektutu/7days-golang
+book: 七天用Go从零实现系列
+book_title: Day2 单机并发缓存
 ---
 
 ![geecache concurrent cache](geecache-day2/concurrent_cache.jpg)
diff --git a/gee-cache/doc/geecache-day3.md b/gee-cache/doc/geecache-day3.md
index a129432..a251dcc 100644
--- a/gee-cache/doc/geecache-day3.md
+++ b/gee-cache/doc/geecache-day3.md
@@ -14,6 +14,8 @@ keywords:
 - HTTP Server
 image: post/geecache-day3/http_logo.jpg
 github: https://github.com/geektutu/7days-golang
+book: 七天用Go从零实现系列
+book_title: Day3 HTTP 服务端
 ---
 
 ![geecache http server](geecache-day3/http.jpg)
diff --git a/gee-cache/doc/geecache-day4.md b/gee-cache/doc/geecache-day4.md
index 30ca624..02db009 100644
--- a/gee-cache/doc/geecache-day4.md
+++ b/gee-cache/doc/geecache-day4.md
@@ -14,6 +14,8 @@ keywords:
 - consistent hash
 image: post/geecache-day4/hash_logo.jpg
 github: https://github.com/geektutu/7days-golang
+book: 七天用Go从零实现系列
+book_title: Day4 一致性哈希
 ---
 
 ![一致性哈希 consistent hashing](geecache-day4/hash.jpg)
diff --git a/gee-cache/doc/geecache-day5.md b/gee-cache/doc/geecache-day5.md
index 4e28083..9f995ba 100644
--- a/gee-cache/doc/geecache-day5.md
+++ b/gee-cache/doc/geecache-day5.md
@@ -14,6 +14,8 @@ keywords:
 - 分布式节点
 image: post/geecache-day5/dist_nodes_logo.jpg
 github: https://github.com/geektutu/7days-golang
+book: 七天用Go从零实现系列
+book_title: Day5 分布式节点
 ---
 
 ![分布式缓存节点](geecache-day5/dist_nodes.jpg)
diff --git a/gee-cache/doc/geecache-day6.md b/gee-cache/doc/geecache-day6.md
index a2236f6..73ad7dd 100644
--- a/gee-cache/doc/geecache-day6.md
+++ b/gee-cache/doc/geecache-day6.md
@@ -14,6 +14,8 @@ keywords:
 - 分布式节点
 image: post/geecache-day6/singleflight_logo.jpg
 github: https://github.com/geektutu/7days-golang
+book: 七天用Go从零实现系列
+book_title: Day6 防止缓存击穿
 ---
 
 ![geecache single flight](geecache-day6/singleflight.jpg)
diff --git a/gee-cache/doc/geecache-day7.md b/gee-cache/doc/geecache-day7.md
index c1bb34c..2f26210 100644
--- a/gee-cache/doc/geecache-day7.md
+++ b/gee-cache/doc/geecache-day7.md
@@ -14,6 +14,8 @@ keywords:
 - 分布式节点
 image: post/geecache-day7/protobuf_logo.jpg
 github: https://github.com/geektutu/7days-golang
+book: 七天用Go从零实现系列
+book_title: Day7 使用 Protobuf 通信
 ---
 
 ![geecache protobuf](geecache-day7/protobuf.jpg)
diff --git a/gee-cache/doc/geecache.md b/gee-cache/doc/geecache.md
index 3eb89ad..dccc53d 100644
--- a/gee-cache/doc/geecache.md
+++ b/gee-cache/doc/geecache.md
@@ -13,6 +13,8 @@ keywords:
 - 动手写分布式缓存
 image: post/geecache/geecache_sm.jpg
 github: https://github.com/geektutu/7days-golang
+book: 七天用Go从零实现系列
+book_title: Day0 序言
 ---
 
 ![分布式缓存geecache](geecache/geecache.jpg)
diff --git a/gee-orm/doc/geeorm-day1.md b/gee-orm/doc/geeorm-day1.md
index 3ecb72c..9fe3adf 100644
--- a/gee-orm/doc/geeorm-day1.md
+++ b/gee-orm/doc/geeorm-day1.md
@@ -14,6 +14,8 @@ keywords:
 - sqlite
 image: post/geeorm/geeorm_sm.jpg
 github: https://github.com/geektutu/7days-golang
+book: 七天用Go从零实现系列
+book_title: Day1 database/sql 基础
 ---
 
 本文是[7天用Go从零实现ORM框架GeeORM](https://geektutu.com/post/geeorm.html)的第一篇。介绍了
diff --git a/gee-orm/doc/geeorm-day2.md b/gee-orm/doc/geeorm-day2.md
index 9287a51..0f6c9d4 100644
--- a/gee-orm/doc/geeorm-day2.md
+++ b/gee-orm/doc/geeorm-day2.md
@@ -16,6 +16,8 @@ keywords:
 - table mapping
 image: post/geeorm/geeorm_sm.jpg
 github: https://github.com/geektutu/7days-golang
+book: 七天用Go从零实现系列
+book_title: Day2 对象表结构映射
 ---
 
 本文是[7天用Go从零实现ORM框架GeeORM](https://geektutu.com/post/geeorm.html)的第二篇。
diff --git a/gee-orm/doc/geeorm-day3.md b/gee-orm/doc/geeorm-day3.md
index 85f5f6f..d541ec3 100644
--- a/gee-orm/doc/geeorm-day3.md
+++ b/gee-orm/doc/geeorm-day3.md
@@ -16,6 +16,8 @@ keywords:
 - select from
 image: post/geeorm/geeorm_sm.jpg
 github: https://github.com/geektutu/7days-golang
+book: 七天用Go从零实现系列
+book_title: Day3 记录新增和查询
 ---
 
 本文是[7天用Go从零实现ORM框架GeeORM](https://geektutu.com/post/geeorm.html)的第三篇。
diff --git a/gee-orm/doc/geeorm-day4.md b/gee-orm/doc/geeorm-day4.md
index 6e0d307..8cfcc75 100644
--- a/gee-orm/doc/geeorm-day4.md
+++ b/gee-orm/doc/geeorm-day4.md
@@ -16,6 +16,8 @@ keywords:
 - delete from
 image: post/geeorm/geeorm_sm.jpg
 github: https://github.com/geektutu/7days-golang
+book: 七天用Go从零实现系列
+book_title: Day4 链式操作与更新删除
 ---
 
 本文是[7天用Go从零实现ORM框架GeeORM](https://geektutu.com/post/geeorm.html)的第四篇。
diff --git a/gee-orm/doc/geeorm-day5.md b/gee-orm/doc/geeorm-day5.md
index e0bf9e2..3d6ffda 100644
--- a/gee-orm/doc/geeorm-day5.md
+++ b/gee-orm/doc/geeorm-day5.md
@@ -16,6 +16,8 @@ keywords:
 - BeforeUpdate
 image: post/geeorm/geeorm_sm.jpg
 github: https://github.com/geektutu/7days-golang
+book: 七天用Go从零实现系列
+book_title: Day5 实现钩子
 ---
 
 本文是[7天用Go从零实现ORM框架GeeORM](https://geektutu.com/post/geeorm.html)的第五篇。
diff --git a/gee-orm/doc/geeorm-day6.md b/gee-orm/doc/geeorm-day6.md
index 37955d3..abe43a9 100644
--- a/gee-orm/doc/geeorm-day6.md
+++ b/gee-orm/doc/geeorm-day6.md
@@ -15,6 +15,8 @@ keywords:
 - transaction
 image: post/geeorm/geeorm_sm.jpg
 github: https://github.com/geektutu/7days-golang
+book: 七天用Go从零实现系列
+book_title: Day6 支持事务
 ---
 
 本文是[7天用Go从零实现ORM框架GeeORM](https://geektutu.com/post/geeorm.html)的第六篇。
diff --git a/gee-orm/doc/geeorm-day7.md b/gee-orm/doc/geeorm-day7.md
index 7e6dc1c..efd96db 100644
--- a/gee-orm/doc/geeorm-day7.md
+++ b/gee-orm/doc/geeorm-day7.md
@@ -15,6 +15,8 @@ keywords:
 - migrate
 image: post/geeorm/geeorm_sm.jpg
 github: https://github.com/geektutu/7days-golang
+book: 七天用Go从零实现系列
+book_title: Day7 数据库迁移
 ---
 
 本文是[7天用Go从零实现ORM框架GeeORM](https://geektutu.com/post/geeorm.html)的第七篇。
diff --git a/gee-orm/doc/geeorm.md b/gee-orm/doc/geeorm.md
index f9c14da..c188002 100644
--- a/gee-orm/doc/geeorm.md
+++ b/gee-orm/doc/geeorm.md
@@ -15,6 +15,8 @@ keywords:
 - sqlite3
 image: post/geeorm/geeorm_sm.jpg
 github: https://github.com/geektutu/7days-golang
+book: 七天用Go从零实现系列
+book_title: Day0 序言
 ---
 
 ![golang ORM framework](geeorm/geeorm.jpg)
diff --git a/gee-rpc/doc/geerpc-day1.md b/gee-rpc/doc/geerpc-day1.md
index 51db1fb..dea8b43 100644
--- a/gee-rpc/doc/geerpc-day1.md
+++ b/gee-rpc/doc/geerpc-day1.md
@@ -15,6 +15,8 @@ keywords:
 - 反序列化
 image: post/geerpc/geerpc.jpg
 github: https://github.com/geektutu/7days-golang
+book: 七天用Go从零实现系列
+book_title: Day1 服务端与消息编码
 ---
 
 ![golang RPC framework](geerpc/geerpc.jpg)
diff --git a/gee-rpc/doc/geerpc-day2.md b/gee-rpc/doc/geerpc-day2.md
index ff2ce20..da70f3a 100644
--- a/gee-rpc/doc/geerpc-day2.md
+++ b/gee-rpc/doc/geerpc-day2.md
@@ -15,6 +15,8 @@ keywords:
 - 并发
 image: post/geerpc/geerpc.jpg
 github: https://github.com/geektutu/7days-golang
+book: 七天用Go从零实现系列
+book_title: Day2 高性能客户端
 ---
 
 ![golang RPC framework](geerpc/geerpc.jpg)
diff --git a/gee-rpc/doc/geerpc-day3.md b/gee-rpc/doc/geerpc-day3.md
index d1a6982..912ea14 100644
--- a/gee-rpc/doc/geerpc-day3.md
+++ b/gee-rpc/doc/geerpc-day3.md
@@ -14,6 +14,8 @@ keywords:
 - 服务
 image: post/geerpc/geerpc.jpg
 github: https://github.com/geektutu/7days-golang
+book: 七天用Go从零实现系列
+book_title: Day3 服务注册
 ---
 
 ![golang RPC framework](geerpc/geerpc.jpg)
diff --git a/gee-rpc/doc/geerpc-day4.md b/gee-rpc/doc/geerpc-day4.md
index b249d2e..4d89c05 100644
--- a/gee-rpc/doc/geerpc-day4.md
+++ b/gee-rpc/doc/geerpc-day4.md
@@ -13,6 +13,8 @@ keywords:
 - 连接超时
 image: post/geerpc/geerpc.jpg
 github: https://github.com/geektutu/7days-golang
+book: 七天用Go从零实现系列
+book_title: Day4 超时处理
 ---
 
 ![golang RPC framework](geerpc/geerpc.jpg)
diff --git a/gee-rpc/doc/geerpc-day5.md b/gee-rpc/doc/geerpc-day5.md
index 5b1797d..c6813da 100644
--- a/gee-rpc/doc/geerpc-day5.md
+++ b/gee-rpc/doc/geerpc-day5.md
@@ -14,6 +14,8 @@ keywords:
 - debug
 image: post/geerpc/geerpc.jpg
 github: https://github.com/geektutu/7days-golang
+book: 七天用Go从零实现系列
+book_title: Day5 支持HTTP协议
 ---
 
 ![golang RPC framework](geerpc/geerpc.jpg)
diff --git a/gee-rpc/doc/geerpc-day6.md b/gee-rpc/doc/geerpc-day6.md
index 87f5877..a0b54cc 100644
--- a/gee-rpc/doc/geerpc-day6.md
+++ b/gee-rpc/doc/geerpc-day6.md
@@ -14,6 +14,8 @@ keywords:
 - 轮询调度
 image: post/geerpc/geerpc.jpg
 github: https://github.com/geektutu/7days-golang
+book: 七天用Go从零实现系列
+book_title: Day6 负载均衡
 ---
 
 ![golang RPC framework](geerpc/geerpc.jpg)
diff --git a/gee-rpc/doc/geerpc-day7.md b/gee-rpc/doc/geerpc-day7.md
index ad4f502..c7bb6c2 100644
--- a/gee-rpc/doc/geerpc-day7.md
+++ b/gee-rpc/doc/geerpc-day7.md
@@ -14,6 +14,8 @@ keywords:
 - 服务发现
 image: post/geerpc/geerpc.jpg
 github: https://github.com/geektutu/7days-golang
+book: 七天用Go从零实现系列
+book_title: Day7 服务发现与注册中心
 ---
 
 ![golang RPC framework](geerpc/geerpc.jpg)
diff --git a/gee-rpc/doc/geerpc.md b/gee-rpc/doc/geerpc.md
index 7a6a324..5f5f1d8 100644
--- a/gee-rpc/doc/geerpc.md
+++ b/gee-rpc/doc/geerpc.md
@@ -15,6 +15,8 @@ keywords:
 - 负载均衡
 image: post/geerpc/geerpc.jpg
 github: https://github.com/geektutu/7days-golang
+book: 七天用Go从零实现系列
+book_title: Day0 序言
 ---
 
 ![golang RPC framework](geerpc/geerpc.jpg)
diff --git a/gee-web/doc/gee-day1.md b/gee-web/doc/gee-day1.md
index de30bc9..9a09b37 100644
--- a/gee-web/doc/gee-day1.md
+++ b/gee-web/doc/gee-day1.md
@@ -14,6 +14,8 @@ keywords:
 - net/http
 image: post/gee/gee.jpg
 github: https://github.com/geektutu/7days-golang
+book: 七天用Go从零实现系列
+book_title: Day1 HTTP 基础
 ---
 
 本文是 [7天用Go从零实现Web框架Gee教程系列](https://geektutu.com/post/gee.html)的第一篇。
diff --git a/gee-web/doc/gee-day2.md b/gee-web/doc/gee-day2.md
index f63fde1..9bd011f 100644
--- a/gee-web/doc/gee-day2.md
+++ b/gee-web/doc/gee-day2.md
@@ -14,6 +14,8 @@ keywords:
 - Context
 image: post/gee/gee.jpg
 github: https://github.com/geektutu/7days-golang
+book: 七天用Go从零实现系列
+book_title: Day2 上下文
 ---
 
 本文是 [7天用Go从零实现Web框架Gee教程系列](https://geektutu.com/post/gee.html)的第二篇。
diff --git a/gee-web/doc/gee-day3.md b/gee-web/doc/gee-day3.md
index 0d66e54..3586a2f 100644
--- a/gee-web/doc/gee-day3.md
+++ b/gee-web/doc/gee-day3.md
@@ -14,6 +14,8 @@ keywords:
 - Route
 image: post/gee-day3/trie_router.jpg
 github: https://github.com/geektutu/7days-golang
+book: 七天用Go从零实现系列
+book_title: Day3 前缀树路由
 ---
 
 本文是 [7天用Go从零实现Web框架Gee教程系列](https://geektutu.com/post/gee.html)的第三篇。
diff --git a/gee-web/doc/gee-day4.md b/gee-web/doc/gee-day4.md
index 3a5eb21..d48202f 100644
--- a/gee-web/doc/gee-day4.md
+++ b/gee-web/doc/gee-day4.md
@@ -14,6 +14,8 @@ keywords:
 - Group Control
 image: post/gee-day4/group.jpg
 github: https://github.com/geektutu/7days-golang
+book: 七天用Go从零实现系列
+book_title: Day4 分组控制
 ---
 
 本文是 [7天用Go从零实现Web框架Gee教程系列](https://geektutu.com/post/gee.html)的第四篇。
diff --git a/gee-web/doc/gee-day5.md b/gee-web/doc/gee-day5.md
index e4fb039..7a540a1 100644
--- a/gee-web/doc/gee-day5.md
+++ b/gee-web/doc/gee-day5.md
@@ -14,6 +14,8 @@ keywords:
 - Middlewares
 image: post/gee-day5/middleware.jpg
 github: https://github.com/geektutu/7days-golang
+book: 七天用Go从零实现系列
+book_title: Day5 中间件
 ---
 
 本文是 [7天用Go从零实现Web框架Gee教程系列](https://geektutu.com/post/gee.html)的第五篇。
diff --git a/gee-web/doc/gee-day6.md b/gee-web/doc/gee-day6.md
index a95d578..1a6283a 100644
--- a/gee-web/doc/gee-day6.md
+++ b/gee-web/doc/gee-day6.md
@@ -14,6 +14,8 @@ keywords:
 - Template
 image: post/gee-day6/html.png
 github: https://github.com/geektutu/7days-golang
+book: 七天用Go从零实现系列
+book_title: Day6 模板 Template
 ---
 
 本文是 [7天用Go从零实现Web框架Gee教程系列](https://geektutu.com/post/gee.html)的第六篇。
diff --git a/gee-web/doc/gee-day7.md b/gee-web/doc/gee-day7.md
index 08310ca..f64de84 100644
--- a/gee-web/doc/gee-day7.md
+++ b/gee-web/doc/gee-day7.md
@@ -15,6 +15,8 @@ keywords:
 - Recover
 image: post/gee-day7/go-panic.png
 github: https://github.com/geektutu/7days-golang
+book: 七天用Go从零实现系列
+book_title: Day7 错误恢复
 ---
 
 本文是[7天用Go从零实现Web框架Gee教程系列](https://geektutu.com/post/gee.html)的第七篇。
diff --git a/gee-web/doc/gee.md b/gee-web/doc/gee.md
index 0596aaf..9dbfc54 100644
--- a/gee-web/doc/gee.md
+++ b/gee-web/doc/gee.md
@@ -14,6 +14,8 @@ keywords:
 - from scratch
 image: post/gee/gee.jpg
 github: https://github.com/geektutu/7days-golang
+book: 七天用Go从零实现系列
+book_title: Day0 序言
 ---
 
 ![gee](gee/gee.jpg)
diff --git a/questions/7days-golang-q1.md b/questions/7days-golang-q1.md
index f1e241b..ccabb4e 100644
--- a/questions/7days-golang-q1.md
+++ b/questions/7days-golang-q1.md
@@ -1,6 +1,6 @@
 ---
 title: Go 接口型函数的使用场景
-date: 2099-10-25 12:30:00
+date: 2020-10-25 12:30:00
 description: Go 语言/golang 中函数式接口或接口型函数的实现与价值，什么是接口型函数，为什么不直接将函数作为参数，而是封装为一个接口。Go 语言标准库 net/http 中是如何使用接口型函数的。
 tags:
 - Go
@@ -13,6 +13,8 @@ keywords:
 - net/http
 image: post/7days-golang-q1/7days-golang-qa.jpg
 github: https://github.com/geektutu/7days-golang
+book: 七天用Go从零实现系列
+book_title: 接口型函数
 ---
 
 ![7days-golang 有价值的问题](7days-golang-q1/7days-golang-qa.jpg)

From d6325500c452f60fa4c4e5714085a5d70e2fcfdd Mon Sep 17 00:00:00 2001
From: gzdaijie <gzdaijie@gmail.com>
Date: Thu, 5 Nov 2020 01:01:54 +0800
Subject: [PATCH 104/122] geerpc/doc: fix github url

---
 gee-rpc/doc/geerpc.md | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/gee-rpc/doc/geerpc.md b/gee-rpc/doc/geerpc.md
index 5f5f1d8..a010128 100644
--- a/gee-rpc/doc/geerpc.md
+++ b/gee-rpc/doc/geerpc.md
@@ -54,13 +54,13 @@ Go 语言广泛地应用于云计算和微服务，成熟的 RPC 框架和微服
 
 ## 4 目录
 
-- 第一天 - [服务端与消息编码](https://geektutu.com/post/geerpc-day1.html) | [Code](gee-rpc/day1-codec)
-- 第二天 - [支持并发与异步的客户端](https://geektutu.com/post/geerpc-day2.html) | [Code](gee-rpc/day2-client)
-- 第三天 - [服务注册(service register)](https://geektutu.com/post/geerpc-day3.html) | [Code](gee-rpc/day3-service )
-- 第四天 - [超时处理(timeout)](https://geektutu.com/post/geerpc-day4.html) | [Code](gee-rpc/day4-timeout )
-- 第五天 - [支持HTTP协议](https://geektutu.com/post/geerpc-day5.html) | [Code](gee-rpc/day5-http-debug)
-- 第六天 - [负载均衡(load balance)](https://geektutu.com/post/geerpc-day6.html) | [Code](gee-rpc/day6-load-balance)
-- 第七天 - [服务发现与注册中心(registry)](https://geektutu.com/post/geerpc-day7.html) | [Code](gee-rpc/day7-registry)
+- 第一天 - [服务端与消息编码](https://geektutu.com/post/geerpc-day1.html) | [Code](ghttps://github.com/geektutu/7days-golang/tree/master/ee-rpc/day1-codec)
+- 第二天 - [支持并发与异步的客户端](https://geektutu.com/post/geerpc-day2.html) | [Code](ghttps://github.com/geektutu/7days-golang/tree/master/ee-rpc/day2-client)
+- 第三天 - [服务注册(service register)](https://geektutu.com/post/geerpc-day3.html) | [Code](https://github.com/geektutu/7days-golang/tree/master/gee-rpc/day3-service )
+- 第四天 - [超时处理(timeout)](https://geektutu.com/post/geerpc-day4.html) | [Code](ghttps://github.com/geektutu/7days-golang/tree/master/ee-rpc/day4-timeout )
+- 第五天 - [支持HTTP协议](https://geektutu.com/post/geerpc-day5.html) | [Code](ghttps://github.com/geektutu/7days-golang/tree/master/ee-rpc/day5-http-debug)
+- 第六天 - [负载均衡(load balance)](https://geektutu.com/post/geerpc-day6.html) | [Code](https://github.com/geektutu/7days-golang/tree/master/gee-rpc/day6-load-balance)
+- 第七天 - [服务发现与注册中心(registry)](https://geektutu.com/post/geerpc-day7.html) | [Code](https://github.com/geektutu/7days-golang/tree/master/gee-rpc/day7-registry)
 
 ## 附 推荐阅读
 

From 8e70671907ed9affd9bc7e93ef130fef6dd9acac Mon Sep 17 00:00:00 2001
From: Dai Jie <gzdaijie@163.com>
Date: Sun, 22 Nov 2020 22:31:44 +0800
Subject: [PATCH 105/122] method.Type.NumIn() => method.Type.NumOut()

---
 gee-rpc/doc/geerpc-day3.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/gee-rpc/doc/geerpc-day3.md b/gee-rpc/doc/geerpc-day3.md
index 912ea14..c1b720c 100644
--- a/gee-rpc/doc/geerpc-day3.md
+++ b/gee-rpc/doc/geerpc-day3.md
@@ -80,8 +80,8 @@ func main() {
 	for i := 0; i < typ.NumMethod(); i++ {
 		method := typ.Method(i)
 		argv := make([]string, 0, method.Type.NumIn())
-        returns := make([]string, 0, method.Type.NumIn())
-        // j 从 1 开始，第 0 个入参是 wg 自己。
+		returns := make([]string, 0, method.Type.NumOut())
+		// j 从 1 开始，第 0 个入参是 wg 自己。
 		for j := 1; j < method.Type.NumIn(); j++ {
 			argv = append(argv, method.Type.In(j).Name())
 		}
@@ -494,4 +494,4 @@ start rpc server on [::]:57509
 ## 附 推荐阅读
 
 - [Go 语言简明教程](https://geektutu.com/post/quick-golang.html)
-- [Go 语言笔试面试题](https://geektutu.com/post/qa-golang.html)
\ No newline at end of file
+- [Go 语言笔试面试题](https://geektutu.com/post/qa-golang.html)

From 658cc8a8943e7663f38ec828c1c4e331e223fae7 Mon Sep 17 00:00:00 2001
From: gzdaijie <gzdaijie@gmail.com>
Date: Sun, 22 Nov 2020 23:18:37 +0800
Subject: [PATCH 106/122] remove hitcount, add high performance go

---
 README.md | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index aa0c66a..168b858 100644
--- a/README.md
+++ b/README.md
@@ -2,7 +2,6 @@
 
 [![CodeSize](https://img.shields.io/github/languages/code-size/geektutu/7days-golang)](https://github.com/geektutu/7days-golang)
 [![LICENSE](https://img.shields.io/badge/license-MIT-green)](https://mit-license.org/)
-[![HitCount](https://hits.dwyl.com/geektutu/7days-golang.svg)](http://github.com/geektutu/7days-golang)
 
 <details>
 <summary><strong>README 中文版本</strong></summary>
@@ -14,7 +13,9 @@
 
 推荐先阅读 **[Go 语言简明教程](https://geektutu.com/post/quick-golang.html)**，一篇文章了解Go的基本语法、并发编程，依赖管理等内容。
 
-另外推荐 **[Go 语言笔试面试题](https://geektutu.com/post/qa-golang.html)**，加深对 Go 语言的理解。
+推荐 **[Go 语言笔试面试题](https://geektutu.com/post/qa-golang.html)**，加深对 Go 语言的理解。
+
+推荐 **[Go 语言高性能编程](https://geektutu.com/post/high-performace-go.html)**，写出高性能的 Go 代码。
 
 期待关注我的「[知乎专栏](https://zhuanlan.zhihu.com/geekgo)」和「[微博](http://weibo.com/geektutu)」，查看最近的文章和动态。
 

From 92a52ed38910a664d02c9cf2ea26dde10a82a26a Mon Sep 17 00:00:00 2001
From: Dai Jie <gzdaijie@163.com>
Date: Mon, 23 Nov 2020 09:22:20 +0800
Subject: [PATCH 107/122] Update README.md

---
 README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 168b858..7c9781e 100644
--- a/README.md
+++ b/README.md
@@ -15,7 +15,7 @@
 
 推荐 **[Go 语言笔试面试题](https://geektutu.com/post/qa-golang.html)**，加深对 Go 语言的理解。
 
-推荐 **[Go 语言高性能编程](https://geektutu.com/post/high-performace-go.html)**，写出高性能的 Go 代码。
+推荐 **[Go 语言高性能编程](https://geektutu.com/post/high-performance-go.html)**，写出高性能的 Go 代码。
 
 期待关注我的「[知乎专栏](https://zhuanlan.zhihu.com/geekgo)」和「[微博](http://weibo.com/geektutu)」，查看最近的文章和动态。
 

From 898e35e34c89e2b2774b463551fdd2a954e747ca Mon Sep 17 00:00:00 2001
From: gzdaijie <gzdaijie@gmail.com>
Date: Tue, 1 Dec 2020 23:30:50 +0800
Subject: [PATCH 108/122] fix goroutine loop variable reference issue

---
 gee-rpc/day6-load-balance/xclient/xclient.go | 4 ++--
 gee-rpc/day7-registry/xclient/xclient.go     | 4 ++--
 gee-rpc/doc/geerpc-day6.md                   | 4 ++--
 3 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/gee-rpc/day6-load-balance/xclient/xclient.go b/gee-rpc/day6-load-balance/xclient/xclient.go
index 838b343..3194d27 100644
--- a/gee-rpc/day6-load-balance/xclient/xclient.go
+++ b/gee-rpc/day6-load-balance/xclient/xclient.go
@@ -85,7 +85,7 @@ func (xc *XClient) Broadcast(ctx context.Context, serviceMethod string, args, re
 	ctx, cancel := context.WithCancel(ctx)
 	for _, rpcAddr := range servers {
 		wg.Add(1)
-		go func() {
+		go func(rpcAddr string) {
 			defer wg.Done()
 			var clonedReply interface{}
 			if reply != nil {
@@ -102,7 +102,7 @@ func (xc *XClient) Broadcast(ctx context.Context, serviceMethod string, args, re
 				replyDone = true
 			}
 			mu.Unlock()
-		}()
+		}(rpcAddr)
 	}
 	wg.Wait()
 	return e
diff --git a/gee-rpc/day7-registry/xclient/xclient.go b/gee-rpc/day7-registry/xclient/xclient.go
index 838b343..3194d27 100644
--- a/gee-rpc/day7-registry/xclient/xclient.go
+++ b/gee-rpc/day7-registry/xclient/xclient.go
@@ -85,7 +85,7 @@ func (xc *XClient) Broadcast(ctx context.Context, serviceMethod string, args, re
 	ctx, cancel := context.WithCancel(ctx)
 	for _, rpcAddr := range servers {
 		wg.Add(1)
-		go func() {
+		go func(rpcAddr string) {
 			defer wg.Done()
 			var clonedReply interface{}
 			if reply != nil {
@@ -102,7 +102,7 @@ func (xc *XClient) Broadcast(ctx context.Context, serviceMethod string, args, re
 				replyDone = true
 			}
 			mu.Unlock()
-		}()
+		}(rpcAddr)
 	}
 	wg.Wait()
 	return e
diff --git a/gee-rpc/doc/geerpc-day6.md b/gee-rpc/doc/geerpc-day6.md
index a0b54cc..7b0ab97 100644
--- a/gee-rpc/doc/geerpc-day6.md
+++ b/gee-rpc/doc/geerpc-day6.md
@@ -259,7 +259,7 @@ func (xc *XClient) Broadcast(ctx context.Context, serviceMethod string, args, re
 	ctx, cancel := context.WithCancel(ctx)
 	for _, rpcAddr := range servers {
 		wg.Add(1)
-		go func() {
+		go func(rpcAddr string) {
 			defer wg.Done()
 			var clonedReply interface{}
 			if reply != nil {
@@ -276,7 +276,7 @@ func (xc *XClient) Broadcast(ctx context.Context, serviceMethod string, args, re
 				replyDone = true
 			}
 			mu.Unlock()
-		}()
+		}(rpcAddr)
 	}
 	wg.Wait()
 	return e

From 8ff3c45ccfe8ae4ddaa97b1df23fb4934af0d0a8 Mon Sep 17 00:00:00 2001
From: gzdaijie <gzdaijie@gmail.com>
Date: Sun, 6 Dec 2020 17:49:40 +0800
Subject: [PATCH 109/122] add project url

---
 README.md                  | 2 +-
 gee-orm/doc/geeorm-day2.md | 1 +
 gee-orm/doc/geeorm.md      | 1 +
 3 files changed, 3 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 7c9781e..296bff7 100644
--- a/README.md
+++ b/README.md
@@ -15,7 +15,7 @@
 
 推荐 **[Go 语言笔试面试题](https://geektutu.com/post/qa-golang.html)**，加深对 Go 语言的理解。
 
-推荐 **[Go 语言高性能编程](https://geektutu.com/post/high-performance-go.html)**，写出高性能的 Go 代码。
+推荐 **[Go 语言高性能编程](https://geektutu.com/post/high-performance-go.html)**([项目地址](https://github.com/geektutu/high-performance-go))，写出高性能的 Go 代码。
 
 期待关注我的「[知乎专栏](https://zhuanlan.zhihu.com/geekgo)」和「[微博](http://weibo.com/geektutu)」，查看最近的文章和动态。
 
diff --git a/gee-orm/doc/geeorm-day2.md b/gee-orm/doc/geeorm-day2.md
index 0f6c9d4..f4a1794 100644
--- a/gee-orm/doc/geeorm-day2.md
+++ b/gee-orm/doc/geeorm-day2.md
@@ -386,4 +386,5 @@ func (engine *Engine) NewSession() *session.Session {
 
 - [Go 语言简明教程](https://geektutu.com/post/quick-golang.html)
 - [Go Test 单元测试简明教程](https://geektutu.com/post/quick-go-test.html)
+- [Go Reflect 提高反射性能](https://geektutu.com/post/hpg-reflect.html)
 - [SQLite 常用命令速查表](https://geektutu.com/post/cheat-sheet-sqlite.html)
\ No newline at end of file
diff --git a/gee-orm/doc/geeorm.md b/gee-orm/doc/geeorm.md
index c188002..6db5c98 100644
--- a/gee-orm/doc/geeorm.md
+++ b/gee-orm/doc/geeorm.md
@@ -137,4 +137,5 @@ gorm 正在彻底重构 v1 版本，短期内看不到发布 v2 的可能。相
 
 - [Go 语言简明教程](https://geektutu.com/post/quick-golang.html)
 - [Go Test 单元测试简明教程](https://geektutu.com/post/quick-go-test.html)
+- [Go Reflect 提高反射性能](https://geektutu.com/post/hpg-reflect.html)
 - [SQLite 常用命令速查表](https://geektutu.com/post/cheat-sheet-sqlite.html)
\ No newline at end of file

From 3d0e400941171abcc83a8e8ad568392d6927202a Mon Sep 17 00:00:00 2001
From: gzdaijie <gzdaijie@gmail.com>
Date: Fri, 1 Jan 2021 21:49:05 +0800
Subject: [PATCH 110/122] rename geektutu-blog to blog

---
 questions/7days-golang-q1.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/questions/7days-golang-q1.md b/questions/7days-golang-q1.md
index ccabb4e..9020b8c 100644
--- a/questions/7days-golang-q1.md
+++ b/questions/7days-golang-q1.md
@@ -200,4 +200,4 @@ Collections.sort(list, (Integer o1, Integer o2) -> o2 - o1 );
 ## 附 参考
 
 - [7days-golang 有价值的问题讨论汇总贴](https://github.com/geektutu/7days-golang/issues/24)
-- [GeeCache第二天 单机并发缓存 - Github 评论区](https://github.com/geektutu/geektutu-blog/issues/64)
\ No newline at end of file
+- [GeeCache第二天 单机并发缓存 - Github 评论区](https://github.com/geektutu/blog/issues/64)
\ No newline at end of file

From 45e999298e91680833d8349c2e78b049f5110c79 Mon Sep 17 00:00:00 2001
From: Dai Jie <gzdaijie@163.com>
Date: Wed, 6 Jan 2021 10:13:14 +0800
Subject: [PATCH 111/122] Update geecache-day2.md

---
 gee-cache/doc/geecache-day2.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/gee-cache/doc/geecache-day2.md b/gee-cache/doc/geecache-day2.md
index 0aa3dde..583408b 100644
--- a/gee-cache/doc/geecache-day2.md
+++ b/gee-cache/doc/geecache-day2.md
@@ -188,7 +188,7 @@ func (c *cache) get(key string) (value ByteView, ok bool) {
 ```
 
 - `cache.go` 的实现非常简单，实例化 lru，封装 get 和 add 方法，并添加互斥锁 mu。
-- 在 `add` 方法中，判断了 `c.lru` 是否为 nil，如果不等于 nil 再创建实例。这种方法称之为延迟初始化(Lazy Initialization)，一个对象的延迟初始化意味着该对象的创建将会延迟至第一次使用该对象时。主要用于提高性能，并减少程序内存要求。
+- 在 `add` 方法中，判断了 `c.lru` 是否为 nil，如果等于 nil 再创建实例。这种方法称之为延迟初始化(Lazy Initialization)，一个对象的延迟初始化意味着该对象的创建将会延迟至第一次使用该对象时。主要用于提高性能，并减少程序内存要求。
 
 ## 3 主体结构 Group
 
@@ -432,4 +432,4 @@ ok      geecache        0.008s
 
 - [Go 语言简明教程 - 并发编程](https://geektutu.com/post/quick-golang.html#7-并发编程-goroutine)
 - [Go Test 单元测试简明教程](https://geektutu.com/post/quick-go-test.html)
-- [sync 官方文档 - golang.org](https://golang.org/pkg/sync/)
\ No newline at end of file
+- [sync 官方文档 - golang.org](https://golang.org/pkg/sync/)

From 371cbe02192565c9d10280d773105e510c740ef2 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Images=E3=80=82?= <elonzzz@163.com>
Date: Tue, 25 May 2021 09:58:19 +0800
Subject: [PATCH 112/122] typo: geerpc-day1.md

---
 gee-rpc/doc/geerpc-day1.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/gee-rpc/doc/geerpc-day1.md b/gee-rpc/doc/geerpc-day1.md
index dea8b43..4e0c22a 100644
--- a/gee-rpc/doc/geerpc-day1.md
+++ b/gee-rpc/doc/geerpc-day1.md
@@ -56,7 +56,7 @@ type Header struct {
 - Error 是错误信息，客户端置为空，服务端如果如果发生错误，将错误信息置于 Error 中。
 
 
-我们将和消息编解码相关的代码都防到 codec 子目录中，在此之前，还需要在根目录下使用 `go mod init geerpc` 初始化项目，方便后续子 package 之间的引用。
+我们将和消息编解码相关的代码都放到 codec 子目录中，在此之前，还需要在根目录下使用 `go mod init geerpc` 初始化项目，方便后续子 package 之间的引用。
 
 进一步，抽象出对消息体进行编解码的接口 Codec，抽象出接口是为了实现不同的 Codec 实例：
 
@@ -439,4 +439,4 @@ reply: geerpc resp 4
 ## 附 推荐阅读
 
 - [Go 语言简明教程](https://geektutu.com/post/quick-golang.html)
-- [Go 语言笔试面试题](https://geektutu.com/post/qa-golang.html)
\ No newline at end of file
+- [Go 语言笔试面试题](https://geektutu.com/post/qa-golang.html)

From 9ef5cbb96b5eee3bd126cf54147396d0cc4b70c5 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Images=E3=80=82?= <elonzzz@163.com>
Date: Tue, 25 May 2021 11:28:03 +0800
Subject: [PATCH 113/122] Update geerpc-day1.md

---
 gee-rpc/doc/geerpc-day1.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/gee-rpc/doc/geerpc-day1.md b/gee-rpc/doc/geerpc-day1.md
index dea8b43..cff6f52 100644
--- a/gee-rpc/doc/geerpc-day1.md
+++ b/gee-rpc/doc/geerpc-day1.md
@@ -183,7 +183,7 @@ var DefaultOption = &Option{
 }
 ```
 
-一般来说，涉及协议协商的这部分信息，需要设计固定的字节来传输的。但是为了实现上更简单，GeeRPC 客户端固定采用 JSON 编码 Option，后续的 header 和 body 的编码方式由 Option 中的 CodeType 指定，服务端首先使用 JSON 解码 Option，然后通过 Option 得 CodeType 解码剩余的内容。即报文将以这样的形式发送：
+一般来说，涉及协议协商的这部分信息，需要设计固定的字节来传输的。但是为了实现上更简单，GeeRPC 客户端固定采用 JSON 编码 Option，后续的 header 和 body 的编码方式由 Option 中的 CodeType 指定，服务端首先使用 JSON 解码 Option，然后通过 Option 的 CodeType 解码剩余的内容。即报文将以这样的形式发送：
 
 ```bash
 | Option{MagicNumber: xxx, CodecType: xxx} | Header{ServiceMethod ...} | Body interface{} |
@@ -439,4 +439,4 @@ reply: geerpc resp 4
 ## 附 推荐阅读
 
 - [Go 语言简明教程](https://geektutu.com/post/quick-golang.html)
-- [Go 语言笔试面试题](https://geektutu.com/post/qa-golang.html)
\ No newline at end of file
+- [Go 语言笔试面试题](https://geektutu.com/post/qa-golang.html)

From 40355892d009fffe7b2af3ca86e3f3bb563c3011 Mon Sep 17 00:00:00 2001
From: alcuin <alcuin0515@163.com>
Date: Wed, 7 Jun 2023 19:54:23 +0800
Subject: [PATCH 114/122] =?UTF-8?q?Day4=20=E4=B8=80=E8=87=B4=E6=80=A7?=
 =?UTF-8?q?=E5=93=88=E5=B8=8C=E5=AD=A6=E4=B9=A0=E7=AC=94=E8=AE=B0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../geecache/consistenthash/consistenthash.go | 24 ++++++++++++-------
 .../consistenthash/consistenthash_test.go     |  6 +++--
 2 files changed, 20 insertions(+), 10 deletions(-)

diff --git a/gee-cache/day4-consistent-hash/geecache/consistenthash/consistenthash.go b/gee-cache/day4-consistent-hash/geecache/consistenthash/consistenthash.go
index c8c9082..3227290 100644
--- a/gee-cache/day4-consistent-hash/geecache/consistenthash/consistenthash.go
+++ b/gee-cache/day4-consistent-hash/geecache/consistenthash/consistenthash.go
@@ -11,13 +11,13 @@ type Hash func(data []byte) uint32
 
 // Map constains all hashed keys
 type Map struct {
-	hash     Hash
-	replicas int
-	keys     []int // Sorted
-	hashMap  map[int]string
+	hash     Hash           // 定义了函数类型 Hash，
+	replicas int            // 虚拟节点倍数
+	keys     []int          // Sorted 哈希环
+	hashMap  map[int]string // 虚拟节点与真实节点的映射表 hashMap，键是虚拟节点的哈希值，值是真实节点的名称。
 }
 
-// New creates a Map instance
+// New creates a Map instance 构造函数 New() 允许自定义虚拟节点倍数和 Hash 函数。
 func New(replicas int, fn Hash) *Map {
 	m := &Map{
 		replicas: replicas,
@@ -25,7 +25,7 @@ func New(replicas int, fn Hash) *Map {
 		hashMap:  make(map[int]string),
 	}
 	if m.hash == nil {
-		m.hash = crc32.ChecksumIEEE
+		m.hash = crc32.ChecksumIEEE // 采取依赖注入的方式，允许用于替换成自定义的 Hash 函数，也方便测试时替换，默认为 crc32.ChecksumIEEE 算法。
 	}
 	return m
 }
@@ -34,11 +34,15 @@ func New(replicas int, fn Hash) *Map {
 func (m *Map) Add(keys ...string) {
 	for _, key := range keys {
 		for i := 0; i < m.replicas; i++ {
+			// 对每一个真实节点 key，对应创建 m.replicas 个虚拟节点，虚拟节点的名称是：strconv.Itoa(i) + key，即通过添加编号的方式区分不同虚拟节点。
 			hash := int(m.hash([]byte(strconv.Itoa(i) + key)))
+			// 使用 m.hash() 计算虚拟节点的哈希值，使用 append(m.keys, hash) 添加到环上。
 			m.keys = append(m.keys, hash)
+			// 在 hashMap 中增加虚拟节点和真实节点的映射关系
 			m.hashMap[hash] = key
 		}
 	}
+	// 最后一步，环上的哈希值排序。
 	sort.Ints(m.keys)
 }
 
@@ -47,12 +51,16 @@ func (m *Map) Get(key string) string {
 	if len(m.keys) == 0 {
 		return ""
 	}
-
+	// 第一步，计算 key 的哈希值。
 	hash := int(m.hash([]byte(key)))
 	// Binary search for appropriate replica.
+	// 第二步，顺时针找到第一个匹配的虚拟节点的下标 idx，从 m.keys 中获取到对应的哈希值。如果 idx == len(m.keys)，
+	// 说明应选择 m.keys[0]，
 	idx := sort.Search(len(m.keys), func(i int) bool {
+		// 寻找到第一个大于这个hash值的keys[i]的坐标idx
 		return m.keys[i] >= hash
 	})
-
+	// 第三步，通过 hashMap 映射得到真实的节点。
+	// 因为 m.keys 是一个环状结构，所以用取余数的方式来处理这种情况。
 	return m.hashMap[m.keys[idx%len(m.keys)]]
 }
diff --git a/gee-cache/day4-consistent-hash/geecache/consistenthash/consistenthash_test.go b/gee-cache/day4-consistent-hash/geecache/consistenthash/consistenthash_test.go
index 34e1275..5faab00 100644
--- a/gee-cache/day4-consistent-hash/geecache/consistenthash/consistenthash_test.go
+++ b/gee-cache/day4-consistent-hash/geecache/consistenthash/consistenthash_test.go
@@ -6,6 +6,7 @@ import (
 )
 
 func TestHashing(t *testing.T) {
+	// 自定义的 Hash 算法只处理数字，传入字符串表示的数字，返回对应的数字即可。
 	hash := New(3, func(key []byte) uint32 {
 		i, _ := strconv.Atoi(string(key))
 		return uint32(i)
@@ -13,13 +14,14 @@ func TestHashing(t *testing.T) {
 
 	// Given the above hash function, this will give replicas with "hashes":
 	// 2, 4, 6, 12, 14, 16, 22, 24, 26
-	hash.Add("6", "4", "2")
-
+	hash.Add("6", "4", "2") // 一开始，有 2/4/6 三个真实节点，对应的虚拟节点的哈希值是 02/12/22、04/14/24、06/16/26。
+	//那么用例 2/11/23/27 选择的虚拟节点分别是 02/12/24/02，也就是真实节点 2/2/4/2。
 	testCases := map[string]string{
 		"2":  "2",
 		"11": "2",
 		"23": "4",
 		"27": "2",
+		"3":  "4",
 	}
 
 	for k, v := range testCases {

From 757bcdcbb119403320bbb6de28c8382ea3ae1c58 Mon Sep 17 00:00:00 2001
From: Alcuin <41372488+Alcuin1@users.noreply.github.com>
Date: Thu, 8 Jun 2023 01:44:07 +0800
Subject: [PATCH 115/122] Update lru.go
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Day1 LRU缓存淘汰策略
---
 gee-cache/day1-lru/geecache/lru/lru.go | 24 +++++++++++++++++++-----
 1 file changed, 19 insertions(+), 5 deletions(-)

diff --git a/gee-cache/day1-lru/geecache/lru/lru.go b/gee-cache/day1-lru/geecache/lru/lru.go
index dc1a317..c4f88b9 100644
--- a/gee-cache/day1-lru/geecache/lru/lru.go
+++ b/gee-cache/day1-lru/geecache/lru/lru.go
@@ -4,20 +4,22 @@ import "container/list"
 
 // Cache is a LRU cache. It is not safe for concurrent access.
 type Cache struct {
-	maxBytes int64
-	nbytes   int64
-	ll       *list.List
-	cache    map[string]*list.Element
+	maxBytes int64                    // 是允许使用的最大内存
+	nbytes   int64                    // nbytes 是当前已使用的内存
+	ll       *list.List               // 在这里我们直接使用 Go 语言标准库实现的双向链表list.List
+	cache    map[string]*list.Element // 键是字符串，值是双向链表中对应节点的指针
 	// optional and executed when an entry is purged.
-	OnEvicted func(key string, value Value)
+	OnEvicted func(key string, value Value) // 是某条记录被移除时的回调函数，可以为 nil
 }
 
+// 键值对 entry 是双向链表节点的数据类型，在链表中仍保存每个值对应的 key 的好处在于，淘汰队首节点时，需要用 key 从字典中删除对应的映射
 type entry struct {
 	key   string
 	value Value
 }
 
 // Value use Len to count how many bytes it takes
+// 为了通用性，我们允许值是实现了 Value 接口的任意类型，该接口只包含了一个方法 Len() int，用于返回值所占用的内存大小。
 type Value interface {
 	Len() int
 }
@@ -34,22 +36,28 @@ func New(maxBytes int64, onEvicted func(string, Value)) *Cache {
 
 // Add adds a value to the cache.
 func (c *Cache) Add(key string, value Value) {
+	// 如果键对应的链表节点存在，则将对应节点移动到队尾，并返回查找到的值
+	// 如果键存在，则更新对应节点的值，并将该节点移到队尾
 	if ele, ok := c.cache[key]; ok {
+		// c.ll.MoveToFront(ele)，即将链表中的节点 ele 移动到队尾（双向链表作为队列，队首队尾是相对的，在这里约定 front 为队尾）
 		c.ll.MoveToFront(ele)
 		kv := ele.Value.(*entry)
 		c.nbytes += int64(value.Len()) - int64(kv.value.Len())
 		kv.value = value
 	} else {
+		// 不存在则是新增场景，首先队尾添加新节点 &entry{key, value}, 并字典中添加 key 和节点的映射关系。
 		ele := c.ll.PushFront(&entry{key, value})
 		c.cache[key] = ele
 		c.nbytes += int64(len(key)) + int64(value.Len())
 	}
+	// 更新 c.nbytes，如果超过了设定的最大值 c.maxBytes，则移除最少访问的节点
 	for c.maxBytes != 0 && c.maxBytes < c.nbytes {
 		c.RemoveOldest()
 	}
 }
 
 // Get look ups a key's value
+// 查找主要有 2 个步骤，第一步是从字典中找到对应的双向链表的节点，第二步，将该节点移动到队尾
 func (c *Cache) Get(key string) (value Value, ok bool) {
 	if ele, ok := c.cache[key]; ok {
 		c.ll.MoveToFront(ele)
@@ -60,13 +68,18 @@ func (c *Cache) Get(key string) (value Value, ok bool) {
 }
 
 // RemoveOldest removes the oldest item
+// 这里的删除，实际上是缓存淘汰。即移除最近最少访问的节点（队首）
 func (c *Cache) RemoveOldest() {
+	// c.ll.Back() 取到队首节点，从链表中删除
 	ele := c.ll.Back()
 	if ele != nil {
 		c.ll.Remove(ele)
 		kv := ele.Value.(*entry)
+		// delete(c.cache, kv.key)，从字典中 c.cache 删除该节点的映射关系
 		delete(c.cache, kv.key)
+		// 更新当前所用的内存 c.nbytes
 		c.nbytes -= int64(len(kv.key)) + int64(kv.value.Len())
+		// 如果回调函数 OnEvicted 不为 nil，则调用回调函数
 		if c.OnEvicted != nil {
 			c.OnEvicted(kv.key, kv.value)
 		}
@@ -74,6 +87,7 @@ func (c *Cache) RemoveOldest() {
 }
 
 // Len the number of cache entries
+// 最后，为了方便测试，我们实现 Len() 用来获取添加了多少条数据
 func (c *Cache) Len() int {
 	return c.ll.Len()
 }

From 2bcb48d91cfe718d2a67238833072a09aa5b2426 Mon Sep 17 00:00:00 2001
From: Alcuin <41372488+Alcuin1@users.noreply.github.com>
Date: Thu, 8 Jun 2023 15:33:03 +0800
Subject: [PATCH 116/122] =?UTF-8?q?Day2=20=E5=8D=95=E6=9C=BA=E5=B9=B6?=
 =?UTF-8?q?=E5=8F=91=E7=BC=93=E5=AD=98geecache.go?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../day2-single-node/geecache/geecache.go     | 25 ++++++++++++++++---
 1 file changed, 21 insertions(+), 4 deletions(-)

diff --git a/gee-cache/day2-single-node/geecache/geecache.go b/gee-cache/day2-single-node/geecache/geecache.go
index e289018..a3ca247 100644
--- a/gee-cache/day2-single-node/geecache/geecache.go
+++ b/gee-cache/day2-single-node/geecache/geecache.go
@@ -7,21 +7,33 @@ import (
 )
 
 // A Group is a cache namespace and associated data loaded spread over
+// 一个 Group 可以认为是一个缓存的命名空间
 type Group struct {
-	name      string
-	getter    Getter
+	// 每个 Group 拥有一个唯一的名称 name。比如可以创建三个 Group，
+	// 缓存学生的成绩命名为 scores，缓存学生信息的命名为 info，缓存学生课程的命名为 courses。
+	name string
+	// 第二个属性是 getter Getter，即缓存未命中时获取源数据的回调(callback)。
+	getter Getter
+	// 第三个属性是 mainCache cache，即一开始实现的并发缓存
 	mainCache cache
 }
 
 // A Getter loads data for a key.
+// 定义接口 Getter 和 回调函数 Get(key string)([]byte, error)，参数是 key，返回值是 []byte。
 type Getter interface {
 	Get(key string) ([]byte, error)
 }
 
 // A GetterFunc implements Getter with a function.
+// 定义函数类型 GetterFunc，并实现 Getter 接口的 Get 方法。
 type GetterFunc func(key string) ([]byte, error)
 
 // Get implements Getter interface function
+// 函数类型实现某一个接口，称之为接口型函数，方便使用者在调用时既能够传入函数作为参数，也能够传入实现了该接口的结构体作为参数。
+// 补充：
+// 这里呢，定义了一个接口 Getter，只包含一个方法 Get(key string) ([]byte, error)，紧接着定义了一个函数类型 GetterFunc，
+// GetterFunc 参数和返回值与 Getter 中 Get 方法是一致的。而且 GetterFunc 还定义了 Get 方式，并在 Get 方法中调用自己，
+// 这样就实现了接口 Getter。所以 GetterFunc 是一个实现了接口的函数类型，简称为接口型函数。
 func (f GetterFunc) Get(key string) ([]byte, error) {
 	return f(key)
 }
@@ -32,6 +44,7 @@ var (
 )
 
 // NewGroup create a new instance of Group
+// 构建函数 NewGroup 用来实例化 Group，并且将 group 存储在全局变量 groups 中。
 func NewGroup(name string, cacheBytes int64, getter Getter) *Group {
 	if getter == nil {
 		panic("nil Getter")
@@ -52,28 +65,32 @@ func NewGroup(name string, cacheBytes int64, getter Getter) *Group {
 func GetGroup(name string) *Group {
 	mu.RLock()
 	g := groups[name]
+	// GetGroup 用来特定名称的 Group，这里使用了只读锁 RLock()，因为不涉及任何冲突变量的写操作
 	mu.RUnlock()
 	return g
 }
 
 // Get value for a key from cache
+// Get 方法实现了上述所说的流程 ⑴ 和 ⑶。
 func (g *Group) Get(key string) (ByteView, error) {
 	if key == "" {
 		return ByteView{}, fmt.Errorf("key is required")
 	}
-
+	// 流程 ⑴ ：从 mainCache 中查找缓存，如果存在则返回缓存值
 	if v, ok := g.mainCache.get(key); ok {
 		log.Println("[GeeCache] hit")
 		return v, nil
 	}
-
+	// 流程 ⑶ ：缓存不存在，则调用 load 方法
 	return g.load(key)
 }
 
+// load 调用 getLocally（分布式场景下会调用 getFromPeer 从其他节点获取），
 func (g *Group) load(key string) (value ByteView, err error) {
 	return g.getLocally(key)
 }
 
+// getLocally 调用用户回调函数 g.getter.Get() 获取源数据，并且将源数据添加到缓存 mainCache 中（通过 populateCache 方法）
 func (g *Group) getLocally(key string) (ByteView, error) {
 	bytes, err := g.getter.Get(key)
 	if err != nil {

From 4815d603f9530b9de440fbaa2f4d82b58b00a5b8 Mon Sep 17 00:00:00 2001
From: Alcuin <41372488+Alcuin1@users.noreply.github.com>
Date: Thu, 8 Jun 2023 15:37:52 +0800
Subject: [PATCH 117/122] =?UTF-8?q?Day1=20LRU=20=E7=BC=93=E5=AD=98?=
 =?UTF-8?q?=E6=B7=98=E6=B1=B0=E7=AD=96=E7=95=A5=20cache.go?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 gee-cache/day2-single-node/geecache/cache.go | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/gee-cache/day2-single-node/geecache/cache.go b/gee-cache/day2-single-node/geecache/cache.go
index 665c3f3..6f56ab8 100644
--- a/gee-cache/day2-single-node/geecache/cache.go
+++ b/gee-cache/day2-single-node/geecache/cache.go
@@ -5,12 +5,15 @@ import (
 	"sync"
 )
 
+// cache.go 的实现非常简单，实例化 lru，封装 get 和 add 方法，并添加互斥锁 mu。
 type cache struct {
 	mu         sync.Mutex
 	lru        *lru.Cache
 	cacheBytes int64
 }
 
+// 在 add 方法中，判断了 c.lru 是否为 nil，如果等于 nil 再创建实例。这种方法称之为延迟初始化(Lazy Initialization)，
+// 一个对象的延迟初始化意味着该对象的创建将会延迟至第一次使用该对象时。主要用于提高性能，并减少程序内存要求。
 func (c *cache) add(key string, value ByteView) {
 	c.mu.Lock()
 	defer c.mu.Unlock()

From a5f414e966fc900964fc1a16d82689d733427701 Mon Sep 17 00:00:00 2001
From: Alcuin <41372488+Alcuin1@users.noreply.github.com>
Date: Thu, 8 Jun 2023 15:40:30 +0800
Subject: [PATCH 118/122] =?UTF-8?q?Day2=20=E5=8D=95=E6=9C=BA=E5=B9=B6?=
 =?UTF-8?q?=E5=8F=91=E7=BC=93=E5=AD=98=20byteview.go?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 gee-cache/day2-single-node/geecache/byteview.go | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/gee-cache/day2-single-node/geecache/byteview.go b/gee-cache/day2-single-node/geecache/byteview.go
index 3ee1022..62a793a 100644
--- a/gee-cache/day2-single-node/geecache/byteview.go
+++ b/gee-cache/day2-single-node/geecache/byteview.go
@@ -1,16 +1,19 @@
 package geecache
 
 // A ByteView holds an immutable view of bytes.
+// ByteView 只有一个数据成员，b []byte，b 将会存储真实的缓存值。选择 byte 类型是为了能够支持任意的数据类型的存储，例如字符串、图片等。
 type ByteView struct {
 	b []byte
 }
 
 // Len returns the view's length
+// 实现 Len() int 方法，我们在 lru.Cache 的实现中，要求被缓存对象必须实现 Value 接口，即 Len() int 方法，返回其所占的内存大小。
 func (v ByteView) Len() int {
 	return len(v.b)
 }
 
 // ByteSlice returns a copy of the data as a byte slice.
+// b 是只读的，使用 ByteSlice() 方法返回一个拷贝，防止缓存值被外部程序修改。
 func (v ByteView) ByteSlice() []byte {
 	return cloneBytes(v.b)
 }

From fd3278efa07e32d1ce13540c3b9989ef0f61c778 Mon Sep 17 00:00:00 2001
From: Alcuin <41372488+Alcuin1@users.noreply.github.com>
Date: Thu, 8 Jun 2023 15:42:13 +0800
Subject: [PATCH 119/122] =?UTF-8?q?Day2=20=E5=8D=95=E6=9C=BA=E5=B9=B6?=
 =?UTF-8?q?=E5=8F=91=E7=BC=93=E5=AD=98=20geecache=5Ftest.go?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 gee-cache/day2-single-node/geecache/geecache_test.go | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/gee-cache/day2-single-node/geecache/geecache_test.go b/gee-cache/day2-single-node/geecache/geecache_test.go
index 7ef9f4f..d507b9a 100644
--- a/gee-cache/day2-single-node/geecache/geecache_test.go
+++ b/gee-cache/day2-single-node/geecache/geecache_test.go
@@ -13,12 +13,13 @@ var db = map[string]string{
 	"Sam":  "567",
 }
 
+// 在这个测试用例中，我们借助 GetterFunc 的类型转换，将一个匿名回调函数转换成了接口 f Getter。
 func TestGetter(t *testing.T) {
 	var f Getter = GetterFunc(func(key string) ([]byte, error) {
 		return []byte(key), nil
 	})
-
 	expect := []byte("key")
+	// 调用该接口的方法 f.Get(key string)，实际上就是在调用匿名回调函数。
 	if v, _ := f.Get("key"); !reflect.DeepEqual(v, expect) {
 		t.Fatal("callback failed")
 	}
@@ -29,10 +30,13 @@ func TestGet(t *testing.T) {
 	gee := NewGroup("scores", 2<<10, GetterFunc(
 		func(key string) ([]byte, error) {
 			log.Println("[SlowDB] search key", key)
+			// 如果存在db中
 			if v, ok := db[key]; ok {
+				// 如果该key没有调用回调函数,就初始化一下
 				if _, ok := loadCounts[key]; !ok {
 					loadCounts[key] = 0
 				}
+				// count++
 				loadCounts[key]++
 				return []byte(v), nil
 			}
@@ -43,6 +47,7 @@ func TestGet(t *testing.T) {
 		if view, err := gee.Get(k); err != nil || view.String() != v {
 			t.Fatal("failed to get value of Tom")
 		}
+		// 在缓存已经存在的情况下，是否直接从缓存中获取，为了实现这一点，使用 loadCounts 统计某个键调用回调函数的次数，如果次数大于1，则表示调用了多次回调函数，没有缓存。
 		if _, err := gee.Get(k); err != nil || loadCounts[k] > 1 {
 			t.Fatalf("cache %s miss", k)
 		}

From a668fe12668adad47df82d6c45704be04d425695 Mon Sep 17 00:00:00 2001
From: Alcuin <41372488+Alcuin1@users.noreply.github.com>
Date: Thu, 8 Jun 2023 16:06:07 +0800
Subject: [PATCH 120/122] =?UTF-8?q?Day3=20HTTP=20=E6=9C=8D=E5=8A=A1?=
 =?UTF-8?q?=E7=AB=AF=20http.go?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 gee-cache/day3-http-server/geecache/http.go | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)

diff --git a/gee-cache/day3-http-server/geecache/http.go b/gee-cache/day3-http-server/geecache/http.go
index b9b994e..468ef5e 100644
--- a/gee-cache/day3-http-server/geecache/http.go
+++ b/gee-cache/day3-http-server/geecache/http.go
@@ -31,32 +31,33 @@ func (p *HTTPPool) Log(format string, v ...interface{}) {
 
 // ServeHTTP handle all http requests
 func (p *HTTPPool) ServeHTTP(w http.ResponseWriter, r *http.Request) {
+	// ServeHTTP 的实现逻辑是比较简单的，首先判断访问路径的前缀是否是 basePath，不是返回错误。
 	if !strings.HasPrefix(r.URL.Path, p.basePath) {
 		panic("HTTPPool serving unexpected path: " + r.URL.Path)
 	}
 	p.Log("%s %s", r.Method, r.URL.Path)
 	// /<basepath>/<groupname>/<key> required
+	// 我们约定访问路径格式为 /<basepath>/<groupname>/<key>
 	parts := strings.SplitN(r.URL.Path[len(p.basePath):], "/", 2)
 	if len(parts) != 2 {
 		http.Error(w, "bad request", http.StatusBadRequest)
 		return
 	}
-
 	groupName := parts[0]
 	key := parts[1]
-
+	// 通过 groupname 得到 group 实例
 	group := GetGroup(groupName)
 	if group == nil {
 		http.Error(w, "no such group: "+groupName, http.StatusNotFound)
 		return
 	}
-
+	// 再使用 group.Get(key) 获取缓存数据
 	view, err := group.Get(key)
 	if err != nil {
 		http.Error(w, err.Error(), http.StatusInternalServerError)
 		return
 	}
-
 	w.Header().Set("Content-Type", "application/octet-stream")
+	// 最终使用 w.Write() 将缓存值作为 httpResponse 的 body 返回
 	w.Write(view.ByteSlice())
 }

From 444d80fb156fe831db6f8a27818990f1ac41d0c9 Mon Sep 17 00:00:00 2001
From: Alcuin <41372488+Alcuin1@users.noreply.github.com>
Date: Thu, 8 Jun 2023 16:06:40 +0800
Subject: [PATCH 121/122] =?UTF-8?q?Day3=20HTTP=20=E6=9C=8D=E5=8A=A1?=
 =?UTF-8?q?=E7=AB=AF=20main.go?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 gee-cache/day3-http-server/main.go | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/gee-cache/day3-http-server/main.go b/gee-cache/day3-http-server/main.go
index 5442dd7..dff9003 100644
--- a/gee-cache/day3-http-server/main.go
+++ b/gee-cache/day3-http-server/main.go
@@ -22,6 +22,7 @@ var db = map[string]string{
 }
 
 func main() {
+	// 创建一个名为 scores 的 Group，若缓存为空，回调函数会从 db 中获取数据并返回。
 	geecache.NewGroup("scores", 2<<10, geecache.GetterFunc(
 		func(key string) ([]byte, error) {
 			log.Println("[SlowDB] search key", key)
@@ -30,7 +31,7 @@ func main() {
 			}
 			return nil, fmt.Errorf("%s not exist", key)
 		}))
-
+	// 使用 http.ListenAndServe 在 9999 端口启动了 HTTP 服务。
 	addr := "localhost:9999"
 	peers := geecache.NewHTTPPool(addr)
 	log.Println("geecache is running at", addr)

From 3c0a79366de7a4a293097ab985eb1a05f17330f4 Mon Sep 17 00:00:00 2001
From: Alcuin <41372488+Alcuin1@users.noreply.github.com>
Date: Thu, 8 Jun 2023 16:56:55 +0800
Subject: [PATCH 122/122] =?UTF-8?q?Day5=20=E5=88=86=E5=B8=83=E5=BC=8F?=
 =?UTF-8?q?=E8=8A=82=E7=82=B9=20peers.go?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 gee-cache/day5-multi-nodes/geecache/peers.go | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/gee-cache/day5-multi-nodes/geecache/peers.go b/gee-cache/day5-multi-nodes/geecache/peers.go
index 8d010e2..6246267 100644
--- a/gee-cache/day5-multi-nodes/geecache/peers.go
+++ b/gee-cache/day5-multi-nodes/geecache/peers.go
@@ -2,11 +2,13 @@ package geecache
 
 // PeerPicker is the interface that must be implemented to locate
 // the peer that owns a specific key.
+// PeerPicker 的 PickPeer() 方法用于根据传入的 key 选择相应节点 PeerGetter。
 type PeerPicker interface {
 	PickPeer(key string) (peer PeerGetter, ok bool)
 }
 
 // PeerGetter is the interface that must be implemented by a peer.
+// 接口 PeerGetter 的 Get() 方法用于从对应 group 查找缓存值。PeerGetter 就对应于上述流程中的 HTTP 客户端
 type PeerGetter interface {
 	Get(group string, key string) ([]byte, error)
 }