Потокът на запис остава явен.

Дефинирайте мутациите като provider методи, следете състоянието с MutationToken и ги изпълнявайте чрез ref.invoke(call).

Отвори API Reference Прочети провайдерите

Градивни елементи на мутацията

Мутацията е Call<R, State>, върнат от 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)

Бележка

За разлика от API-тата от типа notifier.method(), miniriverpod превръща изпълнението на мутацията в първокласен call object.

Изпълнете мутация

Използвайте ref.invoke, така че поведението при отказ и отхвърляне да е видимо за извикващия.

Изпълни

Опции за конкурентност

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.

Пример: оптимистично обновяване + restart

Често срещан модел на запис първо обновява AsyncData оптимистично, а после се синхронизира със сървърния отговор.

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 може да хвърли CancelledMutation към по-старите извикващи.

dropLatest може да хвърли DroppedMutation, докато е заето.

Хващайте ги в UI, когато искате да потиснете временните грешки при отказ.

Следващи стъпки

Flutter API

Свържете състоянието на мутацията с UI чрез ConsumerWidget или ConsumerStatefulWidget.

Отвори Flutter API

API Reference

Прегледайте бързо типовете invoke, mutation, mutate и MutationState.

Отвори API Reference