المرجع

كل ما تحتاج إلى الرجوع إليه أثناء البرمجة، في مكان واحد.

هيكل كل برنامج

import java.util.Scanner;   // only when reading input

public class Main {
    public static void main(String[] args) {
        // your statements go here
    }
}

اختصارات NetBeans

الاختصار	ماذا يفعل
`Ctrl+Shift+N`	مشروع جديد
`sout + Tab`	يكتب أمر الطباعة
`psvm + Tab`	يكتب الدالة main
`F6`	تشغيل المشروع
`Shift+F6`	تشغيل الملف المفتوح
`Ctrl+S`	حفظ الملف
`Alt+Shift+F`	تنسيق الكود
`Ctrl+/`	تعليق السطر أو إلغاء تعليقه
`Ctrl+F5`	بدء التتبّع
`F8`	السطر التالي أثناء التتبّع
`F7`	الدخول إلى الدالة أثناء التتبّع

الأنواع

النوع	مثال	رمز printf	قراءته بواسطة Scanner
`int`	`19`	`%d`	`nextInt()`
`long`	`10L`	`%d`	`nextLong()`
`double`	`3.75`	`%f`	`nextDouble()`
`boolean`	`true`	`%b`	`nextBoolean()`
`char`	`'A'`	`%c`	`next().charAt(0)`
`String`	`"Sara"`	`%s`	`next() / nextLine()`

رموز printf

الرمز	الناتج	المعنى
`%d`	`25`	عدد صحيح
`%f`	`3.140000`	عدد عشري بست خانات
`%.2f`	`3.14`	خانتان عشريتان
`%s`	`Ali`	نص
`%c`	`A`	حرف
`%b`	`true`	قيمة منطقية
`%5d`	`25`	عرض 5 خانات، محاذاة لليمين
`%-5d`	`25`	عرض 5 خانات، محاذاة لليسار
`%05d`	`00025`	تعبئة بأصفار
`%n`	`↵`	سطر جديد
`%%`	`%`	علامة النسبة نفسها

ترتيب العوامل

الأولوية	العوامل
1 (الأعلى)	`() ++ -- ! (cast)`
2	`* / %`
3	`+ -`
4	`< <= > >=`
5	`== !=`
6	`&&`
7	`\|\|`
8 (الأدنى)	`= += -= *= /= %=`

مسرد المصطلحات

المصطلح	بالعربية	المعنى
`variable`	متغير	اسم يحمل قيمة يمكن أن تتغير
`data type`	نوع البيانات	يحدد نوع القيم التي يقبلها المتغير
`declaration`	تصريح	حجز متغير بنوع واسم
`assignment`	إسناد	وضع قيمة في متغير
`expression`	تعبير	كود يُحسب وينتج قيمة
`statement`	أمر	تعليمة كاملة تنتهي عادة بفاصلة منقوطة
`operator`	عامل	رمز ينفذ عملية، مثل `+`
`condition`	شرط	تعبير نتيجته صح أو خطأ
`loop`	حلقة	تكرار مجموعة أوامر
`method`	دالة	مجموعة أوامر لها اسم تؤدي مهمة
`parameter`	معامل	متغير تستقبل به الدالة قيمة
`argument`	وسيط	القيمة الممررة عند الاستدعاء
`return`	إرجاع	إعادة قيمة من الدالة إلى من استدعاها
`array`	مصفوفة	مجموعة قيم من نوع واحد لها مواقع مرقمة
`index`	موقع (فهرس)	رقم موقع العنصر، يبدأ من 0
`class`	صنف	الوحدة التي نكتب داخلها الكود
`package`	حزمة	مجلد يجمع الأصناف
`compiler`	المترجم	يحوّل الكود إلى صيغة قابلة للتشغيل
`bytecode`	البايت كود	الصيغة التي تشغّلها آلة Java الافتراضية
`exception`	استثناء	خطأ يحدث أثناء التشغيل
`debugging`	تتبّع الأخطاء	تشغيل البرنامج خطوة خطوة لفهمه وإصلاحه

دليل رسائل الخطأ

