Completer در زبان برنامهنویسی دارت و فریمورک فلاتر یک ابزار قدرتمند برای مدیریت عملیاتهای ناهمزمان (Async) است.
این ابزار به شما اجازه میدهد تا یک عملیات آسنکرون را آغاز کرده و در زمان مناسب آن را تکمیل کنید. Completerها اغلب در مواردی استفاده میشوند که نیاز به کنترل دقیقتر روی اتمام یک عملیات و مدیریت خطاهای احتمالی وجود دارد.
Completer در برنامه نویسی فلاتر
در زبان دارت یک Completer شی ای است که به مدیریت عملیاتهای ناهمزمان کمک میکند و راهی برای تولید و تکمیل یک Future بهطور دستی فراهم میآورد.
این شیء بهعنوان پلی بین تولیدکننده یک Future (که نمایانگر یک کار ناهمزمان است) و مصرفکننده (که منتظر تکمیل کار است) عمل میکند.
یک Completer بهطور اساسی به شما این امکان را میدهد که بهطور برنامهنویسی یک Future ایجاد و کنترل کنید. شما میتوانید از آن برای نشان دادن زمانی که یک عملیات ناهمزمان با موفقیت به پایان رسیده و نتیجهای دارد، یا زمانی که با خطایی مواجه شده است، استفاده کنید.
مزایا استفاده از Completer
کنترل دستی بر روی Futures: کلاس Compeleter به توسعهدهندگان این امکان را میدهد که بهطور دستی یک Future را در نقطهای دلخواه از کد تکمیل یا علامتگذاری کنند.
این ویژگی بهویژه زمانی مفید است که با عملیاتهای ناهمزمان سفارشی کار میکنید که بهطور مستقیم یک Future را برنمیگردانند.
مدیریت خطا: Completer به شما اجازه میدهد که خطاها را بهطور صریح مدیریت کنید و یک Future را با استفاده از متد completeError() با خطا تکمیل کنید.
این امر کنترل بیشتری بر روی انتشار و مدیریت خطاها در جریانهای ناهمزمان به شما میدهد.
ادغام با APIهای ناهمزمان خارجی: هنگام کار با APIها یا کتابخانههای خارجی که بهطور مستقیم Futures را برنمیگردانند، میتوانید از Completer برای بستهبندی و سازگاری این عملیاتهای ناهمزمان با Futures استفاده کنید، که این امر آنها را با مدل برنامهنویسی ناهمزمان در فلاتر سازگار میسازد.
زنجیرهسازی و ترکیب: Completer میتواند برای ترکیب جریانهای پیچیده ناهمزمان با زنجیرهسازی چندین Future بهکار برود.
این انعطافپذیری به توسعهدهندگان این امکان را میدهد که وظایف ناهمزمان را بهطور مؤثرتری سازماندهی و ترتیبدهی کنند.
بهطور خلاصه، Completer بهعنوان ابزاری چندمنظوره برای مدیریت وظایف ناهمزمان در Dart عمل میکند و کنترل دقیقی بر چرخه حیات و نتایج عملیاتهای ناهمزمان به توسعهدهندگان ارائه میدهد.
این ابزار خوانایی کد را افزایش میدهد، مدیریت خطا را سادهتر میکند و ادغام بیدردسر عملیاتهای ناهمزمان را در برنامههای Dart ممکن میسازد.
آموزش برنامه نویسی غیر همزمان در فلاتر
ساخت Compeleter در فلاتر
برای ایجاد یک شیء Completer، آن را با یک پارامتر نوع خاص که نمایانگر نوع مقداری (یا خطا) است که Future مرتبط را در نهایت تولید خواهد کرد، نمونهسازی میکنید.
import 'dart:async';
void main() {
// Creating a Completer that will complete with a String
Completer<String> completer = Completer<String>();
// Example asynchronous task that completes the Completer
Future.delayed(Duration(seconds: 2), () {
completer.complete('Task completed successfully!');
});
// Handling the completed Future
completer.future.then((value) {
print(value); // Output: Task completed successfully!
});
}
در کد نمونه بالا:
- ما کتابخانه
dart:asyncرا وارد میکنیم تا به کلاس Completer دسترسی پیدا کنیم. - یک Completer به نام
completerایجاد میکنیم که در نهایت یک مقدار از نوع String تولید خواهد کرد. - در داخل عملیات ناهمزمان شبیهسازی شده با
Future.delayed، پس از تأخیری به مدت 2 ثانیه، با استفاده ازcompleter.complete('Task completed successfully!')، completer را با یک مقدار موفقیتآمیز تکمیل میکنیم. - سپس با استفاده از
completer.future.then(...)، Future تکمیلشده را مدیریت میکنیم تا مقدار را زمانی که Future با موفقیت تکمیل میشود، چاپ کنیم.
رابطه بین Future و Completer
رابطه بین Future و Completer ساده است:
- یک Completer برای کنترل وضعیت یک Future استفاده میشود.
- زمانی که شما یک Completer ایجاد میکنید، در واقع یک جایگزین برای یک Future ایجاد میکنید که میتوانید تکمیل آن را بهطور دستی کنترل کنید.
- خاصیت
futureیک Completer (یعنیcompleter.future) شیء Future مرتبط را برمیگرداند که میتوان آن را منتظر (await) کرد یا با استفاده ازthenزنجیرهسازی کرد تا نتیجه عملیات ناهمزمان را مدیریت کند.
import 'dart:async';
void main() {
// Step 1: Create a Completer
Completer<String> completer = Completer<String>();
// Step 2: Simulate an asynchronous operation
simulateAsyncOperation(completer);
// Step 3: Use the Future returned by the Completer
completer.future.then((value) {
print('Received result: $value');
}).catchError((error) {
print('Error occurred: $error');
});
}
// Function to simulate an asynchronous operation
void simulateAsyncOperation(Completer<String> completer) {
// Simulating a delayed operation (e.g., fetching data)
Future.delayed(Duration(seconds: 2), () {
// Completing the Future with a result
completer.complete('Data loaded successfully');
});
}
در کد بالا:
- ما یک Completer (به نام
completer) ایجاد میکنیم. - یک عملیات نا همگام را با استفاده از
Future.delayedبرنامهریزی میکنیم و وقتی کار به پایان رسید، completer را با یک مقدار تکمیل میکنیم. - سپس از
completer.future.then(...)استفاده میکنیم تا مشخص کنیم چه اتفاقی میافتد وقتی Future مربوط به completer تکمیل میشود.
این استفاده پایهای نشان میدهد که چگونه Completer به شما اجازه میدهد تا با عملیاتهای ناهمزمان در زبان برنامه نویسی دارت کنترل و تعامل داشته باشید و مکانیزمی برای تولید و مدیریت Futures بهطور دستی فراهم میکند.
Completer بهویژه زمانی مفید است که نیاز دارید رفتار ناهمزمان سفارشی را در مدل برنامهنویسی ناهمزمان مبتنی بر Future در Dart ادغام کنید.
دریافت اطلاعات از دیتابیس یا API
import 'dart:async';
// Simulated data source class
class DataService {
Future<String> fetchData() {
return Future.delayed(Duration(seconds: 2), () {
// Simulated data retrieval (e.g., from a network or database)
return 'Fetched data from network';
});
}
}
void main() {
// Create a Completer to manage the asynchronous operation
Completer<String> completer = Completer<String>();
// Simulate data fetching using Completer and Future
fetchDataWithCompleter(completer);
// Handle the completed Future
completer.future.then((value) {
print('Received data: $value');
}).catchError((error) {
print('Error occurred while fetching data: $error');
});
}
// Function to fetch data using Completer
void fetchDataWithCompleter(Completer<String> completer) {
// Instantiate a data service
DataService dataService = DataService();
// Initiate the data fetching process
dataService.fetchData().then((data) {
// Complete the Completer with the fetched data
completer.complete(data);
}).catchError((error) {
// Handle errors by completing with an error
completer.completeError('Failed to fetch data: $error');
});
}
در کد بالا:
- ما یک کلاس
DataServiceتعریف میکنیم که یک منبع داده را شبیهسازی میکند و متدfetchData()را ارائه میدهد که یکFuture<String>را برمیگرداند. این متد شبیهسازی میکند که دادهها بهصورت ناهمزمان (مثلاً از یک شبکه یا پایگاه داده) با تأخیری به مدت 2 ثانیه دریافت میشوند.
در تابع main():
- یک
Completer<String>به نامcompleterایجاد میکنیم تا عملیات ناهمزمان دریافت دادهها را مدیریت کند. - متد
fetchDataWithCompleter(completer)را برای آغاز فرآیند دریافت دادهها با استفاده ازDataServiceوCompleterفراخوانی میکنیم. - از
completer.future.then(...)برای مدیریت نتیجه زمانی که عملیات دریافت داده با موفقیت تکمیل میشود، استفاده میکنیم. در اینجا، دادههای دریافتی را چاپ میکنیم. - همچنین از
completer.future.catchError(...)برای مدیریت هر گونه خطایی که در طول فرآیند دریافت دادهها رخ میدهد، استفاده میکنیم.
تابع fetchDataWithCompleter():
- یک نمونه از
DataServiceرا راهاندازی میکند. - متد
fetchData()کلاسDataServiceرا برای آغاز عملیات دریافت دادهها فراخوانی میکند. Completer(یعنیcompleter) را با دادههای دریافتشده (data) زمانی که عملیات با موفقیت انجام میشود، تکمیل میکند.- اگر در طول فرآیند دریافت دادهها خطایی رخ دهد،
Completerرا با یک پیام خطا تکمیل میکند.
این مثال نشان میدهد که چگونه میتوان Completer را با وظایف ناهمزمان، مانند دریافت دادهها از یک شبکه یا پایگاه داده، ادغام کرد.
Completer راهی برای کپسولهسازی و کنترل تکمیل عملیاتهای ناهمزمان فراهم میکند و آن را به ابزاری قدرتمند برای مدیریت و کنترل جریانهای ناهمزمان در برنامه نویسی فلاتر تبدیل میکند.
شما میتوانید این الگو را برای موارد مختلفی که نیاز به کنترل دقیق بر روی عملیاتهای ناهمزمان دارند، تطبیق دهید و از این طریق اطمینان حاصل کنید که مدیریت خطا بهطور مؤثر و بازیابی دادهها بهصورت کارآمد انجام میشود.
آموزش ساخت فایل نصبی Setup ویندوز برای خروجی دسکتاپ فلاتر
ارسال اطلاعات با complete()
void main() {
// Create a Completer to manage the asynchronous operation
Completer<int> completer = Completer<int>();
// Simulate a delayed operation (e.g., fetching data)
simulateAsyncOperation(completer);
// Handle the completed Future
completer.future.then((value) {
print('Received result: $value');
}).catchError((error) {
print('Error occurred: $error');
});
}
// Function to simulate an asynchronous operation
void simulateAsyncOperation(Completer<int> completer) {
// Simulate a delayed operation (e.g., fetching data)
Future.delayed(Duration(seconds: 2), () {
int result = 42; // Simulated result
completer.complete(result); // Complete the Completer with the result
});
}
در کد بالا:
- یک
Completer<int>به نامcompleterایجاد میکنیم تا یک عملیات ناهمزمان را مدیریت کند که در نهایت یک مقدار از نوع int تولید خواهد کرد. - متد
simulateAsyncOperation(completer)را برای آغاز عملیات ناهمزمان شبیهسازیشده فراخوانی میکنیم.
در داخل تابع simulateAsyncOperation():
- از
Future.delayed()برای شبیهسازی یک عملیات با تأخیر (مثلاً دریافت داده) استفاده میکنیم که پس از 2 ثانیه به پایان میرسد. - پس از تأخیر، یک نتیجه شبیهسازیشده (یعنی
int result = 42;) را که میخواهیم به Future منتظر منتقل کنیم، تعیین میکنیم. - سپس از
completer.complete(result);استفاده میکنیم تاCompleterرا با نتیجه تکمیل کنیم، که این امر نشاندهنده تکمیل موفقیتآمیز Future مرتبط با مقدار ارائهشده (در این مورد 42) خواهد بود.
در تابع main():
- از
completer.future.then(...)برای مدیریت Future تکمیلشده استفاده میکنیم تا نتیجه دریافتشده (42) را زمانی که عملیات ناهمزمان با موفقیت تکمیل میشود، چاپ کنیم. - همچنین از
completer.future.catchError(...)برای مدیریت هر گونه خطایی که در طول عملیات ناهمزمان رخ میدهد، استفاده میکنیم.
استفاده از Completer در پروژههای شما نهتنها ابزارهای شما را بهعنوان یک توسعهدهنده Dart/Flutter گسترش میدهد، بلکه شما را با مهارتهای ضروری برای طراحی و پیادهسازی راهحلهای ناهمزمان کارآمد تجهیز میکند. انعطافپذیری و کنترلی که Completer ارائه میدهد را بپذیرید و امکانات جدیدی را برای مدیریت وظایف ناهمزمان در برنامههای خود کشف کنید.
در صورتی که هنوز برنامه نویسی فلاتر را شروع نکرده اید میتوانید از دوره آموزش برنامه نویسی فلاتر مجموعه ما استفاده نمایید.
دیدگاهها (0)
دیدگاه خود را بنویسید