LearningJDK

ملاحظات قراءة كود مصدر JDK

اقرأ كود المصدر اللعين ---- RTFM

أمام الكود المصدري، لا توجد أسرار ---- هوى جي

مقدمة المشروع

يقوم هذا المشروع بشكل أساسي بتنظيم/تسجيل الفهم والخبرة عند قراءة كود مصدر JDK ، كمرجع فقط.

يحتوي المشروع على عدة فروع. يسمى الفرع الرئيسي master ، ويسمى فرع الاختبار test ، ويسمى فرع التعليمات البرمجية المصدر/الملاحظات باسم JDK-X ( X هو إصدار JDK ).

• يقوم الفرع master أحيانًا بتجميع لقطات من ملاحظات الكود المصدري وكود الاختبار.

• يقوم فرع JDK-X بتخزين الكود المصدري وملاحظات JDK . تتم كتابة الملاحظات التي تم إنشاؤها أثناء عملية القراءة مباشرة في ملف التعليمات البرمجية المصدر في شكل تعليقات .

• يقوم فرع test بتخزين رمز الاختبار للمساعدة في الفهم ويمكن تشغيله مباشرة.

  • ملاحظة 1: يوصى بتشغيل ملف الاختبار في بيئة OracleJDK / OpenJDK 11
  • ملاحظة 2: لن تتم كتابة ملفات الاختبار لجميع الفئات/الواجهات، بعضها لأنها بسيطة للغاية، والبعض الآخر بسبب كتابة عدد كبير من الملفات المشابهة، والبعض الآخر بسبب عدم الفهم الصحيح.

تعليمات الاستخدام

1. جاهز للاستخدام مباشرة بمجرد إخراجه من الصندوق. قم باستنساخ/تنزيل المشروع محليًا وافتحه باستخدام IntelliJ IDEA .

2. برجاء التبديل إلى فرع JDK-X عند قراءة الكود المصدري، وليست هناك حاجة لربط JDK .

   عند اختبار الكود المصدري، يرجى التبديل إلى فرع test في هذا الوقت، تحتاج إلى ربط OracleJDK / OpenJDK .

3. لا يدعم كود المصدر هذا الترجمة المباشرة. إذا كنت ترغب في تجميع مشروع JDK بالكامل، فيرجى الرجوع إلى البرنامج التعليمي الرسمي لبناء JDK.

4. إذا أبلغ كود المصدر عن خطأ بسبب فقدان ملفات تبعية فردية، فيرجى البحث عن حزمة الجرة ذات الصلة على Google واستيرادها. أو يمكنك ترك تعليقات حول مشكلات Github.

5. مرحبًا بكم في تبادل الأفكار والاقتراحات والآراء الجيدة حول مشكلات Github.

ارتكاب الأسطورة

رقم سري	com.emoji	ماذا يعني في هذا المشروع	علامة الاختصار
(0)	؟	تهيئة المشروع	:tada:
(1)		قم بتحديث الوثائق، بما في ذلك على سبيل المثال لا الحصر ملف README	:memo:
(2)		نشر ملاحظات القراءة الجديدة (الملاحظة 1)	:bulb:
(3)		التحديث المتزايد لملاحظات القراءة	:sparkles:
(4)	♻️	تشير إعادة البناء بشكل أساسي إلى تعديل ملاحظات القراءة الموجودة، وفي حالات نادرة، سيتم تعديل كود المصدر (الملاحظة 2).	:recycle:
(5)	✏️	يشير التدقيق اللغوي بشكل أساسي إلى تصحيح الأخطاء المطبعية، وضبط تجميع التعليمات البرمجية المصدر، وتعديل تنضيد التعليمات البرمجية المصدر، وما إلى ذلك.	:pencil2:
(6)	✅	نشر ملفات الاختبار	:white_check_mark:

ملاحظة 1:

لمعرفة التقدم الحالي في القراءة لكود مصدر معين، يرجى الرجوع إلى قائمة رموز القراءة_الفرز حسب الوظيفة.

ملاحظة 2: تتضمن السيناريوهات التي تتضمن تعديل التعليمات البرمجية المصدر، على سبيل المثال لا الحصر، ما يلي:

تعديل أسماء المتغيرات التي لا معنى لها إلى أسماء متغيرة أكثر قابلية للفهم؛
إكمال الأقواس المتعرجة في نطاق بيان التحكم؛
إعادة بناء بنية بيان التحكم (مثل تقسيم عبارات if وتبادل for/while)؛
التحويل بين حلقة for و foreach حلقة.
تقسيم سلسلة الاتصال الطويلة جدًا والتي يصعب قراءتها، وعزل العمليات الوسيطة؛
استخراج عملية تحدث بشكل متكرر في طريقة واحدة؛
تقسيم عدة فئات ذات مستوى أعلى في ملف واحد إلى ملفات مختلفة (لا يتم تقسيم الفئات الداخلية)؛
التحويل بين الفئات المجهولة والفئات غير المجهولة؛
تحويل الفئات المجهولة وتعبيرات الوظائف؛
التحويل بين المكالمات الوظيفية والمكالمات العادية؛

مبدأ التعديل هو: تعديل أقل قدر ممكن دون تغيير منطق الكود الأصلي وتشغيل النتائج (الكود الذي يتضمن مؤشرات ترابط متعددة مربك بعض الشيء)
الغرض من التعديل هو تحسين إمكانية القراءة وتسهيل إدراج الملاحظات

روابط ذات صلة

أوراكل JDK

OpenJDK

حاشية سفلية

المصدر المرجعي emoji في معلومات الالتزام:

• قائمة الرموز التعبيرية الكاملة

• com.gitmoji

زائدة

قراءة قائمة التعليمات البرمجية_مرتبة حسب الوظيفة

قراءة التعليمات البرمجية list_sort حسب الاسم

قائمة ملفات الاختبار