Go / 系统课时

用接口隔离调用方与实现

用接口隔离调用方与实现

Go 接口适合放在“调用方需要什么能力”的位置,而不是为具体类型建立继承层次。调用方只依赖少量方法后,真实实现、内存假对象和后续替换实现都能通过同一入口接入,而且具体类型无需写任何 implements 声明。

学习目标

  • 定义职责单一的小接口,并让具体类型隐式满足它
  • 让业务代码依赖接口而不是具体实现
  • 用第二个实现验证接口确实降低了替换和测试成本

从调用方需要的能力定义接口

假设订单完成后需要发送通知。业务层真正需要的只有“发送一条消息”,因此接口只保留一个 Notify 方法,不暴露具体实现的配置字段或辅助方法。

下面是一个完整可运行示例:

go
package main

import "fmt"

type Notifier interface {
	Notify(user, message string) error
}

type ConsoleNotifier struct{}

func (ConsoleNotifier) Notify(user, message string) error {
	fmt.Printf("send to %s: %s\n", user, message)
	return nil
}

type MemoryNotifier struct {
	Messages []string
}

func (m *MemoryNotifier) Notify(user, message string) error {
	m.Messages = append(m.Messages, user+"="+message)
	return nil
}

type OrderService struct {
	notifier Notifier
}

func NewOrderService(n Notifier) *OrderService {
	return &OrderService{notifier: n}
}

func (s *OrderService) Complete(orderID, user string) error {
	if err := s.notifier.Notify(user, "order "+orderID+" paid"); err != nil {
		return err
	}
	return nil
}

var _ Notifier = ConsoleNotifier{}
var _ Notifier = (*MemoryNotifier)(nil)

func main() {
	prod := NewOrderService(ConsoleNotifier{})
	_ = prod.Complete("ORD-42", "lin")

	fake := &MemoryNotifier{}
	testSvc := NewOrderService(fake)
	_ = testSvc.Complete("ORD-99", "test-user")
	fmt.Println(fake.Messages)
}

预期输出:

text
send to lin: order ORD-42 paid
[test-user=order ORD-99 paid]

OrderService 没有导入或保存 ConsoleNotifier,只保存 Notifier。因此生产代码可以传控制台实现,测试代码可以传 MemoryNotifier,业务方法本身无需修改。

接口满足是隐式发生的

Go 不要求类型声明“实现了哪个接口”。只要方法集完整匹配,类型就满足接口。示例里 ConsoleNotifier 的 Notify 是值接收者,所以 ConsoleNotifier 和 *ConsoleNotifier 都能满足 Notifier;MemoryNotifier 的方法使用指针接收者,因此是 *MemoryNotifier 满足接口。

两条编译期断言把这种关系写死在代码里:

  • var _ Notifier = ConsoleNotifier{} 检查值类型是否满足接口。
  • var _ Notifier = (*MemoryNotifier)(nil) 检查指针类型是否满足接口。

如果把 Notify 的参数从 message string 改成 message []byte,而接口仍要求 string,断言所在行会直接编译失败,问题不会拖到运行期。

用依赖注入隔离调用方

把接口作为构造函数参数,是 Go 中常见且足够轻量的依赖注入方式。调用关系可以拆成“业务代码依赖能力,外部负责选择实现”,这样 OrderService 不需要知道通知最终写到终端、HTTP API 还是消息队列。

调用方通过小接口连接不同实现

这种结构最适合边界依赖,例如存储、通知、时间、随机数、外部 HTTP 客户端。若业务代码直接在 Complete 内创建 ConsoleNotifier{},测试时就无法替换它;把选择实现的动作移到 main 或构造函数后,调用方只保留真正需要的能力。

控制接口大小与放置位置

接口越大,实现成本越高,也越容易把调用方绑到不需要的能力上。若 OrderService 只发送通知,就不要把 Close、HealthCheck、Metrics 等方法一起塞进 Notifier。一个只含 1~3 个方法的消费方接口,通常更容易替换和测试。

接口通常定义在使用它的包附近,而不是实现类型所在的包。这样接口描述的是调用方契约,而不是实现方自我声明。标准库中的 io.Reader 只有 Read(p []byte) (n int, err error) 一个方法,就是“小接口”最典型的形式。

还要注意 typed nil:当一个 *MemoryNotifier 为 nil 后再赋给 Notifier,接口值本身可能不等于 nil,因为它仍保存动态类型 *MemoryNotifier。如果 Notify 内部访问字段,就可能 panic。构造服务时应传入真实可用的实现,而不是把带动态类型的 nil 指针当作“没有依赖”。

当调用方只依赖自己真正使用的方法,并由外部注入具体实现时,替换实现、编写测试和控制包依赖都会直接变简单;接口的价值来自这个依赖边界,而不是接口数量本身。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

用接口隔离调用方与实现

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通