论坛 › linux › Qt实现简易的多线程TCP服务器（附源码）

风雨同行 发表于 2024-6-8 09:32:52

Qt实现简易的多线程TCP服务器（附源码）

目录
一.UI界面的设计
二.服务器的启动
三.实现自界说的TcpServer类
1.在widget中声明自界说TcpServer类的成员变量
2.在TcpServer的构造函数中对于我们声明的m_widget进行初始化，m_widget我们用于后续的显示消息等，说白了就是主界面的更新显示等
四.实现自界说的TcpSocket类
1.TcpSocket.h   先忽略掉信号与槽函数，关注构造函数与qintptr类型的 m_sockDesc
五.实现自界说线程类
1.主要关注run函数，其中run函数是继承QThread中的虚函数，必要我们进行重写
2.实现某个客户端断开连接时通过信号与槽让主界面改变
3.实现有新的客户端连接时主界面更新
六.服务器收到多客户端消息进行显示的流程实现
七.服务器发送消息给某个客户端流程
八.服务器发送信息后，要在主页面信息消息更新显示的流程
注意：
效果演示：
源码下载地址：

在初学Qt 中Tcp服务器与客户端的时候，发现每次服务器只能和最后一个连接的客户端进行通信，由于没有用到多线程以及TcpServer中虚函数incomingConnection（），当新的客户端连接的时候，会主动调用incomingConnection函数，在里面产生新的线程来处理通信。
以下来讲讲这个简易的多线程Tcp服务器的实现
一.UI界面的设计

https://img-blog.csdnimg.cn/direct/3bb62b464cf643329f3266cd601545ec.png
其中包括2个Label，一个LineEdit，两个pushbutton，上面是一个TextBrowser用于服务器显示通信记录，下面一个TextEdit用于发送信息。如许一个简朴的界面就搭建完成了~~~

二.服务器的启动

首先我们肯定必要实现点击启动服务器按钮来启动服务器

1.在界面中右击启动按钮 ----> 转到槽
https://img-blog.csdnimg.cn/direct/d1ae651af50c4f7a9bf2224f4611c92a.png
2.实现逻辑，这里直接放代码，其中serverisworking 是我在widget.h 中声明的一个bool类型，用于判断服务器是否启动，同时更改按钮的文本显示内容，以及弹出对话框提示。
//点击开始启动服务器
void Widget::on_pushButton_StartServer_clicked()
{
    //如果服务器没有启动
   if (!this->serverisworking) {
      if(this->m_tcpserver->listen(QHostAddress::Any,ui->lineEdit_Port->text().toUShort())){
            QMessageBox::information(this,"成功！","启动成功！");
            ui->pushButton_StartServer->setText("关闭服务器");
            this->serverisworking = true;
      }
      else {
            QMessageBox::critical(this,"失败!","服务器启动失败请检查设置!");
      }
    }
    //如果服务器正在启动
   else if(this->serverisworking) {
         m_tcpserver->close();
         if(!m_tcpserver->isListening()){
             ui->pushButton_StartServer->setText("启动服务器");
             this->serverisworking = false;
             QMessageBox::information(this,"提示","关闭成功!");
         }
         else {
             QMessageBox::critical(this,"错误","关闭失败,请重试！");
             return;
         }

   }
} 三.实现自界说的TcpServer类

1.首先我们搞清晰，这个类是负责干嘛的？这个类我们要继承QTcpServer，重写虚函数incomingConnetion
2.这是头文件，如果有报错，注意看利用#pragma once没有，由于大概涉及到头文件重复包罗
//tcpserver.h
#pragma once
#ifndef TCPSERVER_H
#define TCPSERVER_H

#include <QObject>
#include<QTcpServer>

#include <widget.h>
#include"serverthread.h"

class TcpServer : public QTcpServer
{
    Q_OBJECT
public:
    explicit TcpServer(QObject *parent = nullptr);

private:

    //重写虚函数
    void incomingConnection(qintptr sockDesc);

private:
   
    //用来保存连接进来的套接字，存到ComboBox中
    QList<qintptr> m_socketList;
   
    //再包含一个widget对象
    Widget *m_widget;

};

#endif // TCPSERVER_H 1.在widget中声明自界说TcpServer类的成员变量

//widget.h
#pragma once
#ifndef WIDGET_H
#define WIDGET_H

#include <QWidget>
#include<QMessageBox>
#include"tcpserver.h"

namespace Ui {
class Widget;
}

class TcpServer;

