跨平台开发 / 系统课时

设计可替换的数据层接口

设计可替换的数据层接口

本篇解决 Flutter 数据访问层难以测试和替换的问题,通过抽象接口隔离 Repository 与具体实现,让网络请求、本地缓存和测试环境可以使用不同的数据来源。

学习目标

  • 理解为什么数据层需要接口抽象,以及接口在项目维护中的作用
  • 掌握定义数据访问接口并实现真实版本与测试版本的方法
  • 能够根据业务变化替换数据实现而不修改上层业务代码

为什么需要可替换的数据层

在简单应用中,页面直接调用 HTTP 客户端获取数据看起来很方便,但随着功能增加,页面会逐渐依赖具体实现。例如页面依赖 Dio 请求接口,测试时就必须启动服务器或构造复杂网络环境。

数据层接口的作用是定义“需要什么能力”,而不是规定“如何实现”。Repository 只依赖接口,真实环境使用网络实现,测试环境使用内存实现或假数据实现。

这种设计可以降低模块之间的耦合,使数据获取策略可以独立变化。

定义数据访问接口

假设应用需要加载用户信息,可以先定义一个只描述能力的接口。

dart
abstract class UserDataSource {
  Future<Map<String, dynamic>> fetchUser(String id);
}

接口没有关心数据来自哪里,只要求实现类提供 fetchUser 方法。网络请求、本地数据库或测试数据都可以满足这个约定。

Repository 使用接口,而不是具体的数据源。

dart
class UserRepository {
  final UserDataSource dataSource;

  UserRepository(this.dataSource);

  Future<String> getUserName(String id) async {
    final json = await dataSource.fetchUser(id);
    return json['name'] as String;
  }
}

实现真实数据源

生产环境中可以创建基于 HTTP 客户端的数据源实现。下面示例省略具体 HTTP 配置,只展示接口替换关系。

dart
class ApiUserDataSource implements UserDataSource {
  @override
  Future<Map<String, dynamic>> fetchUser(String id) async {
    // 实际项目中这里调用 HTTP API 并解析响应
    return {
      'id': id,
      'name': 'Alice',
    };
  }
}

预期输出

text
Repository 可以通过 UserDataSource 获取用户名称,调用方不需要知道数据来源。

使用假实现进行替换

测试时不需要修改 Repository,只需要传入另一个实现。

dart
class FakeUserDataSource implements UserDataSource {
  @override
  Future<Map<String, dynamic>> fetchUser(String id) async {
    return {
      'id': id,
      'name': 'Test User',
    };
  }
}

void main() async {
  final repository = UserRepository(FakeUserDataSource());
  final name = await repository.getUserName('1');
  print(name);
}

预期输出

text
Test User

接口设计中的边界

数据层接口不应该暴露网络细节,例如 URL、HTTP 状态码处理或请求参数拼接逻辑。上层关注业务数据,底层负责数据获取细节。

当数据来源发生变化,例如从 REST API 切换到本地缓存,或者增加离线模式时,只需要新增实现类并调整依赖注入配置,而不需要重写页面逻辑。

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

目录与阅读设置

阅读设置

17

记录一个想法

设计可替换的数据层接口

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

登录哪都通