Потік запису залишається явним.

Визначайте мутації як методи provider, відстежуйте стан за допомогою MutationToken і виконуйте через ref.invoke(call).

Відкрити API Reference Читати Providers

Будівельні блоки мутації

Мутація — це Call<R, State>, що повертається з mutate(token, body, concurrency: ...).

Token

late final renameMut = mutation<void>(#rename)

Execution

await ref.invoke(provider.rename(...))

State

Idle / Pending / Success / Error via ref.watch(token)

注意

На відміну від API на кшталт notifier.method(), miniriverpod робить виконання мутації першокласним call-об'єктом.

Виконати мутацію

Використовуйте ref.invoke, щоб поведінка скасування та відкидання була видима викликачу.

Запустити

Параметри конкурентності

concurrent : run all calls in parallel (default).
queue      : FIFO; keep running queued calls even after an error.
restart    : cancel previous run, keep only latest call.
dropLatest : drop incoming calls while one is running.

Приклад: оптимістичне оновлення + restart

Типовий шаблон запису спочатку оптимістично оновлює AsyncData, а потім синхронізується з відповіддю сервера.

class UserProvider extends AsyncProvider<User?> {
  UserProvider() : super.args(null);

  late final renameMut = mutation<void>(#rename);

  Call<void, AsyncValue<User?>> rename(String newName) => mutate(
    renameMut,
    (ref) async {
      final cur = ref.watch(this).valueOrNull;
      ref.state = AsyncData((cur ?? const User()).copyWith(name: newName), isRefreshing: true);

      final api = ref.watch(apiProvider);
      await api.rename(newName);
      ref.state = AsyncData(await api.me());
    },
    concurrency: Concurrency.restart,
  );
}
restart може кинути CancelledMutation старішим викликачам.
dropLatest може кинути DroppedMutation, коли зайнято.
Ловіть їх у UI, коли хочете придушити тимчасові помилки скасування.

Наступні кроки

Flutter API

Зв'яжіть стан мутації з UI за допомогою ConsumerWidget або ConsumerStatefulWidget.

Відкрити Flutter API

API Reference

Швидко перегляньте типи invoke, mutation, mutate та MutationState.

Відкрити API Reference