Encapsulation in CSharp

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

---

The Problem: Why not just use Public Attributes?

قبل ما نعرف إيه هو الـ Encapsulation، خلينا نسأل نفسنا: ليه منخليش كل الداتا بتاعتنا Public وخلاص؟ الميزة الوحيدة لاستخدام الـ Public Attribute هي سهولة الاستخدام، لإنك بتستخدم نفس الشكل ونفس المنظر ونفس كل حاجة عشان توصل للمتغير في أي مكان في الكود.

بص على المثال ده لـ struct بيمثل موظف:

internal struct Employee
{
    public int Id;
    public string Name;
    public decimal Salary;
    
    // Constructor
    public Employee(string _name, int _id, decimal _salary)
    {
        Id = _id;
        Name = _name;
        Salary = _salary;
    }
 
    public override string ToString()
    {
        return $"Name: {Name}\nID: {Id}\nSalary: {Salary:c}";
    }
}
 
// Main
Employee employee = new Employee("Mahmoud", 253, 5000);
employee.Id = 50;
Console.WriteLine(employee);

لحد هنا الموضوع باين سهل، لكن الطريقة دي مليانة عيوب قاتلة:

1. الـ Tightly Coupled Code: الكود بيكون مرتبط ببعضه جدًا. لو حبيت في يوم أغير اسم الـ variable من Id لـ EmpId أو أغير نوعه، هحتاج أعمل update لكل سطر كود بيستخدم المتغير ده.

2. فقدان التحكم (Loss of Control): تاني مشكلة إن معدش عندي control على الكود بتاعي. بمعنى إني لو عايز أخلي الـ Id ده Read-only (يتقري بس ومحدش يعدله)، فالحل المتاح بالنسبالي هو إني أخليه Private. بس لو عملت كده، ده هيمنع إني أعمله get أو set من الأساس، وكده مليش كنترول. مقدرش أتحكم في الـ read & write بحيث أخلي واحد منهم public والتاني private:

   private int Id;
    
   // Main
   Employee.Id = 50; // ERROR
   Console.WriteLine(Employee.Id); // ERROR

3. مفيش فلترة (No Data Validation): مقدرش أفلتر الداتا اللي رايحة واللي جاية. زي ما الـ user هيدخلها، هاخدها وأخزنها، وده ممكن يضرب البيزنس لوجيك. مثال على ده: لو عندنا class اسمه Bank وفيه متغير Amount كـ public. اليوزر يقدر ببساطة يخزن قيمة سالبة، وده طبعًا غير منطقي في الرصيد:

   public class Bank
   {
       public int Amount;
   }
    
   // Main
   Bank bank = new Bank();
   bank.Amount = 50; // Valid
   bank.Amount = -150; // Invalid logically, but compiler allows it

عشان نحل كل المشاكل دي ونتعامل مع التغييرات المستقبلية بسهولة، الحل السحري هو الـ Encapsulation.

---

What is Encapsulation in C#?

الـ Encapsulation بيخفي الحالة الداخلية (internal state) والوظائف (functionality) بتاعة أي object، وبيسمح بالوصول ليهم بس عن طريق مجموعة public من الـ functions.

بشكل أبسط: هو عملية ربط أو تجميع الـ State (الـ Data Members أو المتغيرات) والـ Behaviour (الـ Member Functions أو الدوال) مع بعض في وحدة واحدة (زي class, interface, struct، إلخ).

الـ Encapsulation بيفصل تعريف الداتا عن طريقة استخدامها. إنت بتفصل تعريف الداتا وتخليها Private، وبعدها بتوفر طريقة Public عشان العالم الخارجي يستخدمها. الهدف الأساسي هو التأكد إن الداتا الحساسة مخفية عن المستخدمين.

Real-World Examples

• الكبسولة الطبية: مبدأ الـ Encapsulation شبه الكبسولة جدًا. زي ما الكبسولة بتحبس المواد الطبية جواها، الـ Encapsulation بيجمع المتغيرات والدوال في وحدة واحدة وبيغلفهم.

graph TD
    subgraph Encapsulation Capsule
        direction TB
        M[Public Methods / Properties]
        subgraph Hidden State
            D[Private Data / Variables]
        end
        M --> D
    end
    User((External Code)) -->|Access via| M
    User -.->|Direct Access Blocked| D

