update timer

Author: cch123

timer.md

@@ -4,15 +4,71 @@
 
 什么 Date，Parse，ParseInLocation，就不说了。主要关注下面几个函数：
 
-ticker 相关:
+### ticker 相关
 
 ```go
 func Tick(d Duration) <-chan Time
 func NewTicker(d Duration) *Ticker
 func (t *Ticker) Stop()
 ```
 
-timer 相关:
+```go
+package main
+
+import (
+    "fmt"
+    "time"
+)
+
+func main() {
+    for t := range time.Tick(time.Second * 2) {
+        fmt.Println(t, "hello world")
+    }
+}
+```
+
+```go
+package main
+
+import (
+    "fmt"
+    "time"
+)
+
+func main() {
+    ticker := time.NewTicker(time.Second * 2)
+    for {
+        select {
+        case t := <-ticker.C:
+            fmt.Println(t, "hello world")
+        }
+    }
+}
+```
+
+需要注意的是，ticker 在不使用时，应该手动 stop，如果不 stop 可能会造成 timer 泄露，比如下面这样的代码:
+
+```go
+package main
+
+import (
+    "fmt"
+    "time"
+)
+
+func main() {
+    for {
+        select {
+        case t := <-time.Tick(time.Second * 2):
+            fmt.Println(t, "hello world")
+        }
+    }
+}
+```
+
+泄露之后会在时间堆中累积越来越多的 timer 对象，从而发生内存泄露。
+
+### timer 相关
 
 ```go
 func After(d Duration) <-chan Time
@@ -21,6 +77,79 @@ func (t *Timer) Reset(d Duration) bool
 func (t *Timer) Stop() bool
 ```
 
+time.After 一般用来控制某些耗时较长的行为，在超时后不再等待，以使程序行为可预期。如果不做超时取消释放资源，则可能因为依赖方响应缓慢而导致本地资源堆积，例如 fd，连接数，内存占用等等。从而导致服务宕机。
+
+这里用阻塞 channel 读取会永远阻塞的特性来模拟较长时间的行为，在超时后会从 select 中跳出。
+
+```go
+package main
+
+import "time"
+
+func main() {
+    var ch chan int
+    select {
+    case <-time.After(time.Second):
+        println("time out, and end")
+    case <-ch:
+    }
+}
+```
+
+time.After 和 time.Tick 不同，是一次性触发的，触发后 timer 本身会从时间堆中删除。所以一般情况下直接用 `<-time.After` 是没有问题的，不过在 for 循环的时候要注意:
+
+```go
+package main
+
+import "time"
+
+func main() {
+    var ch = make(chan int)
+    go func() {
+        for {
+            ch <- 1
+        }
+    }()
+
+    for {
+        select {
+        case <-time.After(time.Second):
+            println("time out, and end")
+        case <-ch:
+        }
+    }
+}
+```
+
+上面的代码，<-ch 这个 case 每次执行的时间都很短，但每次进入 select，`time.After` 都会分配一个新的 timer。因此会在短时间内创建大量的无用 timer，虽然没用的 timer 在触发后会消失，但这种写法会造成无意义的 cpu 资源浪费。正确的写法应该对 timer 进行重用，如下:
+
+```go
+package main
+
+import "time"
+
+func main() {
+    var ch = make(chan int)
+    go func() {
+        for {
+            ch <- 1
+        }
+    }()
+
+    timer := time.NewTimer(time.Second)
+    for {
+        timer.Reset(time.Second)
+        select {
+        case <-timer.C:
+            println("time out, and end")
+        case <-ch:
+        }
+    }
+}
+```
+
+和 Ticker 一样，如果之前的 timer 没用了，可以手动 Stop 以使该 timer 从时间堆中移除。
+
 ## 源码分析
 
 ### 数据结构
@@ -526,7 +655,9 @@ func siftdownTimer(t []*timer, i int) {
                          ▼                                                        
 ```
 
-### time.After
+### 流程
+
+#### timer.After 流程
 
 ```go
 func After(d Duration) <-chan Time {
@@ -560,7 +691,6 @@ func startTimer(*runtimeTimer)
 func startTimer(t *timer) {
     addtimer(t)
 }
-
 ```
 
-TODO timejump
+#### timer.Ticker 流程