როგორ მუშაობს middleware FastAPI-ში?

Question

Accepted Answer

**Middleware** FastAPI-ში არის კოდი, რომელიც გაშვებულია **თითოეული მოთხოვნისა და პასუხის** შემთხვევაში — აფარებს თქვენს endpoint-ებს ისეთი ელემენტების დასამუშავებლად, როგორიცაა logging, timing, CORS და header-ების დამატება. FastAPI იყენებს Starlette-ის middleware სისტემას (ASGI-ზე დაფუძნებული).

## მოწერის მიერ განამტკიცა 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
```

შაბლონი: `await call_next(request)` წინ კოდი მუშაობს **შინ** (endpoint-ის წინ), `call_next` გამოიძახებს endpoint-ს და კოდი შემდეგ მუშაობს **გარეთ** (პასუხის შეცვლა). ეს მოიცავს თითოეულ მოთხოვნას — აქ დაემატა timing header ყველა პასუხისთვის.

## მოთხოვნა/პასუხის ნაკადი

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

```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 მოთხოვნებს), GZip (შეკუმშე პასუხები) და trusted-host შემოწმებები ჩვეულებრივი ჩაშენებული ამოცანებია.

## 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 დამოკიდებულება

```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-ში — ლოგიკა, რომელიც უნდა გამოიყენოს ყველა მოთხოვნა-პასუხის წყვილისთვის, როგორიცაა logging, მოთხოვნის დროის გაზომვა, CORS, შეკუმშვა და მორგებული header-ები.

ამის გაგება მნიშვნელოვანია აპლიკაციის სწორად დაცვლენის თვალსაზრისით: middleware იფარება ყველა endpoint-ზე (გაშვება წინ და შემდეგ, განახლების უნარით მოთხოვნა და პასუხი), რაც იდეალია აპ-ვიდე ქცევის জন্য, რომელიც რთული და შეცდომისკენ მიმართული იქნება ყველა endpoint-ზე გამეორებული.

მნიშვნელოვანია განსხვავების ცოდნა **middleware**-სა (გლობალური, raw მოთხოვნა/პასუხის დონე) და **დამოკიდებულება**-ს (per-endpoint, პარსირებული/დაკარგული მნიშვნელობებთან და DI წვდომით — უკეთესი auth და validation-ისთვის) შორის სწორი ხელსაწყোს არჩევის თვალსაზრისით.

გაერთიანებული მოთხოვნები, როგორიცაა CORS და შეკუმშვა, მოუწყებილია ჩაშენებული middleware-ით, რაც custom middleware-ს კვეთავს logging და instrumentation-ზე — ეს ხელმისაწვდომი, ხშირად გამოყენებული ცოდნა კარგად სტრუქტურირებული, დაკვირვების ადგილის მქონე API-ების აშენებისთვის.