初始化

websocket/handler.go

@@ -0,0 +1,95 @@
+// Package websocket 提供WebSocket HTTP升级处理器
+package websocket
+
+import (
+	"log"
+	"net/http"
+
+	"github.com/gin-gonic/gin"
+	"github.com/gorilla/websocket"
+)
+
+// upgrader 用于将HTTP连接升级为WebSocket连接
+var upgrader = websocket.Upgrader{
+	ReadBufferSize:  1024, // 读缓冲区大小
+	WriteBufferSize: 1024, // 写缓冲区大小
+	// 允许所有来源的连接（开发环境）
+	CheckOrigin: func(r *http.Request) bool {
+		return true
+	},
+}
+
+// HandleWebSocket 处理WebSocket连接升级请求（Gin版本）
+// 客户端通过此接口建立WebSocket连接，加入Hub进行消息通信
+// 路径: GET /api/ws
+func HandleWebSocket(hub *Hub) gin.HandlerFunc {
+	return func(c *gin.Context) {
+		handleWS(hub, c.Writer, c.Request)
+	}
+}
+
+// HandleWebSocketHTTP 处理WebSocket连接升级请求（标准net/http版本）
+// 用于独立的WebSocket服务（端口16703）
+func HandleWebSocketHTTP(hub *Hub) http.HandlerFunc {
+	return func(w http.ResponseWriter, r *http.Request) {
+		handleWS(hub, w, r)
+	}
+}
+
+// handleWS WebSocket连接处理的核心逻辑
+func handleWS(hub *Hub, w http.ResponseWriter, r *http.Request) {
+	// 将HTTP连接升级为WebSocket连接
+	conn, err := upgrader.Upgrade(w, r, nil)
+	if err != nil {
+		log.Printf("WebSocket升级失败: %v", err)
+		return
+	}
+
+	// 创建客户端实例并注册到Hub
+	client := &Client{
+		hub:  hub,
+		conn: conn,
+		send: make(chan []byte, 256),
+	}
+	hub.register <- client
+
+	// 启动读写goroutine
+	go client.writePump()
+	go client.readPump()
+}
+
+// readPump 从WebSocket连接读取消息
+// 持续监听客户端发送的消息，遇到错误或关闭时断开连接
+func (c *Client) readPump() {
+	defer func() {
+		c.hub.unregister <- c
+		c.conn.Close()
+	}()
+
+	for {
+		// 读取消息（目前仅用于检测连接状态，后续可扩展协作协议）
+		_, message, err := c.conn.ReadMessage()
+		if err != nil {
+			if websocket.IsUnexpectedCloseError(err, websocket.CloseGoingAway, websocket.CloseNormalClosure) {
+				log.Printf("WebSocket读取错误: %v", err)
+			}
+			break
+		}
+		// 收到客户端消息后广播给其他客户端（协作基础）
+		c.hub.BroadcastMessage(message)
+	}
+}
+
+// writePump 向WebSocket连接写入消息
+// 从send通道读取消息并发送给客户端
+func (c *Client) writePump() {
+	defer c.conn.Close()
+
+	for message := range c.send {
+		err := c.conn.WriteMessage(websocket.TextMessage, message)
+		if err != nil {
+			log.Printf("WebSocket写入错误: %v", err)
+			break
+		}
+	}
+}

websocket/hub.go

@@ -0,0 +1,89 @@
+// Package websocket 实现WebSocket连接管理和消息广播
+// 为在线协作功能预留，支持多客户端实时通信
+package websocket
+
+import (
+	"log"
+	"sync"
+
+	"github.com/gorilla/websocket"
+)
+
+// Hub WebSocket连接管理中心
+// 负责维护所有活跃的WebSocket连接，处理消息广播
+type Hub struct {
+	clients    map[*Client]bool // 所有已连接的客户端
+	broadcast  chan []byte      // 待广播的消息通道
+	register   chan *Client     // 客户端注册通道
+	unregister chan *Client     // 客户端注销通道
+	mu         sync.RWMutex     // 读写锁，保护 clients map
+}
+
+// Client 单个WebSocket客户端连接
+type Client struct {
+	hub  *Hub            // 所属的Hub
+	conn *websocket.Conn // WebSocket连接实例
+	send chan []byte     // 待发送的消息队列
+}
+
+// NewHub 创建并返回一个新的Hub实例
+func NewHub() *Hub {
+	return &Hub{
+		clients:    make(map[*Client]bool),
+		broadcast:  make(chan []byte, 256),
+		register:   make(chan *Client),
+		unregister: make(chan *Client),
+	}
+}
+
+// Run 启动Hub的主循环
+// 在独立的goroutine中运行，处理客户端注册、注销和消息广播
+func (h *Hub) Run() {
+	for {
+		select {
+		case client := <-h.register:
+			// 新客户端连接注册
+			h.mu.Lock()
+			h.clients[client] = true
+			h.mu.Unlock()
+			log.Printf("WebSocket客户端已连接，当前在线: %d", len(h.clients))
+
+		case client := <-h.unregister:
+			// 客户端断开连接注销
+			h.mu.Lock()
+			if _, ok := h.clients[client]; ok {
+				delete(h.clients, client)
+				close(client.send)
+			}
+			h.mu.Unlock()
+			log.Printf("WebSocket客户端已断开，当前在线: %d", len(h.clients))
+
+		case message := <-h.broadcast:
+			// 向所有客户端广播消息
+			h.mu.RLock()
+			for client := range h.clients {
+				select {
+				case client.send <- message:
+				default:
+					// 发送缓冲区已满，断开该客户端
+					close(client.send)
+					delete(h.clients, client)
+				}
+			}
+			h.mu.RUnlock()
+		}
+	}
+}
+
+// BroadcastMessage 向所有连接的客户端广播消息
+// message: 要广播的字节数据
+func (h *Hub) BroadcastMessage(message []byte) {
+	h.broadcast <- message
+}
+
+// ClientCount 返回当前在线客户端数量
+func (h *Hub) ClientCount() int {
+	h.mu.RLock()
+	defer h.mu.RUnlock()
+	return len(h.clients)
+}