آموزش مدیریت برنامه نویسی ناهمگام با Completer در فلاتر و زبان دارت

Completer در زبان برنامه‌نویسی دارت و فریم‌ورک فلاتر یک ابزار قدرتمند برای مدیریت عملیات‌های ناهمزمان (Async) است.

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)

    دیدگاه خود را بنویسید

    ایمیل شما نمایش داده نمی‌شود. دیدگاه پس از تأیید نمایش داده می‌شود.