Kirjoitusvirta pysyy eksplisiittisenä.

Määritä mutaatiot provider-menetelminä, seuraa tilaa MutationTokenilla ja suorita ne ref.invoke(call) -kutsulla.

Avaa API Reference Lue Providers

Mutaation rakennuspalikat

Mutaatio on Call<R, State>, joka palautetaan 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)

Huomautus

Toisin kuin notifier.method()-tyyliset API:t, miniriverpod tekee mutation suorittamisesta ensiluokkaisen call objectin.

Suorita mutaatio

Käytä ref.invokea, jotta peruutus- ja drop-käyttäytyminen näkyvät kutsujalle.

Suorita

Rinnakkaisuusasetukset

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.

Esimerkki: optimistinen päivitys + restart

Tavallinen kirjoitusmalli päivittää AsyncDataa optimistisesti ja synkronoi sitten palvelimen vastauksen kanssa.

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 voi heittää CancelledMutationin vanhemmille kutsujille.

dropLatest voi heittää DroppedMutationin, kun ollaan varattuna.

Sieppaa ne UI:ssa, kun haluat vaimentaa tilapäiset peruutusvirheet.

Seuraavat askeleet

Flutter API

Sido mutation tila UI:hin ConsumerWidgetillä tai ConsumerStatefulWidgetillä.

Avaa Flutter API

API Reference

Käy nopeasti läpi invoke, mutation, mutate ja MutationState -tyypit.

Avaa API Reference