前言
做为go的使用者,大家应该都多多少少的见过Context包。可是因为我得懒惰都没有跳转进去好好看看,导致我对Context包理解并不深。写博客是一个很好的方式提醒自己不要懒惰,而且还能当成自己的笔记,平时翻一翻加深下记忆。
Context使用场景
目前总结两种使用场景:
1. 主动停止groutine
2. 传递数据
Context是什么?
Context直译为上下文,我们来看一下Context包中对它的说明,在go1.7之后已经添加到了标准库中,我们之间可以在/src/context中查看。
Context包中对Context的说明
英文水平不是太好就直译了过来,最近有在学习英文,遇到了很多优秀的人,真的是比你优秀的人比你还努力。又扯远了…
- 包context定义了Context类型,并包含deadlines(结束时间),cancelation signals(取消信号),和其他的请求api范围的值。
- 对服务器的请求应该创建一个Context,服务器发出的外向请求应该接受Context。链式的函数调用之间必须传递Context,随意的更换它使用一个导出Context使用WithCancel、WithDeadline、WithTimeout、WithValue。当一个Context取消所有从它导出的Contexts都会被取消。
- WithCancel、WithDeadline、WithTimeout函数携带一个Context(父)并返回一个导出的Context(子)和一个CancelFunc(取消函数)。调用CancelFunc函数来取消子和他的孩子,移除父母的参考孩子,并停止任何关联的定时器。调用CancelFunc失败会泄露子和他的孩子直到父取消或者计时器超时。go的审查工具被用在所有的control-flow路径下检查CancelFuncs。
程序在使用Context应遵循如下规则,以保证接口的一致,并允许静态分析工具检查Context传递。
1. 不要将 Contexts 放入结构体,相反context应该作为第一个参数传入,命名为ctx。
func DoSomething(ctx context.Context, arg Arg) error {
... use ctx ...
}
2. 即使函数允许也不要传递一个nil的Context。如果不确定使用哪种Conetex,传递context.TODO
3. 使用context的Value相关方法只应该用于在程序和接口中传递的和请求相关的数据,不要用它来传递一些可选的参数。
4. 相同的Context