websocket.Upgrader

websocket.Upgrader 是 Go 语言中用于升级 HTTP 连接为 WebSocket 连接的工具。它是一个结构体，包含了一些配置选项和方法，用于处理 WebSocket 连接的握手过程。

通过使用 websocket.Upgrader，我们可以将一个普通的 HTTP 请求升级为 WebSocket 连接。这在编写基于 WebSocket 的实时应用程序时非常有用，因为它允许服务器和客户端之间进行双向的实时通信。

例如，可以使用以下代码段来创建一个基本的 WebSocket 服务器：

package main

import (
	"log"
	"net/http"
	"github.com/gorilla/websocket"
)

var upgrader = websocket.Upgrader{
	CheckOrigin: func(r *http.Request) bool {
		// 允许所有来源连接
		return true
	},
}

func main() {
	http.HandleFunc("/ws", handleWebSocket)
	log.Fatal(http.ListenAndServe(":8080", nil))
}

func handleWebSocket(w http.ResponseWriter, r *http.Request) {
	conn, err := upgrader.Upgrade(w, r, nil)
	if err != nil {
		log.Println("WebSocket upgrade failed:", err)
		return
	}
	defer conn.Close()

	for {
		_, message, err := conn.ReadMessage()
		if err != nil {
			log.Println("WebSocket read failed:", err)
			break
		}

		log.Println("Received message:", string(message))

		err = conn.WriteMessage(websocket.TextMessage, message)
		if err != nil {
			log.Println("WebSocket write failed:", err)
			break
		}
	}
}

在上面的代码中，我们定义了一个 "/ws" 路由，当客户端请求该路径时，将调用 handleWebSocket 函数来处理握手和后续的消息传输。通过调用 upgrader.Upgrade() 方法，我们将 HTTP 连接升级为 WebSocket 连接。然后，我们使用 conn.ReadMessage() 和 conn.WriteMessage() 方法来接收和发送消息。

这只是一个简单的示例，实际上你可以根据你的需求进行更复杂的操作，如处理不同类型的消息、群发消息等。websocket.Upgrader 提供了一些配置选项，例如设置允许的来源、设置子协议等，你可以根据需要进行相应的配置。