يعرض هذا المستند تفاصيل تنفيذ واجهة برمجة تطبيقات ASP.NET Core القوية والموحدة باستخدام ProWebAPI. وهو يغطي الجوانب الرئيسية مثل تكامل Swagger، وحقن التبعية، والاستجابات الموحدة، والإصدار، والتحقق من صحة الطلب، ودعم OData v4، ومعالجة الاستثناءات العالمية، وEF Core مع UnitOfWork. يوفر الدليل إرشادات خطوة بخطوة لكل مكون.
ProWebAPI
ASP.NET Core API بجميع المعايير المناسبة
تم تنفيذ المعايير
اختيال
قم بتثبيت سواغر
إعداد دي
الاستجابة القياسية لواجهة برمجة التطبيقات (API).
الاستجابة القياسية
الإصدار
تثبيت مكتبة Nuget
أضف إلى حاوية التبعية
تزيين قاعدة التحكم حسب الحاجة
طلب المدقق
تثبيت مكتبة Nuget
تسجيل المدققين على DI
في مساحة الاسم 'RequestDto'، قم بإضافة أدوات التحقق من الصحة مع dto
إنشاء عامل تصفية التحقق من الصحة
سجل عامل التصفية وقم بإيقاف تشغيل [ApiController] تلقائيًا 400 اعتراض للطلبات السيئة
AppSettings.json
تكوين إعدادات التطبيقات لقواعد البيانات
إنشاء 2 تكوينات البيئة
او داتا v4
لدعم OData، قم بتثبيت NuGetpackages
أضف إلى خدمة DI لـ OData
تكوين أوداتا
قم بتجاوز السمة [EnableQuery] باستخدام [EnableOData] لاكتشاف الأخطاء وإرجاع الاستجابة القياسية
تزيين طريقة العمل
الاستعلام عن طريق URL
معالج الاستثناء العالمي
إنشاء الوسيطة
قم بإنشاء امتداد methord لمنشئ التطبيق
تسجيل الوسيطة
غلاف الاستجابة
السماح بغلاف العضو (الذي سيكون في حالة باسكال للدعائم) بحيث لا تتعارض نتيجة استعلام OData مع الغلاف
إي أف كور + وحدة العمل
إضافة مكتبات الفئات الداعمة
قم بتثبيت الحزم المطلوبة على ProWeb.Data
لتشغيل الهجرات
قم بتعيين ProWeb.Data كـ [مشروع بدء التشغيل] وقم بتشغيل عمليات الترحيل