AspNet6InDepth

تعلم ASP.NET 6 في العمق

1. نظرة عامة على ASP.NET 6

   • التاريخ والخلفية
   • استراتيجية الإصدار
   • تثبيت
   • هيكل المشروع
   • صافي SDK

2. أساسيات ASP.NET 6

   • تطبيق Scaffold ASP.NET 6 API باستخدام .NET SDK
   • تحليل ملف Program.cs
   • حقن التبعية
     • تسجيل الكائن كعمر مفرد
     • تسجيل الكائن كعمر محدد
     • تسجيل الكائن كعمر عابر
   • الوسيطة
     • ملخص
     • إنشاء برامج وسيطة مخصصة
       • من خلال تطبيق واجهة IMiddleware
       • عن طريق حقن كائن RequestDelegate
       • اكتب برامج وسيطة مضمنة باستخدام app.Use و app.Map و app.MapWhen و app.UseWhen و app.Run
     • app.UseStaticFiles();
     • app.UseCors();
     • إضافة الوسيطة Correlationid
     • أضف البرامج الوسيطة للاستثناءات العامة غير المعالجة وأعد الاستجابة القياسية ProblemDetails
   • مضيف الإعداد
   • التكوينات
     • اقرأ التكوينات من appsettings.{environment}.json وواجهة IConfiguration
     • نمط الخيارات
       • ربط التكوين بـ C# POCO المكتوب بقوة باستخدام واجهة IOptions<T>
       • ربط التكوين الذي يمكن إعادة تحميله في وقت التشغيل إلى C# POCO المكتوب بقوة باستخدام واجهة IOptionsSnapshot<T> أو IOptionsMonitor<T>
   • فهم HttpContext و HttpContext.Request و HttpContext.Response
   • توجيه السمة
     • ربط مسارات متعددة بوحدة التحكم باستخدام سمة Route
     • تمرير المعلمات إلى أساليب العمل باستخدام معلمات الطريق
     • أفعال الإجراء HttpGetAttribute و HttpPostAttribute و HttpPutAttribute و HttpPatchAttribute و HttpDeleteAttribute
   • ملزمة النموذج
     • ربط النموذج من المصادر التالية
       • FromQuery : الحصول على القيم من سلسلة الاستعلام
       • FromRoute : يحصل على القيم من بيانات المسار
       • FromForm : يحصل على القيم من حقول النماذج المنشورة
       • FromBody : الحصول على القيم من نص الطلب
       • FromHeader : يحصل على القيم من رؤوس HTTP
   • التعامل مع الاستجابات باستخدام IActionResult<T> أو ActionResult<T>
   • التعامل مع التفاوض على المحتوى باستخدام Accept الرأس
     • أرسل استجابة XML إذا تم تعيين Accept الرأس على application/xml
     • أرسل استجابة JSON إذا تم تعيين Accept الرأس على application/json
   • الإصدار في .NET6 API (واجهات برمجة التطبيقات)
   • التعامل مع طلبات نوع HTTP Patch
   • التحقق من صحة النموذج
     • استخدام سمات التعليقات التوضيحية للبيانات
       • Compare : التحقق من تطابق خاصيتين في النموذج.
       • EmailAddress : التحقق مما إذا كان العقار يحتوي على تنسيق بريد إلكتروني.
       • Phone : التحقق من صحة ما إذا كانت الخاصية تحتوي على تنسيق رقم هاتف.
       • Range : التحقق من صحة ما إذا كانت قيمة الخاصية تقع ضمن نطاق محدد.
       • RegularExpression : التحقق من صحة ما إذا كانت قيمة الخاصية تتطابق مع تعبير عادي محدد.
       • Required : التحقق من صحة الحقل إذا لم يكن فارغًا.
       • StringLength : التحقق من صحة ما إذا كانت قيمة خاصية السلسلة لا تتجاوز حد الطول المحدد.
       • Url : التحقق مما إذا كانت الخاصية تحتوي على تنسيق URL.
     • التحقق من صحة FluentValidation باستخدام أساليب Fluent
   • عميل HTTP
     • إنشاء IHttpClientFactory الأساسي باستخدام IHttpClientFactory.CreateClient();
     • اسمه HttpClient
     • كتبته HttpClient
     • أضف DelegatingHandler إلى عملاء HTTP لتنفيذ المنطق المشترك
     • التعامل مع استثناءات HTTP باستخدام مكتبة Polly
   • المرشحات
   • ضغط الجسم الاستجابة
     • إضافة ضغط الاستجابة باستخدام خوارزمية gzip
   • العولمة والتوطين
   • الحد من المعدل
     • تحديد المعدل باستخدام حزمة Nuget AspNetCoreRateLimit مع موفر الذاكرة.
     • تحديد المعدل باستخدام حزمة AspNetCoreRateLimit و AspNetCoreRateLimit.Redis nuget مع Azure Cache لموفر Redis.
   • التسجيل
     • فهم مستويات السجل
     • قم بالتسجيل باستخدام طرق ملحق ILogger<T>
       • logger.LogTrace سجل رسائل مستوى التتبع
       • logger.LogDebug رسائل مستوى تصحيح الأخطاء
       • logger.LogInformation رسائل مستوى معلومات السجل
       • logger.Warning سجل رسائل مستوى التحذير
       • logger.Error تسجيل رسائل مستوى الخطأ
       • logger.Critical المستوى الحرج للسجل الحرج
     • قم بالتسجيل باستخدام Azure AppInsights SDK
   • الخدمات المستضافة
     • تنفيذ الخدمات المستضافة باستخدام واجهة IHostedService
     • تنفيذ خدمات الخلفية عن طريق تجاوز فئة BackgroundService
   • تعيين الكائنات من نوع إلى آخر باستخدام حزمة Automapper nuget
   • نمط الوسيط
     • تنفيذ الخدمات المترابطة بشكل فضفاض باستخدام حزمة MediatR nuget
   • اختيال
     • قم بتثبيت Swashbuckle.AspNetCore nuget لإضافة دعم Swagger OpenAPI
     • أضف معلومات API والوصف
     • أضف علامات ملخصة للبيانات التعريفية على مستوى واجهة برمجة التطبيقات
     • إضافة معرفات العمليات إلى مجموعة (واجهات برمجة التطبيقات)
     • إثراء البيانات الوصفية للعملية
     • إثراء البيانات التعريفية للاستجابة
     • إثراء البيانات التعريفية للمعلمة
     • إثراء البيانات الوصفية لجسم الطلب
     • إثراء بيانات تعريف المخطط
     • إضافة بيانات تعريف العلامة
     • قم بتغيير بادئة مسار swagger لخدمة swagger.json من مستوى الجذر
     • احذف واجهة برمجة التطبيقات (واجهات برمجة التطبيقات) لتكون مرئية في Swagger
     • إنشاء مستندات Swagger متعددة
   • الفحوصات الصحية