class Widget : public QWidget
{
    Q_OBJECT

public:
    explicit Widget(QWidget *parent = nullptr);
    ~Widget();

public:
    //当有新连接的时候在页面上显示
    void showNewConnection(qintptr sockDesc);

    //断开时显示
    void showDisconnection(qintptr sockDesc);

    //当服务器发送消息后，通知窗口更新消息
    void UpdateServerMsg(qintptr Desc,const QByteArray &msg);


private slots:

    //按钮被触发
    void on_pushButton_StartServer_clicked();

    void on_pushButton_Trans_clicked();


public slots:

    //当服务器收到客户端发送的消息后，更新消息
    void RecvMsg(QString Desc,const QByteArray &msg);


signals :
   voidsendData(qintptr Desc ,const QByteArray &msg);

private:
    Ui::Widget *ui;

    TcpServer *m_tcpserver;

    bool serverisworking;
};

#endif // WIDGET_H 其他的我们先不去讨论，这里我们就声明一个TcpServer类型的m_tcpserver 以及一个bool类型的serverisworking用来判断服务器是否在工作
2.在TcpServer的构造函数中对于我们声明的m_widget进行初始化，m_widget我们用于后续的显示消息等，说白了就是主界面的更新显示等

TcpServer::TcpServer(QObject *parent) : QTcpServer(parent)
{
   m_widget = dynamic_cast<Widget *>(parent);

}
那么，问题来了，我们要重写TcpServer的incomingConnection函数，里面要涉及到线程，那么我们必要去写一个自界说的线程类
//当有新的连接进来的时候会自动调用这个函数，不需要你去绑定信号槽
void TcpServer::incomingConnection(qintptr sockDesc)
{
    //将标识符保存进list
    m_socketList.append(sockDesc);

    //产生线程用于通信
    ServerThread *thread = new ServerThread(sockDesc);

    //窗口中显示有新的连接
    m_widget->showNewConnection(sockDesc);

    //线程中发出断开tcp连接，触发widget中显示断开
    connect(thread, &ServerThread::disconnectTCP, this,[=]{
         m_widget->showDisconnection(sockDesc);
    });



    //当socket 底层有readyread信号的时候-> 发送socket_getmsg信号-> 发送socket_getmsg_thread
    //将socket_getmsg_thread 与 widget中 RecvMsg 绑定，RecvMsg 用于处理将收到的消息进行显示
    connect(thread,&ServerThread::socket_getmsg_thread,this->m_widget,&Widget::RecvMsg);

    //当点击发送的时候-> 产生一个SendData 信号-> 调用线程中SendDataSlot函数用于发送sendData信号来使socket来发送消息
    connect(this->m_widget,&Widget::sendData,thread,&ServerThread::sendDataSlot);

    //当服务器给客户端发送下消息后，会产生一个writeover信号-> 触发线程发送writeover信号给 Tcpserver -> Tcpserver中widget更新消息
    connect(thread,&ServerThread::writeover,[=](qintptr Desc,const QByteArray &msg){
         m_widget->UpdateServerMsg(Desc,msg);
    });


    thread->start();
}
我们要实现线程类，线程的工作是必要每个线程里面都有一个不同的Tcpsocket类实例，但是我们要在不同的线程里面 工作不同的socket，那么我们可以在一个线程中 去利用套接字标识符（socketDesc）去区分不同的套接字，然后服务器也可以通过不同的套接字标识符去进行与不同的套接字进行通信，以是我们必要先去实现一个自界说的TcpSocket类
四.实现自界说的TcpSocket类

1.TcpSocket.h   先忽略掉信号与槽函数，关注构造函数与qintptr类型的 m_sockDesc

为什么是qintptr类型呢，我们查看官方文档，利用qintpt类型作为参数更方便，https://img-blog.csdnimg.cn/direct/758d8ee3ad434c25b11bea3a73866c3f.png
#pragma once
#ifndef SERVERSOCKET_H
#define SERVERSOCKET_H

#include <QObject>
#include<QTcpSocket>



class ServerSocket : public QTcpSocket
{
    Q_OBJECT
public:
    explicit ServerSocket(qintptr socketDesc,QObject *parent = nullptr);

signals:
    void socket_getmsg(QString Desc, const QByteArray &msg);

   void writeover(qintptr Desc,const QByteArray &msg);

public slots:
    void sendData(qintptr Desc, const QByteArray &data);

private:
      qintptr m_sockDesc;
};

#endif // SERVERSOCKET_H 五.实现自界说线程类

