工作流定义
学习如何定义工作流函数,理解工作流接口和类型。
核心概念
工作流是一个接收 workflow.Context 的函数, 它定义了整个业务流程的逻辑。工作流必须是确定性的,即相同的输入总是产生相同的输出。
工作流函数签名
工作流函数必须接收一个 workflow.Context 参数, 可以有零个或多个输入参数,并返回一个结果(或错误)。
workflow.goGo
package main
import (
"time"
"go.temporal.io/sdk/workflow"
)
// SimpleWorkflow 简单的工作流示例
func SimpleWorkflow(ctx workflow.Context, name string) (string, error) {
// 工作流逻辑
return "Hello, " + name + "!", nil
}
// WorkflowWithInput 带有多个参数的工作流
func WorkflowWithInput(
ctx workflow.Context,
firstName string,
lastName string,
age int,
) (string, error) {
// 处理多个参数
return fmt.Sprintf("Name: %s %s, Age: %d", firstName, lastName, age), nil
}
工作流接口定义(推荐)
推荐使用接口定义工作流,这样可以提供类型安全和更好的开发体验。
interfaces.go
package main
// GreetingWorkflow 工作流接口
type GreetingWorkflow interface {
// Greet 工作流方法
Greet(name string) (string, error)
}
// OrderWorkflow 订单处理工作流接口
type OrderWorkflow interface {
// ProcessOrder 处理订单
ProcessOrder(order Order) (OrderResult, error)
}
工作流上下文
工作流上下文提供了访问工作流功能的 API,包括日志、心跳、计时器等。
workflow_with_context.go
package main
import (
"time"
"go.temporal.io/sdk/workflow"
)
func WorkflowWithFeatures(ctx workflow.Context, name string) (string, error) {
// 获取日志记录器
logger := workflow.GetLogger(ctx)
logger.Info("Workflow started", "name", name)
// 使用计时器延迟执行
workflow.Sleep(ctx, 10*time.Second)
// 获取当前时间
now := workflow.Now(ctx)
logger.Info("Current time", "time", now)
// 检查工作流是否被取消
if workflow.IsCanceled(ctx) {
return "", workflow.NewCanceledError()
}
return "Hello, " + name + "!", nil
}
工作流确定性的要求
使用 Temporal 提供的 API
使用 workflow.Sleep() 而不是 time.Sleep()
避免使用外部系统时间
使用 workflow.Now() 而不是 time.Now()
避免随机数生成
不在工作流中使用 rand.Random(),通过活动生成
避免全局变量
不依赖可变的全局状态
工作流类型
简单工作流
接收输入,返回结果,不涉及复杂的流程控制。
顺序工作流
按顺序执行一系列活动,每个活动完成后执行下一个。
并行工作流
同时执行多个活动,并等待所有活动完成。
复杂工作流
包含条件判断、循环、子工作流等复杂逻辑。
最佳实践
1. 使用接口定义工作流
提供类型安全和更好的 IDE 支持。
2. 保持工作流简单
将业务逻辑放在活动中,工作流专注于编排。
3. 添加日志记录
使用工作流日志记录重要事件,便于调试。
4. 处理错误
正确处理活动和工作流错误,实现重试和补偿逻辑。
下一步
版权与许可:Temporal 官方文档及其中文译文项目采用 MIT License;保留原作者声明,详见许可证。