快捷導(dǎo)航

golang context接口類型方法介紹

更新時(shí)間：2023年09月27日 10:33:00 作者：lincoln_hlf1

這篇文章主要為大家介紹了golang context接口類型方法詳解,有需要的朋友可以借鑒參考下,希望能夠有所幫助,祝大家多多進(jìn)步,早日升職加薪

摘要

在很多的 Go 開(kāi)源框架里，我們經(jīng)常能看到 context 的身影，它的使用場(chǎng)景有很多，像超時(shí)通知，取消通知都用到了 context。今天我們就來(lái)好好的認(rèn)識(shí)一下它，看看 context 的相關(guān)知識(shí)和底層原理。

context 介紹

context 從它的字面量就可以看出來(lái)，是用來(lái)傳遞信息的。當(dāng)然，這種傳遞并不僅僅是將數(shù)據(jù)塞給被調(diào)用者，它還能進(jìn)行鏈?zhǔn)降膫鬟f，通過(guò)保存父子 context 關(guān)系，不斷的迭代遍歷來(lái)獲取數(shù)據(jù)。

除此之外，context 還能進(jìn)行鏈?zhǔn)降膫鞑?channel 信號(hào)。

我們知道 channel 是用來(lái)做 goroutine 通信使用的。這就使得 goroutine 之間能夠進(jìn)行鏈?zhǔn)降男盘?hào)通知了，進(jìn)而達(dá)到自上而下的通知效果。

例如通知所有跟 context 有血緣關(guān)系的 goroutine 進(jìn)行取消動(dòng)作。

Context 接口

在 Go 里并沒(méi)有直接為我們提供一個(gè)統(tǒng)一的 context 對(duì)象，而是設(shè)計(jì)了一個(gè)接口類型的 Context。然后在這些接口上來(lái)實(shí)現(xiàn)了幾種具體類型的 context。

這樣的好處就是我們只要根據(jù)開(kāi)放出來(lái)的接口定義，也能夠?qū)崿F(xiàn)屬于自己的 context，進(jìn)而跟官方的 context 一起配合使用。

在分析官方的幾種 context 之前，我們先來(lái)看看 context 要求實(shí)現(xiàn)的幾個(gè)接口：

Deadline() (deadline time.Time, ok bool)
Done() <-chan struct{}
Err() error
Value(key interface{}) interface{}

其中：

Deadline() 表示如果有截止時(shí)間的話，得返回對(duì)應(yīng) deadline 時(shí)間；如果沒(méi)有，則 ok 的值為 false。

Done() 表示關(guān)于 channel 的數(shù)據(jù)通信，而且它的數(shù)據(jù)類型是 struct{}，一個(gè)空結(jié)構(gòu)體，因此在 Go 里都是直接通過(guò) close channel 來(lái)進(jìn)行通知的，不會(huì)涉及具體數(shù)據(jù)傳輸。

Err() 返回的是一個(gè)錯(cuò)誤 error，如果上面的 Done() 的 channel 沒(méi)被 close，則 error 為 nil；如果 channel 已被 close，則 error 將會(huì)返回 close 的原因，比如超時(shí)或手動(dòng)取消。

Value() 則是用來(lái)存儲(chǔ)具體數(shù)據(jù)的方法。

Context 類型

簡(jiǎn)單的看過(guò) Context 接口之后，我們來(lái)看看官方的 context 類型。主要有四種，分別是 emptyCtx，cancelCtx，timerCtx，valueCtx：

emptyCtx：空的 context，實(shí)現(xiàn)了上面的 4 個(gè)接口，但都是直接 return 默認(rèn)值，沒(méi)有具體功能代碼。
cancelCtx：用來(lái)取消通知用的 context
timerCtx：用來(lái)超時(shí)通知用的 context
valueCtx：用來(lái)傳值的 context

其中：
emptyCtx 表示什么都沒(méi)有的 context，一般用作最初始的 context，作為父 context 使用。像我們常見(jiàn)的 context.Background()返回的就是 emptyCtx。

其他類型的創(chuàng)建方法如下：

WithCancel 方法創(chuàng)建的是 cancelCtx 類型的 context。
WithDeadline 方法創(chuàng)建的是 timerCtx 類型的 context。
WithValue 方法創(chuàng)建的是 valueCtx 類型的 context。

上面三個(gè)方法在創(chuàng)建的時(shí)候都會(huì)要求傳 parent context 進(jìn)來(lái)，以此達(dá)到鏈?zhǔn)絺鬟f信息的目的。

Context 源碼

context 的源碼在 src/context/context.go 里，相信大家仔細(xì)研究，也能看到上面介紹的幾個(gè) context 對(duì)象。這邊簡(jiǎn)單解釋下 cancelCtx、timerCtx、valueCtx 的核心流程。

1）cancelCtx 、timerCtx(用來(lái)通知用的 context)

cancelCtx 、timerCtx 在創(chuàng)建的時(shí)候都會(huì)調(diào)用 propagateCancel方法，將當(dāng)前的 context 掛在父 context 下。

接著在 Done() 方法里返回了對(duì)應(yīng)的 channel，讓調(diào)用者能夠監(jiān)聽(tīng) channel 信號(hào)。

當(dāng)要執(zhí)行取消動(dòng)作時(shí)，會(huì)通過(guò) cancel 方法關(guān)閉 channel，來(lái)達(dá)到通知 goroutine 的目的。

在 channel 關(guān)閉的同時(shí)也會(huì)對(duì)子 context 調(diào)用 cancel 方法，直到?jīng)]有子 context。

cancelCtx 和 timerCtxt 不同之處就在于 cancelCtx 是手動(dòng)調(diào)用 cancel 方法來(lái)觸發(fā)取消通知；

而 timerCtxt 則通過(guò) AfterFunc 超時(shí)時(shí)間來(lái)自動(dòng)觸發(fā) cancel 方法。

2）valueCtx(用來(lái)傳值的 context)

valueCtx 通過(guò) key-value 形式來(lái)存儲(chǔ)數(shù)據(jù)，當(dāng)找不到 key 時(shí)，就會(huì)到父 context 里查找，直到?jīng)]有父 context：

func (c *valueCtx) Value(key interface{}) interface{} {
    if c.key == key {
        return c.val
    }
    return c.Context.Value(key) // 到父 context 里查找
}