---

Data Hiding and Access Specifiers

أكبر ميزة للـ Encapsulation هي الـ Data Hiding (إخفاء البيانات). الـ Data hiding هو عملية بنخفي بيها البيانات الداخلية عن العالم الخارجي لحمايتها من سوء الاستخدام. العملية دي أحيانًا بتتسمى Data Encapsulation.

في C#، بنطبق الـ Data Encapsulation عن طريق خطوتين:

1. تعريف المتغيرات أو الحقول (fields) كـ private لمنع الوصول المباشر.
2. توفير public get و set methods، أو من خلال الـ properties للوصول للقيم وتحديثها مع وجود validations مناسبة.

عشان نعمل ده، بنستخدم الـ Access Specifiers اللي بتحدد نطاق ورؤية الكود. C# بتدعم 6 أنواع رئيسية:

• الـ public: متاح لأي كود في أي مكان.
• الـ private: متاح بس جوه نفس الـ class أو الـ struct.
• الـ protected: متاح جوه الـ class وللـ classes اللي بتورث منه.
• الـ internal: متاح جوه نفس الـ assembly (المشروع) بس.
• الـ protected internal: متاح جوه الـ assembly أو لأي derived class بره الـ assembly.
• الـ private protected: متاح للـ classes اللي بتورث منه بشرط يكونوا جوه نفس الـ assembly.

---

Achieving Encapsulation: Getter and Setter Methods

عشان نحقق الـ Encapsulation ونحل المشاكل اللي واجهتنا في الأول، هنخلي المتغير private ونبدأ نستخدم methods عشان نشوفه ونتحكم فيه من بره.

Example 1: Basic Getter and Setter

private string Name;
 
// Public Getter Method
public string GetName()
{
    return Name;
}
 
// Public Setter Method with Validation
public void SetName(string newName)
{
    // Restrict name length to 20 characters maximum
    Name = newName.Length <= 20 ? newName : newName.Substring(0, 20);
}
 
// Main
// Obj.GetName();
// Obj.SetName("VeryLongNameThatWillBeCut");

Example 2: Validating Bank Amount

نرجع لمثال البنك اللي كان بيقبل رصيد بالسالب، ونحله باستخدام الـ Getter والـ Setter:

using System;
namespace EncapsulationDemo
{
    public class Bank
    {
        // Hiding class data
        private int Amount;
 
        public int GetAmount()
        {
            return Amount;
        }
        
        public void SetAmount(int Amount)
        {
            // Validation: Do not allow negative values
            if (Amount > 0)
            {
                this.Amount = Amount;
            }
            else
            {
                throw new Exception("Please Pass a Positive Value");
            }
        }
    }
    
    class Program
    {
        public static void Main()
        {
            try
            {
                Bank bank = new Bank();
                // bank.Amount = 50; // Compile Time Error
                
                bank.SetAmount(10); // Valid
                Console.WriteLine(bank.GetAmount());
                
                bank.SetAmount(-150); // Throws Exception
            }
            catch(Exception ex)
            {
                Console.WriteLine(ex.Message);
            }
        }
    }
}

مميزات الطريقة دي هي كل المزايا اللي قولناها فوق في الـ Encapsulation:

• أقدر أخلي الـ Field يبقى Read-only ببساطة إني أمسح الـ Set method.
• ليا التحكم الكامل ومحدش يقدر يحط داتا غلط.
• لو غيرت اسم المتغير private int Amount; لاسم تاني جوه الـ class، مش هتفرق ومش هتبوظ الكود بره لإن الـ Methods لسه اسمها زي ما هو.

عيب الطريقة دي:

• شكل الكتابة معقد أكتر من الـ Public Attribute المباشر اللي كنا متعودين عليه.

هنا بيجي دور الـ Properties

---

Implementing Data Encapsulation using Properties

الـ Properties هي ميزة قوية في لغة C# بتساعد في حماية الـ field عن طريق التحكم في قراءة وكتابة القيم بأسلوب كتابة (Syntax) سهل وبسيط شبه المتغيرات العادية.

خلينا نطبق نفس مثال البنك باستخدام الـ Properties:

