تقييم الموضوع :
  • 0 أصوات - بمعدل 0
  • 1
  • 2
  • 3
  • 4
  • 5
الدرس السابع - التعليقات
#1
كاتب الموضوع : tibo



التعليقات


ان كاتب أي برنامج يحتاج في بعض الأحيان أن يضيف بعض التعليقات و الملاحظات الخاصة به و التي لا يريد ان يتم تنفيذها في برنامجه.
ما هي التعليقات:

انها الأسطر التي يتجاهلها مترجم الجافا، و لكنها تجعل الكود أسهل قراءة للمبرمج نفسه. بعبارة اخرى انها مجموعة الملاحظات التي يضعها المبرمج في كوده لتسهيل قراءته.
أنواع التعليقات في الجافا:

يمكننا ان نضع ملاحظاتنا في برامج الجافا بثلاثة طرق:
التعليق بسطر واحد:


كما هو موضح في الشكل، فإن هذا النوع من التعليق يتم بوضع علامتي (//) قبل السطر المراد تعليقه. و هذا يعني أن يتجاهله المترجم تماماً. و لكنه بالطبع يقوم بتوضيح بعض الأمور للمبرمج. فأنت مثلاً و انت تنظر للصورة تعرف ان الرقم 100 الموجود في الأسفل يمثل ال total الذي يتحدث عنه المبرمج. و هذا بالطبع يعني شيئاً ما للبرنامج


أما في هذا الشكل، فقد تم اضافة التعليق في نهاية بعض الأسطر. و هذا يسهّل الأمور. لأن المترجم سيقوم بتنفيذ البرنامج حتى يصل لعلامتي (//) عندها سيتجاهل بقية السطر، و سينتقل لتنفيذ السطر التالي.

التعليق بعدة أسطر:



نلاحظ هنا أنه تم حجز عدد من الأسطر بين (*/) و (/*).
و هذا يعني ان هذه الأسطر هي عبارة عن تعليق. و لن يتم تنفيذها في البرنامج، و لكنها وضعت للتوضيح.

ان رؤية المترجم لـ (*/) تجعله يتجاهل كل ما يقابله حتى يصل لعلامة (/*) و يقوم بتنفيذ ما يليها.

التعليق بهدف اضافة معلومات لملفات المساعدة:


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



كما ترى في الصورة فقد تم حصر التعليق بين (**/) و (/*) و هذا يعني ان هذه العبارة ستكون خاصة بالتعليق الذي سيظهر في ملفات المساعدة.

نلاحظ في هذا النوع من التعليقات انه يجب ان تسبق بعض المكونات المحددة في البرنامج، و انها توضح بعض الامكانات لها.

الخاتمة:

ان التعليقات في أي برنامج تساهم في توضيحه و تجعل قراءته أسهل. و اذا كنت تنوي ان تكون مبرمجاً محترفاً، فلا تجعل تهمل التعليقات أبداً. بل و لابد أن تجعل كودك أسهل و أسهل بجعل الكود يتكلم عن نفسه بأن تستخدم اسماء واضحة للمتغيرات و الفئات.

خاتمة القول، استخدم العليق كلما بدا ذلك ضرورياً. و لا تنسى أن شيئاً يبدو واضحاً و بديهياً الآن قد لا يبدو كذلك بعد اربعة أو خمسة أسابيع.

أرجو أن يكون الدرس واضحاً.
}}}}
تم الشكر بواسطة:


المواضيع المحتمل أن تكون متشابهة .
الموضوع : الكاتب الردود : المشاهدات : آخر رد
  الدرس السادس عشر - الطرق Methods RaggiTech 0 638 19-10-12, 12:42 PM
آخر رد: RaggiTech
  الدرس الخامس عشر - أوامر التحكّم - التكرار RaggiTech 0 642 19-10-12, 12:40 PM
آخر رد: RaggiTech
  الدرس الرابع عشر - أوامر التحكّم - الجمل الشرطية RaggiTech 0 754 19-10-12, 12:38 PM
آخر رد: RaggiTech
  الدرس الثالث عشر - العمليات RaggiTech 0 499 19-10-12, 12:36 PM
آخر رد: RaggiTech
  الدرس الحادي عشر - إستدعاء حزمة الواجهة الرسومية والعمل عليها RaggiTech 0 803 19-10-12, 12:33 PM
آخر رد: RaggiTech
  الدرس العاشر - حزم الجافا (Java Packages) RaggiTech 0 604 19-10-12, 12:32 PM
آخر رد: RaggiTech
  الدرس التاسع - كيفية استخدام UndoManager بالبرامج RaggiTech 0 517 19-10-12, 12:26 PM
آخر رد: RaggiTech
  الدرس الثامن - تخزين البيانات الضخمة بقاعدة البيانات اوراكل بواسطة الجافا RaggiTech 0 737 19-10-12, 12:26 PM
آخر رد: RaggiTech
  الدرس السادس (في جافا) - البرمجة بالكائنات الشيئية RaggiTech 0 559 19-10-12, 12:14 PM
آخر رد: RaggiTech
  الدرس الخامس- البحث الثنائى فى المصفوفة Binary Search RaggiTech 0 1,255 19-10-12, 12:12 PM
آخر رد: RaggiTech

التنقل السريع :


يقوم بقرائة الموضوع: بالاضافة الى ( 1 ) ضيف كريم