الواجهات البرمجية والمكتبات

مفردات

English	المعنى
library/ˈlaɪbrəri/	مكتبة
API/ˌeɪ piː ˈaɪ/	واجهة برمجة التطبيقات

الوقوف على أكواد الآخرين

لا تكتب كل شيء من الصفر — Java مزودة بكميات هائلة من الأكواد الجاهزة.
المكتبة هي مجموعة من الفئات المكتوبة مسبقاً يمكنك استخدامها.
المكتبة القياسية لـ Java تتضمن String، Math، Scanner، ArrayList، وألاف غيرها.
إعادة استخدام أكواد مكتبات مختبرة أسرع وأكثر أماناً من اختراعها من جديد.

ما يخبرك به واجهة برمجة التطبيقات

واجهة برمجة التطبيقات (API) هي القائمة الموثقة لما تقدمه الفئة.
تخبرك باسم كل طريقة وما هي المعاملات التي تأخذها وماذا ترجع.
تبرمج بناءً على الـ API — تستخدم الطريقة حسب سلوكها الموثق، لا الكود الداخلي.
الـ API عقد: "أعطني هذه المدخلات، سأعطيك هذا المخرج."

استيراد فئة

بعض الفئات تحتاج إلى جملة import قبل استخدامها.
import java.util.Scanner; يجعل Scanner متاحاً.
الفئات الأساسية مثل String وMath موجودة في java.lang — يتم استيرادها تلقائياً.
الاستيراد يكون في أعلى الملف، فوق الفئة.

استخدامه دون رؤية الداخل

يمكنك استدعاء Math.sqrt(x) دون معرفة كيف تحسب الجذر التربيعي.
هذا هو التجريد: يخفي الـ API التنفيذ خلف واجهة بسيطة.
تحتاج فقط إلى ماذا (السلوك الموثق)، وليس كيف.
المكتبات الجيدة تسمح لك بالبناء بسرعة باعتبار الكود المعقد صندوقاً أسود.

استكشف

استخدم مكتبة، أم اكتبها بنفسك؟

رتّب كل مهمة حسب ما إذا كانت المكتبة القياسية تقوم بها بالفعل.

Watch out

أنت تبرمج بناءً على السلوك الموثق للـ API، لا الكود الداخلي. اقرأ ما تأخذه وما ترجعه الطريقة — لا تحتاج (أو تريد) رؤية كيف تعمل بالداخل. تذكر أن معظم الفئات تحتاج إلى import، لكن فئات java.lang (String، Math، System، Integer) يتم استيرادها تلقائياً، لذا Scanner يحتاج import java.util.Scanner; بينما Math لا يحتاج.

Example

استخدام مكتبة Math:

لا حاجة لاستيراد — Math موجودة في java.lang.
double r = Math.sqrt(16); → r هو 4.0، ولن ترى خوارزمية أبداً.
الـ API وعد فقط: "أعطني رقماً، أرجع جذره التربيعي."

Key idea

المكتبة هي كود مكتوب مسبقاً قابل لإعادة الاستخدام؛ واجهة برمجة التطبيقات توثق طرق كل فئة — أسمائها ومعاملاتها وقيم الإرجاع — حتى تبرمج بناءً على السلوك الموثق. معظم الفئات تحتاج إلى import (مثل Scanner)، لكن فئات java.lang (String، Math) يتم استيرادها تلقائياً. الـ API هو التجريد: استخدمه دون رؤية الداخل.

تدريب

توثق الواجهة البرمجية (API) طرق الفئة من خلال إخبارك بـ...