跨平台开发 / 系统课时

处理提交中的异步状态

处理提交中的异步状态

保存、删除这类操作和“加载页面数据”不同:用户点击后需要立刻看到进行中状态,完成后要区分成功与失败,同时还要阻止重复点击造成二次请求。本节用独立的 AsyncNotifier<void> 管理一次提交的生命周期,让按钮、进度反馈和错误提示都由同一份异步状态驱动。

学习目标

  • 用 AsyncValue 表达提交中的进行中、成功和失败状态。
  • 在 AsyncNotifier 内阻止重复提交,并把异常收敛为可观察状态。
  • 在界面层根据状态禁用按钮,只在真正完成一次提交时显示结果反馈。

提交状态为什么要单独管理

页面已经加载出的资料通常应该继续留在屏幕上,而保存动作只是一个短暂的命令状态。如果直接把整页数据替换成 AsyncLoading,用户点击“保存”后可能看到正文消失,只剩全屏加载。更稳妥的做法是让查询状态负责“显示什么”,让提交状态负责“当前能不能再次提交、刚才是否成功”。

AsyncNotifier<void> 很适合只关心操作结果、不需要额外返回业务数据的提交动作。初始状态是可用状态;开始保存时切到 AsyncLoading;请求结束后进入成功或错误状态。这类短暂、会随用户交互变化的异步状态正适合交给 AsyncNotifierProvider/AsyncNotifier 统一管理。

提交操作的异步状态转换

用 AsyncNotifier 封装提交动作

下面的 main.dart 可以直接放进已添加 flutter_riverpod 依赖的 Flutter 项目运行。示例用延迟模拟保存接口:非空名称保存成功,空名称抛出异常。Notifier 在请求开始前先检查 state.isLoading,因此加载期间再次调用 save 会直接返回。

dart
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'),
            ),
          ],
        ),
      ),
    );
  }
}

预期结果

text
初始:输入框内容为 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;这样“命令是否完成”和“页面展示的数据是什么”仍然保持清晰边界。

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

目录与阅读设置

阅读设置

17

记录一个想法

处理提交中的异步状态

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

登录哪都通