using System;
namespace EncapsulationDemo
{
    public class Bank
    {
        private double _Amount;
        
        // Public Property
        public double Amount
        {
            get
            {
                return _Amount;
            }
            set
            {
                // Validate the value before storing it
                if (value < 0)
                {
                    throw new Exception("Please Pass a Positive Value");
                }
                else
                {
                    _Amount = value;
                }
            }
        }
    }
    
    class Program
    {
        public static void Main()
        {
            Bank bank = new Bank();
            
            // Setting Positive Value using public Property
            bank.Amount = 10;
            
            // Getting the Value
            Console.WriteLine(bank.Amount);
            
            // This will throw an exception
            // bank.Amount = -150; 
        }
    }
}

فكدا خدنا كل مزايا الـ Methods لأنها عبارة عن Methods وخدنا كمان ميزة الكتابة السهلة.

---

Comprehensive Example: Phone Book

عشان نجمع كل اللي اتعلمناه، بص على المثال ده لـ struct بيمثل دليل هواتف (PhoneBook). المثال ده بيستخدم الـ Encapsulation بشكل كامل، وبيدمج بين الـ Properties، الـ Methods، والـ Indexers.

struct PhoneBook
{
    // Private Data (Hidden State)
    string[] Names;
    long[] Numbers;
    int size;
 
    // Read-only Property
    public int Size { get { return size; } }
 
    // Constructor
    public PhoneBook(int _Size) 
    {
        size = _Size;
        Names = new string[size];
        Numbers = new long[size];
    }
 
    // Setter method with validation
    public void SetEntry(int Index, string Name, long Number) 
    {
        if ((Index >= 0) && (Index < size))
        {
            Names[Index] = Name;
            Numbers[Index] = Number;
        }
    }
 
    // Getter method
    public long GetNumber(string Name) 
    {
        for (int i = 0; i < Names?.Length; i++)
            if (Names[i] == Name)
                return Numbers[i];
        return -1;
    }
}

---

Why Encapsulation? (Summary of Advantages)

• تحكم أفضل (Better Control): بيقلل احتمالية إنك (أو غيرك) تبوظ الكود الداخلي.
• تخصيص الصلاحيات: تقدر تخلي الـ fields تتقري بس (read-only) لو استخدمت الـ get بس، أو تتكتب بس (write-only) لو استخدمت الـ set بس.
• المرونة (Flexibility): المبرمج يقدر يغير جزء من الكود الداخلي (زي أسماء المتغيرات) بدون ما يأثر على الأجزاء التانية اللي بتستخدم الـ class ده.
• حماية البيانات (Data Protection & Security): تقدر تعمل validate للداتا قبل ما تتخزن، واليوزر الخارجي مبيكونش عنده فكرة عن التنفيذ الداخلي، وده بيحمي الكود.
• إخفاء البيانات (Data Hiding): الوحدات التانية متقدرش توصل للبيانات مباشرة وتلعب فيها.

---

Notes

• ليه نستخدم Properties بدل Methods؟: في C#، استخدام الـ Properties (زي public int Amount { get; set; }) هو الـ Standard المفضل (Idiomatic C#) عن إنك تعمل دالتين GetAmount() و SetAmount() زي ما بيحصل في لغة Java أو C++. الـ Properties بتديك نفس مستوى الأمان والحماية، بس بشكل كتابة مألوف وسهل كإنك بتتعامل مع متغير عادي.

What’s new in .NET 10

بما إننا بنتكلم عن الـ Encapsulation والـ Properties، فمن التحديثات الثورية المنتظرة في C# 14 (اللي بتيجي مع .NET 10) هي ميزة الـ “Field” keyword in auto-properties. حاليًا عشان تعمل validation جوه Property، لازم تعرّف private (Backing field) زي private double _Amount; وبعدين تستخدمه. في .NET 10، مش هتحتاج المتغير ده خالص! تقدر تستخدم الكلمة المحجوزة field مباشرة جوه الـ Property كالتالي:

public double Amount
{
    get => field;
    set
    {
        if (value < 0) throw new Exception("Positive values only");
        field = value;
    }
}

التحديث ده بيقلل كمية الكود بشكل كبير جدًا، وبيخلي تطبيق الـ Encapsulation أسهل وأنظف من أي وقت فات!