Kaip veikia middleware FastAPI?

Question

Accepted Answer

**Middleware** FastAPI yra kodas, kuris vykdomas **kiekvienam užklausai ir atsakymui** — apvyniojamas jūsų endpoint'ai, kad tvarkyti skersines sąvokas, tokias kaip žurnalizavimas, laiko nustatymas, CORS ir antraščių pridėjimas. FastAPI naudoja Starlette middleware sistemą (pagrįstą ASGI).

## Rašymas pasirinktinio 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
```

Šablonas: kodas prieš `await call_next(request)` vykdomas **viduje** (prieš endpoint'ą), `call_next` iškviečia endpoint'ą ir kodas po to vykdomas **lauke** (modifikuodamas atsakymą). Tai apvynioja kiekvieną užklausą — čia pridedama laiko nustatymo antraštė visiems atsakymams.

## Užklausos/atsakymo srautas

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

## Integruotas / bendras 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 paprastai pridedamas per `add_middleware` — CORS (leisti per-Origin užklausas), GZip (suspausti atsakymus) ir patikimų šaltinių patikra yra tipiški integruoti įrankiai.

## Bendras middleware naudojimas

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

## Middleware ir priklausomybės

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

## Kodėl tai svarbu

Middleware yra tinkamas mechanizmas **pasaulinėms, skersinėms problemoms** FastAPI — logika, kuri turėtų būti taikoma kiekvienai užklausai ir atsakymui, tokia kaip žurnalizavimas, užklausos laiko nustatymas, CORS, suspaudimas ir pasirinktinės antraščės.

Supratimas yra svarbus norint teisingai struktūrizuoti programas: middleware apvynioja visus endpoint'us (vykdydamas prieš ir po, su galimybe modifikuoti tiek užklausą, tiek atsakymą), todėl jis idealus visos programos elgesiui, kurį būtų nuobodu ir klaidinga kartoti kiekviename endpoint'e.

Svarbi yra žinoti skirtumą tarp **middleware** (globalus, žemas užklausos/atsakymo lygis) ir **priklausomybių** (per-endpoint'ą, su prieiga prie analizuotų/suketintų verčių ir DI — geriau auth ir validacijai) norint pasirinkti tinkamą įrankį.

Bendri poreikiai, tokie kaip CORS ir suspaudimas, tvarkomi integruoto middleware, o pasirinktinis middleware dengia žurnalizavimą ir instrumentavimą — tai praktinios, dažnai naudojamos žinios norint kurti gerai struktūrizuotas, stebėtas API.