Az írási folyamat továbbra is explicit.

Definiáld a mutációkat provider metódusokként, kövesd az állapotot MutationTokennel, és futtasd őket a ref.invoke(call) segítségével.

API Reference megnyitása Providers olvasása

Mutációs építőelemek

Egy mutáció egy Call<R, State>, amely a mutate(token, body, concurrency: ...) függvényből jön vissza.

Token

late final renameMut = mutation<void>(#rename)

Execution

await ref.invoke(provider.rename(...))

State

Idle / Pending / Success / Error via ref.watch(token)

Megjegyzés

A notifier.method()-szerű API-kkal szemben a miniriverpod a mutáció végrehajtását első osztályú call objectté teszi.

Mutáció futtatása

Használd a ref.invoke-ot, hogy a megszakítás és a drop viselkedés látható legyen a hívó számára.

Futtatás

Konkurencia opciók

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.

Példa: optimista frissítés + restart

Egy gyakori írási minta optimistikusan frissíti az AsyncData-t, majd szinkronizál a szerver válaszával.

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,
  );
}
A restart CancelledMutationt dobhat a régebbi hívóknak.
A dropLatest DroppedMutationt dobhat, miközben foglalt.
Kapd el őket a UI-ban, ha a átmeneti megszakítási hibákat el akarod nyomni.

Következő lépések

Flutter API

Kösd össze a mutáció állapotát a UI-val ConsumerWidget vagy ConsumerStatefulWidget segítségével.

Flutter API megnyitása

API Reference

Tekintsd át gyorsan az invoke, mutation, mutate és MutationState típusokat.

API Reference megnyitása