البرمجة المتوازية في دلفي
#4
كود :
unit Async.Promises; interface uses   System.SysUtils, System.Threading, System.Classes, Models.Response; type   // 1. تعريف الواجهة (The Interface)   // نستخدم GUID صالح ونحول الإجراءات إلى وظائف تعيد الواجهة نفسها لتسمح بالتسلسل   IPromise<T> = interface     ['{A1B2C3D4-E5F6-4A1B-8C2D-E3F4A5B6C7D8}']     function OnSuccess(Proc: TProc<T>): IPromise<T>;     function OnError(Proc: TProc<Exception>): IPromise<T>;   end;   // 2. تعريف الفئة المنفذة (The Implementation Class)   TPromise<T> = class(TInterfacedObject, IPromise<T>)   private     FTask: ITask;     FResult: T;     FError: Exception;     FOnSuccess: TProc<T>;     FOnError: TProc<Exception>;     FSelfRef: IPromise<T>; // لحماية الكائن من التدمير التلقائي أثناء العمل   public     constructor Create(Func: TFunc<T>);     // دالة الانتقال للخطوة التالية (تستخدم الكلاس مباشرة لتجنب قيود الواجهة في دلفي)     function ThenCall<TNext>(Func: TFunc<T, TNext>): TPromise<TNext>;     // تنفيذ دوال الواجهة     function OnSuccess(Proc: TProc<T>): IPromise<T>;     function OnError(Proc: TProc<Exception>): IPromise<T>;     // دالة داخلية للحماية والتشغيل     procedure ProtectAndStart;     // نقطة الانطلاق الساكنة     class function Start(Func: TFunc<T>): TPromise<T>;   end; implementation { TPromise<T> } constructor TPromise<T>.Create(Func: TFunc<T>); begin   inherited Create;   // إنشاء المهمة (Task)   FTask := TTask.Create(procedure   begin     try       // تنفيذ الكود المطلوب في الخلفية       FResult := Func();       // العودة للخيط الرئيسي لتنفيذ الـ Callback       TThread.Queue(nil, procedure       begin         try           if Assigned(FOnSuccess) then             FOnSuccess(FResult);         finally           FSelfRef := nil; // تحرير الكائن بعد الانتهاء بنجاح         end;       end);     except       on E: Exception do       begin         FError := E;         TThread.Queue(nil, procedure         begin           try             if Assigned(FOnError) then               FOnError(FError);           finally             FSelfRef := nil; // تحرير الكائن بعد حدوث خطأ           end;         end);       end;     end;   end); end; procedure TPromise<T>.ProtectAndStart; begin   FSelfRef := Self; // نطلب من الكائن أن يمسك نفسه في الذاكرة   FTask.Start;      // ابدأ التنفيذ الفعلي end; class function TPromise<T>.Start(Func: TFunc<T>): TPromise<T>; begin   Result := TPromise<T>.Create(Func);   Result.ProtectAndStart; end; function TPromise<T>.ThenCall<TNext>(Func: TFunc<T, TNext>): TPromise<TNext>; var   CurrentStep: TPromise<T>; begin   CurrentStep := Self;   // إنشاء الوعد التالي (Step Next)   Result := TPromise<TNext>.Create(function: TNext   begin     // انتظر انتهاء الخطوة الحالية     CurrentStep.FTask.Wait;     // إذا حدث خطأ في الخطوة السابقة، ارفعه للأعلى ليتم التقاطه في OnError     if CurrentStep.FError <> nil then       raise CurrentStep.FError;     // تنفيذ الخطوة الحالية باستخدام نتيجة الخطوة السابقة     Result := Func(CurrentStep.FResult);   end);   // حماية وتشغيل الخطوة التالية   Result.ProtectAndStart; end; function TPromise<T>.OnSuccess(Proc: TProc<T>): IPromise<T>; begin   FOnSuccess := Proc;   Result := Self; // إرجاع الواجهة للسماح بإضافة .OnError بعدها end; function TPromise<T>.OnError(Proc: TProc<Exception>): IPromise<T>; begin   FOnError := Proc;   Result := Self; // إرجاع الواجهة للسماح بإضافة .OnSuccess بعدها end; end. //unit Async.Promises; // //interface // //uses //  System.SysUtils, System.Threading, System.Classes, Models.Response; // //type //  // الواجهة التي تحدد ما يمكن للمستخدم رؤيته في النهاية //  IPromise<T> = interface //    ['{A1B2C3D4-E5F6-4A1B-8C2D-E3F4A5B6C7D8}'] //    procedure OnSuccess(Proc: TProc<T>); //    procedure OnError(Proc: TProc<Exception>); //  end; // //  // الكلاس المنفذ //  TPromise<T> = class(TInterfacedObject, IPromise<T>) //  private //    FTask: ITask; //    FResult: T; //    FError: Exception; //    FOnSuccess: TProc<T>; //    FOnError: TProc<Exception>; //    FSelfRef: IPromise<T>; //  public //    constructor Create(Func: TFunc<T>); // //    // دالة التسلسل //    function ThenCall<TNext>(Func: TFunc<T, TNext>): TPromise<TNext>; // //    // دالة الحماية والتشغيل (هذه ستحل مشكلة الـ Access والـ Type Mismatch) //    procedure ProtectAndStart; // //    procedure OnSuccess(Proc: TProc<T>); //    procedure OnError(Proc: TProc<Exception>); // //    class function Start(Func: TFunc<T>): TPromise<T>; //  end; // //implementation // //{ TPromise<T> } // //constructor TPromise<T>.Create(Func: TFunc<T>); //begin //  inherited Create; //  FTask := TTask.Create(procedure //  begin //    try //      FResult := Func(); //      TThread.Queue(nil, procedure //      begin //        try //          if Assigned(FOnSuccess) then FOnSuccess(FResult); //        finally //          FSelfRef := nil; // تحرير الكائن //        end; //      end); //    except //      on E: Exception do //      begin //        FError := E; //        TThread.Queue(nil, procedure //        begin //          try //            if Assigned(FOnError) then FOnError(FError); //          finally //            FSelfRef := nil; // تحرير الكائن //          end; //        end); //      end; //    end; //  end); //end; // //procedure TPromise<T>.ProtectAndStart; //begin //  // هنا النوع T يطابق تماماً النوع T الخاص بالـ SelfRef //  FSelfRef := Self; //  FTask.Start; //end; // //class function TPromise<T>.Start(Func: TFunc<T>): TPromise<T>; //begin //  Result := TPromise<T>.Create(Func); //  Result.ProtectAndStart; // استدعاء دالة الحماية والتشغيل //end; // //function TPromise<T>.ThenCall<TNext>(Func: TFunc<T, TNext>): TPromise<TNext>; //var //  Current: TPromise<T>; //begin //  Current := Self; // //  // إنشاء الوعد التالي //  Result := TPromise<TNext>.Create(function: TNext //  begin //    Current.FTask.Wait; // انتظر الخطوة السابقة //    if Current.FError <> nil then raise Current.FError; //    Result := Func(Current.FResult); //  end); // //  // تشغيل الوعد التالي وحمايته باستخدام الدالة العامة ProtectAndStart //  Result.ProtectAndStart; //end; // //procedure TPromise<T>.OnSuccess(Proc: TProc<T>); //begin //  FOnSuccess := Proc; //end; // //procedure TPromise<T>.OnError(Proc: TProc<Exception>); //begin //  FOnError := Proc; //end; // //end.

