الأعضاء العامة مقابل الخاصة

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

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

في لغة Dart، تكون أعضاء الفئة (الحقول والأساليب) عامة (public) بشكل افتراضي. وهذا يعني أن أي كود يمكنه الوصول إليها مباشرة:

class BankAccount {
  String owner;
  double balance;
  
  BankAccount(this.owner, this.balance);
}

var account = BankAccount('Alice', 1000);
account.balance = -500;  // يمكن لأي شخص تعديل هذا مباشرة!

هذا أمر إشكالي. لا يوجد شيء يمنع تعيين رصيد غير صالح.

لحماية البيانات الداخلية، تستخدم Dart أعضاءً خاصين. يصبح العضو خاصاً عندما يبدأ اسمه بشرطة سفلية _:

class BankAccount {
  String owner;
  double _balance;  // خاص - يبدأ بشرطة سفلية
  
  BankAccount(this.owner, this._balance);
  
  double get balance => _balance;  // وصول متحكم به
}

الآن لا يمكن الوصول إلى _balance مباشرة من خارج المكتبة التي تم تعريف الفئة فيها. يجب أن يستخدم الكود الخارجي الـ getter العام بدلاً من ذلك. يتيح لك هذا التحكم في كيفية قراءة البيانات وتعديلها، مما يضمن بقاء كائناتك دائمًا في حالة صالحة.

التحدي

سهل

لنقم ببناء مدير كلمات مرور بسيط يوضح الفرق بين الأعضاء العامة (public) والخاصة (private). سترى كيف تحمي البادئة التي تتكون من شرطة سفلية (underscore) البيانات الحساسة من الوصول إليها مباشرة من خارج مكتبة الفئة (class).

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

credential.dart: قم بتعريف فئة Credential التي تخزن معلومات تسجيل الدخول لموقع ويب. يجب أن تحتوي الفئة على:
- عضو عام String website - لا بأس أن يرى أي شخص الموقع المخصص له هذا الاعتماد
- عضو عام String username - يمكن أن يكون اسم المستخدم مرئيًا
- عضو خاص String _password - يجب حماية كلمة المرور الفعلية
- منشئ (constructor) يأخذ القيم الثلاث جميعها
- مسترجع عام (getter) باسم password يعيد القيمة الخاصة _password (وصول محكوم)
- دالة getMaskedPassword() تعيد كلمة المرور مع استبدال جميع الأحرف بعلامات النجمة * (بنفس طول كلمة المرور الفعلية)
- دالة displayCredential() تطبع معلومات الاعتماد بأمان (تعرض كلمة المرور المقنعة، وليس الحقيقية)
main.dart: قم باستيراد فئة الاعتماد الخاصة بك ووضح كيف يحمي التغليف (encapsulation) كلمة المرور:
- أنشئ اعتمادًا لموقع الويب 'github.com'، واسم المستخدم 'dev_user'، وكلمة المرور 'secret123'
- أنشئ اعتمادًا آخر لموقع الويب 'email.com'، واسم المستخدم 'john_doe'، وكلمة المرور 'myP@ss'
- لكل اعتماد، استدعِ displayCredential()، ثم اطبع Actual password length: [length] باستخدام المسترجع العام للوصول إلى طول كلمة المرور

يجب أن تطبع الدالة displayCredential() بهذا التنسيق:

--- Credential ---
Website: [website]
Username: [username]
Password: [maskedPassword]

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

--- Credential ---
Website: github.com
Username: dev_user
Password: *********
Actual password length: 9
--- Credential ---
Website: email.com
Username: john_doe
Password: ******
Actual password length: 6

ورقة مرجعية

يتحكم التغليف (Encapsulation) في الوصول إلى البيانات الداخلية للفئة من خلال تحديد ما يجب أن يكون مرئيًا وما يجب أن يظل مخفيًا.

في لغة Dart، تكون أعضاء الفئة عامة بشكل افتراضي:

class BankAccount {
  String owner;
  double balance;  // Public - can be accessed directly
  
  BankAccount(this.owner, this.balance);
}

var account = BankAccount('Alice', 1000);
account.balance = -500;  // Direct modification allowed

لحماية البيانات الداخلية، استخدم الأعضاء الخاصين عن طريق إضافة شرطة سفلية _ كبادئة للاسم:

class BankAccount {
  String owner;
  double _balance;  // Private - starts with underscore
  
  BankAccount(this.owner, this._balance);
  
  double get balance => _balance;  // Controlled access via getter
}

لا يمكن الوصول إلى الأعضاء الخاصين مباشرة من خارج المكتبة التي تم تعريف الفئة فيها. استخدم دوال الجلب (getters) والأساليب (methods) العامة لتوفير وصول محكوم للبيانات الخاصة، مما يضمن بقاء الكائنات في حالة صالحة.

جرّب بنفسك

import 'credential.dart';

void main() {
  // TODO: github.com قم بإنشاء بيانات اعتماد لموقع
  // website: 'github.com', username: 'dev_user', password: 'secret123'
  
  // TODO: على بيانات الاعتماد الأولى displayCredential() قم باستدعاء
  
  // TODO: قم بطباعة طول كلمة المرور الفعلي باستخدام أداة الحصول العامة (getter)
  // Format: "Actual password length: [length]"
  
  // TODO: email.com قم بإنشاء بيانات اعتماد لموقع
  // website: 'email.com', username: 'john_doe', password: 'myP@ss'
  
  // TODO: على بيانات الاعتماد الثانية displayCredential() قم باستدعاء
  
  // TODO: قم بطباعة طول كلمة المرور الفعلي باستخدام أداة الحصول العامة (getter)
}