1.主要关注run函数，其中run函数是继承QThread中的虚函数，必要我们进行重写

//serverthread.h
#pragma once
#ifndef SERVERTHREAD_H
#define SERVERTHREAD_H

#include <QObject>

#include <QThread>
#include<serversocket.h>

class ServerThread : public QThread
{
    Q_OBJECT
public:

    //构造函数初始化套接字标识符
    explicit ServerThread(qintptr sockDesc,QObject *parent = nullptr);

    void run() override;

    ~ServerThread();

signals:
    void disconnectTCP(qintptr m_sockDesc);

    void sendData(qintptr Desc, const QByteArray& msg);

    void socket_getmsg_thread(QString Desc,const QByteArray &msg);

    voidwriteover(qintptr Desc,const QByteArray &msg);

publicslots:
    void sendDataSlot(qintptr Desc, const QByteArray& msg);



private:
    qintptr m_socketDesc;

    ServerSocket *m_socket;

};



#endif // SERVERTHREAD_H 2.实现某个客户端断开连接时通过信号与槽让主界面改变

1）我们在run函数中，实在就是对某个对应的用来通信套接字运行一个线程，以是我们在run中，先对m_socket进行初始化，将自身的m_socketDesc 作为参数传给m_socket的有参构造。而且利用TcpSocket的setSocketDescriptor方法对m_socket进行绑定标识符，如许我们每个线程内工作的套接字都是不同的
m_socket = new ServerSocket(this->m_socketDesc);

    //绑定套接字标识符绑定给自定义套接字对象
    if (!m_socket->setSocketDescriptor(this->m_socketDesc)) {
      return ;
    } 2）在线程中，当该线程中的套接字断开时，底层会发射出disconnected信号，我们线程可以此信号与一个用来发射信号的槽函数绑定起来，实现当套接字发送disconnect信号的时候，线程发射出一个disconnectTcp如许一个自界说信号关照服务器套接字断开，server在调用widget成员的方法实现在主界面中显示断开连接
