跨平台开发 / 系统课时

让 Notifier 调用 Repository

让 Notifier 调用 Repository

当页面既负责发请求又负责修改加载状态时,数据访问和状态转换很快会混在一起。更清晰的做法是让 Repository 负责取数和写数据,让 Notifier 调用 Repository,并把结果转换成 Riverpod 状态供 UI 订阅。

学习目标

  • 划分 Repository 与 Notifier 的职责边界
  • 在 AsyncNotifier 中通过 ref 取得 Repository
  • 正确处理加载、成功和失败状态

把数据访问和状态转换分开

Repository 回答“数据怎样取得或保存”,Notifier 回答“这次业务操作应该怎样改变界面状态”。例如新增待办事项时,Repository 负责保存数据,Notifier 则负责进入加载状态、调用 Repository,再把最新列表写回 state。

Notifier 调用 Repository 并更新 AsyncValue 状态的流程

AsyncNotifier 很适合表示需要异步初始化并继续执行写操作的状态。下面的完整示例用一个内存 Repository 模拟数据源,并通过 AsyncNotifierProvider 暴露状态。

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

class TodoRepository {
  final List<String> _items = ['Read Riverpod docs'];

  Future<List<String>> fetchTodos() async {
    return List.unmodifiable(_items);
  }

  Future<List<String>> addTodo(String title) async {
    _items.add(title);
    return List.unmodifiable(_items);
  }
}

final todoRepositoryProvider = Provider<TodoRepository>((ref) {
  return TodoRepository();
});

class TodoNotifier extends AsyncNotifier<List<String>> {
  TodoRepository get _repository => ref.read(todoRepositoryProvider);

  @override
  Future<List<String>> build() {
    return _repository.fetchTodos();
  }

  Future<void> addTodo(String title) async {
    state = const AsyncLoading();

    state = await AsyncValue.guard(() async {
      return _repository.addTodo(title);
    });
  }
}

final todoProvider =
    AsyncNotifierProvider<TodoNotifier, List<String>>(TodoNotifier.new);

Future<void> main() async {
  final container = ProviderContainer();

  print(await container.read(todoProvider.future));

  await container.read(todoProvider.notifier).addTodo('Write tests');
  print(await container.read(todoProvider.future));

  container.dispose();
}

预期输出

text
[Read Riverpod docs]
[Read Riverpod docs, Write tests]

build() 负责生成初始状态,因此它调用 fetchTodos()。业务操作 addTodo() 则先把状态切换为 AsyncLoading,再调用 Repository。AsyncValue.guard 会把成功结果包装成 AsyncData,异常则转换成 AsyncError,避免手写重复的 try/catch 状态赋值。

为什么 Notifier 不应该直接访问客户端

如果 TodoNotifier 直接调用 HTTP 客户端,它就会同时知道请求路径、响应结构、错误转换和界面状态。之后数据源改成数据库或加入缓存时,Notifier 也必须跟着修改,职责会不断膨胀。

把这些细节留在 Repository 后,Notifier 只依赖诸如 fetchTodos()、addTodo() 这样的业务数据接口。它更关心一次操作何时开始、得到什么结果,以及结果应该怎样进入状态。

read 与 watch 怎么选

Notifier 中取得 Repository 时常见的是 ref.read(todoRepositoryProvider):执行一次业务方法时只需要拿到当前 Repository,不需要因为读取动作本身建立持续监听。

如果 Notifier 的 build() 结果确实依赖一个可能变化的 Provider,例如当前账户或运行环境,则可以在 build() 中使用 ref.watch(...) 建立响应式依赖。是否使用 watch 应由“依赖变化后是否需要重新计算状态”决定,而不是机械地统一写法。

UI 只负责触发和渲染

页面订阅 todoProvider 后,只需要根据 AsyncValue 渲染加载、数据和错误状态;用户点击按钮时调用 ref.read(todoProvider.notifier).addTodo(...)。这样 UI 不处理数据访问,Repository 不管理界面状态,Notifier 则成为两者之间明确的业务状态边界。

当后续增加刷新、删除或重试操作时,也应继续沿用这个方向:Repository 提供稳定的数据能力,Notifier 编排操作并更新状态,UI 只观察状态与发送用户意图。

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

目录与阅读设置

阅读设置

17

记录一个想法

让 Notifier 调用 Repository

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

登录哪都通