FastAPI मा middleware कसरी काम गर्छ?

Question

Accepted Answer

**Middleware** FastAPI मा यो कोड हो जो **हरेक request र response** को लागि चल्छ — तपाइँको endpoints लाई wrap गरेर logging, timing, CORS, र headers थप्न जस्ता cross-cutting concerns लाई हेरफेर गर्न। FastAPI ले Starlette को middleware system प्रयोग गर्छ (यो ASGI-based हो)।

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

यो pattern हो: `await call_next(request)` भन्दा पहिले को कोड **भित्र** चल्छ (endpoint भन्दा पहिले), `call_next` ले endpoint लाई invoke गर्छ, र पछाडि को कोड **बाहिर** चल्छ (response लाई modify गर्दै)। यो हरेक request लाई wrap गर्छ — यहाँ, सबै responses मा timing header थप्दै।

## Request/response flow

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

## Built-in / common 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 सामान्यतः `add_middleware` को माध्यमबाट थप गरिन्छ — CORS (cross-origin requests अनुमति दिन), GZip (responses compress गर्न), र trusted-host checks यो typical built-ins हुन्।

## Common middleware uses

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

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

## यो किन महत्वपूर्ण छ

Middleware FastAPI मा **global, cross-cutting concerns** को लागि सही mechanism हो — logic जो हरेक request र response मा लागु हुनुपर्छ, जस्तै logging, request timing, CORS, compression, र custom headers।

यसलाई बुझ्न अनुप्रयोग सही तरिकाले संरचना गर्नको लागि महत्वपूर्ण छ: middleware सबै endpoints लाई wrap गर्छ (पहिले र पछाडि चलाइन्छ, request र response दुबै लाई modify गर्न को क्षमता सहित), जसले यो app-wide behavior को लागि आदर्श बनाउँछ जो हरेक endpoint मा दोहोर्याउन उबाऊ र त्रुटि-प्रवण हुन्छ।

**Middleware** (global, raw request/response level) र **dependencies** (per-endpoint, parsed/typed values र DI मा पहुँच सहित — auth र validation को लागि राम्रो) को बीच को भेद जान्न सही उपकरण छनौट गर्न को लागि महत्वपूर्ण छ।

CORS र compression जस्ता common needs built-in middleware द्वारा सामना गरिन्छ, जबकि custom middleware logging र instrumentation लाई कभर गर्छ — यसले यो व्यावहारिक, बारम्बार प्रयोग हुने ज्ञान को लागि well-structured, observable APIs निर्माण गर्न बनाउँछ।