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版本对应；编译好了，运行前，请注意目录结构是否正确。

小结

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