跨平台开发 / 系统课时

用 Repository 统一数据入口

用 Repository 统一数据入口

当页面既可能读网络、磁盘又可能命中内存缓存时,如果把这些判断散落在 Widget 或状态管理层,业务代码会很快失去边界。本课用一个可运行示例把数据来源决策收进 Repository,并让上层只依赖稳定的 getUser 接口。

学习目标

  • 理解 Repository 在界面层与具体数据源之间承担的职责
  • 实现“先缓存、再本地、最后网络”的统一读取策略
  • 知道哪些逻辑应该放进 Repository,哪些不应该

Repository 解决的核心问题

Repository 不是“再包一层 API”,而是数据访问边界。上层只表达“我要用户 42”,不关心数据来自 HTTP、本地数据库还是内存;Repository 负责选择来源、组合结果并隐藏切换细节。

Repository 统一网络、本地与缓存的数据读取路径

这种结构带来的直接收益是:网络库、SQLite 实现或缓存策略发生变化时,上层调用方式可以保持不变。Repository 对外暴露的是业务所需能力,而不是底层 SDK 的原始接口。

实现统一读取策略

下面示例使用纯 Dart 模拟三种数据源,策略是“内存优先、本地次之、远端兜底”。代码可直接保存为 main.dart 并运行。

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);
}

预期输出:

text
Local Alice
Remote User 2
Remote User 2

第三次读取虽然输出与第二次相同,但数据已经来自内存缓存,不会再次进入远端请求。真实项目中可通过日志、Mock 或网络调试工具验证调用次数。

保持对外接口稳定

Repository 的公开方法应尽量贴近业务动作,例如 getUser、saveDraft、refreshFeed。不要把 getFromSqlite、requestByDio 这类底层细节直接暴露给页面,否则上层仍然被具体实现绑住。

当需要“强制刷新”时,可以把意图显式放进接口,例如增加 forceRefresh 参数,或单独提供 refreshUser。不要让调用方自己组合“删缓存 → 请求网络 → 写本地”,因为这正是 Repository 应统一处理的职责。

Repository 不负责什么

Repository 适合处理数据来源选择、缓存回填、多个数据源的组合和必要的数据转换,但不应顺手承担界面状态或复杂业务流程。加载动画、按钮禁用、导航以及页面级错误提示仍应由上层负责。

当数据入口统一后,状态管理层只需要依赖 Repository 的稳定接口,测试时也能直接替换为 Fake Repository,而不必同时 Mock 网络、本地存储和缓存。

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

目录与阅读设置

阅读设置

17

记录一个想法

用 Repository 统一数据入口

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

登录哪都通