第34篇 网络（四）FTP（二）
FTP（二）版权声明该文章原创于Qter开源社区（www.qter.org），作者yafeilinux，转载请注明出处！
导语前面讲述了一个最简单的FTP客户端程序的编写，这一节我们将这个程序进行扩展，使其可以浏览并能下载服务器上的所有文件。
环境：Windows Xp + Qt 4.8.5+QtCreator 2.8.0
目录
一、修改界面二、功能实现
正文
一、修改界面
我们删除了TextBrowser ，加入了几个Label ，Line Edit ，Push Button部件，一个Tree Widget及一个Progress Bar部件。然后我们对其中几个部件做如下更改。（1）将“FTP服务器”标签后的Line Edit的objectName属性改为“ftpServerLineEdit”，其text 属性改为“ftp.qt-project.org”。（2）将“用户名”标签后的Line Edit的objectName属性改为“userNameLineEdit”，其text属性改为“anonymous”，将其toolTip属性改为“默认用户名请使用：anonymous ，此时密码任意。”（3）将“密码”标签后的Line Edit的objectName属性改为“passWordLineEdit”，其text属性改为“123456”，将其echoMode属性改为“Password”。（4）将“连接”按钮的objectName属性改为“connectButton”。（5）将“返回上一级目录”按钮的objectName属性改为“cdToParentButton”。（6）将“下载”按钮的objectName属性改为“downloadButton”。（7）将Tree Widget的objectName属性改为“fileList”，然后在Tree Widget部件上单击鼠标右键，选择Edit Items菜单，添加列属性如下。
最终界面如图所示：
下面我们的程序中，就是实现在用户填写完相关信息后，按下“连接”按钮，就可以连接到FTP服务器，并在TreeWidget中显示服务器上的所有文件，我们可以按下“下载”按钮来下载选中的文件，并使用进度条显示下载进度。
二、功能实现
1.更改widget.h文件。
（1）添加头文件#include <QtGui>
（2）在private中添加变量：QHash<QString, bool> isDirectory; //用来存储一个路径是否为目录的信息QString currentPath; //用来存储现在的路径QFile *file;
（3）添加槽：private slots:void on_downloadButton_clicked();void on_cdToParentButton_clicked();void on_connectButton_clicked();void ftpCommandFinished(int,bool);void ftpCommandStarted(int);void updateDataTransferProgress(qint64,qint64 );//更新进度条//将服务器上的文件添加到Tree Widget中void addToList(const QUrlInfo &urlInfo); void processItem(QTreeWidgetItem*,int);//双击一个目录时显示其内容
2.更改widget.cpp的内容。
（1）实现“连接”按钮的单击事件槽。void Widget::on_connectButton_clicked() //连接按钮{ ui->fileList->clear(); currentPath.clear(); isDirectory.clear(); ftp = new QFtp(this); connect(ftp,SIGNAL(commandStarted(int)),this,SLOT(ftpCommandStarted(int))); connect(ftp,SIGNAL(commandFinished(int,bool)), this,SLOT(ftpCommandFinished(int,bool))); connect(ftp,SIGNAL(listInfo(QUrlInfo)),this,SLOT(addToList(QUrlInfo))); connect(ftp,SIGNAL(dataTransferProgress(qint64,qint64)), this,SLOT(updateDataTransferProgress(qint64,qint64))); QString ftpServer = ui->ftpServerLineEdit->text(); QString userName = ui->userNameLineEdit->text(); QString passWord = ui->passWordLineEdit->text(); ftp->connectToHost(ftpServer,21); //连接到服务器,默认端口号是21 ftp->login(userName,passWord); //登录} 我们在“连接”按钮的单击事件槽函数中新建了ftp对象，然后关联了相关的信号和槽。这里的listInfo()信号由ftp->list()函数发射，它将在登录命令完成时调用，下面我们提到。而dataTransferProgress()信号在数据传输时自动发射。最后我们从界面上获得服务器地址，用户名和密码等信息，并以它们为参数执行连接和登录命令。
（2）更改ftpCommandFinished()函数。我们在相应位置做更改。
首先，在登录命令完成时，我们调用list()函数：
ui->label->setText(tr("登录成功"));ftp->list(); //发射listInfo()信号，显示文件列表 然后，在下载命令完成时，我们使下载按钮可用，并关闭打开的文件。ui->label->setText(tr("已经完成下载"));ui->downloadButton->setEnabled(true);file->close(); delete file;
最后再添加一个if语句，处理list命令完成时的情况：if (ftp->currentCommand() == QFtp::List){ if (isDirectory.isEmpty()) { //如果目录为空,显示“empty” ui->fileList->addTopLevelItem( new QTreeWidgetItem(QStringList()<< tr("<empty>"))); ui->fileList->setEnabled(false); ui->label->setText(tr("该目录为空")); }}我们在list命令完成时，判断文件列表是否为空，如果为空，就让Tree Widget不可用，并显示“empty”条目。
（3）添加文件列表函数的内容如下。void Widget::addToList(const QUrlInfo &urlInfo)//添加文件列表{ QTreeWidgetItem *item = new QTreeWidgetItem; item->setText(0, urlInfo.name()); item->setText(1, QString::number(urlInfo.size())); item->setText(2, urlInfo.owner()); item->setText(3, urlInfo.group()); item->setText(4, urlInfo.lastModified().toString("MMM dd yyyy")); QPixmap pixmap(urlInfo.isDir() ? "../myFtp2/dir.png" : "../myFtp2/file.png"); item->setIcon(0, pixmap); isDirectory = urlInfo.isDir(); //存储该路径是否为目录的信息 ui->fileList->addTopLevelItem(item); if (!ui->fileList->currentItem()) { ui->fileList->setCurrentItem(ui->fileList->topLevelItem(0)); ui->fileList->setEnabled(true); }} 当ftp->list()函数执行时会发射listInfo()信号，此时就会执行addToList()函数，在这里我们将文件信息显示在Tree Widget上，并在isDirectory中存储该文件的路径及其是否为目录的信息。为了使文件与目录进行区分，我们使用了不同的图标file.png 和dir.png来表示它们，这两个图标放在了工程文件夹中。
（4）将构造函数的内容更改如下。{ ui->setupUi(this); ui->progressBar->setValue(0); //鼠标双击列表中的目录时，我们进入该目录 connect(ui->fileList,SIGNAL(itemActivated(QTreeWidgetItem*,int)), this,SLOT(processItem(QTreeWidgetItem*,int)));} 这里我们只是让进度条的值为0，然后关联了Tree Widget的一个信号itemActivated()。当鼠标双击一个条目时，发射该信号，我们在槽函数中判断该条目是否为目录，如果是则进入该目录。
（5）processItem()函数的实现如下。void Widget::processItem(QTreeWidgetItem* item,int)//打开一个目录{ QString name = item->text(0); if (isDirectory.value(name)) {//如果这个文件是个目录，则打开 ui->fileList->clear(); isDirectory.clear(); currentPath += '/'; currentPath += name; ftp->cd(name); ftp->list(); ui->cdToParentButton->setEnabled(true); }}
（6）“返回上一级目录”按钮的单击事件槽函数如下。void Widget::on_cdToParentButton_clicked()//返回上级目录按钮{ ui->fileList->clear(); isDirectory.clear(); currentPath = currentPath.left(currentPath.lastIndexOf('/')); if (currentPath.isEmpty()) { ui->cdToParentButton->setEnabled(false); ftp->cd("/"); } else { ftp->cd(currentPath); } ftp->list();} 在返回上一级目录时，我们取当前路径的最后一个“/”之前的部分，如果此时路径为空了，我们就让“返回上一级目录”按钮不可用。
（7）“下载”按钮单击事件槽函数如下。void Widget::on_downloadButton_clicked()//下载按钮{ QString fileName = ui->fileList->currentItem()->text(0); file = new QFile(fileName); if (!file->open(QIODevice::WriteOnly)) { delete file; return;}//下载按钮不可用，等下载完成后才可用 ui->downloadButton->setEnabled(false); ftp->get(ui->fileList->currentItem()->text(0), file);} 在这里我们获取了当前项目的文件名，然后新建文件，使用get()命令下载服务器上的文件到我们新建的文件中。
（8）更新进度条函数内容如下。void Widget::updateDataTransferProgress( //进度条 qint64 readBytes,qint64 totalBytes){ ui->progressBar->setMaximum(totalBytes); ui->progressBar->setValue(readBytes);}
3.流程说明。整个程序的流程就和我们实现函数的顺序一样。用户在界面上输入服务器的相关信息，然后我们利用这些信息进行连接并登录服务器，等登录服务器成功时，我们列出服务器上所有的文件。对于一个目录，我们可以进入其中，并返回上一级目录，我们可以下载文件，并显示下载的进度。 对于ftp的操作，全部由那些命令和信号来完成，我们只需要调用相应的命令，并在其发出信号时，进行对应的处理就可以了。而对于文件的显示，则是视图部分的知识了。
4.运行程序，效果如下图所示。
结语
最后需要说明的是，因为为了更好的讲解知识，使得程序简单化，所以我们省去了很多细节上的处理，如果需要，你可以自己添加。比如断开连接和取消下载，你都可以使用ftp->abort()函数。你也可以参考Qt自带的Ftp Example例子。对于其他操作，比如上传等，你可以根据需要添加。 FTP的相关编程就讲到到这里。
涉及到的源码下载：
上一篇： 第33篇 网络（三）FTP（一）
下一篇：
返回：系列教程目录
这个怎么用交互式设计写呢，还是有点不懂 只是路过 发表于 2013-9-30 00:48 static/image/common/back.gif
这个怎么用交互式设计写呢，还是有点不懂
具体哪里不懂？ yafeilinux 发表于 2013-9-30 11:22 static/image/common/back.gif
具体哪里不懂？
不好意思 假期出去玩 没看到就是这些connect（）；怎么用交互式设计的方法代替呢 只是路过 发表于 2013-10-6 14:46 static/image/common/back.gif
不好意思 假期出去玩 没看到就是这些connect（）；怎么用交互式设计的方法代替呢 ...
交互式设计的方法？
是指什么样的方式呢？ yafeilinux 发表于 2013-10-6 16:25 static/image/common/back.gif
交互式设计的方法？
是指什么样的方式呢？
就是用拖拽的方式设计界面的。。。 只是路过 发表于 2013-10-6 22:59 static/image/common/back.gif
就是用拖拽的方式设计界面的。。。
简单的信号和槽关联可以在设计器中完成，但是如果槽里面需要自定义代码，那么就必须使用代码来关联。 yafeilinux 发表于 2013-10-7 09:01 static/image/common/back.gif
简单的信号和槽关联可以在设计器中完成，但是如果槽里面需要自定义代码，那么就必须使用代码来关联。 ...
哦哦我懂了 谢谢亚飞老师话说老师你有没有写过学习linux内核方面的帖子 只是路过 发表于 2013-10-7 19:12 static/image/common/back.gif
哦哦我懂了 谢谢亚飞老师话说老师你有没有写过学习linux内核方面的帖子 ...
这个没有。 qt5中要添加
#include <QTreeWidgetItem> 在ftpCommandFinished(int,bool)函数的定义里面，最后一句
ui->label->setText(tr("该目录为空"));
编译器一直提醒常量中有换行符错误，百度了说是汉字编码问题（极少数的汉字会出现这个问题），将汉字改成英语就行了。希望对其他遇到同样问题的人有所帮助。
点击连接之后的错误，这该如何解决：QObject: Cannot create children for a parent that is in a different thread.
(Parent is Widget(0x23fe0c), parent's thread is QThread(0x38aa10), current thread is QThread(0x1390f398) Raincchina 发表于 2014-6-24 14:59 static/image/common/back.gif
点击连接之后的错误，这该如何解决：QObject: Cannot create children for a parent that is in a differen ...
下载源码试试。 Win7 64bit + Qt 5.5 + Qt Creator 3.4.2
哎，关于Ftp的两篇都没有调试成功，有没有人成功的，交流一下？ hebbely 发表于 2016-9-6 11:47 static/image/common/back.gif
Win7 64bit + Qt 5.5 + Qt Creator 3.4.2
哎，关于Ftp的两篇都没有调试成功，有没有人成功的，交流一下？ ...
Qt 5中已经没有QFtp模块了，需要使用外部库。 yafeilinux 发表于 2016-9-13 15:54 static/image/common/back.gif
Qt 5中已经没有QFtp模块了，需要使用外部库。
哎，使用前面评论**享的QFtp类也没成功，在上一篇的评论中有详细介绍了遇到的错误 hebbely 发表于 2016-9-14 08:12 static/image/common/back.gif
哎，使用前面评论**享的QFtp类也没成功，在上一篇的评论中有详细介绍了遇到的错误 ...
去网上下载一个QFtp，直接用源码添加到自己项目中 运行之后，链接不服务器QObject: Cannot create children for a parent that is in a different thread.
(Parent is Widget(0x7dfe0c), parent's thread is QThread(0x1947ad78), current thread is QThread(0x1af19d40) @yafeilinux 我用的原码在QT上编译的 出现了这个问题
jsjshhd 发表于 2017-5-22 16:02
@yafeilinux 我用的原码在QT上编译的 出现了这个问题
用的是Qt 5版本吗？这个源码是基于Qt 4的。