Go語言的context包從放棄到入門


以下內容由偉大的詩人、哲學家chenqionghe吐血傳授,希望能幫助到你,謝謝~

一、Context包到底是幹嘛用的

我們會在用到很多東西的時候都看到context的影子,比如gin框架,比如grpc,這東西到底是做啥的?
大家都在用,沒幾個知道這是幹嘛的,知其然而不知其所以然,

誰都在CRUD,誰都覺得if else就完了,有代碼能copy我也行,原理啥啥不懂不重要,反正就是一把梭

原理說白了就是:

  1. 當前協程取消了,可以通知所有由由它的子協程退出
  2. 當前協程取消了,不會影響到他父級協程的狀態
  3. 擴展了一些其他的功能:超時取消、定時取消、給以給子協程傳遞數據

二、主協程退出通知子協程示例演示

主協程通知子協程退出

如下代碼展示了,通過一個叫done的channel通道達到了這樣的效果

package main

import (
    "fmt"
    "time"
)

func main() {
    done := make(chan string)

    //緩衝通道預先放置10個消息
    messages := make(chan int, 10)
    defer close(messages)
    for i := 0; i < 10; i++ {
        messages <- i
    }
    //啓動3個子協程消費messages消息
    for i := 1; i <= 3; i++ {
        go child(i, done, messages)
    }

    time.Sleep(3 * time.Second) //等待子協程接收一半的消息
    close(done) //結束前通知子協程
    time.Sleep(2 * time.Second) //等待所有的子協程輸出
    fmt.Println("主協程結束")
}

//從messages通道獲取信息,當收到結束信號的時候不再接收
func child(i int, done <-chan string, messages <-chan int) {
Consume:
    for {
        time.Sleep(1 * time.Second)
        select {
        case <-done:
            fmt.Printf("[%d]被主協程通知結束...\n", i)
            break Consume
        default:
            fmt.Printf("[%d]接收消息: %d\n", i, <-messages)
        }
    }
}

運行結束如下

這裏,我們用一個channel的關閉做到了通知所有的消費到一半的子協程退出。
問題來了,如果子協程又要啓動它的子協程,這可咋整?

主協程通知有子協程,子協程又有多個子協程

這是可哲學問題,我們還是得建立一個叫done的channel來監測
下面演示一下這種操作,再在每個child方法裏啓動多個job,如下

全量代碼貼出來

package main

import (
    "fmt"
    "time"
)

func main() {
    done := make(chan string)

    //緩衝通道預先放置10個消息
    messages := make(chan int, 10)
    defer close(messages)
    for i := 0; i < 10; i++ {
        messages <- i
    }
    //啓動3個子協程消費messages消息
    for i := 1; i <= 3; i++ {
        go child(i, done, messages)
    }

    time.Sleep(3 * time.Second) //等待子協程接收一半的消息
    close(done) //結束前通知子協程
    time.Sleep(2 * time.Second) //等待所有的子協程輸出
    fmt.Println("主協程結束")
}

//從messages通道獲取信息,當收到結束信號的時候不再接收
func child(i int, done <-chan string, messages <-chan int) {
    newDone := make(chan string)
    defer close(newDone)
    go childJob(i, "a", newDone)
    go childJob(i, "b", newDone)

Consume:
    for {
        time.Sleep(1 * time.Second)
        select {
        case <-done:
            fmt.Printf("[%d]被主協程通知結束...\n", i)
            break Consume
        default:
            fmt.Printf("[%d]接收消息: %d\n", i, <-messages)
        }
    }
}

//任務
func childJob(parent int, name string, done <-chan string) {
    for {
        time.Sleep(1 * time.Second)
        select {
        case <-done:
            fmt.Printf("[%d-%v]被結束...\n", parent, name)
            return
        default:
            fmt.Printf("[%d-%v]執行\n", parent, name)
        }
    }
}

運行結果如下

問題來了,如果job裏再啓動自己的goroutine,這樣沒完沒了的建立done的通道有點噁心,這時候context包就來了!

我們先把上面的代碼改成context包的方式

package main

import (
    "context"
    "fmt"
    "time"
)

func main() {
    ctx, cancel := context.WithCancel(context.Background())
    //緩衝通道預先放置10個消息
    messages := make(chan int, 10)
    defer close(messages)
    for i := 0; i < 10; i++ {
        messages <- i
    }
    //啓動3個子協程消費messages消息
    for i := 1; i <= 3; i++ {
        go child(i, ctx, messages)
    }
    time.Sleep(3 * time.Second) //等待子協程接收一半的消息
    cancel() //結束前通知子協程
    time.Sleep(2 * time.Second) //等待所有的子協程輸出
    fmt.Println("主協程結束")
}

