طرق HTTP في UniRest: GET و POST و PUT و DELETE

التواصل الفعال بين التطبيقات ضروري في تطوير البرمجيات الحديثة. غالبًا ما يعتمد هذا التواصل على بروتوكولات محددة جيدًا مثل بروتوكول نقل النص الفائق (HTTP). ضمن HTTP، تحدد أساليب معينة نوع التفاعل المقصود بين العميل والخادم.

لفهم ما هي أساليب HTTP المتاحة في UniRest، ستستعرض هذه المقالة الوظائف الأساسية لأربع أساليب HTTP أساسية—GET، وPOST، وPUT، وDELETE—كما تم تنفيذها بواسطة مكتبة UniRest. فهم هذه الأساليب أمر بالغ الأهمية لبناء تطبيقات الويب القوية والمتعددة الاستخدامات.

ما هي أساليب HTTP؟

أساليب HTTP هي مجموعة محددة من التعليمات التي تحدد العمل المقصود على مورد معين. تعتبر أساليب HTTP أفعالًا تحدد قنوات التواصل الواضحة بين تطبيقات العميل وموارد الخادم.

أساليب HTTP في UniRest مع مثال

طريقة GET في UniRest

يسترجع البيانات من عنوان URL محدد. توفر UniRest طريقة get(url) لهذا الغرض. يمكنك اختيارياً تضمين معلمات الاستعلام باستخدام طريقة queryString(String key, Object value) لتحسين طلبك.

طريقة POST في UniRest

تقوم بإنشاء مورد جديد على الخادم. تقدم UniRest طريقة post(url) لبدء طلب POST. يمكنك تضمين البيانات التي سيتم إنشاؤها داخل جسم الطلب باستخدام أساليب مثل body(Object body) أو field(String key, Object value) لبيانات النموذج.

طريقة PUT في UniRest

تقوم بتحديث مورد موجود بالكامل. تسهل طريقة put(url) في UniRest إرسال طلبات PUT. مشابهةً لـ POST، يمكنك تقديم البيانات المحدّثة داخل جسم الطلب باستخدام body(Object body).

طريقة DELETE في UniRest

تزيل مورد محدد من الخادم. يتم بدء هذا الإجراء غير القابل للإلغاء باستخدام طريقة delete(url) في UniRest.

طريقة HEAD في UniRest

تسترجع فقط معلومات الرأس المرتبطة بمورد، مستثنية المحتوى الفعلي. تقدم UniRest طريقة head(url) لهذا الغرض.

طريقة OPTIONS في UniRest

تستفسر الخادم لتحديد أساليب HTTP المدعومة لمورد معين. توفر UniRest طريقة options(url) لهذه الوظيفة.

طريقة PATCH في UniRest

تطبق تعديلات جزئية على مورد موجود. تسمح طريقة patch(url) في UniRest بإرسال طلبات PATCH. عادةً ما يتم تعريف التغييرات المحددة في تنسيق مثل JSON Patch.

طريقة CONNECT في UniRest

تؤسس اتصال نفق إلى الخادم. تقدم UniRest طريقة connect(url) لهذا الغرض، على الرغم من أنها أقل استخدامًا مقارنة بأساليب أخرى.

طريقة TRACE في UniRest

يتتبع المسار الذي اتخذته الطلبات عبر شبكة الوسطاء. يتم استخدام هذه الطريقة بشكل أساسي لأغراض تصحيح الأخطاء، وتقدم UniRest طريقة trace(url) لذلك.

بالإضافة إلى هذه الأساليب الأساسية، توفر UniRest وظائف لـ:

• المصادقة الأساسية: تعيين اسم المستخدم وكلمة المرور للتفويض باستخدام basicAuth(String username, String password).
• تحميل النماذج: تحميل الملفات داخل طلب POST باستخدام field(String key, File file).
• طلبات غير متزامنة: تتم الطلبات غير المتزامنة باستخدام الأساليب غير المتزامنة المقدمة من UniRest.

من خلال الاستفادة من هذه الأساليب والوظائف، تمكّن UniRest المطورين من بناء تفاعلات ديناميكية وفعّالة مع خدمات الويب، مما يسهل عملية استرجاع البيانات وإنشائها ومعالجتها وحذفها.

نقاط كود أمثلة لأساليب HTTP في UniRest

إليك بعض أمثلة لأساليب HTTP في UniRest بلغة UniRest Java.

طلب GET لاسترجاع البيانات

// استيراد الفئات الضرورية
import com.mashape.unirest.http.HttpResponse;
import com.mashape.unirest.http.JsonNode;
import com.mashape.unirest.http.Unirest;

public class GetExample {

  public static void main(String[] args) throws Exception {

    // تعريف عنوان URL ومعلمة الاستعلام الاختيارية
    String url = "https://api.example.com/users";
    int userId = 123;

    // بناء طلب GET مع معلمة الاستعلام
    HttpResponse<JsonNode> response = Unirest.get(url)
        .queryString("id", userId)
        .asJson();

    // التحقق من استجابة ناجحة
    if (response.getStatus() == 200) {
      JsonNode user = response.getBody();
      System.out.println("استرجاع بيانات المستخدم: " + user);
    } else {
      System.out.println("خطأ في استرجاع المستخدم: " + response.getStatus());
    }
  }
}

