Conas a oibríonn middleware i FastAPI?

Question

Accepted Answer

Is ionann **middleware** i FastAPI agus cód a rithíonn do **gach iarratas agus freagra** — do do endpoints a chlúdach chun gníomhaíochtaí trasnánach a dhéileáil leo cosúil le logáil, tímiú, CORS, agus ceanglais a chur leis. Úsáideann FastAPI córas middleware Starlette (bunaithe ar ASGI).

## Middleware saincheaptha a scríobh

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

An patrún: rithíonn cód roimh `await call_next(request)` ar an mbealach **isteach** (roimh an endpoint), gealadh a dhéanann `call_next` ar an endpoint, agus rithíonn cód ina dhiaidh sin ar an mbealach **amach** (an freagra a mhionathrú). Clúdaíonn sé seo gach iarratas — anseo, ceanglais tímiú a chur le gach freagra.

## An fhluain iarratas/freagra

```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 ionsuite / coitianta

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

Is iondúil go gcuirtear middleware ar fáil trí `add_middleware` — CORS (iarrataí trasdhúchais a cheadú), GZip (freagraí a dhomhchumpríonn), agus seiceanna fósta-eisiach ar iondúil le ceannasacha ionchuí.

## Úsáidí coitianta 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 spleáchais

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

## Cén fáth a bhfuil sé tábhachtach

Is é middleware an meicníoc cheart do **bhreithnithe domhanda, trasnánach** i FastAPI — loighic ar chóir go n-imirt ar gach iarratas agus freagra, mar logáil, tímiú iarratas, CORS, comhbhrúchtú, agus ceanglais dhritúine.

Tá sé tábhachtach é a thuiscint chun feidhmchláir a dhéanamh i gceart: clúdaíonn middleware gach endpoint (ag rith roimh agus i ndiaidh, a bhfuil an t-acmhainn acu an t-iarratas agus an freagra araon a athrú), rud a fhágann go bhfuil sé oiriúnach do iompar ar dhromchla an app a bheadh tedious agus oscailt-bharraigthe a athdhéanamh i ngach endpoint.

A bheith eolach ar an idirdhealú idir **middleware** (domhanda, ar leibhéal iomlán iarratas/freagra) agus **spleáchais** (in aghaidh an endpoint, a bhfuil rochtain aici ar luachanna parsáilte/clóscríofa agus DI — níos fearr do auth agus bailíochtú) tá ríthábhachtach chun an uirlis cheart a roghnú.

Láimhseálann middleware ionsuite riachtanais choitianta cosúil le CORS agus comhbhrúchtú, agus tugann middleware saincheaptha dó logáil agus ionstrúmentiú — rud a fhágann go bhfuil na heolais phraiticiúla seo, a úsáidtear go minic, riachtanach chun APIanna a bhfoirm deas, breathnuithe a thógáil.