QTcpSocket使用指南与实践

QTcpSocket 深度解析与实践指南

一、QTcpSocket 概述

QTcpSocket是Qt Network模块提供的TCP协议网络通信类，继承自QAbstractSocket，用于实现TCP客户端功能。它与QTcpServer配合使用，支持流式数据传输，提供面向连接的可靠通信。

核心特性：

• 基于事件驱动的异步IO模型

• 支持IPv4/IPv6双协议栈

• 提供SSL/TLS加密支持（需QSslSocket）

• 跨平台统一接口（Windows/Linux/macOS）

二、基础使用流程

1. 创建Socket对象

QTcpSocket *socket = new QTcpSocket(parent);

2. 连接服务器

socket->connectToHost("127.0.0.1", 8888);

3. 信号处理

关键信号绑定：

// 连接成功
connect(socket, &QTcpSocket::connected, 
        [](){ qDebug() << "Connected!"; });

// 收到数据
connect(socket, &QTcpSocket::readyRead,
        [=](){ handleData(socket); });

// 断开连接
connect(socket, &QTcpSocket::disconnected,
        [](){ qDebug() << "Disconnected!"; });

// 错误处理
connect(socket, QOverload<QAbstractSocket::SocketError>::of(&QAbstractSocket::error),
        [](QAbstractSocket::SocketError error){
            qDebug() << "Error:" << error;
        });

4. 发送数据

QByteArray data = "Hello Server!";
socket->write(data);
// 确保立即发送
socket->flush(); 

5. 接收数据

推荐处理方式：

void handleData(QTcpSocket* socket) {
    while(socket->bytesAvailable() > 0) {
        QByteArray buffer = socket->readAll();
        processData(buffer);
    }
}

三、完整客户端示例

class TcpClient : public QObject {
    Q_OBJECT
public:
    explicit TcpClient(QObject *parent = nullptr)
        : QObject(parent) {
        socket = new QTcpSocket(this);
        
        connect(socket, &QTcpSocket::connected, [this](){
            qInfo() << "Connected to server";
            socket->write("Client Ready\n");
        });

        connect(socket, &QTcpSocket::readyRead, [this](){
            QByteArray data = socket->readAll();
            qInfo() << "Received:" << data;
        });

        connect(socket, &QTcpSocket::disconnected, [this](){
            qWarning() << "Connection closed";
        });
    }

    void connectToServer(const QString &host, quint16 port) {
        qInfo() << "Connecting to" << host << ":" << port;
        socket->connectToHost(host, port);
    }

private:
    QTcpSocket *socket;
};