طلب POST لإنشاء مورد

public class PostExample {

  public static void main(String[] args) throws Exception {

    // تعريف عنوان URL والبيانات للمورد الجديد
    String url = "https://api.example.com/posts";
    String title = "منشوري الجديد";
    String content = "هذا هو بعض المحتوى للمنشور الجديد.";

    // بناء طلب POST مع بيانات الجسم
    HttpResponse<String> response = Unirest.post(url)
        .body("{\"title\": \"" + title + "\", \"content\": \"" + content + "\"}")
        .asString();

    // التحقق من استجابة ناجحة
    if (response.getStatus() == 201) {
      System.out.println("تم إنشاء المنشور بنجاح!");
    } else {
      System.out.println("خطأ في إنشاء المنشور: " + response.getStatus());
    }
  }
}

طلب PUT لتحديث مورد

public class PutExample {

  public static void main(String[] args) throws Exception {

    // تعريف عنوان URL والبيانات المحدثة للمورد
    String url = "https://api.example.com/posts/10";
    String newTitle = "عنوان محدث";

    // بناء طلب PUT مع بيانات الجسم
    HttpResponse<String> response = Unirest.put(url)
        .body("{\"title\": \"" + newTitle + "\"}")
        .asString();

    // التحقق من استجابة ناجحة
    if (response.getStatus() == 200) {
      System.out.println("تم تحديث المنشور بنجاح!");
    } else {
      System.out.println("خطأ في تحديث المنشور: " + response.getStatus());
    }
  }
}

طلب DELETE لإزالة مورد

public class DeleteExample {

  public static void main(String[] args) throws Exception {

    // تعريف عنوان URL للمورد المراد حذفه
    String url = "https://api.example.com/comments/5";

    // بناء طلب DELETE
    HttpResponse<String> response = Unirest.delete(url)
        .asString();

    // التحقق من استجابة ناجحة
    if (response.getStatus() == 204) {
      System.out.println("تم حذف التعليق بنجاح!");
    } else {
      System.out.println("خطأ في حذف التعليق: " + response.getStatus());
    }
  }
}

Apidog - ابدأ في دمج التطبيقات مع UniRest!

UniRest هي أداة قوية تزود المطورين بالوظائف اللازمة لربط الشيفرة والخوادم من خلال قوة APIs. لذلك، من الضروري أن يفهم المطورون كيفية تنفيذ كل من APIs وأدواتها.

إذا كنت جديدًا في تطوير API، فإننا نوصيك بزيارة Apidog.

Apidog هي أداة شاملة لتطوير API تمكّن المطورين من بناء واختبار وتقليد وتوثيق APIs عن طريق تزويدهم بجميع الأدوات اللازمة.

عبر واجهة مستخدم بسيطة وبديهية، يمكن لمستخدمي Apidog، سواء كانوا جدد أو ذوي خبرة في التطبيق، التنقل داخل التطبيق في أي وقت من الأوقات. مع منحنى تعلم منخفض، لن يشعر المستخدمون الجدد بالرعب من تعقيد تطوير API.

استيراد APIs الموجودة إلى Apidog

إذا كان لديك مشروع API موجود ترغب في ملاحظته، يمكنك استيراده إلى Apidog بعدد قليل من نقرات المؤشر.

بمجرد تنزيل Apidog، يمكنك الانتقال إلى قسم الإعدادات لمشروعك. قم بالبحث عن زر استيراد البيانات حتى تتمكن من اختيار أي نوع من ملفات API لديك. إذا لم ترَ واحدًا، يمكنك سحبه وإفلاته في المربع أدناه.

إنشاء كود عميل في بضع ثوانٍ مع Apidog

ميزة رئيسية يمكن لمستخدمي Apidog الاستفادة منها هي ميزة إنشاء الكود.

أولاً، قم بتثبيت وفتح Apidog، وتأكد من فتح مشروع. تابع بالبحث عن زر </> حول الجانب العلوي الأيمن من نافذة Apidog كما هو موضح في الصورة أعلاه.

ستظهر نافذة منبثقة تحتوي على قائمة بلغات البرمجة. الصورة أعلاه توضح إنشاء الكود لـ UniRest Java.

استنتاج

تزود مكتبة UniRest المطورين بمجموعة أدوات قوية وسهلة الاستخدام للتفاعل مع خدمات الويب. من خلال تقديم واجهة API واضحة وموجزة لأساليب HTTP الأساسية مثل GET وPOST وPUT وDELETE، تبسط UniRest عملية استرجاع البيانات وإنشائها ومعالجتها وحذفها. بالإضافة إلى ذلك، فإن دعمها لميزات مثل المصادقة، وتحميل النماذج، والطلبات غير المتزامنة يمكّن المطورين من بناء تطبيقات ويب قوية وفعالة.

للاستكشاف المتعمق وإتقان وظائف UniRest، فإن استشارة الوثائق الرسمية موصى به بشدة. توفر الوثائق تفسيرات شاملة، وأمثلة كود توضيحية، وأفضل الممارسات لاستخدام UniRest بفعالية في مساعيك التطويرية. من خلال الاستفادة من المكتبة ووثائقها، يمكن للمطورين تبسيط تفاعلات خدمات الويب وتسريع إنشاء تطبيقات ديناميكية وغنية بالميزات.