QFtp源码学习及目录下载

背景

需要在QT5中进行FTP文件下载,并需要支持整目录下载,经过对比选择,最后决定使用Qt4中的QFtp来完成我们的需求。因此决定学习源码,看清结构,做到能真正解决所要面对的问题。

分解源码

Qftp一共只有四个文件,主要文件是qftp.cpp,这个文件中,有太多的类,首先按类分解到各自文件中,这样利用官方的示例代码,跑起来后,可以方便的查看代码。

类说明

  • class QFtpCommand : 此类是对FTP命令的封装,将命令与QIODevice设备关联起来,并返回一个唯一的标识ID。
  • class QFtpPI : 此类是对FTP协议的封装,processReply是主要函数,应答服务端响应。
  • class QFtpDTP : 此类是数据操作封装,数据读取、解析、存储都是在此类中处理。
  • class QFtpPrivate : 此类是QFtp的实际操作类,被组合到QFtp类中,是逻辑处理中心。
  • class QFtp : 此类是外壳,用户直接面对。
  • class QUrlInfo : 此为信息类,存储接收到的每一条文件数据信息。

运行流程

所有的客户端命令被压入到命令堆栈。一个命令运行有两个入口:一是命令被压入堆栈时,若堆栈中只有一条命令,即被运行;二是作响应服务端响应时,类型为idle或not waiting。
每个命运被构造时,都会返回唯一ID,这是很重要的一点,因为命令大多关联着一本地IO设备,在清理IO时,要注意与命令对应,因为所有的操作都是异步的。

改造list响应

QFtp列当前目录的原有逻辑是取一条数据就发送一条文件或目录的消息,这样在我们连续遍历目录时,无法分清楚是哪个目录下的数据,无法进行正确的递归。
QFtpDTP::socketReadyRead() - 修改读取目录列表时的信号发送方式

if (pi->currentCommand().startsWith(QLatin1String("LIST"))) {
        QVector infos;                        //增加vector来存储整个目录信息
        while (socket->canReadLine()) {
            QUrlInfo i;
            QByteArray line = socket->readLine();
            if (parseDir(line, QLatin1String(""), &i)) {
                infos.push_back(i);
                //emit listInfo(i);                     //原来在循环内,读一条数据发送一个listInfo信号
            }
            else {
                if (line.endsWith("No such file or directory\r\n"))
                    err = QString::fromLatin1(line);
            }
        }
        emit listInfos(infos);                          //改为在循环外发送新增的listInfos信号
    }

FtpWindow::addToList(const QVector& urlInfos) - listInfos响应修改

    for (int i = 0; i < urlInfos.size(); i++)
    {
        QTreeWidgetItem* item = new QTreeWidgetItem;
        QUrlInfo urlInfo = urlInfos[i];
        if (urlInfo.name().compare(".") != 0) {
            item->setText(0, urlInfo.name().toLatin1());
            item->setText(1, QString::number(urlInfo.size()));
            item->setText(2, QString::number(urlInfo.isDir()));
            item->setText(3, urlInfo.owner());
            item->setText(4, urlInfo.group());
            item->setText(5, urlInfo.lastModified().toString("MMM dd yyyy"));
            QPixmap pixmap(urlInfo.isDir() ? ":/images/dir.png" : ":/images/file.png");
            item->setIcon(0, pixmap);
            isDirectory[urlInfo.name()] = urlInfo.isDir();
            fileList->addTopLevelItem(item);
        }
    }

目录下载

将FtpWindow::downloadFile() slot分解成两个函数,增加downAllFile(QString rootDir)来完成目录递归。

void FtpWindow::downloadFile()
{
    files.clear();      //初始化本地设备
    downDirs.clear();   //清空需要下载的目录堆栈

    downAllFile(currentPath);   //下载具体操作,另一个入口在list的响应中
    showProgressDialog();       //进度条显示
}

下载的真实操作函数

void FtpWindow::downAllFile(QString rootDir) {
    QString thisRoot(rootDir + "/");        //要下载的父目录
    QList selectedItemList = fileList->selectedItems();
    for (int i = 0; i < selectedItemList.size(); i++)
    {
        QString fileName = selectedItemList[i]->text(0);
        if (isDirectory.value(fileName)) {      //若是子目录,组合完成的目录,压入待下载目录堆栈
            if(fileName != "..")
                downDirs.push(thisRoot + fileName);
        }
        else {
            downloadTotalBytes += selectedItemList[i]->text(1).toLongLong();    //统计需要下载的字节量
            ...
            QFile* file = new QFile(dirTmp.append("/").append(fileName));
            //文件下载请求,是异步操作
            int id = ftp->get(QString::fromLatin1((selectedItemList[i]->text(0)).toStdString().c_str()), file);
            files.insert(id, file);     //本地IO设备与其命令绑定并存储
        }
    }
    if (downDirs.size() > 0) {      //待下载目录堆栈不空,处理一条
        enterSubDir = true;         //表示正在下载目录
        QString nextDir(downDirs.pop());  //取需要处理的下一个目录
        ftp->cd(nextDir);                 //切换到这个目录
        currentDownPath = nextDir;
        ftp->list();                        //列目录,在其响应中将再递归调用本函数~~~~
    }
}

list响应的递归处理部分

    if (!enterSubDir) {     //下载的文件中没有目录
        ...     
    }
    else {                              //正处理于目录下载中
        fileList->selectAll();          //选中列表中所有
        downAllFile(currentDownPath);   //递归调用下载处理函数
    }

项目地址

https://github.com/zhoutk/qtDemo

命令行编译

git clone https://github.com/zhoutk/qtDemo
cd qtDemo/ftpClient & mkdir build & cd build
cmake ..
cmake --build .      

编译时注意:cmake默认为x86架构,需要与你安装的Qt版本对应;编译好了,运行前,请注意目录结构是否正确。

小结

我选择的这种目录下载方式比较麻烦,没有放到后台再开一个进程去处理,试图做整体考虑,且整个运行过程都是异步的,调试也比较难,其中进度条控件控制还有些坑,需要小心处理。过程艰难,收获颇多。

你可能感兴趣的:(c++ftpqt5)