זרימת הכתיבה נשארת מפורשת.

הגדירו mutations כשיטות provider, עקבו אחרי המצב עם MutationToken והריצו אותן דרך ref.invoke(call).

פתיחת API Reference קריאת Providers

אבני הבניין של mutations

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)

הערה

בניגוד ל-API בסגנון notifier.method(), 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.

דוגמה: עדכון אופטימי + 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

קשרו את מצב ה-mutation ל-UI באמצעות ConsumerWidget או ConsumerStatefulWidget.

פתיחת Flutter API

API Reference

עברו במהירות על הטיפוסים invoke, mutation, mutate ו-MutationState.

פתיחת API Reference