Kirjutusvoog jääb selgeks.

Määra mutatsioonid provideri meetoditeks, jälgi olekut MutationTokeniga ja käivita need ref.invoke(call) kaudu.

Ava API Reference Loe Providers

Mutatsioonide ehituskivid

Mutatsioon on Call<R, State>, mis tagastatakse 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)

Märge

Erinevalt notifier.method()-stiili API-dest muudab miniriverpod mutatsiooni täitmise esmaklassiliseks call objectiks.

Käivita mutatsioon

Kasuta ref.invoke'i, et tühistamise ja drop-i käitumine oleks kutsujale nähtav.

Käivita

Samaaegsuse valikud

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.

Näide: optimistlik uuendus + restart

Tavaline kirjutusmuster uuendab AsyncData optimistlikult ja sünkroonib seejärel serveri vastusega.

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 võib visata CancelledMutationi vanematele kutsujatele.
dropLatest võib visata DroppedMutationi, kui ollakse hõivatud.
Püüa need UI-s kinni, kui tahad ajutisi tühistamisvigu alla suruda.

Järgmised sammud

Flutter API

Seo mutatsiooni olek UI-ga ConsumerWidgeti või ConsumerStatefulWidgeti abil.

Ava Flutter API

API Reference

Vaata kiiresti tüüpe invoke, mutation, mutate ja MutationState.

Ava API Reference