//從messages通道獲取信息,當收到結束信號的時候不再接收
func child(i int, ctx context.Context, messages <-chan int) {
    //基於父級的context建立context
    newCtx, _ := context.WithCancel(ctx)
    go childJob(i, "a", newCtx)
    go childJob(i, "b", newCtx)

Consume:
    for {
        time.Sleep(1 * time.Second)
        select {
        case <-ctx.Done():
            fmt.Printf("[%d]被主協程通知結束...\n", i)
            break Consume
        default:
            fmt.Printf("[%d]接收消息: %d\n", i, <-messages)
        }
    }
}

//任務
func childJob(parent int, name string, ctx context.Context) {
    for {
        time.Sleep(1 * time.Second)
        select {
        case <-ctx.Done():
            fmt.Printf("[%d-%v]被結束...\n", parent, name)
            return
        default:
            fmt.Printf("[%d-%v]執行\n", parent, name)
        }
    }
}

運行結果如下

可以看到,改成context包還是順利的通過子協程退出了
主要修改了幾個地方,再ctx向下傳遞

基於上層context再構建當前層級的context

監聽context的退出信號,

這就是context包的核心原理,鏈式傳遞context,基於context構造新的context

三、Context包的核心接口和方法

context接口

context是一個接口,主要包含以下4個方法

  • Deadline
    返回當前context任務被取消的時間,沒有設定返回ok返回false
  • Done
    當綁定當前的context任務被取消時,將返回一個關閉的channel
  • Err
    Done返回的channel沒有關閉,返回nil;
    Done返回的channel已經關閉,返回非空值表示任務結束的原因;
    context被取消,返回Canceled。
    context超時,DeadlineExceeded
  • Value
    返回context存儲的鍵

emptyCtx結構體

實現了context接口,emptyCtx沒有超時時間,不能取消,也不能存儲額外信息,所以emptyCtx用來做根節點,一般用Background和TODO來初始化emptyCtx

Backgroud

通常用於主函數,初始化以及測試,作爲頂層的context

TODO

不確定使用什麼用context的時候纔會使用

valueCtx結構體

type valueCtx struct{ Context key, val interface{} }

valueCtx利用Context的變量來表示父節點context,所以當前context繼承了父context的所有信息
valueCtx還可以存儲鍵值。

Value

func (c *valueCtx) Value(key interface{}) interface{} {
    if c.key == key {
        return c.val
    }
    return c.Context.Value(key)
}

可以用來獲取當前context和所有的父節點存儲的key

如果當前的context不存在需要的key,會沿着context鏈向上尋找key對應的值,直到根節點

WithValue

可以向context添加鍵值

func WithValue(parent Context, key, val interface{}) Context {
    if key == nil {
        panic("nil key")
    }
    if !reflect.TypeOf(key).Comparable() {
        panic("key is not comparable")
    }
    return &valueCtx{parent, key, val}
}

添加鍵值會返回創建一個新的valueCtx子節點

cancelCtx結構體

type cancelCtx struct {
    Context
    mu sync.Mutex
    done chan struct{}
    children map[canceler]struct{}
    err error
}
type canceler interface {
    cancel(removeFromParent bool, err error)
    Done() <-chan struct{}
}

和valueCtx類似,有一個context做爲父節點,
變量done表示一個channel,用來表示傳遞關閉;
children表示一個map,存儲了當前context節點爲下的子節點
err用來存儲錯誤信息表示任務結束的原因

WithCancel

用來創建一個可取消的context,返回一個context和一個CancelFunc,調用CancelFunc可以觸發cancel操作。

timerCtx結構體

timerCtx是基於cancelCtx的context精英,是一種可以定時取消的context,過期時間的deadline不晚於所設置的時間d

WithDeadline

返回一個基於parent的可取消的context,並且過期時間deadline不晚於所設置時間d

WithTimeout

創建一個定時取消context,和WithDeadline差不多,WithTimeout是相對時間

四、總結核心原理

  1. Done方法返回一個channel
  2. 外部通過調用<-channel監聽cancel方法
  3. cancel方法會調用close(channel)
    當調用close方法的時間,所有的channel再次從通道獲取內容,會返回零值和false
res,ok := <-done:
  1. 過期自動取消,相當於返回了一個函數,到時調用cancel方法
  c.timer = time.AfterFunc(dur, func() {
   c.cancel(true, DeadlineExceeded)
  })

授人以漁不如授人以漁,知其然也知其所以然,讓我們共同構建美麗新世界,讓人與自然更加和諧,就是這樣,giao~

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章