跨平台开发 / 系统课时

通过构造参数注入外部依赖

通过构造参数注入外部依赖

业务对象如果在内部直接创建网络客户端、数据库或时间源,单元测试就会被真实环境牵制。构造参数注入把这些外部能力移到对象之外,使生产实现和测试实现可以通过同一接口替换。

学习目标

  • 理解直接创建外部依赖为什么会降低单元测试的稳定性
  • 能通过构造参数把业务逻辑与外部实现解耦
  • 能使用轻量 Fake 验证业务结果和依赖调用

把依赖创建移出业务对象

假设 UserService 需要从远程服务读取用户名。如果它在方法内部直接创建 HTTP 客户端,那么测试 greeting 时就不得不面对网络连接、服务地址、认证信息和远端数据状态。真正想验证的字符串拼接逻辑反而被大量无关条件包围。

更合适的边界是让业务对象只依赖一个描述所需能力的抽象,再由外部代码决定传入真实实现还是测试实现。

构造参数注入让业务对象与外部依赖实现解耦

构造注入还有一个直接收益:依赖关系会出现在构造函数签名中。创建 UserService 的代码必须明确提供 UserGateway,因此对象需要什么能力一目了然,不会隐藏在某个方法里的 new 调用中。

用接口和构造函数建立替换点

下面的测试文件定义了接口、业务对象和一个 Fake。Fake 不访问网络,只返回测试指定的数据,同时记录收到的用户 ID,从而验证业务对象是否正确调用了依赖。

dart
import 'package:test/test.dart';

abstract class UserGateway {
  Future<String> loadDisplayName(String userId);
}

class UserService {
  UserService(this._gateway);

  // 业务对象只认识抽象,不负责创建具体网络实现。
  final UserGateway _gateway;

  Future<String> greeting(String userId) async {
    final name = await _gateway.loadDisplayName(userId);
    return 'Hello, $name';
  }
}

class FakeUserGateway implements UserGateway {
  FakeUserGateway(this.name);

  final String name;
  String? requestedUserId;

  @override
  Future<String> loadDisplayName(String userId) async {
    // Fake 同时提供可控结果并记录协作参数。
    requestedUserId = userId;
    return name;
  }
}

void main() {
  test('greeting uses injected gateway', () async {
    final gateway = FakeUserGateway('Ada');
    final service = UserService(gateway);

    final result = await service.greeting('u-42');

    expect(result, 'Hello, Ada');
    expect(gateway.requestedUserId, 'u-42');
  });
}

将文件保存为 test/user_service_test.dart 后运行 dart test test/user_service_test.dart。预期输出末尾类似下面内容,其中 <TIME> 会随运行环境变化:

text
<TIME> +1: All tests passed!

这个测试没有启动服务器,也没有请求真实接口。UserService 的行为由输入和 Fake 的返回值完全控制,因此失败时可以优先检查业务逻辑,而不是先排查网络环境。

接口应该围绕业务需要设计

为了测试而给每个类都创建接口会增加无意义的抽象。真正值得隔离的通常是具有副作用、速度慢或结果不稳定的边界,例如网络请求、数据库、文件系统、系统时间和随机数。

接口也不必照搬第三方库的全部 API。UserService 只需要“根据用户 ID 获取显示名”,因此 UserGateway 只暴露这一项能力。接口越贴近业务需要,Fake 越容易编写,测试也越不容易因为底层 SDK 更换而大面积修改。

网络、存储和时间都可以采用同一思路

网络依赖可以注入 Gateway 或 API Client,存储依赖可以注入 Repository 或 Key-Value Store,时间依赖则可以注入时钟对象或返回当前时间的函数。共同原则是:业务对象负责使用能力,外部组装代码负责选择具体实现。

构造参数注入尤其适合“对象生命周期内依赖不会变化”的场景。它让生产代码显式表达依赖,让测试可以传入可控实现,并把真实网络、磁盘和系统时钟留在单元测试边界之外。

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

目录与阅读设置

阅读设置

17

记录一个想法

通过构造参数注入外部依赖

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

登录哪都通