framework
framework/websocket/index.md
medium
framework-websocket-index
WebSocket（Java/Spring 视角）使用约定 — 端点接入/STOMP 消息/会话与心跳/集群广播四个独立决策点。Use when 接入 WebSocket / 用 STOMP 推送 / 管在线会话与心跳 / 多实例广播时。
子项索引
| 子项 | 一句话 |
|---|---|
| websocket-spring-websocket skill | Spring WebSocket 接入选型 — JSR-356 '@ServerEndpoint' vs Spring 原生 WebSocketHandler/握手拦截器/WebSocketSession 会话操作 |
| websocket-stomp-messaging skill | STOMP 子协议消息路由 — '@MessageMapping'/'@SendTo' 接收并广播、客户端订阅 topic、SimpMessagingTemplate 服务端主动推送给全体或指定用户 |
| websocket-session-and-heartbeat skill | WebSocket 会话管理 — 用户↔WebSocketSession 映射用并发容器、心跳保活、读空闲断线检测清理、单用户连接数上限 |
| websocket-cluster-broadcast skill | WebSocket 集群广播 — 多实例下本地 session 只在本节点，需用 Redis pub/sub 或 MQ 把消息扇出到所有节点，各节点再推给本地 session |
WebSocket · 框架使用约定索引
四个独立决策点，按你正在做的事下钻：
| 你在做什么 | 进哪个 |
|---|---|
| 接入 WebSocket、选端点写法、写握手鉴权拦截器 | spring-websocket |
| 用 STOMP 做订阅/广播、服务端主动推送 | stomp-messaging |
| 维护在线 session、做心跳保活/断线检测/限连 | session-and-heartbeat |
| 多实例部署、推送只有部分用户收到、跨节点广播 | cluster-broadcast |