بنفس الطريقة زر ولايبيل وضع الكود

كود :
Label3.Caption := 'جاري العمل في الخلفية...';   TPromise<TOperationResult>.Start(function: TOperationResult     begin       // الخطوة 1: استدعاء الدالة الأولى       Result := FetchFromAPI;     end)   .ThenCall<TOperationResult>(function(Prev: TOperationResult): TOperationResult     begin       // الخطوة 2: استدعاء الدالة الثانية وتمرير نتيجة الأولى لها       Result := ProcessData(Prev);     end)   .OnSuccess(procedure(Final: TOperationResult)     begin       // تحديث الواجهة بالنتيجة النهائية       if Final.IsSuccess then         Label3.Caption := 'نجاح: ' + Final.Message       else         Label3.Caption := 'فشل: ' + Final.Message;       // تحرير الكائن النهائي (آخر حلقة في السلسلة)       Final.Free;     end)   .OnError(procedure(E: Exception)     begin       // في حال حدوث خطأ غير متوقع في أي مرحلة       Label3.Caption := 'خطأ حرج: ' + E.Message;     end);

الان صار بامكاننا استدعاء  ThenCall عدة مرات بالتسلسل الذي نريده 

ولشرح ما يجري هنا سارفق لكم الاجراءات الفرعية للتوضيح

لدينا الاجراء يجلب ID 

كود :
function TForm1.FetchFromAPI: TOperationResult; begin   // ننشئ نتيجة افتراضية (فشل)   Result := TOperationResult.Create(False, 'بداية العملية');   try     // محاكاة وقت انتظار الشبكة (2 ثانية)     Sleep(2000);     // لنفترض أننا جلبنا معرف موظف جديد     Result.IsSuccess := True;     Result.Message := 'تم الاتصال بالسيرفر وجلب البيانات';     Result.NewId := 550;   except     on E: Exception do     begin       Result.IsSuccess := False;       Result.Message := 'خطأ في الاتصال: ' + E.Message;     end;   end; end;
إذا رأيت منتجاً مجانياً فأعلم بأنك أنت السّلعة
الرد


الردود في هذا الموضوع
RE: البرمجة المتوازية في دلفي - بواسطة الفجر الابيض - 31-03-2026, 09:09 AM

التنقل السريع :


يقوم بقرائة الموضوع: بالاضافة الى ( 1 ) ضيف كريم