跨平台开发 / 系统课时
用 refresh 重新获取当前数据
用 refresh 重新获取当前数据
用户点击刷新按钮、页面重新进入或业务操作完成后,应用经常需要立即获取最新数据。Riverpod 提供的 refresh 可以主动重新执行 Provider,并直接返回新的状态结果。
学习目标
- 理解 refresh 与 invalidate 的执行时机差异
- 掌握使用 refresh 实现主动刷新
- 了解 refresh 在异步 Provider 中的返回行为
refresh 的工作方式
refresh 会先让目标 Provider 失效,然后立即重新创建该 Provider 的状态。因此它与 invalidate 最大的区别是执行时机:
invalidate等待下一次读取。refresh当前调用位置立即触发重新计算。
当界面中存在明确的刷新动作,例如下拉刷新、点击重试按钮、提交表单后更新列表,refresh 通常更符合用户预期。
使用 refresh 重新加载数据
下面示例展示在按钮点击时重新请求远程数据。refresh 返回新的 Provider 状态,可以继续等待异步结果。
dart
import 'package:flutter_riverpod/flutter_riverpod.dart';
final profileProvider = FutureProvider<Map<String, String>>((ref) async {
// 实际项目中这里通常请求 HTTP 接口
return {'name': 'Alice', 'level': '3'};
});
Future<void> reloadProfile(WidgetRef ref) async {
// 立即重新执行 profileProvider
final result = await ref.refresh(profileProvider.future);
print(result['name']);
}预期输出
text
Alice在界面交互中使用 refresh
常见刷新流程是:用户触发操作,调用 refresh,界面等待新的 AsyncValue 状态,然后根据 loading、data 或 error 展示不同内容。
例如列表页中,刷新按钮只需要负责触发重新加载,不需要自己维护一个 loading 标记,因为 Provider 本身已经包含异步状态。
dart
ref.refresh(usersProvider);预期结果
text
usersProvider 立即重新执行。
界面监听到新的 AsyncValue 后更新显示状态。refresh 的使用边界
refresh 适合主动刷新,不适合替代正常状态管理。如果每次页面构建都调用 refresh,会造成重复请求和性能问题。
对于写操作后的数据同步,需要根据场景选择:
| 场景 | 推荐方式 |
|---|---|
| 用户点击刷新按钮 | refresh |
| 后台数据变化,等待下次访问更新 | invalidate |
| 本地状态直接修改 | 更新对应 Notifier 状态 |
理解 refresh 的关键是把它看成一次主动重新计算请求,而不是简单清空缓存。它解决的是“现在就需要最新结果”的问题。
按自己的节奏,确认真正理解。