Django میں middleware کیا ہے؟

Question

Accepted Answer

**Middleware** ایک hooks کا فریم ورک ہے جو **ہر request اور response** کو عام طور پر process کرتا ہے، ویب سرور اور آپ کے views کے درمیان بیٹھا ہوا۔ ہر middleware درخواست کو اندر آتے وقت اور جوابات کو باہر نکلتے وقت جانچ سکتا ہے/تبدیل کر سکتا ہے — authentication، security headers، sessions، اور logging جیسے cross-cutting concerns کے لیے موزوں۔

## Middleware کے ذریعے request/response کا بہاؤ

```text
Request  → MW1 → MW2 → MW3 → VIEW
Response ← MW1 ← MW2 ← MW3 ← VIEW

Middleware wraps the view like layers of an onion:
  - on the way IN (request): top-to-bottom
  - on the way OUT (response): bottom-to-top (reverse order)
```

## Django کا تعمیر شدہ middleware (settings.py میں)

```python
MIDDLEWARE = [
    "django.middleware.security.SecurityMiddleware",          # security headers (HSTS, etc.)
    "django.contrib.sessions.middleware.SessionMiddleware",   # enables request.session
    "django.middleware.common.CommonMiddleware",
    "django.middleware.csrf.CsrfViewMiddleware",              # CSRF protection
    "django.contrib.auth.middleware.AuthenticationMiddleware",# enables request.user
    "django.middleware.clickjacking.XFrameOptionsMiddleware", # clickjacking protection
]
# ORDER MATTERS — e.g. SessionMiddleware must come before AuthenticationMiddleware
```

Django کی بہت سی بنیادی فعالیت middleware ہے: sessions (`request.session`)، authentication (`request.user`)، CSRF حفاظت، اور security headers سب تعمیر شدہ middleware سے آتے ہیں۔ **ترتیب اہم ہے** — کچھ middleware دوسروں پر منحصر ہے کہ پہلے چلیں۔

## کسٹم middleware لکھنا

```python
class TimingMiddleware:
    def __init__(self, get_response):
        self.get_response = get_response          # the next middleware/view

def __call__(self, request):
        # --- code here runs on the way IN (before the view) ---
        import time; start = time.time()

response = self.get_response(request)     # call the next layer (eventually the view)

# --- code here runs on the way OUT (after the view) ---
        response["X-Response-Time"] = f"{time.time() - start:.3f}s"
        return response
```

ایک middleware ایک callable ہے: `self.get_response(request)` سے پہلے کوڈ request پر چلتا ہے، اس کے بعد کوڈ response پر چلتا ہے۔ یہ آپ کو view کی نفاذ سے پہلے اور بعد میں دونوں میں کام کرنے دیتا ہے۔

## Middleware کے عام استعمالات

```text
✓ Authentication / setting request.user
✓ Security headers (CSP, HSTS, X-Frame-Options)
✓ Request/response logging, timing, metrics
✓ Sessions, locale/i18n detection, CORS
✓ Rate limiting, maintenance mode, custom request preprocessing
```

## Middleware بمقابلہ views/decorators

```text
Middleware → GLOBAL, cross-cutting concerns affecting EVERY (or most) request
Decorators/view logic → per-view concerns specific to certain endpoints
→ Use middleware for app-wide behavior; decorators for selective behavior.
```

## یہ کیوں اہم ہے

Middleware Django کے لیے بنیادی ہے کہ کیسے requests کو process کرتے ہیں — اسے سمجھنا یہ بتاتا ہے کہ فریم ورک کی بہت سی بنیادی فعالیت اصل میں کیسے کام کرتی ہے اور **عام، cross-cutting concerns** کے لیے صحیح طریقہ فراہم کرتا ہے۔

یہ تسلیم کرنا کہ sessions، authentication (`request.user`)، CSRF حفاظت، اور security headers سب تعمیر شدہ middleware سے آتے ہیں، Django کی request handling کو واضح کرتا ہے اور دکھاتا ہے کہ یہ خصوصیات "بس کام کریں۔" **Onion-layer request/response بہاؤ** کو سمجھنا (middleware view کو لپیٹتا ہے، requests کو اوپر سے نیچے تک اور responses کو نیچے سے اوپر تک process کرتا ہے) اور **ترتیب اہم ہے** (کچھ middleware دوسروں پر منحصر ہے، جیسے authentication کو sessions پہلے چاہیے) Django کو صحیح طریقے سے ترتیب دینے اور مسائل کو ڈیبگ کرنے کے لیے اہم ہے۔

**کسٹم middleware لکھنے** کی صلاحیت قیمتی ہے app کے وسیع رویے کو صاف طریقے سے نافذ کرنے کے لیے — logging، timing، custom headers، rate limiting، maintenance mode — ایک جگہ میں بجائے اسے views کے ساتھ دہرایا۔

یہ جاننا کہ کب middleware استعمال کریں (عام concerns زیادہ تر requests کو متاثر کرتے ہیں) بمقابلہ decorators یا view logic (فی endpoint concerns) ایک اہم architecturalیقین ہے۔

Middleware وہ جگہ ہے جہاں Django request/response processing کو سنبھالتا ہے جو پوری application میں لاگو ہوتی ہے، اسے اہم، عملی طور پر متعلقہ علم بناتا ہے فریم ورک کے internals کو سمجھنے کے لیے اور صحیح طریقے سے ساخت والی applications بنانے کے لیے proper separation کے ساتھ cross-cutting concerns کے۔