الدرس 5: أساسيات بناء الجملة في Java، التعليقات، واصطلاحات التسمية
الاتساق والوضوح أمران حاسمان في البرمجة.
1. قواعد بناء الجملة الأساسية
- حساسية حالة الأحرف: لغة Java حساسة لحالة الأحرف.
myVariableتختلف عنmyvariable. - البيانات (Statements): يجب أن تنتهي كل جملة برمجية في Java بفاصلة منقوطة (
;). - كتل الكود (Code Blocks): تحدد الأقواس المتعرجة (
{}) كتلة من الكود (مثلاً داخل فئة، أو دالة، أو حلقة). - المسافات البيضاء: تتجاهل Java إلى حد كبير المسافات البيضاء الإضافية، ولكن استخدمها لتنسيق الكود بشكل واضح.
2. التعليقات
التعليقات هي نصوص غير قابلة للتنفيذ تُستخدم لشرح الكود.
| النوع | الصيغة | حالة الاستخدام |
|---|---|---|
| سطر واحد | // هذا تعليق | شرح سطر معين أو متغير. |
| متعدد الأسطر | /* ... */ | تعطيل كتل كبيرة من الكود أو شرح مطول. |
| التوثيق (Javadoc) | /** ... */ | إنشاء توثيق خارجي للمشروع. |
java /**
-
هذه الفئة تمثل كائن طالب. */ public class Student { // هذا تعليق لسطر واحد private int age;
/*
- هذا تعليق متعدد الأسطر
- يصف المنشئ (constructor). */ public Student(int age) { this.age = age; } }
3. اصطلاحات التسمية (Naming Conventions)
تتبع Java اصطلاحات صارمة (CamelCase هي الأساس):
| العنصر | الاصطلاح | مثال |
|---|---|---|
| الفئات (Classes) | PascalCase (تبدأ بحرف كبير) | CarEngine, UserManager |
| الدوال (Methods) | camelCase (تبدأ بحرف صغير) | calculateTotal(), printDetails() |
| المتغيرات (Variables) | camelCase | firstName, currentSpeed |
| الثوابت (Constants) | SCREAMING_SNAKE_CASE (كلها أحرف كبيرة مع شرطة سفلية) | MAX_VALUE, PI_CONSTANT |
| الحزم (Packages) | كل الأحرف صغيرة | com.mycompany.utils |