ASP.NET Core Middleware شرح شامل مع أمثلة

ما هو Middleware في ASP.NET Core؟
الـ Middleware هو جزء أساسي في أي تطبيق ASP.NET Core، وبيشتغل جوه حاجة اسمها Request Pipeline.
ببساطة كده
أي طلب HTTP داخل على التطبيق:

• بيعدي على سلسلة Middleware
• كل Middleware يقدر:
  • يقرأ الطلب
  • يعدله
  • يوقفه
  • أو يسيبه يكمل للي بعده

والـ Response بيرجع بالعكس بنفس الترتيب

---

​

ليه Middleware مهم جدًا في أي تطبيق؟ ​

الـ Middleware هو العمود الفقري لأي تطبيق شغال Production
كل الحاجات التقيلة بتمر من خلاله، زي:

• Authentication & Authorization
• Error Handling
• Logging
• Performance Optimization
• Compression
• Rate Limiting
• CORS
• Caching

من غير Middleware = تطبيق شغال وخلاص
مع Middleware = تطبيق احترافي وآمن وسريع

---

​

الهدف الأساسي من استخدام Middleware ​

الهدف الرئيسي هو Separation of Concerns يعني بدل ما تحط:

• التحقق الأمني
• تسجيل الطلبات
• معالجة الأخطاء

جوه كل Controller
بتحطهم مرة واحدة في Middleware
ويتطبقوا على كل المشروع أو أجزاء معينة منه
وده بيخلي الكود:

• أنضف
• أسهل في الصيانة
• أسهل في التوسيع

---

​

Middleware بيتكتب فين؟ ​

في ASP.NET Core الـ Middleware بيتكتب ويتنظم داخل ملف: Program.cs
وبالتحديد بعد السطر ده: var app = builder.Build();

---

​

Request Pipeline شغال إزاي؟ ​

الاتجاه مهم جدًا

• الطلب (Request)
  من أول Middleware لآخر واحد
• الاستجابة (Response)
  من آخر Middleware للأول

ترتيب الـ Middleware مش رفاهية… ده فرق بين تطبيق شغال وتطبيق بايظ

---

​

الترتيب الصح للـ Middleware (Best Practice) ​

ده شكل شائع واحترافي لترتيب الـ Middleware:

var app = builder.Build();

app.UseExceptionHandler("/error"); // معالجة الأخطاء
app.UseHttpsRedirection();          // HTTPS
app.UseStaticFiles();               // ملفات ثابتة
app.UseRouting();                   // Routing
app.UseCors("DefaultPolicy");       // CORS
app.UseAuthentication();            // Authentication
app.UseAuthorization();             // Authorization
app.UseRateLimiter();               // Rate Limiting
app.MapControllers();               // Endpoints

app.Run();

---

​

الفرق بين Use و Run و Map ​

فهم النقطة دي مهم جدًا لأي مبرمج ASP.NET Core

Use()​

• بيضيف Middleware
• وبيكمل للي بعده

app.Use(async (context, next) =>
{
    // قبل الطلب
    await next();
    // بعد الاستجابة
});

---

Run()​

• بيقفل الـ Pipeline
• مفيش بعده Next

app.Run(async context =>
{
    await context.Response.WriteAsync("Hello World");
});

---

Map()​

• بيفرّع الـ Pipeline حسب المسار

app.Map("/health", appBuilder =>
{
    appBuilder.Run(async context =>
    {
        await context.Response.WriteAsync("Healthy");
    });
});

---

​

Short-Circuit: إيقاف الطلب بدري ​

أحيانًا محتاج توقف الطلب فورًا، زي:

• Health Check
• Block IP
• Feature Flags

وده بيخلي الأداء أحسن، ويمنع طلبات ملهاش لازمة

---

​

معالجة الاستثناءات (غلط شائع) ​

تحط Exception Middleware في النص
لازم يكون أول Middleware
ليه؟ -لأنه مش هيقدر يمسك أخطاء حصلت قبله

app.UseExceptionHandler(errorApp =>
{
    errorApp.Run(async context =>
    {
        context.Response.StatusCode = 500;
        await context.Response.WriteAsync("حدث خطأ غير متوقع");
    });
});

---

​

Authentication و Authorization (ترتيب قاتل) ​

غلط منتشر جدًا

app.UseAuthorization();
app.UseAuthentication(); // ❌ غلط

الصح
لازم تعرف المستخدم الأول، بعدين تفوضه:

app.UseAuthentication();
app.UseAuthorization();

---

​

Custom Middleware (المرحلة الاحترافية) ​

في المشاريع الكبيرة، Middleware الجاهز مش دايمًا كفاية ساعتها بتكتب Custom Middleware
مثال Middleware لتسجيل الطلبات:

public class RequestLoggingMiddleware
{
    private readonly RequestDelegate _next;

    public RequestLoggingMiddleware(RequestDelegate next)
    {
        _next = next;
    }

    public async Task Invoke(HttpContext context)
    {
        Console.WriteLine($"Request: {context.Request.Method} {context.Request.Path}");
        await _next(context);
        Console.WriteLine($"Response: {context.Response.StatusCode}");
    }
}

ده مفيد جدًا في:

• Debugging
• Monitoring
• Security Auditing

---

​

الخلاصة ​

لو بتتعلم ASP.NET Core بجد:

• لازم تفهم Middleware
• لازم تهتم بالترتيب
• لازم تعرف Use / Run / Map
• ولازم تكتب Custom Middleware لما تحتاج

فهمك للنقطة دي = نقلة كبيرة في مستواك البرمجي