Паток запісу застаецца відавочным.

Вызначайце мутацыі як метады provider, адсочвайце стан праз MutationToken і запускайце праз ref.invoke(call).

Адкрыць API Reference Чытаць Providers

Асновы мутацый

Мутацыя — гэта Call<R, State>, які вяртаецца з mutate(token, body, concurrency: ...).

Token

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

Выканаўца

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

Стан

Idle / Pending / Success / Error праз ref.watch(token)

Нататка

У адрозненне ад API ў стылі notifier.method(), miniriverpod робіць выкананне мутацыі першакласным аб'ектам выкліку.

Выканаць мутацыю

Выкарыстоўвайце ref.invoke, каб адмены і drop-паводзіны былі бачныя выклікачу.

Запусціць

Варыянты паралельнасці

concurrent : запускаць усе выклікі паралельна (па змаўчанні).
queue      : FIFO; працягваць выконваць пастаўленыя ў чаргу выклікі нават пасля памылкі.
restart    : адмяніць папярэдні запуск, пакінуць толькі апошні выклік.
dropLatest : адхіляць новыя выклікі, пакуль адзін выконваецца.

Прыклад: аптымісцнае абнаўленне + 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