الأصناف القابلة للاستدعاء (Callable Classes)

جزء من قسم البرمجة كائنية التوجه في رحلة Dart على Coddy. الدرس 84 من 110.

في Dart، يمكنك جعل مثيلات class قابلة للاستخدام كـ function من خلال تنفيذ method call(). يتيح لك ذلك استخدام object مع صيغة استدعاء function، باستخدام الأقواس مباشرةً على المثيل.

class Multiplier {
  final int factor;
  
  Multiplier(this.factor);
  
  int call(int value) {
    return value * factor;
  }
}

void main() {
  var double = Multiplier(2);
  var triple = Multiplier(3);
  
  print(double(5));   // 10 - استدعاء الكائن كدالة
  print(triple(5));   // 15
}

عندما تكتب double(5)، تستدعي Dart تلقائيًا طريقة call() مع 5 باعتبارها الوسيطة. يتصرف الكائن مثل function مع الاحتفاظ بحالته (الحقل factor).

يمكن أن تكون لطريقة call() أيّ توقيع — معلمات متعددة، أو معلمات اختيارية، أو حتى إرجاع أنواع مختلفة:

class Greeter {
  final String greeting;
  
  Greeter(this.greeting);
  
  String call(String name, {String punctuation = '!'}) {
    return '$greeting, $name$punctuation';
  }
}

void main() {
  var hello = Greeter('Hello');
  print(hello('Alice'));              // مرحباً، أليس!
  print(hello('Bob', punctuation: '.')); // مرحباً، بوب.
}

تكون Callable class مفيدة عندما تحتاج إلى سلوك يشبه function مع دمجه بحالة أو إعدادات. وتُستخدم عادةً لإنشاء عمليات أو أدوات تحقّق أو تحويلات قابلة لإعادة الاستخدام، والتي تحتاج إلى تذكّر الإعدادات بين عمليات call.

التحدي

سهل

لنبنِ نظامًا لتنسيق النصوص باستخدام callable classes! ستنشئ كائنات يمكن استدعاؤها مثل function لتحويل النص بطرق مختلفة، مع الاحتفاظ بإعدادات التهيئة الخاصة بها.

ستنظّم الشيفرة في ملفين:

formatters.dart: أنشئ فئتَي callable لتحويل النص:
- فئة Wrapper التي تغلّف النص ببادئة ولاحقة. ينبغي أن تخزّن String prefix وString suffix، وعند استدعائها باستخدام parameter من نوع String text، تُرجع النص مغلّفًا بين البادئة واللاحقة.
- فئة Repeater التي تكرّر النص عددًا معينًا من المرات. ينبغي أن تخزّن قيمة int times، وعند استدعائها باستخدام parameter من نوع String text، تُرجع النص مكررًا بذلك العدد من المرات مع وضع مسافة بين كل تكرار.
main.dart: استورد formatters الخاصة بك ووضّح كيفية عمل callable classes:
- أنشئ Wrapper باستخدام prefix يساوي "[" وsuffix يساوي "]"
- أنشئ Wrapper another باستخدام prefix يساوي "***" وsuffix يساوي "***"
- أنشئ Repeater يكرّر 3 مرات
- استدعِ first wrapper باستخدام "Hello" واطبع result
- استدعِ second wrapper باستخدام "Important" واطبع result
- استدعِ repeater باستخدام "Go" واطبع result
- أخيرًا، ادمج بينها: استدعِ first wrapper باستخدام result استدعاء repeater مع "Dart"، ثم اطبع result

لاحظ كيف يتذكر كل كائن من كائنات formatters إعدادات تهيئته، ويمكن استدعاؤه مباشرةً باستخدام الأقواس، تمامًا مثل function!

الناتج المتوقع:

[Hello]
***Important***
Go Go Go
[Dart Dart Dart]

جرّب بنفسك

import 'formatters.dart';

void main() {
  // TODO: أنشئ Wrapper بالبادئة "[" واللاحقة "]"
  
  // TODO: أنشئ Wrapper آخر بالبادئة "***" واللاحقة "***"
  
  // TODO: أنشئ Repeater يكرر 3 مرات
  
  // TODO: استدعِ الـ wrapper الأول مع "Hello" واطبع النتيجة
  
  // TODO: استدعِ الـ wrapper الثاني مع "Important" واطبع النتيجة
  
  // TODO: استدعِ الـ repeater مع "Go" واطبع النتيجة
  
  // TODO: ادمجهما: استدعِ الـ wrapper الأول بنتيجة
  // استدعاء الـ repeater مع "Dart"، واطبع النتيجة
  
}