题外话
又是周一,一起床就很乏且困,还想再睡一会,想着坐我的加长凯迪拉克去公司,又怕堵车,苦思冥想下决定,让我的管家拉博伊特开 直9轻型直升飞机送我去吧……
又是乏味的一天…… 人生就是这么简简单单
话说今天有点阴天但不冷,真不错
废话不多说,上货
Background()和TODO()
昨天说到了go的Context 接口,怕大家忘记,我再把他贴这里
其定义如下:
type Context interface {
Deadline() (deadline time.Time, ok bool)
Done() <-chan struct{}
Err() error
Value(key interface{}) interface{}
}
然后我们再说说他的两个内置方法
Go语言内置两个函数:Background() 和 TODO(),这两个函数分别返回一个实现了 Context 接口的 background 和 todo。
Background() 主要用于 main 函数、初始化以及测试代码中,作为 Context 这个树结构的最顶层的 Context,也就是根 Context。
TODO(),它目前还不知道具体的使用场景,在不知道该使用什么 Context 的时候,可以使用这个。
background 和 todo 本质上都是 emptyCtx 结构体类型,是一个不可取消,没有设置截止时间,没有携带任何值的 Context。
举个例子
他俩的源码如下
var (
background = new(emptyCtx)
todo = new(emptyCtx)
)
// Background returns a non-nil, empty Context. It is never canceled, has no
// values, and has no deadline. It is typically used by the main function,
// initialization, and tests, and as the top-level Context for incoming
// requests.
可以看出todo 和background 都是一个emtyCtx实例,为什么要把两者区分开呢,使用效果上有什么不一样的么?
官方给了一个一言难尽的解释
TODO is recognized by static analysis tools that determine
翻译一下就是 –todo 会有其他的代码审查工具来检查
说了但好像又没说
Context的With 系列函数
Context 包中还定义了四个 With 系列函数。
分别是
-
WithCancel:
WithCancel 返回带有新 Done 通道的父节点的副本,当调用返回的 cancel 函数或当关闭父上下文的 Done 通道时,将关闭返回上下文的 Done 通道,无论先发生什么情况。
-
WithDeadline
WithDeadline 函数会返回父上下文的副本,并将 deadline 调整为不迟于 d。如果父上下文的 deadline 已经早于 d,则 WithDeadline(parent, d) 在语义上等同于父上下文。当截止日过期时,当调用返回的 cancel 函数时,或者当父上下文的 Done 通道关闭时,返回上下文的 Done 通道将被关闭,以最先发生的情况为准。 -
WithTimeout
WithTimeout 函数返回 WithDeadline(parent, time.Now().Add(timeout))。取消此上下文将释放与其相关的资源,因此代码应该在此上下文中运行的操作完成后立即调用 cancel -
WithValue
WithValue 函数接收 context 并返回派生的 context,其中值 val 与 key 关联,并通过 context 树与 context 一起传递。这意味着一旦获得带有值的 context,从中派生的任何 context 都会获得此值。不建议使用 context 值传递关键参数,函数应接收签名中的那些值,使其显式化。所提供的键必须是可比较的,并且不应该是 string 类型或任何其他内置类型,以避免使用上下文在包之间发生冲突。WithValue 的用户应该为键定义自己的类型,为了避免在分配给接口{ } 时进行分配,上下文键通常具有具体类型 struct{}。或者,导出的上下文关键变量的静态类型应该是指针或接口。
使用 Context 的注意事项
最后说说使用 Context 的注意事项吧
- 不要把 Context 放在结构体中,要以参数的方式显示传递;
- 以 Context 作为参数的函数方法,应该把 Context 作为第一个参数;
- 给一个函数方法传递 Context 的时候,不要传递 nil,如果不知道传递什么,就使用 context.TODO;
- Context 的 Value 相关方法应该传递请求域的必要数据,不应该用于传递可选参数;
- Context 是线程安全的,可以放心的在多个 Goroutine 中传递。
你以为结束了
小问题:能不能自己写个demo?
大家看完发现有什么错误,写在下面吧!跟我黑虎阿福比划比划!