3. الوصول إلى البيانات في تطبيق ASP.NET 6 API

   • الوصول إلى البيانات باستخدام Micro ORM Dapper وPostgreSQL

     • قم بتثبيت Npgsql
     • قم بتثبيت Dapper Micro ORM
     • قم بتثبيت Azure Data Studio
     • تكوين قاعدة بيانات Azure لـ PostgreSQL
     • اكشف عن واجهات برمجة تطبيقات CRUD باستخدام Dapper MicroORM للكشف عن نقاط النهاية التالية
       • إزاحة ترقيم الصفحات /api/Persons?page=1&limit=10
       • ترقيم الصفحات لمجموعة المفاتيح /api/Persons?searchAfter=4499b79a-c710-45e4-ba87-083d22c4d6ad_2023-04-17T12:00:25&limit=10
       • احصل على أغنية فردية بواسطة المعرف /api/Persons/b1333cad-9d7c-4a64-8823-db8c9aa55646
       • إنشاء /api/Persons
       • تحديث /api/Persons/b1333cad-9d7c-4a64-8823-db8c9aa55646
       • حذف /api/Persons/b1333cad-9d7c-4a64-8823-db8c9aa55646

   • الوصول إلى البيانات باستخدام EF Core 6 ORM وPostgreSQL

     • تثبيت إي أف كور 6
     • قم بتثبيت Azure Data Studio
     • تكوين قاعدة بيانات Azure لـ PostgreSQL
     • أضف DbSet<T> إلى الجداول النموذجية في قاعدة البيانات
     • تحليل DbContext
     • قم بإنشاء نمط المستودع باستخدام طرق ملحق DbContext
     • إضافة تكوينات لإضافة قيود إلى جداول قاعدة البيانات
     • إضافة بيانات البذور
     • أضف عمليات الترحيل باستخدام البرامج النصية للترحيل EF Core وخيار idempotent
     • اكشف عن واجهات برمجة تطبيقات CRUD باستخدام EF Core ORM للكشف عن نقاط النهاية التالية
       • إزاحة ترقيم الصفحات /api/Employees?page=1&limit=10
       • ترقيم الصفحات لمجموعة المفاتيح /api/Employees?searchAfter=4499b79a-c710-45e4-ba87-083d22c4d6ad_2023-04-17T12:00:25&limit=10
       • احصل على رقم التعريف /api/Employees/b1333cad-9d7c-4a64-8823-db8c9aa55646
       • إنشاء /api/Employees
       • تحديث /api/Employees/b1333cad-9d7c-4a64-8823-db8c9aa55646
       • حذف /api/Employees/b1333cad-9d7c-4a64-8823-db8c9aa55646