https://img-blog.csdnimg.cn/direct/8b438290ca4242668afa02cb7377441a.png
//run()中：
    //当套接字断开时，发送底层的disconnected信号
    connect(m_socket, &ServerSocket::disconnected, this, [=]{

      //此信号可以出发server的槽函数然后再调用widget中combobox清除该socketDesc
      emit disconnectTCP(this->m_socketDesc);

      //让该线程中的套接字断开连接
      m_socket->disconnectFromHost();//断开连接

      //线程退出
      this->quit();
   

//incommingConnection中
//线程中发出断开tcp连接，触发widget中显示断开
    connect(thread, &ServerThread::disconnectTCP, this,[=]{
         m_widget->showDisconnection(sockDesc);
    }); //widget.cpp中
//用以显示连接断开
void Widget::showDisconnection(qintptr sockDesc)
{
    ui->textBrowser_ServerMess->append(QString::number(sockDesc)+"断开了连接");
   
    //通过信号传递的标识符，将其删除
    int index = ui->comboBox_CilentID->findData(sockDesc);

    ui->comboBox_CilentID->removeItem(index);
}
3.实现有新的客户端连接时主界面更新

当有新的客户端连接的时候，会主动调用server中的incommingConnect函数，直接在此函数中调用widget->showNewconnection函数
//incomingConnection函数中:
    //窗口中显示有新的连接
    m_widget->showNewConnection(sockDesc); //widget.cpp
void Widget::showNewConnection(qintptr sockDesc)
{
    ui->textBrowser_ServerMess->append("有新的连接！，新接入"+QString::number(sockDesc));
    ui->comboBox_CilentID->addItem(QString("%1").arg(sockDesc), sockDesc);
}
 通过这两个连接就可以直接实现有新的客户端连接时主界面更新。

六.服务器收到多客户端消息进行显示的流程实现

https://img-blog.csdnimg.cn/direct/d77af6a08ef84cf0b4244e42004fe4b7.png
//serversocket.cpp
ServerSocket::ServerSocket(qintptr socketDesc,QObject *parent) : QTcpSocket(parent)
{
    this->m_sockDesc = socketDesc;


    connect(this,&ServerSocket::readyRead,this,[=]{

      QString name = QString::number(m_sockDesc);

      QByteArray msg = readAll();

      emit socket_getmsg(name,msg);

    });
} //serverthread::run()中
    //套接字发出有消息的信号，然后触发线程中发出有消息的信号
    connect(m_socket, &ServerSocket::socket_getmsg, this,[=](QString Desc,const QByteArray &msg){


                emit socket_getmsg_thread(Desc,msg);

    }); //server.cpp
   //当socket 底层有readyread信号的时候-> 发送socket_getmsg信号-> 发送socket_getmsg_thread
    //将socket_getmsg_thread 与 widget中 RecvMsg 绑定，RecvMsg 用于处理将收到的消息进行显示
    connect(thread,&ServerThread::socket_getmsg_thread,this->m_widget,&Widget::RecvMsg); //widget.cpp
//当客户端发送消息，服务器收到后，显示消息
void Widget::RecvMsg(QString Desc,const QByteArray &msg)
{
    ui->textBrowser_ServerMess->append(Desc+":"+msg);
}
实现收到客户端消息进行显示

七.服务器发送消息给某个客户端流程

https://img-blog.csdnimg.cn/direct/99a24fd091e64e709843b0b198fe3377.png
void Widget::on_pushButton_Trans_clicked()
{
    if(serverisworking){

      //如果连接个数大于0，发送发送消息的信号
      if(ui->comboBox_CilentID->count() >0)
      {
            //发射 发送信号
            emit sendData( ui->comboBox_CilentID->currentText().toInt(), ui->textEdit_SendMess->toPlainText().toUtf8());
            qDebug()<<"发送了sendData信号"<<endl;
            ui->textEdit_SendMess->clear();
      }

    }
    else {
      QMessageBox::critical(this,"错误","请检查连接");
      return;
    }

} //Tcpserver.cppincomingConnection中
    //当点击发送的时候-> 产生一个SendData 信号-> 调用线程中SendDataSlot函数用于发送sendData信号来使socket来发送消息
    connect(this->m_widget,&Widget::sendData,thread,&ServerThread::sendDataSlot); void ServerThread::sendDataSlot(qintptr Desc, const QByteArray &msg)
{

   emit sendData(Desc, msg);
}
//run（）中
   connect(this,&ServerThread::sendData,m_socket,&ServerSocket::sendData); void ServerSocket::sendData(qintptr Desc, const QByteArray &msg)
{
    if (Desc == m_sockDesc && !msg.isEmpty()) {
      this->write(msg);

      //发送完毕，发出信号，通知主页面更新聊天框
      emit writeover(Desc,msg);
    }
}

八.服务器发送信息后，要在主页面信息消息更新显示的流程

https://img-blog.csdnimg.cn/direct/20e8274f7ecd48c98c851391f1f2baf8.png
void ServerSocket::sendData(qintptr Desc, const QByteArray &msg)
{
    if (Desc == m_sockDesc && !msg.isEmpty()) {
      this->write(msg);

      //发送完毕，发出信号，通知主页面更新聊天框
      emit writeover(Desc,msg);
    }
} //serverthread.cpp
    //socket 发送 writeorver 通知线程发送writeover 用来提醒server中的widget更新消息
    connect(m_socket,&ServerSocket::writeover,this,[=](qintptr Desc, const QByteArray& msg){
            emit writeover(Desc,msg);
    }); //server.cpp
    //当服务器给客户端发送下消息后，会产生一个writeover信号-> 触发线程发送writeover信号给 Tcpserver -> Tcpserver中widget更新消息
    connect(thread,&ServerThread::writeover,[=](qintptr Desc,const QByteArray &msg){
         m_widget->UpdateServerMsg(Desc,msg);
    }); //widget.cpp
//当服务器发送消息后，通知主窗口更新信号
void Widget::UpdateServerMsg(qintptr Desc, const QByteArray &msg)
{
    ui->textBrowser_ServerMess->append("服务器："+msg+" to "+QString::number(Desc));
}
注意：

注册自界说信号参数，否则信号槽机制利用时会出现生存
#include "widget.h"
#include <QApplication>

int main(int argc, char *argv[])
{
    qRegisterMetaType<qintptr>("qintptr");
    QApplication a(argc, argv);
    Widget w;
    w.show();

    return a.exec();
}
效果演示：

https://img-blog.csdnimg.cn/direct/dde07b5c8b0f426095b06e00a501105f.png
源码下载地址：

yuanzhaoyi/My_project at master (github.com)https://csdnimg.cn/release/blog_editor_html/release2.3.6/ckeditor/plugins/CsdnLink/icons/icon-default.png?t=N7T8https://github.com/yuanzhaoyi/My_project/tree/master

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。

查看完整版本: Qt实现简易的多线程TCP服务器（附源码）