كيفية كتابة REST API بلغة Java في 30 دقيقة: للمبتدئين

كيفية كتابة REST API بلغة Java في 30 دقيقة: للمبتدئين

إنشاء REST API هو أحد المهارات الأساسية للمطور الحديث. إذا كنت قد بدأت للتو في تعلم Java وتريد إنشاء أول خدمة ويب لك بسرعة، فهذا الدليل لك. سننتقل من تثبيت الأدوات إلى API يعمل يمكن اختباره في المتصفح أو Postman. العملية بأكملها لن تستغرق أكثر من 30 دقيقة.

في هذه المقالة، سنستخدم Spring Boot - الإطار الأكثر شيوعًا لإنشاء تطبيقات الويب بلغة Java. فهو يتولى جميع الإعدادات الروتينية، مما يسمح لك بالتركيز على المنطق. ونتيجة لذلك، ستحصل على API بسيط لإدارة قائمة المهام (Todo List).

ما هو REST API ولماذا هو مطلوب؟

REST (Representational State Transfer) هو نمط معماري لبناء خدمات الويب. يعمل REST API عبر بروتوكول HTTP ويستخدم الطرق القياسية:

• GET — جلب البيانات
• POST — إنشاء سجل جديد
• PUT — تحديث سجل موجود
• DELETE — حذف سجل

عادةً ما يتم نقل البيانات بتنسيق JSON. يُستخدم REST API في كل مكان: من تطبيقات الهواتف المحمولة إلى بنية الخدمات المصغرة. بإتقانه، ستتمكن من إنشاء الجزء الخادم لأي عميل.

الخطوة 1: تجهيز البيئة

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

1.1. JDK (Java Development Kit)

قم بتنزيل وتثبيت JDK 17 أو أحدث من الموقع الرسمي لـ Oracle أو استخدم OpenJDK. تحقق من التثبيت باستخدام الأمر في الطرفية:

java -version

1.2. IntelliJ IDEA (Community Edition)

هي بيئة تطوير مجانية مثالية لـ Java. قم بتنزيلها من الموقع الرسمي.

1.3. Postman (اختياري)

أداة لاختبار API. يمكن تنزيلها من postman.com. في البداية، يمكنك الاستغناء عنها واستخدام المتصفح.

الخطوة 2: إنشاء مشروع Spring Boot

أسرع طريقة هي استخدام Spring Initializr. وهي أداة ويب تنشئ هيكل المشروع.

1. انتقل إلى start.spring.io.
2. اختر: Project: Maven، Language: Java، Spring Boot: 3.x.x.
3. في حقل Group أدخل com.example، وفي Artifact — todoapi.
4. اضغط على Add Dependencies وأضف Spring Web.
5. اضغط على Generate — سيتم تنزيل ملف ZIP يحتوي على المشروع.
6. قم بفك ضغط الملف وافتح المجلد في IntelliJ IDEA.

سيكون هيكل المشروع على النحو التالي:

• src/main/java/com/example/todoapi/ — الكود الرئيسي
• src/main/resources/application.properties — الإعدادات
• pom.xml — ملف بناء Maven

الخطوة 3: إنشاء نموذج البيانات ووحدة التحكم

الآن سنكتب الكود. أولاً، سننشئ نموذجًا بسيطًا — الفئة TodoItem.

3.1. فئة النموذج

أنشئ فئة Java جديدة في الحزمة com.example.todoapi باسم TodoItem.java:

package com.example.todoapi;

public class TodoItem {    private Long id;    private String title;    private boolean completed;

    // المُنشئ الافتراضي    public TodoItem() {}

    // المُنشئ مع المعاملات    public TodoItem(Long id, String title, boolean completed) {        this.id = id;        this.title = title;        this.completed = completed;    }

    // الدوال الجالبة والضابطة    public L