使用QT编写TCP服务器与客户端程序

自由的好好干活

已于 2022-06-02 19:48:15 修改

阅读量5.2k

点赞数 6

分类专栏： QT 文章标签： qt 服务器 tcp/ip

于 2022-06-02 16:31:48 首次发布

本文链接：https://blog.csdn.net/haohaoganhuo/article/details/125102668

版权

QT 专栏收录该内容

8 篇文章 6 订阅

订阅专栏

建立工程

在学习了霍亚飞的《Qt Creator快速入门（第3版）》后，参考“18.4 TCP”中的示例程序，编写了一个在同一个工程中实现服务器与客户端的习作程序，变量名命名方式和示例程序大体一致，程序实现了TCP客户端发送文件，服务器接收文件的功能，用到了QFile，QDataStream，QTcpServer，QTcpSocket等QT类。本文记录了编写过程，主要目的就是为了熟悉QT下TCP编程。
首先新建工程，选择“Qt Widget Application”，工程名称是“TcpFileServerClient”，下一步到“Class Information”的时候基类选择QWidget，Class Name改成Client，如下图所示：
在这里插入图片描述
点击下一步直到完成。
在项目栏中双击工程文件名:

在QT += core gui后面添加network,变成这样：
QT += core gui network
这个操作将会把QT网络编程需要的库文件添加进来。

设计客户端界面

双击client.ui文件，进入设计师界面，在界面上先放一个窗体布局控件（Form Layout），然后在里面右键添加“窗体布局行”，标签文字“主机：”，字段名称改成hostEdit，如下图所示：
在这里插入图片描述

然后用相同方法添加“端口：”，字段名称改成portEdit
然后添加进度条（Progress Bar），使用默认名称progressBar即可
添加一个标签控件（label），名称改成labelStatus，文本内容改成“请先打开文件”
添加两个按钮（Push Button)，一个按钮文本改成“打开文件”，名称改成openButton;一个按钮文本改成“发送文件”，名称改成sendButton
最终界面如下图所示：
在这里插入图片描述

编写客户端代码

修改client.h文件，在里面添加如下内容：

//这个头文件中定义了网络错误处理槽函数测参数类型。
#include <QAbstractSocket>

client.h里面只是使用到了类指针，可以前置声明这个类来减少编译时间。

//前置声明类
class QTcpSocket;
class QFile;

……

//定义私有变量
private:
    QTcpSocket* tcpClient;//客户端连接
    QFile* localFile;//文件操作
    qint64 totalBytes;//总传输字节数
    qint64 bytesToWrite;//还剩下要写的字节数
    qint64 bytesWritten;//已经写的字节数
    qint64 payloadSize;//每次传输字节数
    QString fileName;//包含了全路径的文件名
    QByteArray outBlock;//输出缓冲区
//定义私有槽函数，全都是和网络相关的
private slots:
	//建立连接成功后槽函数，开始传输
    void startTransfer();
    //发送完成槽函数，更新进度条，开始下一批传输
    void sendFile(qint64 numSend);
    //网络错误处理槽函数
    void displayError(QAbstractSocket::SocketError);

修改client.c文件
包含必要头文件：

#include <QtNetwork>
#include <QFileDialog>
#include <QDebug>

此时可以先编译一下，不用考虑是否会成功，主要目的是为了生成ui对象中包含的窗体对象变量，这样后续编程会比较方便。
在构造函数中实例化客户端对象，并且关联相关槽函数。

//实例化客户端对象
    tcpClient = new QTcpSocket(this);
    //关联建立连接成功槽函数
    connect(tcpClient, &QTcpSocket::connected, this, &Client::startTransfer);
//建立发送完成槽函数
    connect(tcpClient, &QTcpSocket::bytesWritten, this, &Client::sendFile);

    //关联错误处理槽函数,因为error是一个多态函数，所以只能使用SIGNAL关键字来关联
    connect(tcpClient, SIGNAL(error(QAbstractSocket::SocketError)),
            this, SLOT(displayError(QAbstractSocket::SocketError)));
    ui->sendButton->setEnabled(false);
	ui->hostEdit->setText(tr("localhost"));
    ui->portEdit->setText(tr("6666"));

双击client.ui进入设计师界面，然后在打开文件按钮上右键选择转到槽，选择默认的clicked(),点击OK按钮后会自动生成
void Client::on_openButton_clicked()
这个函数将在单击按钮时执行。此函数代码如下：

