Conas a dhéileálann tú le WebSockets in FastAPI?

Question

Accepted Answer

Tacaíonn FastAPI **WebSockets** do chumarsáid dhéatreolaigh i bhfíor-am (comhrá, nuashonruithe beo, fógra) trí an deochladóir `@app.websocket`. Murab ionann agus beart iarratas-fhreagra HTTP, fanann nasc WebSocket oscailte, a ligean do an freastalaí agus an cliant teachtaireachtaí a sheoladh go saor.

## Pointe WebSocket bunúsach

```python
from fastapi import WebSocket, WebSocketDisconnect

@app.websocket("/ws")
async def websocket_endpoint(websocket: WebSocket):
    await websocket.accept()                  # accept the connection
    try:
        while True:
            data = await websocket.receive_text()    # receive a message from the client
            await websocket.send_text(f"Echo: {data}")  # send a message back
    except WebSocketDisconnect:
        print("client disconnected")           # handle disconnection (cleanup)
```

An patrún: glacann `accept()` an nasc, ansin lúb — léann `receive_text()`/`receive_json()` teachtaireachtaí, cuireann `send_text()`/`send_json()` ar aghaidh iad. Fógraíonn eisceachtas `WebSocketDisconnect` gur fhág an cliant (áit a ghlanann tú).

## Craobhscaoileadh do na fóclanna iolracha (m.sh. comhrá)

```python
class ConnectionManager:
    def __init__(self): self.active: list[WebSocket] = []
    async def connect(self, ws): await ws.accept(); self.active.append(ws)
    def disconnect(self, ws): self.active.remove(ws)
    async def broadcast(self, msg):
        for conn in self.active:
            await conn.send_text(msg)          # send to ALL connected clients

manager = ConnectionManager()

@app.websocket("/chat")
async def chat(ws: WebSocket):
    await manager.connect(ws)
    try:
        while True:
            msg = await ws.receive_text()
            await manager.broadcast(msg)        # everyone gets the message
    except WebSocketDisconnect:
        manager.disconnect(ws)                  # remove on disconnect
```

Bainistiú liosta de naisc ghníomhacha a ligean duit **craobhscaoileadh** do na fóclanna ar fad — an bhunús ar fhéilirí comhrá agus ghnéithe nuashonraithe beo.

## Caveat scálú

```text
⚠️ WebSocket connections are STATEFUL and live on ONE server instance.
To scale across multiple instances, use a Redis Pub/Sub (or similar) backplane so
messages/broadcasts reach clients connected to OTHER instances.
(Like sessions, don't keep connection state only in one process when scaling horizontally.)
```

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

Cumasaíonn WebSockets **fíor-am, déatreolaigh** gné — comhrá, fógra beo, láithreacht, eagarthóireacht chomhoibritheach, dealbhóidí beo — nach bhféadfadh an tsamhail iarratas-fhreagra HTTP a sholáthar (is féidir leis an freastalaí brú a dhéanamh ar chliaint, ní díreach freagra a thabhairt).

Tá sé luachmhar an tacaíochta WebSocket FastAPI a thuiscint chun feidhmchláir idirghníomhacha nua-aimseartha a thógáil: an deochladóir `@app.websocket` leis an lúb glacadh/fháil/seol cumarsáid fhíor-am bhunúsach a chlúdaíonn, agus bainistiú ar naisc ghníomhacha a chumasaíonn **craobhscaoileadh** (an croílár na bhféilirí iolracha fhocal mar shamhrá).

Oireann bunús asincronach FastAPI go fíor-thairbhiúil do WebSockets.

I ndáiríre tábhachtach an **caveat scálú**: tá nasc WebSocket staid-bhunaithe agus ceangailte do aon chás freastalaí, mar sin tá a bheith ag scálú thar iliomad chás a éileamh **Redis Pub/Sub backplane** chun teachtaireachtaí a atreoladh idir cásanna — dochar coitianta, mar (cosúil le seisiúin) ní féidir státchuid naisc a bheth ina gheal i gcuimhne próiseas amháin agus tú ag rith iliomad chásanna.

A fhios a bheith agat ar an bpatrún WebSocket bunúsach, craobhscaoileadh, láimhseáil dhícheangal, agus an bhreithniú scálú is gá do oibrí sinsir inaitheanta chun na turgnaimh idirghníomhacha agus fhíor-am a bhronn níos iomláine i bhfeidhmchláir nua-aimseartha a thógáil.