跨平台开发 / 系统课时
处理提交中的异步状态
处理提交中的异步状态
保存、删除这类操作和“加载页面数据”不同:用户点击后需要立刻看到进行中状态,完成后要区分成功与失败,同时还要阻止重复点击造成二次请求。本节用独立的 AsyncNotifier<void> 管理一次提交的生命周期,让按钮、进度反馈和错误提示都由同一份异步状态驱动。
学习目标
- 用
AsyncValue表达提交中的进行中、成功和失败状态。 - 在
AsyncNotifier内阻止重复提交,并把异常收敛为可观察状态。 - 在界面层根据状态禁用按钮,只在真正完成一次提交时显示结果反馈。
提交状态为什么要单独管理
页面已经加载出的资料通常应该继续留在屏幕上,而保存动作只是一个短暂的命令状态。如果直接把整页数据替换成 AsyncLoading,用户点击“保存”后可能看到正文消失,只剩全屏加载。更稳妥的做法是让查询状态负责“显示什么”,让提交状态负责“当前能不能再次提交、刚才是否成功”。
AsyncNotifier<void> 很适合只关心操作结果、不需要额外返回业务数据的提交动作。初始状态是可用状态;开始保存时切到 AsyncLoading;请求结束后进入成功或错误状态。这类短暂、会随用户交互变化的异步状态正适合交给 AsyncNotifierProvider/AsyncNotifier 统一管理。

用 AsyncNotifier 封装提交动作
下面的 main.dart 可以直接放进已添加 flutter_riverpod 依赖的 Flutter 项目运行。示例用延迟模拟保存接口:非空名称保存成功,空名称抛出异常。Notifier 在请求开始前先检查 state.isLoading,因此加载期间再次调用 save 会直接返回。
import 'dart:async';
import 'package:flutter/material.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
void main() {
runApp(const ProviderScope(child: MyApp()));
}
final profileRepositoryProvider = Provider<ProfileRepository>((ref) {
return ProfileRepository();
});
class ProfileRepository {
Future<void> saveName(String name) async {
await Future<void>.delayed(const Duration(seconds: 1));
if (name.trim().isEmpty) {
throw StateError('Name cannot be empty');
}
}
}
final saveProfileProvider =
AsyncNotifierProvider<SaveProfileNotifier, void>(
SaveProfileNotifier.new,
);
class SaveProfileNotifier extends AsyncNotifier<void> {
@override
FutureOr<void> build() {}
Future<void> save(String name) async {
if (state.isLoading) {
return;
}
state = const AsyncLoading();
state = await AsyncValue.guard(
() => ref.read(profileRepositoryProvider).saveName(name),
);
}
}
class MyApp extends StatelessWidget {
const MyApp({super.key});
@override
Widget build(BuildContext context) {
return const MaterialApp(home: ProfilePage());
}
}
class ProfilePage extends ConsumerStatefulWidget {
const ProfilePage({super.key});
@override
ConsumerState<ProfilePage> createState() => _ProfilePageState();
}
class _ProfilePageState extends ConsumerState<ProfilePage> {
final _controller = TextEditingController(text: 'Ada');
@override
void dispose() {
_controller.dispose();
super.dispose();
}
@override
Widget build(BuildContext context) {
final submitState = ref.watch(saveProfileProvider);
ref.listen<AsyncValue<void>>(saveProfileProvider, (previous, next) {
if (previous?.isLoading == true && next.hasValue) {
ScaffoldMessenger.of(context).showSnackBar(
const SnackBar(content: Text('Saved')),
);
}
if (previous?.isLoading == true && next.hasError) {
ScaffoldMessenger.of(context).showSnackBar(
SnackBar(content: Text('${next.error}')),
);
}
});
return Scaffold(
appBar: AppBar(title: const Text('Profile')),
body: Padding(
padding: const EdgeInsets.all(16),
child: Column(
children: [
TextField(controller: _controller),
const SizedBox(height: 16),
ElevatedButton(
onPressed: submitState.isLoading
? null
: () => ref
.read(saveProfileProvider.notifier)
.save(_controller.text),
child: submitState.isLoading
? const SizedBox(
width: 18,
height: 18,
child: CircularProgressIndicator(strokeWidth: 2),
)
: const Text('Save'),
),
],
),
),
);
}
}预期结果
初始:输入框内容为 Ada,Save 按钮可点击。
点击 Save:按钮立即禁用并显示进度环。
约 1 秒后:出现 Saved 提示,按钮恢复可点击。
清空输入框后点击 Save:约 1 秒后出现 Bad state: Name cannot be empty。
加载期间即使再次触发 save,也不会发起第二次保存。只对完成后的状态做一次反馈
build() 完成后,Provider 本来就处于一个成功状态。如果界面只判断 next.hasValue,页面首次建立监听时就可能把“初始可用”误当成“刚刚保存成功”。示例额外要求 previous?.isLoading == true,只有从提交中离开时才弹成功或失败提示。
AsyncValue.guard 会把异步调用的正常完成转换成成功状态,把抛出的异常转换成错误状态,因此 Notifier 不需要在每个提交方法里重复写 try/catch。界面只负责把状态映射成禁用、进度和提示,业务调用仍集中在 Notifier 内。
哪些情况要再拆一层状态
如果保存成功后还要返回新建记录的 ID,可以把 AsyncNotifier<void> 改成对应的结果类型,例如 AsyncNotifier<String>。如果同一列表里每一行都能独立删除或保存,则单一全局提交状态会让所有按钮一起进入加载,此时应按记录 ID 建立参数化提交状态。
对于页面数据刷新,不要为了“显示保存中”而清空已有内容。提交成功后如果确实需要重新读取服务端数据,可以再失效对应的查询 Provider;这样“命令是否完成”和“页面展示的数据是什么”仍然保持清晰边界。