【Qt】Qt WebSocket介绍

最新推荐文章于 2025-07-09 12:32:55 发布

晴雨日记

最新推荐文章于 2025-07-09 12:32:55 发布

阅读量948

点赞数 18

CC 4.0 BY-SA版权

分类专栏： Qt进阶文章标签： qt c++

本文链接：https://blog.csdn.net/weixin_43510208/article/details/148032417

Qt进阶专栏收录该内容

51 篇文章

订阅专栏

文章目录

1. WebSocket 协议基础

核心特性：
- 全双工通信：客户端与服务器可同时发送和接收数据。
- 低延迟：基于 TCP 的长连接，避免了 HTTP 轮询的开销。
- 轻量级帧结构：数据以消息帧（Frame）形式传输，支持文本（UTF-8）和二进制格式。
- 握手协议：通过 HTTP Upgrade 头部完成协议切换（例如 Connection: Upgrade 和 Upgrade: websocket）。
适用场景：
- 实时聊天、在线协作工具
- 多人在线游戏、实时数据监控（如股票、IoT 传感器）
- 需要高频双向通信的应用

2. Qt WebSocket 模块架构

模块依赖：
- 需在项目文件（.pro）中添加 QT += websockets。
- 依赖 Qt 的网络模块（QtNetwork）和核心模块（QtCore）。
核心类：
- QWebSocket：
  - 客户端连接的核心类，提供连接、发送消息、关闭连接等功能。
  - 支持文本（sendTextMessage）和二进制（sendBinaryMessage）数据传输。
  - 通过信号（如 textMessageReceived、binaryMessageReceived）处理接收的数据。
- QWebSocketServer：
  - 服务器端类，用于监听端口、接受客户端连接。
  - 支持安全模式（SecureMode，需 SSL 证书）和非安全模式（NonSecureMode）。
- QWebSocketCorsAuthenticator：
  - 处理跨域请求（CORS），验证客户端来源是否合法。

3. 详细使用步骤

3.1 服务器端开发

创建服务器实例：

QWebSocketServer server("MyServer", QWebSocketServer::NonSecureMode);
server.listen(QHostAddress::Any, 1234); // 监听 1234 端口

处理客户端连接：

connect(&server, &QWebSocketServer::newConnection, [&server]() {
    QWebSocket *client = server.nextPendingConnection();
    // 处理消息接收、断开连接等事件
});

接收和响应消息：

connect(client, &QWebSocket::textMessageReceived, [client](const QString &msg) {
    qDebug() << "Received:" << msg;
    client->sendTextMessage("Echo: " + msg); // 回传消息
});

关闭连接与资源释放：

connect(client, &QWebSocket::disconnected, [client]() {
    client->deleteLater(); // 防止内存泄漏
});

3.2 客户端开发

建立连接：

QWebSocket socket;
socket.open(QUrl("ws://localhost:1234")); // 连接服务器

发送消息：

connect(&socket, &QWebSocket::connected, [&socket]() {
    socket.sendTextMessage("Hello Server!");
});

接收响应：

connect(&socket, &QWebSocket::textMessageReceived, [](const QString &msg) {
    qDebug() << "Server Response:" << msg;
});

错误处理：

connect(&socket, QOverload<QAbstractSocket::SocketError>::of(&QWebSocket::error),
        [](QAbstractSocket::SocketError error) {
            qDebug() << "Error:" << error;
        });

4. 高级功能与配置

4.1 二进制数据传输

发送二进制数据（如图片、文件）：

QByteArray data = ...; // 二进制数据
socket.sendBinaryMessage(data);

接收二进制数据：

connect(&socket, &QWebSocket::binaryMessageReceived, [](const QByteArray &data) {
    qDebug() << "Received binary data of size:" << data.size();
});

4.2 安全通信（SSL/TLS）

服务器端配置：

QWebSocketServer server("SecureServer", QWebSocketServer::SecureMode);
QSslConfiguration sslConfig = server.sslConfiguration();
sslConfig.setLocalCertificate("path/to/cert.pem"); // 加载证书
sslConfig.setPrivateKey("path/to/key.pem");
server.setSslConfiguration(sslConfig);

客户端连接：

QWebSocket socket;
socket.open(QUrl("wss://secure-server.com:443")); // 使用 wss://

4.3 跨域处理（CORS）

验证客户端来源：

connect(&server, &QWebSocketServer::originAuthenticationRequired,
        [](QWebSocketCorsAuthenticator *authenticator) {
            if (authenticator->origin() == "https://trusted-domain.com") {
                authenticator->setAllowed(true);
            }
        });

4.4 心跳机制（Ping/Pong）

保持连接活跃：

// 定时发送 Ping 帧
QTimer *timer = new QTimer(this);
connect(timer, &QTimer::timeout, [&socket]() {
    socket.ping(); // 发送 Ping
});
timer->start(30000); // 每 30 秒发送一次

// 接收 Pong 响应
connect(&socket, &QWebSocket::pong, [](quint64 elapsedTime, const QByteArray &payload) {
    qDebug() << "Pong received after" << elapsedTime << "ms";
});

5. 性能优化与最佳实践

多线程处理：
- 将 QWebSocketServer 或 QWebSocket 移至子线程，避免主线程阻塞。
```
QThread *thread = new QThread;
server.moveToThread(thread);
thread->start();
```
连接池管理：
- 使用 QMap<QString, QWebSocket*> 维护活跃客户端，按需释放资源。
流量控制：
- 通过 QWebSocket::bytesToWrite() 检查待发送数据量，避免缓冲区溢出。