Kako middleware funkcionira u FastAPI?

Question

Accepted Answer

**Middleware** u FastAPI je kod koji se izvršava za **svaki zahtjev i odgovor** — omotavajući vaše endpoints kako bi se bavili pitanjima kao što su logging, mjerenje vremena, CORS i dodavanje zaglavlja. FastAPI koristi Starlette-ov middleware sustav (zasnovan je na ASGI).

## Pisanje prilagođenog middleware

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

Uzorak: kod prije `await call_next(request)` se izvršava na putu **unutra** (prije endpoint-a), `call_next` poziva endpoint, i kod nakon toga se izvršava na putu **van** (mijenjajući odgovor). Ovo omotava svaki zahtjev — ovdje se dodaje zaglavlje vremena svim odgovorima.

## Tok zahtjev/odgovor

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

## Ugrađeni / čest middleware

```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 se obično dodaje preko `add_middleware` — CORS (dozvoli zahtjeve s drugog izvora), GZip (kompresiraj odgovore), i provjere pouzdanog hosta su tipični ugrađeni elementi.

## Česte upotrebe 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 ovisnosti

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

## Zašto je to važno

Middleware je pravi mehanizam za **globalna, sveobuhvatna pitanja** u FastAPI — logika koja bi trebala vrijediti za svaki zahtjev i odgovor, kao što su logging, mjerenje vremena zahtjeva, CORS, kompresija i prilagođena zaglavlja.

Razumijevanje je važno za ispravno strukturiranje aplikacija: middleware omotava sve endpoints (izvršavajući se prije i nakon, s mogućnošću izmjene i zahtjeva i odgovora), čineći ga idealnim za ponašanje na razini cijele aplikacije koje bi bilo dosadno i sklono greškama ponavljati u svakom endpoint-u.

Znati razliku između **middleware-a** (globalni, nivo sirovih zahtjev/odgovor) i **ovisnosti** (po endpoint-u, s pristupom parsiranim/tipiziranim vrijednostima i DI — bolje za autentifikaciju i validaciju) ključno je za izbor ispravnog alata.

Običa pitanja kao što su CORS i kompresija obrađuju se ugrađenim middleware, dok prilagođeni middleware pokriva logging i instrumentaciju — čineći ovo praktičnim, često korištenim znanjem za izgradnju dobro strukturiranih, promatranih API-ja.