الرسالة	معناها	كيف تصلحها
`';' expected`	نقص رمز يتطلبه Java في هذا الموضع، وغالبًا هو الفاصلة المنقوطة `;` في نهاية الأمر.	انظر إلى نهاية السطر السابق للعلامة، وأضف الرمز الناقص.
`cannot find symbol`	استخدمت اسمًا لا يعرفه المترجم: إما لم تصرّح عنه، أو كتبته بحروف مختلفة.	تأكد من التصريح عن المتغير قبل استخدامه، ومن تطابق الحروف الكبيرة والصغيرة.
`cannot find symbol (method)`	استدعيت دالة غير موجودة بهذا الاسم أو بهذه المعاملات.	تحقق من اسم الدالة وعدد معاملاتها وأنواعها، مثل `println` وليس `printn`.
`cannot find symbol (class)`	هذا الصنف غير معروف، وغالبًا نسيت سطر `import`.	أضف الاستيراد المناسب، مثل `import java.util.Scanner;`.
`incompatible types`	نوع القيمة لا يناسب نوع المتغير، مثل وضع نص في `int` أو `double` في `int`.	غيّر نوع المتغير، أو حوّل القيمة، مثل `(int) 3.5` أو `Integer.parseInt("19")`.
`not a statement`	كتبت تعبيرًا لا يفعل شيئًا وحده، مثل `x + 1;`.	خزّن النتيجة أو اطبعها، مثل `x = x + 1;`.
`unclosed string literal`	فتحت علامة تنصيص `"` ولم تغلقها في السطر نفسه.	أضف علامة التنصيص الناقصة.
`unclosed comment`	فتحت تعليقًا بالرمز `/*` ولم تغلقه، فصار بقية الملف تعليقًا.	أضف `*/` في نهاية التعليق.
`reached end of file while parsing`	انتهى الملف قبل أن تُغلق كل الأقواس، فهناك `}` ناقصة.	عُدّ الأقواس، واستخدم Alt+Shift+F لتنسيق الكود في NetBeans.
`illegal start of expression`	في هذا الموضع رمز لا يمكن أن يبدأ به تعبير، وغالبًا السبب قوس ناقص قبله.	راجع الأقواس والسطر الذي قبل العلامة.
`illegal start of type`	يوجد كود في مكان لا يُسمح فيه، غالبًا خارج `main` أو بعد قوس زائد.	تأكد أن أوامرك داخل قوسي `main`.
`variable x might not have been initialized`	تحاول قراءة متغير قد لا يحمل قيمة بعد.	أسند له قيمة عند التصريح، مثل `int x = 0;`.
`variable x is already defined`	صرّحت عن الاسم نفسه مرتين في النطاق نفسه.	احذف النوع من السطر الثاني إن أردت الإسناد فقط: `x = 5;`.
`missing return statement`	قد تنتهي الدالة دون إرجاع قيمة، مع أن نوعها ليس `void`.	تأكد أن كل مسار في الدالة ينتهي بأمر `return`.
`incomparable types`	تقارن قيمتين من نوعين لا تصح مقارنتهما.	حوّل إحدى القيمتين، أو قارن النصوص باستخدام `equals`.
`bad operand types for binary operator`	هذا العامل لا يعمل مع هذين النوعين، مثل طرح نص من عدد.	تأكد من أنواع القيم على طرفي العامل.
`'else' without 'if'`	يوجد `else` بلا `if` قبله مباشرة، وغالبًا السبب `;` بعد الشرط أو قوس ناقص.	احذف الفاصلة المنقوطة بعد `if (...)` وراجع الأقواس.
`break outside switch or loop`	الأمر `break` يعمل داخل حلقة أو `switch` فقط.	انقله إلى داخل الحلقة، أو استخدم `return` للخروج من الدالة.
`unreachable statement`	لن يصل التنفيذ إلى هذا السطر أبدًا، مثل سطر بعد `return` أو `break`.	احذف السطر أو انقله إلى قبل الأمر الذي ينهي التنفيذ.
`method cannot be applied to given types`	استدعيت الدالة بعدد أو أنواع معاملات لا تطابق تعريفها.	طابق عدد المعاملات وأنواعها مع تعريف الدالة.
`class X is public, should be declared in a file named X.java`	اسم الصنف العام يجب أن يطابق اسم الملف تمامًا.	غيّر اسم الصنف أو اسم الملف ليتطابقا.
`integer number too large`	هذا العدد أكبر مما يتسع له `int`.	استخدم `long` وأضف الحرف `L`، مثل `3000000000L`.
`incompatible types`	نوع القيمة لا يناسب ما هو مطلوب هنا.	راجع نوع القيمة ونوع المتغير.
`ArithmeticException: / by zero`	قسمة عدد صحيح على صفر أثناء التشغيل.	تحقق من أن المقسوم عليه ليس صفرًا قبل القسمة.
`ArrayIndexOutOfBoundsException`	استخدمت موقعًا خارج حدود المصفوفة. المواقع تبدأ من 0 وتنتهي عند `length - 1`.	راجع شرط الحلقة: استخدم `i < a.length` وليس `i <= a.length`.
`StringIndexOutOfBoundsException`	موقع الحرف خارج حدود النص.	المواقع من 0 إلى `length() - 1`.
`NullPointerException`	استخدمت متغيرًا قيمته `null`، أي لا يشير إلى شيء.	أنشئ الكائن أو أسند قيمة للمتغير قبل استخدامه.
`NumberFormatException`	تحاول تحويل نص إلى عدد، لكن النص ليس عددًا صحيحًا.	تأكد من محتوى النص قبل استخدام `Integer.parseInt`.
`InputMismatchException`	طلب `Scanner` عددًا لكن المدخل كان نصًا.	أدخل قيمة من النوع المطلوب، أو تحقق باستخدام `hasNextInt()`.
`NoSuchElementException`	يطلب البرنامج مدخلات أكثر مما تم إدخاله.	تأكد من عدد القراءات وعدد المدخلات.
`IllegalFormatConversionException: d != java.lang.String`	رمز التنسيق لا يناسب نوع القيمة، مثل `%d` مع نص أو عدد عشري.	استخدم `%d` للأعداد الصحيحة و`%f` للعشرية و`%s` للنصوص.
`MissingFormatArgumentException: Format specifier '%d'`	في القالب رموز تنسيق أكثر من القيم المعطاة.	أعطِ قيمة لكل رمز تنسيق بالترتيب.
`StackOverflowError`	دالة تستدعي نفسها بلا توقف حتى امتلأت الذاكرة المخصصة للاستدعاءات.	أضف شرط توقف للدالة التراجعية.