Tok pisanja ostane ekspliciten.

Mutacije definirajte kot metode providerja, stanje spremljajte z MutationToken in izvajajte prek ref.invoke(call).

Odpri API Reference Preberi Providers

Gradniki mutacije

Mutacija je Call<R, State>, vrnjen iz 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)

Opomba

Za razliko od API-jev tipa notifier.method() miniriverpod izvajanje mutacije naredi za prvovrstni call objekt.

Izvedi mutacijo

Uporabite ref.invoke, da bo vedenje preklica in zavrnitve vidno klicatelju.

Zaženi

Možnosti sočasnosti

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.

Primer: optimistična posodobitev + restart

Pogost zapisni vzorec najprej optimistično posodobi AsyncData, nato pa se sinhronizira z odgovorom strežnika.

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 lahko vrže CancelledMutation starejšim klicateljem.
dropLatest lahko vrže DroppedMutation, ko je zaseden.
Zajemite jih v UI, ko želite zatreti prehodne napake preklica.

Naslednji koraki

Flutter API

Stanje mutacije povežite z UI z uporabo ConsumerWidget ali ConsumerStatefulWidget.

Odpri Flutter API

API Reference

Na hitro preglejte tipe invoke, mutation, mutate in MutationState.

Odpri API Reference