Context接口

context.Context是一个接口,该接口定义了四个需要实现的方法。具体签名如下:
type Context interface {
Deadline() (deadline time.Time, ok bool)
Done() <-chan struct{}
Err() error
Value(key interface{}) interface{}
}

Deadline方法需要返回当前Context被取消的时间,也就是完成工作的截止时间(deadline);

Done方法需要返回一个Channel,这个Channel会在当前工作完成或者上下文被取消之后关闭,多次调用Done方法会返回同一个Channel;

Err方法会返回当前Context结束的原因,它只会在Done返回的Channel被关闭时才会返回非空的值;
如果当前Context被取消就会返回Canceled错误;
如果当前Context超时就会返回DeadlineExceeded错误;

Value方法会从Context中返回键对应的值,对于同一个上下文来说,多次调用Value 并传入相同的Key会返回相同的结果,该方法仅用于传递跨API和进程间跟请求域的数据;

 


使用Context的注意事项
1、推荐以参数的方式显示传递Context
2、以Context作为参数的函数方法,应该把Context作为第一个参数。
3、给一个函数方法传递Context的时候,不要传递nil,如果不知道传递什么,就使用context.TODO()
4、Context的Value相关方法应该传递请求域的必要数据,不应该用于传递可选参数
5、Context是线程安全的,可以放心的在多个goroutine中传递

posted @ 2021-09-05 09:43  算盘  阅读(62)  评论(0编辑  收藏  举报