void Client::on_openButton_clicked()
{
    //通过对话框得到含有全路径的文件名
    fileName = QFileDialog::getOpenFileName(this);
    if (!fileName.isEmpty())
    {
        ui->sendButton->setEnabled(true);
        ui->labelStatus->setText(tr("等待传输文件%1").arg(fileName));
    }
}

然后使用设计师界面自动生成发送文件按钮的槽函数，具体如下：

void Client::on_sendButton_clicked()
{
    //打开文件
    localFile = new QFile(fileName);
    if (!localFile->open(QFile::ReadOnly))
    {
        qDebug() << localFile->errorString();
ui->labelStatus->setText(tr("打开文件失败！"));
        return;
    }
ui->labelStatus->setText(tr("连接中……"));
    tcpClient->connectToHost(ui->hostEdit->text(),
                             ui->portEdit->text().toInt());
}

接下来写建立连接成功槽函数，在函数中发送文件头，包含了总传输数据量和文件名称等信息：

void Client::startTransfer()
{
    //注意QDataStream是写操作的时候，需要传递缓冲区指针
    QDataStream out(&outBlock, QIODevice::WriteOnly);
    //发送和接收版本号要一致
    out.setVersion(QDataStream::Qt_5_9);
    //得到去掉路径的文件名
    QString currentFileName =
            fileName.right(fileName.size() -
                           fileName.lastIndexOf('/') - 1);
    //前面保留出总字节数和文件名字节数。
    out << qint64(0) << qint64(0) << currentFileName;
    totalBytes = localFile->size() + outBlock.size();
    //得到文件名占用字节数，注意QDataStream有其单独的数据结构
    //所以文件名占用的字节数不能使用currentFileName.size()获得。
    qint64 fileNameSize = outBlock.size() - sizeof(qint64) * 2;
    out.device()->seek(0);
    out << totalBytes << fileNameSize;
    //先将文件头写出去
    bytesToWrite = totalBytes - tcpClient->write(outBlock);
}

接下来在发送完成槽函数中将文件全部传输完毕，并且更新进度条：

void Client::sendFile(qint64 numSend)
{
    bytesWritten += numSend;
    if (bytesToWrite > 0)
    {
        outBlock = localFile->read(qMin(bytesToWrite, payloadSize));
        bytesToWrite -= tcpClient->write(outBlock);
    }
    //更新进度条
    ui->progressBar->setMaximum(totalBytes);
    ui->progressBar->setValue(bytesWritten);
    if (bytesWritten == totalBytes)
    {
        localFile->close();
        tcpClient->close();
        ui->labelStatus->setText("发送文件成功！");
    }
}

最后在网络错误槽函数中处理错误信息

void Client::displayError(QAbstractSocket::SocketError)
{
    qDebug() << tcpClient->errorString();
    tcpClient->close();
    localFile->close();
    ui->sendButton->setEnabled(true);
}

设计服务器端界面

在工程名上点击右键选择Add New，如下图所示：
在这里插入图片描述

选择Qt，Qt界面设计师类，如下图所示：
在这里插入图片描述

然后选择Widget，下一步，选择类名的时候改成Server，如下图所示：
在这里插入图片描述

下一步，完成。然后在窗体设计界面中添加一个进度条，一个标签，一个按钮，将标签文本修改成“正在监听localhost的6666端口”，将按钮文本修改成“开始监听”。如下图所示：
在这里插入图片描述

编写服务器端代码

首先在头文件server.h中添加包含的头文件和类声明：

#include <QAbstractSocket>
#include <QTcpServer>

class QTcpSocket;
class QFile;

然后在Server类中声明必要的成员函数与槽函数：

//进行网络通讯和传输文件所需变量
private:
    QTcpServer tcpServer;
    QTcpSocket* tcpConnection;//保存客户端连接
    QFile* localFile;
    qint64 fileNameSize;
    qint64 bytesReceived;
    qint64 totalBytes;
    QString fileName;

private slots:
    void newConnection();//客户端建立连接槽函数
    void readyRead();//端口数据可读槽函数
    void displayError(QAbstractSocket::SocketError);//网络错误处理函数
    void on_pushButton_clicked();

修改Server.c文件
首先包含必要头文件：

