31-03-2026, 09:09 AM
كود :
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;
إذا رأيت منتجاً مجانياً فأعلم بأنك أنت السّلعة


