golang的context

Go语言的context包主要用于管理请求级别的数据、取消信号和截止时间。本文详细介绍了context的基本概念,包括context如何解决多goroutine协作时的取消问题,Background()和TODO()的用法,以及WithCancel、WithDeadline、WithTimeout和WithValue等函数的应用。同时强调了使用context的注意事项,如作为函数首参数传递,避免在Context中传递不必要的数据等。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

1.context简介

在go的http包的server中,每一个对应的请求都有一个goroutine负责处理,处理函数通常会启动额外的goroutine去处理,如果一个请求被取消或者超时,用来处理该请求的goroutine应该及时退出,这样就不会有大量的goroutine去占用资源。

Context类型专用来简化对于处理单个请求的多个goroutine之间与请求域的数据、取消信号、截止时间等相关操作,这些操作可能涉及多个API调用。因此对服务器的请求应该去创建上下文,对服务器的传输调用也应该接收上下文,它们的函数调用必须传上下文,或可以使用WithCancel、WithDeadline、WithTimeout或WithValue创建的派生上下文。当一个上下文取消时 它派生的所有上下文也会取消。
context.Context是一个接口,接口定义了四个实现的方法:
 

type Context interface {
    Deadline() (deadline time.Time, ok bool)
    Done() <-chan struct{}
    Err() error
    Value(key interface{}) interface{}
}
  1. Deadline:返回的第一个值是 截止时间,到了这个时间点,Context 会自动触发 Cancel 动作。返回的第二个值是 一个布尔值,true 表示设置了截止时间,false 表示没有设置截止时间,如果没有设置截止时间,就要手动调用 cancel 函数取消 Context。
  2. Done:返回一个只读的通道(只有在被cancel后才会返回),类型为 struct{}。当这个通道可读时,意味着parent context已经发起了取消请求,根据这个信号,开发者就可以做一些清理动作,退出goroutine。 多次调用Done方法会返回同一个Channel。
  3. Err:返回 context 被 cancel 的原因。它只会在Done返回的Channel关闭时才会返回非空的值,如果当前Context被取消就会返回Canceled,如果当前Context超时就会返回DeadlineExceeded。
  4. Value:返回被绑定到 Context 的值,是一个键值对,所以要通过一个Key才可以获取对应的值,这个值一般是线程安全的。对于同一个上下文来 说,多次调用Value 并传入相同的Key会返回相同的结果,该方法仅用于传递跨API和进程间请求域的数据。

2.context解决的问题

当有多个goroutine在运行的时候,主goroutine如果提前结束,会导致其余的goroutine没有执行完毕,我们一般来用互斥锁+全局变量或者channel来解决。如下:

var wg sync.WaitGroup
var exit bool
// 全局变 方式存在的   
// 1. 使用全局变量在跨包调用时不容易统一
// 2. 如果worker中再启动goroutine 就不太好控制了。
func worker() {
	for {
		fmt.Println("worker")
		time.Sleep(time.Second)
		if exit {
			break
		}
	}
	wg.Done()
}
func main() {
	wg.Add(1)
	go worker()
	time.Sleep(time.Second * 3) 
	exit &
### GolangContext 的使用教程 #### 创建和传递 `context.Context` `Context` 是 Go 语言中用于在 goroutine 之间传递请求范围的数据、取消信号和其他内容的标准方式。创建一个新的上下文通常通过调用 `context.Background()` 或者 `context.TODO()` 来实现[^1]。 当需要向现有上下文中添加截止时间、超时或者键值对的时候,可以利用如下函数: - `WithCancel`: 返回带有取消功能的新子上下文; - `WithValue`: 向父级上下文中加入键值对; - `WithDeadline`: 设置绝对结束期限; - `WithTimeout`: 基于当前时间设置相对过期时间; ```go ctx, cancel := context.WithTimeout(context.Background(), time.Second*5) defer cancel() ``` 上述代码片段展示了如何基于背景上下文创建一个具有五秒超时期限的新上下文实例,并立即安排其释放资源的操作[^2]。 #### 取消操作与监听取消事件 为了能够响应取消指令,在启动新的 Goroutines 执行任务之前应该总是先获取到对应的上下文对象以及它的取消方法。一旦不再需要该协程继续运行,则应尽早调用此取消回调来通知其他依赖于此上下文的任务停止工作并清理现场[^3]。 ```go select { case <-time.After(1 * time.Minute): fmt.Println("Operation completed.") case <-ctx.Done(): fmt.Printf("Operation was cancelled or timed out: %v\n", ctx.Err()) } ``` 这段程序会等待一分钟完成某项耗时较长的工作,但如果在此之前关联的上下文被标记为已完成(无论是因为达到了设定的时间限制还是显式地触发了取消),它就会提前退出循环体执行后续逻辑处理[^4]。 #### 错误处理模式 对于由 `Done()` 方法返回通道所携带的信息而言,一般情况下只会有三种可能的结果——正常关闭、由于超时而终止或者是收到外部发出的手动取消命令。因此可以通过检查错误的具体类型来进行相应的异常恢复措施[^5]。 ```go if err != nil && errors.Is(err, context.Canceled) { log.Fatal("Request canceled by the user") } else if err != nil && errors.Is(err, context.DeadlineExceeded){ log.Fatal("Request processing took too long and has been terminated") } ``` 以上示例演示了怎样区分不同类型的取消原因以便采取恰当的动作回应这些状况的发生[^6]。 #### 实际应用场景举例 考虑这样一个场景:构建 RESTful API 接口服务端应用时经常遇到并发请求的情况,此时就可以借助 `net/http` 包内置的支持机制自动将 HTTP 请求映射成合适的上下文结构供内部业务层组件消费使用[^7]。 ```go func handler(w http.ResponseWriter, r *http.Request) { // Extract context from incoming request. ctx := r.Context() select { case <-time.After(time.Duration(rand.Intn(5)) * time.Second): w.WriteHeader(http.StatusOK) _, _ = io.WriteString(w, "Hello!\n") case <-ctx.Done(): w.WriteHeader(http.StatusServiceUnavailable) _, _ = io.WriteString(w, "Sorry, can't serve your request now.\n") } } ``` 这里定义了一个简单的HTTP处理器函数,它会在随机延迟一段时间之后给客户端发送问候消息,不过如果期间收到了来自上游服务器转发过来的中断指示则改为告知对方暂时无法提供服务[^8]。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值