本文介绍在函数计算中使用Go运行时开发代码时,所涉及的Context(上下文)的相关概念和使用示例。
什么是上下文
当函数计算运行您的函数时,它会将上下文对象(context.Context
)传递到执行方法中。该对象包含有关调用、服务、函数、链路追踪和执行环境等信息。
事件请求处理程序(Event Handler)和HTTP请求处理程序(HTTP Handler)都支持上下文对象作为传入参数,且格式和内容相同。上下文对象主要提供了以下参数。
字段 | 说明 |
变量 | |
RequestID | 本次调用请求的唯一ID。您可以记录该ID,当函数调用出现问题时方便查询。 |
Credentials | 函数计算服务通过扮演服务角色而获取的一组临时密钥,其有效时间是36小时。您可以在代码中使用 |
Function | 当前调用的函数的一些基本信息,例如函数名、函数入口、函数内存和超时时间。 |
Service | 当前调用的函数所在的服务信息,包含服务名称、接入的日志服务SLS的Project和Logstore信息,以及服务的版本和别名信息。其中qualifier 表示调用函数时指定的服务版本或别名,version_id 表示实际调用的服务版本。 |
Region | 当前调用的函数所在地域ID,例如在华东2(上海)地域调用,则地域ID为cn-shanghai。详细信息,请参见服务接入地址。 |
AccountId | 函数所属的阿里云账号ID(主账号ID)。 |
方法 | |
deadline | 返回函数执行的超时时间,格式为Unix时间戳,单位:毫秒。 |
完整的数据结构,请参见context.go。
使用示例
示例一:打印Context信息
首先,函数的handler
需要包含context
参数,函数计算会把Context信息中的变量信息插入到context
的取值中。然后,需要import aliyun/fc-runtime-go-sdk/fccontext
,通过fccontext.FromContext
方法获取fccontext
。
package main
import (
"context"
"encoding/json"
"log"
"github.com/aliyun/fc-runtime-go-sdk/fc"
"github.com/aliyun/fc-runtime-go-sdk/fccontext"
)
func main() {
fc.Start(echoContext)
}
func echoContext(ctx context.Context) (string, error) {
fctx, _ := fccontext.FromContext(ctx)
log.Println(fctx.AccountId)
log.Printf("%#v\n", fctx)
res, _ := json.Marshal(fctx)
return string(res), nil
}
示例二:获取函数剩余执行时间
以下示例展示了如何使用deadline
获取函数剩余执行时间。
package main
import (
"context"
"fmt"
"log"
"time"
"github.com/aliyun/fc-runtime-go-sdk/fc"
)
func LongRunningHandler(ctx context.Context) (string, error) {
deadline, _ := ctx.Deadline()
fmt.Printf("now: %s\ndeadline: %s\n", time.Now().String(), deadline.String())
deadline = deadline.Add(-100 * time.Millisecond)
timeoutChannel := time.After(time.Until(deadline))
for {
select {
case <-timeoutChannel:
return "Finished before timing out.", nil
default:
log.Print("hello!")
time.Sleep(50 * time.Millisecond)
}
}
}
func main() {
fc.Start(LongRunningHandler)
}
文档内容是否对您有帮助?