// ServerWsSession.h — MFC 服务端设备端口的 WebSocket 传输层 // // 与 Go 服务端 server/go/server/ws.go 的 wrapWebSocket / wsConn 同构:在同一端口上 // 与明文、TLS 设备共存,首包是 "GET " 时按 HTTP Upgrade 升级,之后把每帧载荷原样交回 // 既有解析路径;发送方向「一次发送 = 一帧」,与 wsConn.Write 对齐。 // // 与 TLS 是分层而不是并列的关系:wss = TLS 里的 WebSocket。本类不碰加密,tls 非空时 // 所有字节都经 ServerTlsSession 加解密(顺序:应用字节 → WS 帧 → TLS 记录)。 // // 线程模型:Handshake 在专用握手线程上阻塞执行(与 TlsHandshakeThreadProc 同一模式, // 握手期间独占 socket);握手完成后 Feed 只由 IOCP 工作线程调用(每连接同一时刻只有 // 一个未决 WSARecv,天然串行);Frame 由发送方在 CONTEXT_OBJECT::SendLock 内调用。 #pragma once #include #include #include class ServerTlsSession; class ServerWsSession { public: ServerWsSession() {} ~ServerWsSession() {} // 升级握手。initial 是触发判定的首批明文(以 "GET " 开头,可能只是请求头的一部分); // pending 返回升级完成后多读到的线缆字节(可能是客户端紧随其后的首帧),由调用方交 // 给 Feed;peer 是直接对端地址,用于判断是否信任 X-Forwarded-For。失败返回 false 并 // 置 err(调用方关闭连接,fail-closed)。 bool Handshake(SOCKET sock, ServerTlsSession* tls, const std::vector& initial, std::vector& pending, const std::string& peer, std::string* err); // 解帧:线缆字节 wire 还原成应用字节 app,产出需要写回的完整帧 replies(应答 ping、 // 回显 close)。返回 0 正常;-1 表示协议错误或对端已关闭,调用方应关闭连接 // (replies 仍须先发出)。 int Feed(const BYTE* wire, int len, std::vector& app, std::vector& replies); // 封装:把一段应用字节封成一帧二进制帧(服务端帧不加掩码)。 bool Frame(const BYTE* app, int len, std::vector& wire); // 供外部在握手/升级完成后标记连接已关闭。 void MarkClosed() { m_open = false; } bool IsOpen() const { return m_open; } // 代理转发的真实客户端地址(仅在直接对端是回环地址、且升级请求带了转发头时非空)。 const std::string& ForwardedIP() const { return m_forwardedIP; } private: bool ReadByte(BYTE& b, std::string* err); bool WriteWire(const BYTE* data, int len); void Compact(); SOCKET m_sock = INVALID_SOCKET; ServerTlsSession* m_tls = NULL; std::vector m_stash; // 已从 socket 读出、尚未消费的字节(TLS 时是明文) std::string m_forwardedIP; std::vector m_in; // 尚未解完的线缆字节 size_t m_pos = 0; // m_in 中已消费到的位置 long long m_remaining = 0; // 当前数据帧剩余载荷 bool m_masked = false; // 当前数据帧是否带掩码 BYTE m_mask[4] = { 0, 0, 0, 0 }; int m_maskPos = 0; bool m_open = false; // 升级完成后为 true,收到 close / 出错后为 false };