跨平台开发 / 系统课时
设计可替换的数据层接口
设计可替换的数据层接口
本篇解决 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 切换到本地缓存,或者增加离线模式时,只需要新增实现类并调整依赖注入配置,而不需要重写页面逻辑。
按自己的节奏,确认真正理解。