如何用Golang实现适配器模式_Golang 适配器模式实践

适配器模式用于解决接口不兼容问题,通过组合和接口实现转换。目标接口为客户端期望的Logger或SMSSender,被适配者如FileLogger、AliyunSMS有不同方法签名,适配器FileLoggerAdapter和AliyunSMSAdapter持有被适配者实例并实现目标接口,使旧组件或第三方服务适配新系统,无需修改原有代码,提升复用性与灵活性。

适配器模式用于解决接口不兼容的问题。在 Go 语言中,虽然没有继承的概念,但通过组合和接口可以非常自然地实现适配器模式。它的核心思想是:将一个类的接口转换成客户端期望的另一个接口,使原本不兼容的类可以一起工作。

适配器模式的基本结构

适配器模式通常包含三个角色:

  • 目标接口(Target):客户端期望使用的接口。
  • 被适配者(Adaptee):已有的接口,与目标接口不兼容。
  • 适配器(Adapter):实现目标接口,并持有被适配者的实例,负责调用适配者的方法并进行转换。

实际例子:日志系统适配

假设我们有一个旧的日志库,它提供的是 LogToFile(message string) 方法,但我们新写的系统期望使用统一的日志接口 Log(msg string)

先定义目标接口:

type Logger interface {
    Log(msg string)
}

这是已有的被适配者:

type FileLogger struct{}

func (fl *FileLogger) LogToFile(message string) {
    fmt.Println("写入文件:", message)
}

现在我们创建适配器,让它实现 Logger 接口:

type FileLoggerAdapter struct {
    fileLogger *FileLogger
}

func NewFileLoggerAdapter(fileLogger *FileLogger) *FileLoggerAdapter {
    return &FileLoggerAdapter{fileLogger: fileLogger}
}

func (a *FileLoggerAdapter) Log(msg string) {
    a.fileLogger.LogToFile(msg)
}

使用示例:

func main() {
    fileLogger := &FileLogger{}
    adapter := NewFileLoggerAdapter(fileLogger)

    var logger Logger = adapter
    logger.Log("这是一条日志")
    // 输出:写入文件: 这是一条日志
}

适配第三方服务API

适配器模式特别适合对接第三方服务。比如我们有两个短信服务商:阿里云和腾讯云,它们的发送方法签名不同。

定义统一的目标接口:

type SMSSender interface {
    Send(phone, message string) error
}

阿里云SDK提供的接口:

type AliyunSMS struct{}

func (a *AliyunSMS) SendTo(phone string, content string) bool {
    fmt.Printf("阿里云发送短信到 %s: %s\n", phone, content)
    return true
}


为阿里云创建适配器:

type AliyunSMSAdapter struct {
    client *AliyunSMS
}

func NewAliyunSMSAdapter(client *AliyunSMS) *AliyunSMSAdapter {
    return &AliyunSMSAdapter{client: client}
}

func (a *AliyunSMSAdapter) Send(phone, message string) error {
    success := a.client.SendTo(phone, message)
    if !success {
        return errors.New("阿里云发送失败")
    }
    return nil
}

这样上层代码就可以统一使用 SMSSender 接口,无需关心底层具体实现。

何时使用适配器模式

当你遇到以下情况时,适配器模式会很有帮助:

  • 集成老系统或第三方库,但接口不匹配。
  • 多个外部服务功能类似,但调用方式不同,希望统一调用入口。
  • 避免修改现有代码的前提下扩展功能。

Go 的接口是隐式实现的,不需要显式声明“implements”,这让适配器的编写更加轻量。只要适配器实现了目标接口的所有方法,就能当作该接口使用。

基本上就这些。适配器模式在 Go 中实现简单,关键是理解“转换接口”这一核心意图。通过组合已有对象并包装其行为,就能让不兼容的组件协同工作。不复杂但容易忽略。