د لیکلو جریان روښانه پاتې کېږي.
Mutations د provider methods په توګه تعریف کړئ، state د 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() په څېر APIs برعکس، miniriverpod د mutation اجرا د لومړۍ درجې call object ګرځوي.
یو mutation اجرا کړئ
ref.invoke وکاروئ څو د cancellation او drop چلندونه caller ته ښکاره شي.
فاصله
د 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 update + restart
یو عام write pattern AsyncData په optimistic ډول update کوي، بیا یې د server response سره sync کوي.
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,
);
}
راتلونکې ګامونه
Flutter API
د ConsumerWidget یا ConsumerStatefulWidget په کارولو mutation state له UI سره وتړئ.
Flutter API پرانیزئ