#include <QtNetwork>
#include <QFile>
#include <QDebug>

在构造函数中关联新建连接槽函数：

connect(&tcpServer, &QTcpServer::newConnection, 
         this, &Server::newConnection);

接下来实现新建连接槽函数，实现读数据槽函数，错误处理函数，以及单击按钮槽函数：

void Server::newConnection()
{
    //保存连接实例
    tcpConnection = tcpServer.nextPendingConnection();
    //关联读数据槽函数
    connect(tcpConnection, &QTcpSocket::readyRead, this, &Server::readyRead);
    //关联网络错误槽函数
    connect(tcpConnection, SIGNAL(error(QAbstractSocket::SocketError)),
            this, SLOT(displayError(QAbstractSocket::SocketError)));
    fileNameSize = 0;
    totalBytes = 0;
    bytesReceived = 0;
    //已经成功和客户端建立连接，可以关闭端口
    tcpServer.close();
}

void Server::readyRead()
{
    if (bytesReceived <= sizeof(qint64) * 2)
    {//先接收头部信息，获取总数居字节数和文件名
        QDataStream in(tcpConnection);
        in.setVersion(QDataStream::Qt_5_9);
        //先获取总数居个数和文件名大小
        if (!fileNameSize &&
                tcpConnection->bytesAvailable() >= sizeof(qint64)*2)
        {
            in >> totalBytes >> fileNameSize;
            bytesReceived += sizeof(qint64) * 2;
        }
        else
        {
            return;
        }
        //获取文件名
        if (fileNameSize &&
                tcpConnection->bytesAvailable() >= fileNameSize)
        {
            in >> fileName;
            localFile = new QFile(fileName);
            if (!localFile->open(QFile::WriteOnly))
            {
                qDebug() << localFile->errorString();
                tcpConnection->close();
                ui->label->setText(tr("写文件错误"));
                return;
            }
            bytesReceived += fileNameSize;
        }
        else
           return;
    }

    if (bytesReceived < totalBytes)
    {
        //从网络缓冲区读取数据
        bytesReceived += tcpConnection->bytesAvailable();
        QByteArray inBlock = tcpConnection->readAll();
        //写入文件
        localFile->write(inBlock);
    }
    //更新进度条
    ui->progressBar->setMaximum(totalBytes);
    ui->progressBar->setValue(bytesReceived);

    if (bytesReceived == totalBytes)
    {//传输完成
        localFile->close();
        tcpConnection->close();
        ui->label->setText(tr("接收文件%1成功！").arg(fileName));
        ui->pushButton->setEnabled(true);
    }
}

void Server::displayError(QAbstractSocket::SocketError)
{
    qDebug() << tcpConnection->errorString();
    ui->label->setText(tr("网络错误：%1").arg(tcpConnection->errorString()));
    tcpConnection->close();
}

void Server::on_pushButton_clicked()
{
    if (!tcpServer.listen(QHostAddress::LocalHost, 6666))
    {
        qDebug() << tcpServer.errorString();
        ui->label->setText(tr("监听失败！"));
    }
    ui->label->setText(tr("正在监听localhost的6666端口"));
    ui->progressBar->setValue(0);
    ui->pushButton->setEnabled(false);
}

将服务器和客户端对话框同时显示

修改“main.cpp”文件如下所示：

#include "client.h"
#include "server.h"

#include <QApplication>

int main(int argc, char *argv[])
{
    QApplication a(argc, argv);
    Client w;
    w.show();
    Server s;
    s.show();
    return a.exec();
}

至此，大功告成，可以到我的资源里面下载源程序。
QT编写的TCP服务端和客户端传输文件的源程序

自由的好好干活

关注

6
点赞
踩
41

收藏

觉得还不错? 一键收藏
0
评论
使用QT编写TCP服务器与客户端程序

在学习了霍亚飞的《Qt Creator快速入门（第3版）》后，参考“18.4 TCP”中的示例程序，编写了一个在同一个工程中实现服务器与客户端的习作程序，变量名命名方式和示例程序大体一致，程序实现了TCP客户端发送文件，服务器接收文件的功能，用到了QFile，QDataStream，QTcpServer，QTcpSocket等QT类。本文记录了编写过程，主要目的就是为了熟悉QT下TCP编程。首先新建工程，选择“Qt Widget Application”，工程名称是“TcpFileServerClient
复制链接

扫一扫