Գրելու հոսքը մնում է հստակ.

Սահմանեք mutation-ները որպես provider մեթոդներ, հետևեք վիճակին MutationToken-ով և գործարկեք դրանք ref.invoke(call)-ով.

Mutation-ների կառուցողական մասերը

Mutation-ը 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)

Նշում

notifier.method()-տիպի API-ներից տարբերվելով՝ miniriverpod-ը mutation-ի կատարումը դարձնում է առաջին կարգի call object.

Գործարկել mutation

Օգտագործեք ref.invoke, որպեսզի չեղարկման և drop-ի վարքը տեսանելի լինի կանչողին.

Գործարկել

Concurrency ընտրանքներ

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.

Օրինակ՝ optimistic թարմացում + restart

Գրելու տարածված օրինակը AsyncData-ն optimistically թարմացնում է, ապա սինքրոնացվում է 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-ը կարող է CancelledMutation նետել ավելի հին կանչողներին.
dropLatest-ը կարող է DroppedMutation նետել, մինչ զբաղված է.
Դրանք բռնեք UI-ում, երբ ուզում եք ճնշել ժամանակավոր չեղարկման սխալները.

Հաջորդ քայլերը

Flutter API

Կապեք mutation-ի վիճակը UI-ին ConsumerWidget կամ ConsumerStatefulWidget-ի միջոցով.

Բացել Flutter API

API Reference

Արագ նայեք invoke, mutation, mutate և MutationState տիպերին.

Բացել API Reference