الـ Enums ودوالها

جزء من قسم Object Oriented Programming في رحلة Java على Coddy — الدرس 50 من 87.

يُعد الـ enum (التعداد) نوعاً خاصاً من الفئات (class) يمثل مجموعة ثابتة من الثوابت. فبدلاً من استخدام أعداد صحيحة أو سلاسل نصية عشوائية لتمثيل خيارات مثل أيام الأسبوع أو حالات الطلب، توفر التعدادات (enums) قيماً آمنة من حيث النوع (type-safe) وقابلة للقراءة.

enum Day {
    MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY
}

Day today = Day.MONDAY;
System.out.println(today);  // يطبع: MONDAY

تعد أنواع التعداد (Enums) أكثر من مجرد ثوابت بسيطة، فهي فئات (classes) كاملة. يمكنك إضافة حقول (fields)، ومنشئات (constructors)، ودوال (methods) إليها:

enum Size {
    SMALL(10), MEDIUM(20), LARGE(30);
    
    private int price;
    
    Size(int price) {
        this.price = price;
    }
    
    public int getPrice() {
        return price;
    }
}

System.out.println(Size.MEDIUM.getPrice());  // يطبع: 20

يأتي كل enum مع دوال مدمجة مفيدة. تُرجع الدالة values() مصفوفة من جميع الثوابت، بينما تقوم valueOf() بتحويل سلسلة نصية إلى ثابت enum المطابق. تُرجع الدالة ordinal() موضع الثابت (بدءاً من 0):

for (Day d : Day.values()) {
    System.out.println(d + " is at position " + d.ordinal());
}

Day day = Day.valueOf("FRIDAY");  // يحول السلسلة النصية إلى enum

تعتبر التعدادات (Enums) مثالية عندما يكون لديك مجموعة معروفة وثابتة من القيم التي لن تتغير أثناء وقت التشغيل (runtime)، مما يجعل الكود الخاص بك أكثر أماناً وأكثر تعبيراً من استخدام الثوابت العادية.

التحدي

سهل

لنقم ببناء نظام لطلب القهوة يوضح قوة التعدادات (enums) مع الحقول، والمشيدات (constructors)، والأساليب (methods). ستقوم بإنشاء enum باسم CoffeeSize يخزن معلومات التسعير ونظاماً لمعالجة طلبات العملاء.

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

CoffeeSize.java: قم بإنشاء enum يمثل أحجام القهوة مع الأسعار المرتبطة بها. يجب أن يحتوي الـ enum الخاص بك على ثلاثة ثوابت: SMALL، و MEDIUM، و LARGE بأسعار 2.50، و 3.50، و 4.50 على التوالي.
يحتاج كل حجم إلى حقل price خاص (double)، ومشيد لتعيينه، وطريقة getPrice() لاسترجاعه. أضف أيضاً طريقة getDescription() التي تعيد سلسلة نصية بالتنسيق التالي: [size name] - $[price] (على سبيل المثال: SMALL - $2.5)
Order.java: قم بإنشاء فئة (class) تمثل طلب القهوة. يحتوي الطلب (Order) على حقلين خاصين: customerName (String) و size (CoffeeSize). قم بتضمين مشيد لتهيئة كلا الحقلين وطرق getter لكل منهما.
أضف طريقة getReceipt() التي تعيد سلسلة نصية متعددة الأسطر:
```
Order for: [customerName]
Size: [size description from getDescription()]
Total: $[price from the size]
```
Main.java: اجعل مقهى القهوة الخاص بك ينبض بالحياة! ستتلقى مدخلين: اسم العميل (String) واسم الحجم (String مثل "SMALL" أو "MEDIUM" أو "LARGE").
أولاً، استخدم CoffeeSize.valueOf() لتحويل سلسلة الحجم النصية إلى ثابت enum المقابل. أنشئ طلباً (Order) باسم العميل والحجم، ثم اطبع الإيصال.

بعد طباعة الإيصال، اطبع سطراً فارغاً، ثم اعرض القائمة الكاملة من خلال التكرار عبر جميع قيم CoffeeSize باستخدام طريقة values(). لكل حجم، اطبع وصفه في سطر منفصل.

ستتلقى مدخلين بالترتيب: اسم العميل واسم الحجم (واحد من "SMALL" أو "MEDIUM" أو "LARGE").

لاحظ كيف يغلف الـ enum كلاً من هوية الحجم والسعر المرتبط به — وهذا أنظف بكثير من استخدام ثوابت منفصلة أو أرقام سحرية (magic numbers) في جميع أنحاء الكود الخاص بك!

ورقة مرجعية

الـ enum هو نوع فئة خاص يمثل مجموعة ثابتة من الثوابت، مما يوفر قيمًا آمنة النوع (type-safe) وسهلة القراءة:

enum Day {
    MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY
}

Day today = Day.MONDAY;
System.out.println(today);  // يطبع: MONDAY

يمكن أن تحتوي الـ Enums على حقول (fields)، ومنشئات (constructors)، ودوال (methods):

enum Size {
    SMALL(10), MEDIUM(20), LARGE(30);
    
    private int price;
    
    Size(int price) {
        this.price = price;
    }
    
    public int getPrice() {
        return price;
    }
}

System.out.println(Size.MEDIUM.getPrice());  // يطبع: 20

دوال الـ enum المدمجة:

values() - تعيد مصفوفة تحتوي على جميع ثوابت الـ enum
valueOf(String) - تحول سلسلة نصية إلى ثابت الـ enum المطابق
ordinal() - تعيد ترتيب (موقع) الثابت (بدءاً من 0)

for (Day d : Day.values()) {
    System.out.println(d + " is at position " + d.ordinal());
}

Day day = Day.valueOf("FRIDAY");  // يحول السلسلة النصية إلى enum

جرّب بنفسك

import java.util.Scanner;

class Main {
    public static void main(String[] args) {
        Scanner scanner = new Scanner(System.in);
        
        // قراءة المدخلات
        String customerName = scanner.nextLine();
        String sizeName = scanner.nextLine();
        
        // TODO: تحويل sizeName إلى CoffeeSize enum باستخدام valueOf()
        
        // TODO: إنشاء Order باسم العميل والحجم
        
        // TODO: طباعة الإيصال
        
        // TODO: طباعة سطر فارغ
        
        // TODO: عرض القائمة الكاملة من خلال التكرار عبر جميع قيم CoffeeSize
        // Hint: استخدم CoffeeSize.values() للحصول على جميع ثوابت enum
        
    }
}