如何在Golang中实现模板与钩子方法_Golang模板方法模式流程示例

模板方法模式在Go中需用接口+结构体组合模拟,通过定义Processor接口和Workflow执行器实现流程控制,钩子方法参数应统一为共享state指针,避免嵌入具体类型导致方法集不匹配。

模板方法模式在 Go 中没有语言级支持,但能用组合+接口模拟

Go 没有抽象类、不能定义“仅声明不实现”的方法,所以 Template Method Pattern 必须靠接口 + 结构体嵌入 + 显式调用约定来实现。核心思路是:定义一个公共执行流程(如 Execute()),把可变步骤抽成接口方法,由具体类型实现。

用 interface 定义钩子方法,结构体嵌入实现统一流程

典型结构是声明一个 Processor 接口,包含 Setup()DoWork()TearDown() 等钩子;再写一个通用执行器结构体,持有该接口并按序调用——这就是“模板”。实际行为由传入的具体实现决定。

type Processor interface {
    Setup()
    DoWork()
    TearDown()
}

type Workflow struct {
    p Processor
}

func (w *Workflow) Execute() {
    w.p.Setup()
    w.p.DoWork()
    w.p.TearDown()
}

// 具体实现
type FileProcessor struct{}

func (f FileProcessor) Setup()   { fmt.Println("open file") }
func (f FileProcessor) DoWork()  { fmt.Println("parse content") }
func (f FileProcessor) TearDown() { fmt.Println("close file") }

// 使用
wf := &Workflow{p: FileProcessor{}}
wf.Execute()

钩子方法参数和返回值需提前对齐,否则无法复用模板

如果不同实现需要不同上下文(比如有的要传 *os.File,有的要传 context.Context),就不能直接用空接口或硬编码参数。常见做法是:

  • 让钩子方法接收一个共享的 state 结构体指针,各实现按需读写字段
  • 或者把参数提取到 Workflow 字段中,在 Execute() 前初始化
  • 避免在钩子中返回 error 后中断流程——除非你显式检查并处理,否则模板会继续执行后续步骤

例如,加一个 State 字段后,Setup() 可以初始化资源,DoWork() 直接用 w.state.Input,不用改签名。

注意嵌入结构体时方法集继承的陷阱

如果用匿名字段嵌入具体类型(如 struct{ FileProcessor })来“复用”钩子实现,要注意 Go 的方法集规则:只有**值类型嵌入**时,外部结构体才拥有其指针方法;而**指针嵌入**会导致方法集不被提升。更稳妥的方式是显式组合接口,而非嵌入具体类型。

容易踩的坑包括:

  • 误以为 struct{ FileProcessor } 能自动满足 Processor 接口——它不能,因为 FileProcessor 是值类型,其方法集只包含值接收者方法;若你定义的是指针接收者方法(如 func (f *FileProcessor) Setup()),那必须嵌入 *FileProcessor
  • Execute() 内部调用钩子时,传了错误的 receiver(比如用了值而非指针),导致状态未更新

最简、最可控的做法始终是:用接口字段 + 显式赋值,不依赖嵌入自动提升。