跨平台开发 / 系统课时
用 Repository 统一数据入口
用 Repository 统一数据入口
当页面既可能读网络、磁盘又可能命中内存缓存时,如果把这些判断散落在 Widget 或状态管理层,业务代码会很快失去边界。本课用一个可运行示例把数据来源决策收进 Repository,并让上层只依赖稳定的 getUser 接口。
学习目标
- 理解 Repository 在界面层与具体数据源之间承担的职责
- 实现“先缓存、再本地、最后网络”的统一读取策略
- 知道哪些逻辑应该放进 Repository,哪些不应该
Repository 解决的核心问题
Repository 不是“再包一层 API”,而是数据访问边界。上层只表达“我要用户 42”,不关心数据来自 HTTP、本地数据库还是内存;Repository 负责选择来源、组合结果并隐藏切换细节。

这种结构带来的直接收益是:网络库、SQLite 实现或缓存策略发生变化时,上层调用方式可以保持不变。Repository 对外暴露的是业务所需能力,而不是底层 SDK 的原始接口。
实现统一读取策略
下面示例使用纯 Dart 模拟三种数据源,策略是“内存优先、本地次之、远端兜底”。代码可直接保存为 main.dart 并运行。
class User {
const User(this.id, this.name);
final int id;
final String name;
}
class MemoryCache {
final Map<int, User> _items = {};
User? read(int id) => _items[id];
void write(User user) => _items[user.id] = user;
}
class LocalDataSource {
final Map<int, User> _items = {
1: const User(1, 'Local Alice'),
};
Future<User?> read(int id) async => _items[id];
Future<void> write(User user) async {
_items[user.id] = user;
}
}
class RemoteDataSource {
Future<User> fetch(int id) async {
// 实际项目中这里通常调用 Dio、http 或生成的 API Client。
return User(id, 'Remote User $id');
}
}
class UserRepository {
UserRepository(this.cache, this.local, this.remote);
final MemoryCache cache;
final LocalDataSource local;
final RemoteDataSource remote;
Future<User> getUser(int id) async {
final cached = cache.read(id);
if (cached != null) {
return cached;
}
final localUser = await local.read(id);
if (localUser != null) {
cache.write(localUser);
return localUser;
}
final remoteUser = await remote.fetch(id);
// 远端成功后同步回填,后续读取无需再次请求网络。
await local.write(remoteUser);
cache.write(remoteUser);
return remoteUser;
}
}
Future<void> main() async {
final repository = UserRepository(
MemoryCache(),
LocalDataSource(),
RemoteDataSource(),
);
final first = await repository.getUser(1);
final second = await repository.getUser(2);
final third = await repository.getUser(2);
print(first.name);
print(second.name);
print(third.name);
}预期输出:
Local Alice
Remote User 2
Remote User 2第三次读取虽然输出与第二次相同,但数据已经来自内存缓存,不会再次进入远端请求。真实项目中可通过日志、Mock 或网络调试工具验证调用次数。
保持对外接口稳定
Repository 的公开方法应尽量贴近业务动作,例如 getUser、saveDraft、refreshFeed。不要把 getFromSqlite、requestByDio 这类底层细节直接暴露给页面,否则上层仍然被具体实现绑住。
当需要“强制刷新”时,可以把意图显式放进接口,例如增加 forceRefresh 参数,或单独提供 refreshUser。不要让调用方自己组合“删缓存 → 请求网络 → 写本地”,因为这正是 Repository 应统一处理的职责。
Repository 不负责什么
Repository 适合处理数据来源选择、缓存回填、多个数据源的组合和必要的数据转换,但不应顺手承担界面状态或复杂业务流程。加载动画、按钮禁用、导航以及页面级错误提示仍应由上层负责。
当数据入口统一后,状态管理层只需要依赖 Repository 的稳定接口,测试时也能直接替换为 Fake Repository,而不必同时 Mock 网络、本地存储和缓存。