التعامل مع HTTP VERBS
اهلا وسهلا بكم احبائي في المحاضرة انشاء الله سوف نناقش ونتعرف على كيفية التعامل مع HTTP VERBS وهي- GET
- POST
- PUP
- DELETE
هذه الـ HTTP VERBS تحدد عملية عرض البيانات او اضافة البيانات او التعديل على البيانات او حذف البيانات بناء على النوع لهذه HTTP VERBS اي هنا بناء على تحديدك على نوع الـ HTTP VERBS والتي تريد تطبيقها على الـ RESURCE
يمكنك عرض البيانات اذا حددت الـ GET , ويمكنك التعديل اذا حددت PUT ويمكنك الحذف اذا حددت DELETE ويضا يمكنك الاضافة اذا حددت الـ POST .
امثلة تطبيقية على HTTP VERBS
لو ذهبنا الى الـ VISUAL STUDIO وعلى التطبيق الذي انشأناه في المحاضرة السابقة وبالتحديد على الـ VALUES CONTROLLERS
فمثلا لو كتبان OBJEC : STR على انه قائمة من النصوص ( TEXT1,TEXT2,TEXT3)
وهذا الـ OBJECT سوف نطبق عليها العمليات التالية ( العرض والاضافة والتعديل والحذف )
فمثلا اذا قمنا ببناء دالة تسمى GET ولو اردنا ان نقرأ محتوى الـ STR فاننا نعيد الـ OBJECT : STR
الان عند تشغيل النظام سوف نحصل على النتيجة التالية .. لاتنسى ان تكتب المسار API/VALUES كما تعلمناه في المحاضرة السابقة وايضا كما قلنا ان المسار يتم كتابته في الـ ROUTES
اما اذا اردنا عرض نص معين من القائمة STR فاننا هنا نرسل المتغير الـ ID فمثلا اذا ارسلنا الـ ID=1 فان النتبجة سوف تكون TEXT2 , واذا ارسلنا الـ ID =2 فان النتيجة سوف تكون TEXT2
لذلك الدالة هنا الـ GET سوف تستقل المتغير ID لذلك سوف تعييد النص المراد على حسب الـ ID كتالي
اما عند الاضافة سوف نستخدم النوع POST للدالة و سوف نرسل للدالة القيمة التي نريد اضافتها ان الدالة سوف تستقبل الـ VALUE والتي سوف تضيفها الى الدالة بكتالة الدالة ADD ممثلا اذا وضعنا TEXT3 للقيمة VALUE سوف تضافة الى القائمة STR لذلك هنا الدالة سوف تستقبل VALUE كما في الصورة التالية :
اما عند التعديل فسوف نستخدم النوع PUT للدالة. لذلك سو نرسل للدالة نوعان من المتغيران وهما الـ ID وهو يمثل موقع النص وكذلك نرسل له الـ VALUE وهي تمثل القيمة التي نريدها للتعديل فمثلا هنا يمكننا ان نختار موقع النص في القائمة STR ونعدلها بالقيمة فمثلا يمكننا كتابة عدلي على القيمة TEXT1 بالقيمة TEXT6
لذلك الدالة تكتب بالاتي :
اما عند الحذف فسوف نستخدم النوع DELETE للدالة . لذلك سوف نرسل فقط الـ ID الذي يمثل موقع النص في المقائمة وذا حددنا الموقع وطبقنا دالة الـ REMOVE سوف يتم الحذف تلقائيا .. كما في الدالة التالية :
التطبيق عمليات العرض على برنامج Fiddler
الان دعونا نكمل التطبيق ..هناك برنامج يستخدم في تجربة سلامة الروابط يسمى fiddler - قم بتنزيله
سوف نستخدمه في هذه الدورة لاختبار سلامة الروابط
في البداية سوف نقوم باعداد هذا البرنامج المسمى fiddler كتالي :
- نذهب الى تبويب الـ Composer
- من شريط نحدد نوع الطلب وليكن Get , وكذلك ندخل عنوان الرابط والذي ناخذه من المتصفح وليكن (https://localhost:44372/API/Values)
- ثم نقوم بالضغط على زر تنفيذ - Execute
بعد الضغط على Execute
- يظهر رابط في برنامج الـ fodder في الطرف الايسر ... ننقر عليه بالماوس
- بعد النقر عليه ينتقل البويب الى Inspectors
- تظهر النتيجة في الطرف الايمن تحت وهي على شكل json
الان دعونا نرسل الرقم 1 في الرابط اي موقع النص في القائمة ... سوف يكون الناتج text2
مفاهيم هامة في ASP.NET WEB API
هناك بعض المفاهيم الهامة يجب ان نفهما جيدا في الـ Asp.net Web API ,والمختصة في Http Verbs والتي سوف تحدد ماهي العملية التي تم اجراءها على الـ Resource وهي كتالي :- عنوان الطلب - Request Header: يحتوي على معلومات اضافية حول الطلب - حيث يمكن ان تحدد له نوع الاستجابة الراجعة من السيرفر كا تنسيق مثلا xml او json
- جسم الطلب -Request Body : يحتوي على البيانات والتي سوف ترسل الى السيرفر
- جسم الاستجابة : Response Body : يحتوي على البيانات المرسلة كاستجابة من السيرفر - الخادم-
- كود حالة الاستجابة: Response Status Code : هنا سوف يعلم ويزود الـ Client بحالة الطلب الذي قام بإنشاؤه المستخدم .
ايضا من المفاهيم التي يجب ان نفهمها لحالة الاستجابة وهي :
- اي استجابة تبدأ بالرقم (1) فهذا يدل على الحصول على معلومات
- اي استجابة تبدأ بالرقم (2) فهذا يدل على نجاح العملية
- اي استجابة تبدأ بالرقم (3) فهذا يدل على اعادة التوجيه
- اي استجابة تبدأ بالرقم ( 4) فهذا يدل على ان هناك خطأ ناتج من الـ Client
- اي استجابة تبدأ بالرقم (5) فهذا يدل على ان هناك خطأ تانج من السيرفر