فهم الـ Methods في جافا - بناء كتل الكود القابلة لإعادة الاستخدام

📖 فهم الـ Methods في جافا: بناء كتل الكود القابلة لإعادة الاستخدام

مرحباً بك في درس جديد من أكاديمية كودكس! تخيل أنك تريد تنفيذ مهمة محددة في برنامجك، مثل حساب متوسط درجات الطلاب. بدلاً من كتابة نفس الأوامر الحسابية في كل مرة تحتاج فيها إلى هذه المهمة، يمكنك تغليفها داخل وحدة واحدة قابلة للاستدعاء. هذه الوحدة تسمى Method (وظيفة أو دالة). في هذا الدرس، سنتعلم معاً كيف ننشئ Methods ونستخدمها لجعل كودنا أكثر تنظيماً وفعالية.

🔍 ما هي الـ Method في جافا؟

الـ Method هي مجموعة من الأوامر (statements) مجمعة معاً لأداء مهمة أو عملية محددة. يمكنك التفكير فيها كـ "وصفة" أو "تعليمات" جاهزة. بمجرد كتابة هذه التعليمات مرة واحدة، يمكنك استدعاؤها (Call) وتنفيذها من أي مكان في برنامجك، عدة مرات كما تشاء.

فوائد استخدام Methods:

• إعادة الاستخدام (Reusability): اكتب الكود مرة واحدة، واستخدمه مراراً.
• التنظيم (Modularity): تقسيم البرنامج المعقد إلى أجزاء صغيرة وواضحة المسؤولية.
• سهولة الصيانة (Maintenance): إذا أردت تعديل المهمة، فأنت تعدلها في مكان واحد فقط (داخل الـ Method).

📝 هيكل أو بناء Method في جافا (Syntax)

لإنشاء Method، نتبع القواعد التالية:

modifier returnType methodName(parameterList) {
    // جسم الـ Method: الأوامر التي نريد تنفيذها
    // ...
    // قد تحتوي على جملة return
}

دعونا نشرح كل جزء:

1. modifier (مُعدِّل الوصول): يحدد من يمكنه استخدام هذه الـ Method. في بدايتنا، سنستخدم public باستمرار، مما يعني أنها متاحة للاستخدام من أي مكان.
2. returnType (نوع القيمة المُرجعة): يحدد نوع البيانات الذي سترجعه الـ Method بعد تنفيذها (مثل int, String, double). إذا كانت الـ Method لا ترجع أي قيمة، نستخدم الكلمة المفتاحية void.
3. methodName (اسم الـ Method): هو اسم نختاره لوصف مهمة الـ Method. نتبع نفس قواعد تسمية المتغيرات (تبدأ بحرف، ولا مسافات).
4. parameterList (قائمة المعاملات): قائمة متغيرات نضعها بين قوسين ()، تفصل بينها بفواصل. نستخدمها لإدخال بيانات للـ Method لتعمل عليها. يمكن أن تكون فارغة ().
5. جسم الـ Method { }: بداخله نكتب جميع الأوامر التي نريد تنفيذها عندما يتم استدعاء الـ Method.

🧪 أنواع Methods بناءً على القيمة المُرجعة والمعاملات

1. Method لا ترجع قيمة (void) وبدون معاملات (Parameters)

هذه أبسط صورة. تنفذ مهمة ولا تحتاج لبيانات إدخال ولا ترجع نتيجة.

مثال: Method للترحيب.

public class Main {
    // تعريف الـ Method
    public static void sayHello() {
        System.out.println("مرحباً بكم في أكاديمية كودكس! 👋");
    }

    public static void main(String[] args) {
        // استدعاء الـ Method
        sayHello(); // ستطبع: مرحباً بكم في أكاديمية كودكس! 👋
        sayHello(); // يمكن استدعاؤها مرة أخرى
    }
}

2. Method لا ترجع قيمة (void) ولكن لها معاملات

تأخذ بيانات كمدخلات (Input) لتعمل عليها.

مثال: Method لطباعة رسالة مخصصة.

