Si funksionon middleware në FastAPI?

Question

Accepted Answer

**Middleware** në FastAPI është kod që ekzekutohet për **çdo kërkesë dhe përgjigje** — mbështjellë pikat përfundimtare tuaja për të trajtuar shqetësimet tërthore si regjistrim, matje kohe, CORS dhe shtim të kokave. FastAPI përdor sistemin e middleware të Starlette (është i bazuar në ASGI).

## Shkrimi i middleware të personalizuar

```python
import time

@app.middleware("http")
async def add_timing(request: Request, call_next):
    start = time.time()
    response = await call_next(request)        # call the endpoint (and any inner middleware)
    response.headers["X-Process-Time"] = str(time.time() - start)   # modify the response
    return response
```

Shablloni: kodi para `await call_next(request)` ekzekutohet në hyrje (para pikas përfundimtare), `call_next` thërret pikën përfundimtare, dhe kodi pas ekzekutohet në dalje (modifikimi i përgjigjes). Ky mbështjellë çdo kërkesë — këtu, duke shtuar një kokë kohe në të gjitha përgjigjet.

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

```text
Request  → MW1 → MW2 → endpoint
Response ← MW1 ← MW2 ← endpoint
Middleware wraps the endpoint; runs in order on the way in, reverse on the way out.
```

## Middleware i ndërtuar / i zakonshëm

```python
from fastapi.middleware.cors import CORSMiddleware
from fastapi.middleware.gzip import GZipMiddleware

app.add_middleware(CORSMiddleware, allow_origins=["https://app.example.com"], ...)  # CORS
app.add_middleware(GZipMiddleware, minimum_size=1000)                               # compression
```

Middleware zakonisht shtohet përmes `add_middleware` — CORS (lejon kërkesa ndër-burime), GZip (kompreson përgjigjet), dhe kontroller të burimeve të besueshme janë ndërtime tipike.

## Përdorimet e zakonshme të middleware

```text
✓ Logging / request timing / metrics
✓ CORS (cross-origin request handling)
✓ Adding security or custom headers
✓ Response compression (GZip)
✓ Request ID / correlation ID injection
```

## Middleware vs varësi

```text
Middleware   → runs for ALL requests; works at the raw request/response level (headers,
               timing, the whole response). Best for truly global concerns.
Dependencies → per-endpoint (or grouped) logic with access to parsed params, DI, and
               typed values. Best for auth, validation, shared parameters.
→ Use middleware for global cross-cutting concerns; dependencies for endpoint logic.
```

## Pse ka rëndësi

Middleware është mekanizmi i duhur për **shqetësimet globale, tërthore** në FastAPI — logjika që duhet të zbatohet në çdo kërkesë dhe përgjigje, si regjistrim, matje kohe kërkese, CORS, kompresim dhe koka të personalizuar.

Kuptimi i tij është i rëndësishëm për strukturimin e duhur të aplikacioneve: middleware mbështjellë të gjitha pikat përfundimtare (duke ekzekutuar para dhe pas, me aftësinë për të modifikuar si kërkesën ashtu edhe përgjigjen), duke e bërë atë ideal për sjelljet në nivel aplikacioni që do të ishin të lodhshme dhe të ndjeshme ndaj gabimeve nëse përsëriteshin në çdo pikë përfundimtare.

Dallimi ndërmjet **middleware** (globale, në nivelin e kërkesës/përgjigjes) dhe **varësive** (për pikë përfundimtare, me qasje në vlerat e analizuara/të shtyruara dhe DI — më mirë për autentifikim dhe validim) është çelësor për zgjedhjen e vegles të duhur.

Nevojat e zakonshme si CORS dhe kompresim trajtohen nga middleware i ndërtuar, ndërsa middleware i personalizuar mbulimi regjistrim dhe instrumentim — duke e bërë këtë njohuri praktike, të përdorur shpesh për ndërtimin e API-ve të strukturuar mirë dhe të vëzhgueshme.