Qt5 基于TCP传输的发送/接收文件服务器（支持多客户端）

一、实现功能
1、服务器端选择待发送的文件，可以是多个
2、开启服务器，支持多客户端接入，能够实时显示每个客户端接入状态
3、等待所有客户端都处于已连接状态时，依次发送文件集给每个客户端，显示每个客户端发送进度
4、发送完成后等待接收客户端发回的文件，显示接收进度
5、关闭服务器


二、实现要点
先讲一下实现上述功能的几个关键点，明白的这几个要点，功能的大框架就搭好了，细节在下一节再讲

1、新建服务器类testServer，继承自QTcpServer
功能：用于接收客户端TCP请求，存储所有客户端信息，向主窗口发送信息
在这个类中实例化QTcpServer的虚函数：
void incomingConnection(int socketDescriptor); //虚函数，有tcp请求时会触发
 
参数为描述socket ID的int变量
此函数在QTcpServer检测到外来TCP请求时，会自动调用。

注：若要接收局域网内的TCP请求，连接newConnection信号到自定义槽函数
connect(tcpServer,SIGNAL(newConnection()),this,SLOT(acceptConnection()));
但是这种方法无法处理多客户端


2、新建客户端类testClient，继承自QTcpSocket
功能：存储每个接入的客户端信息，控制发送/接收文件，向testServer发送信息

在testServer的incomingConnection函数中，通过设置socketDescriptor，初始化一个testClient实例

testClient *socket = new testClient(this);

if (!socket->setSocketDescriptor(socketDescriptor))
{
    emit error(socket->error());
    return;
}

3、发送数据
实例化testClient类，通过void writeData(const char * data, qint64 size)函数将数据写入TCP流

testClient *a;
a->writeData("message",8);

一般来说，使用QByteArray和QDataStream进行格式化的数据写入，设置流化数据格式类型为QDataStream::Qt_5_0，与客户端一致

testClient *a;
QByteArray outBlock;       //缓存一次发送的数据
QDataStream sendOut(&outBlock, QIODevice::WriteOnly);	//数据流
sendOut.setVersion(QDataStream::Qt_5_0);
sendOut << "message";

a->writeData(outBlock,outBlock.size());

outBlock.resize(0);

注意outBlock如果为全局变量，最后需要resize，否则下一次写入时会出错


在testClient构造函数中连接数据成功发送后产生的bytesWritten()信号

connect(this, SIGNAL(bytesWritten(qint64)), this, SLOT(updateClientProgress(qint64)));

参数为成功写入TCP流的字节数
通过捕获这个信号，可以实现数据的连续发送。因为发送文件时，数据是一块一块发送的，比如设定一块的大小为20字节，那么发送完20字节，怎么继续发送呢？就靠的是这个函数，再用全局变量记录下总共发送的字节数，便可以控制发送的结束。


4、发送文件
先把文件读到QFile变量中，再通过QBytesArray发送

testClient *a;
QFile sendFile = new QFile(sendFilePath);	//读取发送文件路径
if (!sendFile->open(QFile::ReadOnly ))  //读取发送文件
{    return;}
QByteArray outBlock;
outBlock = sendFile->read(sendFile.size());
a->writeData(outBlock,outBlock.size());

5、接收数据
依旧是testClient类，连接有readyRead()信号，readyRead()信号为新连接中有可读数据时发出

connect(this, SIGNAL(readyRead()), this, SLOT(recvData()));

首先将testClient连接实例（如testClient *a）封装到QDataStream变量中，设置流化数据格式类型为QDataStream::Qt_5_0，与客户端一致。
在读入数据前，用a->bytesAvailable()检测数据流中可读入的字节数，然后就可以通过"<<"操作符读入数据了。

QDataStream in(a); //本地数据流
in.setVersion(QDataStream::Qt_5_0); //设置流版本，以防数据格式错误
quint8 receiveClass;
if(this->bytesAvailable() >= (sizeof(quint8)))
{    
    in >> receiveClass;
}

6、接收文件
使用readAll读入TCP流中所有数据，再写入到QFile变量中

QByteArray inBlock;
inBlock = a->readAll();	//读入所有数据
QFile receivedFile = new QFile(receiveFilePath);	//打开接收文件
if (!receivedFile->open(QFile::WriteOnly ))
{    return;}
QFile receivedFile->write(inBlock);	//写入文件
inBlock.resize(0);

三、具体实现
1、全局定义
需要定义一些全局变量和常量，定义如下

//存储文件路径和文件名的结构体
struct openFileStruct
{
    QString filePath;
    QString fileName;
};

struct clientInfo   //客户端信息
{
    QString ip;     //ip
    int state;      //状态
    QString id;     //id
};

const quint8 sendtype_file = 0;    //发送类型是文件
const quint8 sendtype_start_test = 10;    //发送类型是开始测试
const quint8 sendtype_msg = 20;    //发送类型是消息

const quint16 filetype_list = 0;    //文件类型为列表
const quint16 filetype_wavfile = 1;    //文件类型为wav文件

const QString clientStatus[7] =    //客户端状态
    {QObject::tr("Unconnected"),QObject::tr("HostLookup"),QObject::tr("Connecting"),
        QObject::tr("Connected"),QObject::tr("Bound"),QObject::tr("Listening"),QObject::tr("Closing")};

openFileStruct 用于主窗口，存储发送文件的路径和文件名
clientInfo 用于主窗口，存储每个客户端的信息
规定传输协议为先发送一个quint8的标志位，规定传输类型，即为sendtype定义的部分
sendtype为0时，发送文件。filetype为文件类型
发送文件协议为：发送类型 | 数据总大小 | 文件类型 | 文件名大小 | 文件名 | 文件内容
发送文件时，先发送一个文件列表，每行一个文件名，再逐个发送文件
clientStatus为客户端状态，与Qt内部的socket status定义相同

2、testClient类
一个testClient类实例为一个socket客户端描述
（1）类声明：

class testClient : public QTcpSocket
{
    Q_OBJECT
public:
    testClient(QObject *parent = 0);
    int num;    //客户端序号

    void prepareTransfer(std::vector<openFileStruct>& openFileList,int testtype_t);    //准备传输文件

signals:
    void newClient(QString, int, int);  //客户端信息变更信号
    void outputlog(QString);    //输出日志信息
    void updateProgressSignal(qint64,qint64,int);   //更新发送进度信号
    void newClientInfo(QString,int,int);  //更新客户端信息

private slots:
    void recvData();    //接收数据
    void clientConnected();     //已连接
    void clientDisconnected();  //断开连接
    void newState(QAbstractSocket::SocketState);    //新状态
    void startTransfer(const quint16);    //开始传输文件
    void updateClientProgress(qint64 numBytes);  //发送文件内容
    void getSendFileList(QString path);     //在指定路径生成发送文件列表
    quint64 getSendTotalSize();    //获取sendFilePath对应文件加上头的大小

private:
    //发送文件所需变量
    qint64  loadSize;          //每次接收的数据块大小

    qint64  TotalSendBytes;        //总共需发送的字节数
    qint64  bytesWritten;      //已发送字节数
    qint64  bytesToWrite;      //待发送字节数
    QString sendFileName;          //待发送的文件的文件名
    QString sendFilePath;          //待发送的文件的文件路径
    QFile *sendFile;          //待发送的文件
    QByteArray outBlock;       //缓存一次发送的数据
    int sendNum;        //记录当前发送到第几个文件
    int sendFileNum;    //记录发送文件个数
    int totalSendSize;  //记录发送文件总大小
    quint64 proBarMax;  //发送进度条最大值
    quint64 proBarValue;    //进度条当前值

    std::ve