Kako deluje vmesna programska oprema (middleware) v FastAPI?

Question

Accepted Answer

**Vmesna programska oprema (Middleware)** v FastAPI je koda, ki se zažene za **vsak zahtevek in odgovor** — obdaja vaše končne točke in obravnava prečne težave, kot so beleženje, merjenje časa, CORS in dodajanje glav. FastAPI uporablja Starlettejev sistem vmesne programske opreme (temelji se na ASGI).

## Pisanje prilagojene vmesne programske opreme

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

Muster: koda pred `await call_next(request)` se zažene na poti **naprej** (pred končno točko), `call_next` aktivira končno točko, in koda po njej se zažene na poti **nazaj** (spreminjanje odgovora). To obdaja vsak zahtevek — tukaj dodajamo glavo s časovnim žigom vsem odgovorom.

## Tok zahtevka/odgovora

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

## Vgrajena / pogosta vmesna programska oprema

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

Vmesna programska oprema se običajno doda prek `add_middleware` — CORS (dovoljavamo zahtevke iz različnih izvora), GZip (stisnemo odgovore) in preverke zaupanih gostiteljev so tipični vgrajeni moduli.

## Pogosta uporaba vmesne programske opreme

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

## Vmesna programska oprema v primerjavi z odvisnostmi

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

## Zakaj je to pomembno

Vmesna programska oprema je pravi mehanizem za **globalne, prečne težave** v FastAPI — logika, ki bi se morala uporabljati za vsak zahtevek in odgovor, kot so beleženje, merjenje časa zahtevkov, CORS, stiskanje in prilagojene glave.

Razumevanje je pomembno za pravilno strukturiranje aplikacij: vmesna programska oprema obdaja vse končne točke (se zažene pred in po, z zmožnostjo spremembe zahtevka in odgovora), kar jo naredi idealno za obnašanje, ki se uporablja v celotni aplikaciji in bi bilo dolgočasno in nagnjeno h napakam ponovljati v vsaki končni točki.

Pomembno je poznati razliko med **vmesno programsko opremo** (globalna, raven surovih zahtevkov/odgovorov) in **odvisnostmi** (na ravni končne točke, z dostopom do razčlanjenih/tipiziranih vrednosti in DI — bolje za avtentikacijo in preverjanje veljavnosti), saj je to ključno za izbiro pravega orodja.

Splošne potrebe, kot so CORS in stiskanje, so obravnavane z vgrajeno vmesno programsko opremo, medtem ko prilagojeno vmesno programsko opremo pokrivajo beleženje in instrumentacija — kar to naredi praktično in pogosto uporabljeno znanje za gradnjo dobro strukturiranih in opazljivih API-jev.