Çfarë është middleware në Django?

Question

Accepted Answer

**Middleware** është një kornizë hook-esh që përpunojnë **çdo kërkesë dhe përgjigje** globalisht, duke qenë ndërmjet server-it web dhe view-ve tuaja. Çdo middleware mund të inspektojë/modifikojë kërkesën në hyrje dhe përgjigjet në dalje — ideale për shqetësimet ndërkruese si autentifikimi, header-ët e sigurisë, sesionet dhe regjistrimiet.

## Rrjedha e kërkesës/përgjigjes përmes middleware

```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)
```

## Middleware i brendshëm i Django (në 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
```

Mjafta e funksionalitetit themelor të Django-s është middleware: sesionet (`request.session`), autentifikimi (`request.user`), mbrojtja CSRF dhe header-ët e sigurisë vijnë të gjitha nga middleware i brendshëm. **Rendi ka rëndësi** — disa middleware varen nga të tjerat që të ekzekutohen përpara.

## Shkrimi i middleware të personalizuar

```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
```

Një middleware është një callable: kodi para `self.get_response(request)` ekzekutohet në kërkesë, kodi pas ekzekutohet në përgjigje. Kjo ju lejon të veproni para dhe pas ekzekutimit të view-it.

## Përdorimet e zakonshme të 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 përkundër view-ve/dekoratorëve

```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.
```

## Pse ka rëndësi

Middleware është themelor për mënyrën se si Django përpunon kërkesën — ta kuptosh atë shpjegon se si funksionon shumë e funksionalitetit themelor të kornizës dhe ofron mekanizmin e duhur për **shqetësimet globale dhe ndërkruese**.

Fakt i rëndësishëm është të njohësh se sesionet, autentifikimi (`request.user`), mbrojtja CSRF dhe header-ët e sigurisë vijnë të gjitha nga middleware i brendshëm — kjo demistifikon përpunimin e kërkesës në Django dhe tregon pse këto veçori "funksionojnë vetë". Të kuptosh **rrjedhën e shtresës cipulle të kërkesës/përgjigjes** (middleware që mbështetet në view, duke përpunuar kërkesën nga lart poshtë dhe përgjigjet nga poshtë lart) dhe faktin se **rendi ka rëndësi** (disa middleware varen nga të tjerat, si autentifikimi që ka nevojë për sesionet së pari) është i rëndësishëm për konfigurimin e saktë të Django-s dhe zbatimin e debugging-ut.

Abiliteti i **shkrimit të middleware të personalizuar** është i vlefshëm për zbatimin e sjelljeve në të gjithë aplikacionin në mënyrë të pastër — regjistrim, matja e kohës, header-ë të personalizuar, kufizimi i normës, mënyrja e mirëmbajtjes — në një vend në vend se ta përsëritni atë në të gjitha view-et.

Të dish kur të përdorësh middleware (shqetësimet globale që ndikojnë në shumicën e kërkesave) përkundër dekoratorëve ose logjikës së view-it (shqetësimet për çdo pikë fundore) është një vendim arkitektonik kyç.

Middleware është ajo ku Django menaxhon përpunimin e kërkesës/përgjigjes që zbatohet në të gjithë aplikacionin, duke e bërë atë njohuri të rëndësishme, praktikisht të rëndësishme për të dy kuptimin e brendshëm të kornizës dhe ndërtimin e aplikacioneve të strukturuara mirë me ndarjen e duhur të shqetësimeve ndërkruese.