លំហូរសរសេរនៅតែច្បាស់លាស់។
កំណត់ mutation ជា provider methods តាមដានស្ថានភាពដោយ 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)
ចំណាំ
ផ្ទុយពី APIs រចនាប័ទ្ម 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.
ឧទាហរណ៍: ការធ្វើបច្ចុប្បន្នភាព optimistic + restart
លំនាំសរសេរធម្មតាធ្វើបច្ចុប្បន្នភាព AsyncData បែប optimistic ហើយបន្ទាប់មក sync ជាមួយការឆ្លើយតបពី 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