4. التخزين المؤقت للاستجابة في تطبيق ASP.NET 6 API

   • أضف ذاكرة التخزين المؤقت باستخدام IMemoryCache
   • أضف التخزين المؤقت الموزع باستخدام Azure Cache لـ Redis و StackExchange.Redis

5. الأمان في تطبيق ASP.NET 6 API

   • إضافة المصادقة

     • فهم Claim ClaimsIdentity ومدير ClaimsPrincipal
     • تنفيذ المصادقة الأساسية
     • تنفيذ مصادقة ملفات تعريف الارتباط
     • تنفيذ مصادقة JWT (مخصصة)
       • تجزئة كلمات المرور ذات النص العادي باستخدام خوارزمية BCrypt و BCrypt.Net-Next nuget
       • قم بإنشاء JWTs باستخدام System.IdentityModel.Tokens.Jwt
       • أضف واجهة (واجهات) API التالية
         • /api/Account/Register لتسجيل المستخدم
         • /api/Account/Login لتسجيل دخول المستخدم وإنشاء المجموعة الأولية من رمز الوصول ورمز التحديث
         • /api/Account/Token لتحديث رمز الوصول باستخدام رمز التحديث المُرسل
         • /api/Account/Revoke لإبطال رمز التحديث

   • إضافة تصريح

     • تنفيذ التفويض القائم على الدور
     • تنفيذ التفويض القائم على السياسة
       • فهم "متطلبات" السياسة وتنفيذ واجهة IAuthorizationRequirement
       • قم بتجاوز HandleRequirementAsync لإنشاء متطلبات السياسة المخصصة
       • قم بتسجيل المتطلبات المخصصة في Program.cs

   • دراسة الحالة: أضف مصادقة JWT وترخيص الدور باستخدام Auth0

     • فهم OAuth2
     • فهم مصطلحات OAuth2
     • فهم تدفقات OAuth
       • التدفق الضمني
       • تدفق بيانات اعتماد العميل
       • تدفق رمز المصادقة
     • إنشاء التطبيق في Auth0
     • قم بتعيين عناوين URL لإعادة التوجيه في Auth0
     • قم بتأمين جميع نقاط نهاية API باستخدام Auth0
     • تحديد الأذونات على واجهة برمجة التطبيقات (API) وإجراء تفويض السياسة

6. التعامل مع تحميل الملفات وتنزيل الملفات

   • تحميل الملفات
     • التعامل مع تحميل ملفات مفردة أو متعددة
     • قم بتخزين الملف الذي تم تحميله محليًا في wwwroot folder
     • قم بتخزين الملف الذي تم تحميله في حاويات تخزين Azure Blob
   • تنزيلات الملفات
     • دفق ملف CSV للرد
     • دفق ملف Excel .xlsx للاستجابة

7. اختبار

   • اختبار الوحدة

     • إضافة اختبار الوحدة باستخدام xUnit.net
     • فهم [Fact] و [Theory]
     • تهيئة بيانات الاختبار باستخدام المُنشئ
     • تنظيف بيانات الاختبار باستخدام طريقة Dispose
     • إنشاء اختبارات ذات معلمات
       • تمرير المعلمات البدائية باستخدام [InlineData]
       • تمرير المعلمات البدائية والمعقدة باستخدام [MemberData]
       • تمرير المعلمات البدائية والمعقدة باستخدام [ClassData]
     • مشاركة سياق الاختبار في نفس الفصل باستخدام IClassFixture
     • مشاركة سياق الاختبار بين فئات متعددة باستخدام ICollectionFixture
     • محاكاة خدمة التبعية باستخدام Moq
     • تحقق من استدعاء الخدمة الساخرة باستخدام Verify() أو VerifyAll()

   • اختبار التكامل

     • قم بإنشاء مصنع تطبيقات ويب مخصص عن طريق وراثة WebApplicationFactory<TStartup>
     • استخدم EF Core في قاعدة بيانات الذاكرة لاختبار التكامل
     • اكتب اختبارات التكامل لواجهة برمجة التطبيقات (واجهات برمجة التطبيقات) باستخدام xUnit.net

8. الاتصال المتزامن بين الخدمات باستخدام gRPC وHTTP2

   • قم ببناء واجهة API للبوابة وواجهة برمجة التطبيقات الداخلية للتواصل مع بعضهما البعض بشكل متزامن باستخدام gRPC

9. الاتصال غير المتزامن بين الخدمات باستخدام قوائم انتظار الرسائل

   • أنشئ واجهة برمجة تطبيقات البوابة وواجهات برمجة التطبيقات الداخلية (وظيفة Azure) التي تتواصل مع بعضها البعض بشكل غير متزامن باستخدام ناقل خدمة Azure.

10. استضافة تطبيق ASP.NET 6 API

    • استضافة تطبيق ASP.NET 6 API باستخدام IIS ونشر المجلدات
    • استضافة تطبيق ASP.NET 6 API باستخدام خدمة Azure App والنشر اليدوي