68 lines
3.3 KiB
C++
68 lines
3.3 KiB
C++
// 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 <WinSock2.h>
|
||
|
||
#include <string>
|
||
#include <vector>
|
||
|
||
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<BYTE>& initial,
|
||
std::vector<BYTE>& 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<BYTE>& app, std::vector<BYTE>& replies);
|
||
|
||
// 封装:把一段应用字节封成一帧二进制帧(服务端帧不加掩码)。
|
||
bool Frame(const BYTE* app, int len, std::vector<BYTE>& 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<BYTE> m_stash; // 已从 socket 读出、尚未消费的字节(TLS 时是明文)
|
||
std::string m_forwardedIP;
|
||
|
||
std::vector<BYTE> 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
|
||
};
|