Il flusso di scrittura resta esplicito.

Definisci le mutazioni come metodi del provider, monitora lo stato con MutationToken ed eseguili tramite ref.invoke(call).

Apri API Reference Leggi i Providers

Blocchi di costruzione delle mutazioni

Una mutazione è un Call<R, State> restituito da 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)

Nota

A differenza delle API in stile notifier.method(), miniriverpod rende l'esecuzione della mutazione un call object di prima classe.

Esegui una mutazione

Usa ref.invoke in modo che i comportamenti di annullamento e drop siano visibili al chiamante.

Esegui

Opzioni di concorrenza

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.

Esempio: aggiornamento ottimistico + restart

Un pattern di scrittura comune aggiorna AsyncData in modo ottimistico, poi si sincronizza con la risposta del server.

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 può lanciare CancelledMutation ai chiamanti più vecchi.

dropLatest può lanciare DroppedMutation mentre è occupato.

Catturali nella UI quando vuoi sopprimere gli errori di annullamento temporanei.

Prossimi passi

Flutter API

Collega lo stato della mutazione alla UI con ConsumerWidget o ConsumerStatefulWidget.

Apri Flutter API

API Reference

Rivedi rapidamente i tipi invoke, mutation, mutate e MutationState.

Apri API Reference