Conas a dhéanann tú gné-neart in-am-fíor a thógáil le geataí WebSocket?

Question

Accepted Answer

Tacaíonn NestJS **cumarsáid dhéthreo in-am-fíor** trí **gheataí WebSocket** — ranganna a dhéantar maisithe le `@WebSocketGateway()` a láimhseálann naisc agus teachtaireachtaí WebSocket (de ghnáth thar Socket.IO). Tugann siad deis do ghné-neart ar nós comhráite, fógraí beo, agus dealbhóireacht bheo, ag úsáid an chéad dhéanamh NestJS (DI, maisithe).

## An geata a shainiú

```ts
import { WebSocketGateway, SubscribeMessage, MessageBody, WebSocketServer } from "@nestjs/websockets";
import { Server } from "socket.io";

@WebSocketGateway({ cors: true })
export class ChatGateway {
  @WebSocketServer()
  server: Server;                        // the Socket.IO server instance

// handle a 'message' event from a client
  @SubscribeMessage("message")
  handleMessage(@MessageBody() data: { text: string }) {
    // BROADCAST to all connected clients
    this.server.emit("message", data);   // everyone receives the message
  }
}
```

Úsáideann geata `@SubscribeMessage("event")` chun imeachtaí isteach a láimhseáil (comhchosúil le `@Post` do HTTP) agus an `server` insteallta chun imeachtaí **a scaipeadh** ar ais chuig cliant — scaipeann `server.emit` chuig gach duine.

## Crochet saolré an naisc

```ts
export class ChatGateway implements OnGatewayConnection, OnGatewayDisconnect {
  handleConnection(client: Socket) {
    console.log(`Client connected: ${client.id}`);   // a user joined
  }
  handleDisconnect(client: Socket) {
    console.log(`Client disconnected: ${client.id}`); // a user left — clean up
  }
}
```

Is féidir le geataí a bheith ina n-iachall d'iar-chleachtóirí ag ceangal agus ag imeall — fúilneach do rianú láithreachta agus glanadh.

## Cliant ar leith agus seomraí a bhíonn i bhfócas

```ts
@SubscribeMessage("joinRoom")
handleJoin(@ConnectedSocket() client: Socket, @MessageBody() room: string) {
  client.join(room);                              // add the client to a room
}

@SubscribeMessage("roomMessage")
sendToRoom(@MessageBody() data: { room: string; text: string }) {
  this.server.to(data.room).emit("message", data.text);   // emit only to that room
  // client.emit(...) → just that client; server.emit(...) → everyone
}
```

**Seomraí** grúpa cliant (m.sh. seomra comhrá, comhoibrithe doiciméad), ag tabhairt deis duit a scaipeadh go foghrúpaí ar leith seachas gach duine — riachtanach do ghné-neart in-am-fíor scópaithe.

## Geataí ag atúsáil gné-neart NestJS

```text
Gateways are providers → they support dependency injection (inject services),
and can use guards, pipes, interceptors, and filters — just like HTTP controllers.
→ The same structure/patterns apply to real-time as to REST.
```

## Scáileáil WebSockets

```text
⚠️ WebSocket connections are STATEFUL and live on ONE server instance.
To scale across multiple instances, use a Redis adapter (socket.io-redis) so
broadcasts/rooms work across all instances. (Like sessions, don't keep state in
one process's memory when scaling horizontally.)
```

## Cén fáth a bhíonn tábhacht aige

Is iad geataí WebSocket an chaoi ar chuireann NestJS **gné-neart dhéthreo in-am-fíor** ar fáil — comhráite, fógraí beo, láithreacht, eagarthóireacht chomhoibritheach, dealbhóireacht bheo, idirghnéasanna iolraighreabhar — nach féidir le múnla iarrata-freagra REST a chur ar fáil (is féidir leis an bhfreastalaí a bhrú chuig cliant, ní hamháin do iarrataí a fhreagairt).

Bhí sé fúilneach eolas d'fhálchomhghníomhach le tuiscint ar iad a thógáil feidhmíochta gníomhaíochta athraonta.

Is é an príomh-neart ná go gcuireann geataí deis ar struchtúr cuibheasach NestJS: siad soláthraí a thacaíonn **le tabhairt isteach spleáchais** agus is féidir leo **guaird, píopaí, eatramhálaí, agus scagairí** a úsáid díreach cosúil le rialaithe HTTP, ionas go mbíonn na patrúin agus an eagrú cóid chéanna i bhfeidhm i réadúla-am agus REST.

An tsraith a dhéanamh ar an gceist ar chóir a bhheith ag déanamh imeachtaí (`@SubscribeMessage`), a scaipeadh chuig cliaint (`server.emit`), úsáid **seomraí** chun scóp-scaipeadh a bhíonn i bhfóghrúpaí ábhartha (seomraí comhrá, comhoibrithe doiciméad), agus staid an naisc a bhainistiú (láithreacht, glanadh) a chlúdaíonn an fúnneamh praciticiúil in-am-fíor.

Riachtanach ar an **tabhacht scáileála**: Tá naisc WebSocket statúil agus ceangailte do thuar a bhíonn ar an bhfreastalaí, agus ar an méid go scalach thréimhsiúil gníomhaíochta **adapter Redis** ar bhóthar dhá bhreac-scaipeadh/seomraí trasna imlíne (gontanáth common — cosúil le seisiún, ní féidir le státas in-am-fíor a bheith i cuimhne próisis amháin agus roinnt imlíne ag rith).

Is é seo gné thábhachtach, níos iomláine ar bhord a chur ar fáil don gníomhaíochta anuas-am-fíor, gníomhaíochta idirghníomhach a bhíonn ag iachall ar úsáidí nua-aimseartha, agus déanann cumhachta glain an-logánta NestJS inrochtana agus ag atúsáil ar struchtúr an spréachta.