跨平台开发 / 系统课时
让 Notifier 调用 Repository
让 Notifier 调用 Repository
当页面既负责发请求又负责修改加载状态时,数据访问和状态转换很快会混在一起。更清晰的做法是让 Repository 负责取数和写数据,让 Notifier 调用 Repository,并把结果转换成 Riverpod 状态供 UI 订阅。
学习目标
- 划分 Repository 与 Notifier 的职责边界
- 在 AsyncNotifier 中通过 ref 取得 Repository
- 正确处理加载、成功和失败状态
把数据访问和状态转换分开
Repository 回答“数据怎样取得或保存”,Notifier 回答“这次业务操作应该怎样改变界面状态”。例如新增待办事项时,Repository 负责保存数据,Notifier 则负责进入加载状态、调用 Repository,再把最新列表写回 state。

AsyncNotifier 很适合表示需要异步初始化并继续执行写操作的状态。下面的完整示例用一个内存 Repository 模拟数据源,并通过 AsyncNotifierProvider 暴露状态。
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();
}预期输出
[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 只观察状态与发送用户意图。