إنشاء الإجراءات (Actions) باستخدام Kawkab

الإجراءات (Actions) هي فئات تمثل الأنشطة أو العمليات التي يمكن أن يتم تنفيذها في تطبيقك، مثل تحديث كلمة المرور أو انشاء ارقام عشوائية او غيرها. باستخدام Kawkab، يمكنك إنشاء إجراءات بسهولة وتنظيم الأكواد المتعلقة بها بطريقة مرنة لتنفيذ مهمة واحدة محددة.

إنشاء Action جديد باستخدام Kawkab

لإنشاء Action جديد باستخدام Kawkab، قم بتشغيل الأمر التالي في سطر الأوامر:

npm run kawkab action:make <name> [module]

تفاصيل المعلمات:

• <name>: اسم الـ Action الذي ترغب في إنشائه (على سبيل المثال UpdateUserPassword).
• [module]: اسم الموديول الذي يحتوي على الـ Action (اختياري، الافتراضي هو main).

مثال على كيفية تنفيذ الأمر:

npm run kawkab action:make UpdateUserPassword

بعد تنفيذ الأمر، سيتم إنشاء Action باسم UpdateUserPassword في الموديول main.

ماذا يحدث بعد تشغيل الأمر؟

• سيتم إنشاء ملف الـ Action باسم 'UpdateUserPassword' بنجاح.
• يمكنك الآن استخدام هذا الـ Action في تطبيقك عن طريق استيراده واستخدامه كما في المثال التالي.

كيفية استخدام Action في التطبيق

بمجرد إنشاء الـ Action، يمكنك استيراده واستخدامه في أي جزء من التطبيق.

استيراد الـ Action:

لاستيراد الـ Action الذي تم إنشاؤه، استخدم الكود التالي في ملفك:

import { UpdateUserPasswordAction } from "../actions/UpdateUserPassword";

محتوى ملف الـ Action:

سيحتوي ملف الـ Action UpdateUserPassword على الكود التالي:

import { BaseAction } from "kawkab";
 
export class UpdateUserPasswordAction extends BaseAction {
    handle() {
        // إضافة الكود الخاص بالتعامل مع تغيير كلمة المرور هنا
    }
}

استخدام الـ Action في التطبيق:

يمكنك الآن استخدام الـ Action من خلال إنشاء كائن جديد من الفئة UpdateUserPasswordAction كما يلي:

const action = new UpdateUserPasswordAction();
action.handle(); // سيتم تنفيذ الكود داخل دالة handle

إرسال البيانات إلى الـ Action:

يمكنك تمرير البيانات التي تحتاج إليها عند إنشاء كائن الـ Action:

const action = new UpdateUserPasswordAction({ id: 1, name: 'Hassan' });
console.log(action.data);  // ستطبع { id: 1, name: 'Hassan' }

الوصول إلى البيانات داخل الـ Action:

داخل الـ Action، يمكنك الوصول إلى البيانات الممررة باستخدام this.data:

export class UpdateUserPasswordAction extends BaseAction {
    handle() {
        console.log(this.data);  // ستطبع البيانات الممررة مثل { id: 1, name: 'Hassan' }
    }
}

ملاحظات إضافية

• إجراءات متعددة: يمكنك إنشاء العديد من الإجراءات في تطبيقك باستخدام نفس الأسلوب، حيث يمكنك إنشاء فئات Action جديدة لأي عملية تحتاج إليها.
• توسيع الوظائف: داخل كل Action، يمكنك إضافة منطق الأعمال الخاص بك مثل استعلامات قاعدة البيانات أو التعامل مع البيانات التي تم تمريرها.
• مرونة في استخدام البيانات: يمكن تمرير البيانات عند إنشاء الـ Action للوصول إليها بسهولة في داخل الـ Action باستخدام this.data.

الخاتمة

تعتبر الإجراءات (Actions) في Kawkab وسيلة قوية لتنظيم العمليات التي يحتاج تطبيقك إلى تنفيذها. مع Kawkab، يمكنك إنشاء واستخدام الإجراءات بسهولة لتنفيذ وظائف مثل تحديث البيانات، إرسال الإشعارات، وأكثر من ذلك بكثير. استفد من المرونة التي يوفرها Kawkab لتنظيم تطبيقك وتحسين كفاءته!