public class Main {
    // تعريف method تأخذ معامل من نوع String اسمه 'message'
    public static void printMessage(String message) {
        System.out.println("📨 رسالتك: " + message);
    }

    public static void main(String[] args) {
        // نمرر قيمة نصية عند الاستدعاء (تُسمى Argument)
        printMessage("أنا أتعلم الجافا!");
        printMessage("الـ Methods رائعة!");
    }
}

المعامل (Parameter): هو المتغير الموجود في تعريف الـ Method (String message). الوسيط (Argument): هي القيمة الفعلية التي نمررها عند استدعاء الـ Method ("أنا أتعلم الجافا!").

3. Method ترجع قيمة (Return Value)

هنا تكمن القوة الحقيقية! تقوم الـ Method بحساب أو معالجة ثم ترجع النتيجة.

مثال: Method لجمع عددين.

public class Main {
    // تعريف method ترجع قيمة من نوع int
    public static int sum(int num1, int num2) {
        int result = num1 + num2; // نحسب النتيجة
        return result; // نُرجع النتيجة باستخدام كلمة 'return'
    }

    public static void main(String[] args) {
        int total = sum(5, 3); // نستدعيها ونخزن القيمة المُرجعة في متغير
        System.out.println("مجموع 5 و 3 هو: " + total); // الناتج: 8

        // يمكننا استخدامها مباشرة في طباعة أو عملية أخرى
        System.out.println("مجموع 10 و 20 هو: " + sum(10, 20));
    }
}

ملاحظة مهمة: عندما يكون نوع الإرجاع غير void، يجب أن تحتوي الـ Method على جملة return تليها قيمة من نفس النوع المعلن.

📞 كيف نستدعي Method؟ (Method Call)

استدعاء الـ Method يعني طلب تنفيذ الأوامر الموجودة داخلها. نكتب اسمها متبوعاً بأقواس ().

• إذا كانت الـ Method تأخذ معاملات، نمرر القيم (Arguments) داخل الأقواس.
• إذا كانت ترجع قيمة، يمكننا تخزين هذه القيمة في متغير أو استخدامها مباشرة.

// استدعاء method لا ترجع قيمة
sayHello();

// استدعاء method تأخذ معاملات
printMessage("Hello World");

// استدعاء method ترجع قيمة وتخزين الناتج
int mySum = sum(7, 8);

// استدعاء method ترجع قيمة واستخدام الناتج مباشرة
System.out.println( sum(2, 2) );

🧩 مثال شامل يجمع الأنواع

لنطبق كل ما تعلمناه في مثال واحد بسيط:

public class CalculatorDemo {
    // 1. method من نوع void بدون parameters
    public static void showAppName() {
        System.out.println("=== الآلة الحاسبة البسيطة ===");
    }

    // 2. method من نوع void مع parameters
    public static void showOperation(int a, int b, String op) {
        System.out.println("العملية: " + a + " " + op + " " + b);
    }

    // 3. method ترجع قيمة
    public static int multiply(int x, int y) {
        return x * y;
    }

    public static void main(String[] args) {
        showAppName(); // استدعاء النوع الأول

        int number1 = 6;
        int number2 = 7;

        showOperation(number1, number2, "x"); // استدعاء النوع الثاني

        int answer = multiply(number1, number2); // استدعاء النوع الثالث
        System.out.println("الناتج: " + answer);
    }
}

🧠 ملخص الدرس

في هذا الدرس، تعلمنا أن:

• الـ Method هي كتلة كود قابلة لإعادة الاستخدام تؤدي مهمة محددة.
• تتكون من: مُعدِّل، نوع الإرجاع، اسم، معاملات، وجسم.
• نوع الإرجاع void يعني أن الـ Method لا ترجع قيمة.
• نستخدم المعاملات (Parameters) لإدخال بيانات للـ Method.
• نستخدم جملة return لإرجاع قيمة من الـ Method.
• نستدعي الـ Method بكتابة اسمها والأقواس ()، وتمرير القيم إذا لزم الأمر.