إنشاء Mixins

جزء من قسم Object Oriented Programming في رحلة Dart على Coddy — الدرس 51 من 110.

الآن بعد أن فهمت ماهية الـ mixins، دعنا نلقي نظرة على كيفية إنشائها بشكل صحيح. يتم التصريح عن الـ mixin باستخدام الكلمة المفتاحية mixin بدلاً من class.

mixin Logging {
  void log(String message) {
    print('[LOG] $message');
  }
  
  void logError(String error) {
    print('[ERROR] $error');
  }
}

يمكن أن تحتوي الـ Mixins على دوال (methods)، وخصائص (properties)، وحتى دوال جلب وتعيين (getters و setters) - تماماً مثل الأصناف (classes). ومع ذلك، هناك قاعدة مهمة واحدة: لا يمكن للـ mixins أن تحتوي على دوال بناء (constructors). وبما أن الـ mixins مخصصة ليتم "دمجها" بدلاً من إنشائها بشكل مباشر، فهي لا تحتاج إلى منطق تهيئة (initialization logic).

mixin Timestamped {
  DateTime createdAt = DateTime.now();
  
  String get formattedTime => createdAt.toString();
  
  void printTimestamp() {
    print('Created at: $formattedTime');
  }
}

class Document with Timestamped {
  String title;
  Document(this.title);
}

void main() {
  var doc = Document('Report');
  doc.printTimestamp();  // يستخدم ميثود الـ mixin
  print(doc.createdAt);  // يستخدم خاصية الـ mixin
}

عندما تقوم بتطبيق mixin باستخدام with، تصبح جميع أعضائه جزءاً من الـ class الخاص بك. يمكن للـ class استخدامها مباشرةً، وكذلك يمكن لأي كود لديه instance من ذلك الـ class. وهذا يجعل الـ mixins وسيلة نظيفة لإضافة وظائف قابلة لإعادة الاستخدام دون تعقيد تسلسلات الوراثة الهرمية.

التحدي

سهل

لنقم ببناء نظام مراسلة يوضح كيفية إنشاء mixins مع الطرق (methods)، والخصائص (properties)، والمسترجعات (getters). ستقوم بتصميم mixin يضيف إمكانيات التنسيق لأنواع مختلفة من الرسائل.

ستقوم بتنظيم الكود الخاص بك في ملفين:

messaging.dart: قم بتعريف الـ mixin وفئات الرسائل الخاصة بك هنا:
- mixin باسم Formattable يحتوي على:
  - خاصية String prefix مهيأة بالقيمة '>>>'
  - مسترجع (getter) باسم separator يعيد ' | '
  - طريقة format(String text) تعيد السلسلة النصية [prefix][separator][text]
  - طريقة formatBold(String text) تعيد **[text]**
- فئة TextMessage تستخدم الـ mixin المسمى Formattable. أضف خاصية String sender مع منشئ (constructor). قم بتضمين طريقة send(String content) تطبع نتيجة استدعاء format() مع [sender]: [content]
- فئة AlertMessage تستخدم أيضاً الـ mixin المسمى Formattable. أضف خاصية String level مع منشئ (constructor). قم بتضمين طريقة alert(String content) تطبع نتيجة استدعاء format() مع [[level]] [formatBold(content)]
main.dart: قم باستيراد ملف المراسلة الخاص بك ووضح كيف يكتسب كلا نوعي الرسائل إمكانيات التنسيق من الـ mixin:
- قم بإنشاء TextMessage مع المرسل 'Alice'
- قم بإنشاء AlertMessage مع المستوى 'WARNING'
- استدعِ send('Hello there!') على رسالة النص
- استدعِ alert('System overload') على رسالة التنبيه

يوضح الـ mixin الخاص بك أن الـ mixins يمكن أن تحتوي على خصائص بقيم افتراضية، ومسترجعات (getters) تحسب القيم، وطرق متعددة يمكنها حتى استدعاء بعضها البعض. تكتسب كلتا فئتي الرسائل كل هذه الوظائف ببساطة عن طريق استخدام الكلمة المفتاحية with.

المخرجات المتوقعة:

>>> | Alice: Hello there!
>>> | [WARNING] **System overload**

ورقة مرجعية

يتم التصريح عن الـ Mixins باستخدام الكلمة المفتاحية mixin بدلاً من class:

mixin Logging {
  void log(String message) {
    print('[LOG] $message');
  }
  
  void logError(String error) {
    print('[ERROR] $error');
  }
}

يمكن أن تحتوي الـ Mixins على دوال (methods)، وخصائص (properties)، و getters، و setters، ولكن لا يمكن أن تحتوي على دوال بناء (constructors):

mixin Timestamped {
  DateTime createdAt = DateTime.now();
  
  String get formattedTime => createdAt.toString();
  
  void printTimestamp() {
    print('Created at: $formattedTime');
  }
}

يتم تطبيق الـ mixins على الفئات (classes) باستخدام الكلمة المفتاحية with. تصبح جميع أعضاء الـ mixin جزءاً من الفئة:

class Document with Timestamped {
  String title;
  Document(this.title);
}

void main() {
  var doc = Document('Report');
  doc.printTimestamp();  // يستخدم دالة الـ mixin
  print(doc.createdAt);  // يستخدم خاصية الـ mixin
}

جرّب بنفسك

import 'messaging.dart';

void main() {
  // TODO: 'Alice' مع المرسل TextMessage قم بإنشاء
  
  // TODO: 'WARNING' مع المستوى AlertMessage قم بإنشاء
  
  // TODO: على الرسالة النصية send('Hello there!') قم باستدعاء
  
  // TODO: على رسالة التنبيه alert('System overload') قم باستدعاء
}