Golang适配器模式详解与使用教程

学习Golang要努力，但是不要急！今天的这篇文章《Golang适配器模式实现与使用方法》将会介绍到等等知识点，如果你想深入学习Golang，可以关注我！我会持续更新相关文章的，希望对大家都能有所帮助！

Go适配器模式通过组合与接口转换实现，而非继承；适用于无法修改第三方/遗留代码但需匹配自定义接口的场景，核心是包装行为、转换接口形状。

Go 语言没有接口继承和类继承，所以适配器模式不是靠「让类实现某接口」来硬套，而是靠组合 + 接口转换来达成目标。核心在于：把一个已有类型的行为，包装成另一个接口所期望的形状。

什么时候该用 Adapter 而不是直接改原类型

常见于对接第三方库、遗留代码或标准库时——你无法修改对方源码，但又需要它符合你当前系统定义的接口。比如：

• 标准库的 http.ResponseWriter 不满足你自定义的 Writer 接口（比如多了 StatusCode() 方法）
• 某个 SDK 返回的 DBClient 只有 Exec() 和 Query()，而你的业务层依赖的是 DataStore 接口（含 BeginTx(), Close()）
• 测试中想把 *bytes.Buffer 当作实现了 io.ReadCloser 的对象用，但它没实现 Close()

最简适配器：嵌入 + 方法转发

这是最轻量、最 Go 风格的做法。不新增结构体字段，只通过嵌入已有类型，并补全缺失方法：

// 假设你有这个接口
type DataWriter interface {
	Write(data []byte) error
	Close() error
}

// 第三方类型（你不能改）
type LegacyWriter struct{}

func (l *LegacyWriter) Write(data []byte) error {
	// 实际写逻辑
	return nil
}

// 适配器：嵌入 + 补 Close
type LegacyWriterAdapter struct {
	*LegacyWriter
}

func (a *LegacyWriterAdapter) Close() error {
	// 可以是空实现、日志、资源清理等
	return nil
}

注意：*LegacyWriterAdapter 现在能赋值给 DataWriter 接口变量。这种写法干净、零分配、无中间层开销。

带状态的适配器：显式字段 + 组合

当适配逻辑需要额外状态（如缓存、配置、上下文），就不能只靠嵌入了。必须显式持有被适配对象，并手动实现所有接口方法：

type LoggingDBAdapter struct {
	db     *sql.DB
	logger *log.Logger
}

func (a *LoggingDBAdapter) Query(query string, args ...interface{}) ([]map[string]interface{}, error) {
	a.logger.Printf("QUERY: %s", query)
	// 转调 db.QueryContext 或其他逻辑
	return nil, nil
}

func (a *LoggingDBAdapter) Exec(query string, args ...interface{}) (int64, error) {
	a.logger.Printf("EXEC: %s", query)
	return 0, nil
}

关键点：

• 不要试图让 LoggingDBAdapter 嵌入 *sql.DB —— 它不是 DB，只是“用 DB 做事的代理”
• 方法名不必和原类型一致（Query vs QueryRow），只要满足目标接口签名即可
• 如果原类型方法返回值与目标接口不兼容（比如多一个 error），适配器里要处理掉或转换

容易踩的坑：空指针、循环引用、接口零值

适配器本质是包装，出错往往发生在初始化或调用链路中：

• 忘记初始化嵌入字段：ad := &LegacyWriterAdapter{} 中 LegacyWriter 是 nil，调 Write() panic
• 在适配器方法里误调自己（而非被包装对象），造成无限递归 —— 尤其在重名方法中
• 把适配器当成可导出类型到处传，结果接收方做了类型断言（v, ok := w.(*LegacyWriterAdapter)），这破坏了接口抽象，也限制复用
• 适配器内部缓存了旧状态（如连接、token），但没提供 Reset() 或 Refresh()，导致后续调用行为异常

真正难的从来不是“怎么写一个适配器”，而是判断“该不该在这里加一层适配”——多数时候，重构原接口或换用更小粒度的组合，比硬套模式更可持续。

以上就是本文的全部内容了，是否有顺利帮助你解决问题？若是能给你带来学习上的帮助，请大家多多支持golang学习网！更多关于Golang的相关知识，也可关注golang学习网公众号。