التصميم
خطّط بنية REST API: نقاط النهاية، ونماذج البيانات، وتدفق العمل.
التصميم درس مجاني في Java Academy على CoddyKit. هذا هو الدرس 1 من أصل 4. يمكنك قراءة الدرس كاملاً أدناه مجاناً — ثم تمرن عليه مباشرة في المتصفح باستخدام محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7. هذا الدرس جزء من مسار التعلم في Java Academy، وتقدمك يتزامن عبر الويب وتطبيق CoddyKit. تتضمن دورة Java Academy 4 دروس في المجموع.
مقدمة
الهدف: تصميم REST API صغير لإدارة المهام. سنحدّد نقاط النهاية ونماذج البيانات والتدفق.
نقاط النهاية
GET /tasks: عرض جميع المهامPOST /tasks: إنشاء مهمةGET /tasks/{id}: الحصول على مهمة واحدةPUT /tasks/{id}: تحديث مهمةDELETE /tasks/{id}: حذف مهمة
الشفرة: نموذج Task
يحتوي نموذج Task على حقول المعرّف والعنوان وحالة الإنجاز.
public class Task {
private Long id;
private String title;
private boolean done;
// getters/setters omitted
}
التدفق
التدفق: تتولى وحدة التحكم معالجة HTTP → تنفّذ الخدمة منطق الأعمال → يحفظ المستودع البيانات.
الشفرة: مخطط وحدة التحكم
يحدّد مخطط وحدة التحكم نقاط النهاية؛ وسنربط الخدمة والمستودع لاحقاً.
import org.springframework.web.bind.annotation.*;@RestController
@RequestMapping("/tasks")
public class TaskController {
@GetMapping
public String all() { return "list tasks"; }
@PostMapping
public String create() { return "create task"; }
}
ممارسات جيدة
الممارسات الجيدة: استخدموا أسماءً للموارد في معرّفات URI، وأفعال HTTP المناسبة، وأعيدوا نصوص استجابة بتنسيق JSON.
فحص فعل HTTP
فحص سريع: ما فعل HTTP المستخدم عادةً لإنشاء مورد جديد؟
مراجعة
مراجعة: صمّمتم API للمهام يتضمن نقاط النهاية والنموذج والتدفق والممارسات الجيدة.
الأسئلة الشائعة
هل درس «التصميم» مجاني؟
نعم — نص درس «التصميم» كامل متاح مجاناً هنا على الويب. لتمرينه بشكل تفاعلي (محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7) وفتح باقي دورة Java Academy، انتقل إلى CoddyKit PRO. تتضمن دورة Java Academy 4 دروس في المجموع.
ماذا ستتعلم في «التصميم»؟
خطّط بنية REST API: نقاط النهاية، ونماذج البيانات، وتدفق العمل. تتمرن على Java Academy مع أكواد عملية تشغلها مباشرة في المتصفح، ومدرس ذكاء اصطناعي متاح 24/7 يجيب على أسئلتك أثناء عملك.
هل أحتاج إلى خبرة سابقة لأبدأ Java Academy؟
لا تُشترط خبرة سابقة. Java Academy على CoddyKit منظم للمبتدئين حتى المتقدمين، لذا يمكنك البدء من هنا أو من البداية والتقدم بسرعتك الخاصة. هذا هو الدرس 1 من أصل 4.
كم من الوقت يستغرق درس «التصميم»؟
معظم دروس CoddyKit تستغرق حوالي 5–10 دقائق. كل منها موجز وتفاعلي، لذا تحرز تقدماً مستمراً وتستأنف من حيث توقفت عبر الويب والتطبيق.
هل يمكنني كتابة وتشغيل أكواد في درس Java Academy هذا؟
نعم. كل درس في Java Academy يتضمن محرر أكواد مدمج، لذا تكتب وتشغل أكواداً حقيقية مباشرة في متصفحك وتحصل على تعليقات فورية من الذكاء الاصطناعي — بدون إعداد محلي.