Prúd zápisu zostáva explicitný.

Definujte mutácie ako metódy providerov, sledujte stav pomocou MutationToken a vykonávajte cez ref.invoke(call).

Otvoriť API Reference Čítať Providers

Stavebné bloky mutácie

Mutácia je Call<R, State> vrátený z 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)

Poznámka

Na rozdiel od API typu notifier.method() miniriverpod robí z vykonania mutácie objekt call prvej triedy.

Vykonajte mutáciu

Používajte ref.invoke, aby bolo správanie zrušenia a odhodenia viditeľné pre volajúceho.

Spustiť

Možnosti konkurencie

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.

Príklad: optimistická aktualizácia + restart

Bežný zápisový vzor najprv optimisticky aktualizuje AsyncData a potom sa zosynchronizuje s odpoveďou servera.

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 môže vyhodiť CancelledMutation starším volajúcim.

dropLatest môže vyhodiť DroppedMutation, keď je zaneprázdnený.

Zachyťte ich v UI, keď chcete potlačiť prechodné chyby zrušenia.

Ďalšie kroky

Flutter API

Prepojte stav mutácie s UI pomocou ConsumerWidget alebo ConsumerStatefulWidget.

Otvoriť Flutter API

API Reference

Rýchlo si prejdite typy invoke, mutation, mutate a MutationState.

Otvoriť API Reference