Tok pisanja ostaje eksplicitan.

Definišite mutacije kao metode provider-a, pratite stanje uz MutationToken i izvršavajte kroz ref.invoke(call).

Otvori API Reference Čitaj Providers

Gradivni blokovi mutacije

Mutacija je Call<R, State> koji se vraća 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)

Napomena

Za razliku od API-ja tipa notifier.method(), miniriverpod čini izvršavanje mutacije call objektom prve klase.

Izvrši mutaciju

Koristite ref.invoke tako da ponašanje otkazivanja i odbacivanja bude vidljivo pozivaocu.

Pokreni

Opcije konkurentnosti

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čko ažuriranje + restart

Uobičajen obrazac pisanja najpre optimistično ažurira AsyncData, a zatim se sinhronizuje sa odgovorom 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 može da baci CancelledMutation starijim pozivaocima.

dropLatest može da baci DroppedMutation dok je zauzet.

Uhvatite ih u UI-ju kada želite da potisnete prolazne greške otkazivanja.

Sledeći koraci

Flutter API

Povežite stanje mutacije sa UI-jem koristeći ConsumerWidget ili ConsumerStatefulWidget.

Otvori Flutter API

API Reference

Brzo pregledajte tipove invoke, mutation, mutate i MutationState.

Otvori API Reference