في هذا المقال، سنتعرف على كيفية إنشاء Api End Point REST بسيطة باستخدام إطار العمل Spring Boot. الكود التالي يمثل تطبيقًا صغيرًا يعرض رسالة ترحيبية عند زيارة الرابط الجذر ("/").
ونأتي الان لشرح الاكواد بالتفصيل سطربسطر:
🔧 أولاً: الحزمة (Package)
- هذا السطر يحدد المسار الحزمي (package) للكلاس داخل المشروع.
- التنظيم بالحزم يجعل المشروع أكثر قابلية للإدارة، وهنا يتم تنظيم الكود داخل الحزمة
com.mutee.learnSpringboot.learnSpringBoot.rest.
📦 الاستيراد (Imports)
- @RestController: من مكتبة Spring، وتُستخدم لجعل الكلاس يستجيب لطلبات HTTP (عادةً تُستخدم في REST APIs).
- @GetMapping: تحدد أن هذه الدالة ستُستدعى عندما يستقبل السيرفر طلبًا من نوع GET على رابط معين.
🎯 الكلاس الرئيسي
- @RestController: هذه التعليمة تجعل Spring Boot يفهم أن هذا الكلاس هو "Controller" (أي: وحدة تحكم تستقبل طلبات الـ HTTP وتُرجع ردود).
- الكلاس يُسمى FunRestController، ويمكن تسميته بأي اسم، لكن الاسم يوضح أنه مسؤول عن التحكم في الطلبات القادمة للـ REST API.
🌐 النقطة النهائية (Endpoint)
التحليل:
- @GetMapping("/"):
- تُستخدم لتحديد أن هذه الدالة مرتبطة بمسار "/" (أي: العنوان الجذري للسيرفر).
- عندما يفتح المستخدم المتصفح على العنوان: http://localhost:8080/ فسيتم تنفيذ هذه الدالة.
- public String sayHello(): دالة تُعيد نص بسيط من نوع String.
- return "Hello World";: الجملة التي سترجع للمستخدم عند فتح الرابط. أي أن المستخدم سيرى "Hello World" في المتصفح.
✅ النتيجة النهائية:
تعليقات
إرسال تعليق