Qt三种方式实现FTP上传功能

FTP协议

FTP的中文名称是“文件传输协议”，是File Transfer Protocol三个英文单词的缩写。FTP协议是TCP/IP协议组中的协议之一，其传输效率非常高，在网络上传输大的文件时，经常采用该协议。

FTP协议又分主动模式和被动模式， 本文不做过多介绍。

三种方式

废话不多说，直接先上结果。

三种方式实现Qt项目中的Ftp传输功能：

1、Qt4 QFtp

2、Qt5 QNetworkAccessManager

3、POCO中的 FTPClientSession

接下来我们一一分析这几种方式的优缺点。

QFtp

先来说说QFtp，QFtp是Qt4中的专门负责Ftp传输的类，Ftp相关的常用接口都已经包含了，比如说：创建目录、删除目录、删除文件、获取文件列表、上传、下载等等常规操作。

int setProxy(const QString &host, quint16 port);
    int connectToHost(const QString &host, quint16 port=21);
    int login(const QString &user = QString(), const QString &password = QString());
    int close();
    int setTransferMode(TransferMode mode);
    int list(const QString &dir = QString());
    int cd(const QString &dir);
    int get(const QString &file, QIODevice *dev=0, TransferType type = Binary);
    int put(const QByteArray &data, const QString &file, TransferType type = Binary);
    int put(QIODevice *dev, const QString &file, TransferType type = Binary);
    int remove(const QString &file);
    int mkdir(const QString &dir);
    int rmdir(const QString &dir);
    int rename(const QString &oldname, const QString &newname);

光看名字就知道其功能了，可以说是很全面的了。但不幸的是这么好用的东西竟然被Qt5给抛弃了，取而代之的是用 QNetworkAccessManager 来实现。

QNetworkAccessManager

QNetworkAccessManager 是Qt里面专门负责网络请求的模块，包含了http的post、get，还有一个put，而Qt5中要实现Ftp上传功能就通过put来完成，下载通过get来完成。

*put(const QNetworkRequest &request, QIODevice *data)
 QNetworkReply *put(const QNetworkRequest &request, const QByteArray &data)
 QNetworkReply *put(const QNetworkRequest &request, QHttpMultiPart *multiPart)

 QNetworkReply *get(const QNetworkRequest &request)

遗憾的是，没有办法通过QNetworkAccessManager 实现Ftp创建目录、删除目录、删除文件、获取文件列表等功能。只能做上传下载操作。

FTPClientSession

最后来看FTPClientSession，这是 POCO中网络模块里面负责实现FTP的类，POCO是目前最流行的C++轻量级封装库之一，里面包含了很多常用的封装库。

而FTPClientSession提供了FTP的很多常用接口，如下：

void setTimeout(const Poco::Timespan& timeout);
  Poco::Timespan getTimeout() const;
  void setPassive(bool flag, bool useRFC1738 = true);
  bool getPassive() const;
  virtual void open(const std::string& host, Poco::UInt16 port, const std::string& username = "", const std::string& password = "");
  virtual void login(const std::string& username, const std::string& password);
  void logout();
  void close();
  std::string systemType();
  void setFileType(FileType type);
  FileType getFileType() const;
  void setWorkingDirectory(const std::string& path);
  std::string getWorkingDirectory();
  void cdup();
  void rename(const std::string& oldName, const std::string& newName);
  void remove(const std::string& path);
  void createDirectory(const std::string& path);
  void removeDirectory(const std::string& path);
  std::istream& beginDownload(const std::string& path);
  void endDownload();
  std::ostream& beginUpload(const std::string& path);
  void endUpload();
  std::istream& beginList(const std::string& path = "", bool extended = false);
  void endList();
  void abort();
  int sendCommand(const std::string& command, std::string& response);
  int sendCommand(const std::string& command, const std::string& arg, std::string& response);
  bool isOpen() const;
  bool isLoggedIn() const;
  bool isSecure() const;
  const std::string& welcomeMessage();

可以看到，FTPClientSession提供的这些接口基本包含了所有的Ftp上传的需求。

以上三种方式都可以实现FTP的上传，但是这三种各有各的优缺点，本人在使用过程中遇到了各种各样的问题，这三种都有结合使用，那么，接下来整理一下这段时间在使用这三种方式的区别和优缺点。

三者区别

QFtp

首先来看QFtp，由于在Qt5中已经移除了该模块，所以如果要使用它的话就需要自己下载源码进行编译，还要解决各种编码问题，其实挺麻烦的。

优点：接口完整，而且使用方便，该有的接口都有

缺点：要自己编译源码，或者可以直接使用源码嵌入到项目中，然后要解决编码问题；对于异常处理不是太好，比如突然断网，收不到异常信号，也不会报错，甚至连接状态都不会改变，联网后不能继续上传，会一直假死，这种情况下处理异常就很不友好了，需要自己去解决这个问题。

QNetworkAccessManager

优点：简单，集成度高；对于异常的处理比较友好，比如断网后，会立马收到信号反馈，用户可以及时去处理剩下的任务，而且在超时时间内如果连接上网络后可以继续接着上一次的任务进行上传，这一点非常好，给开发省了不少事情。

缺点：太过于简单了，很多接口都没有，就只能做个上传下载，不能创建文件夹、删除文件等操作。

FTPClientSession

优点：使用简单，而且基本ftp的基本操作接口都有提供，对异常处理可以抛出异常，通过try catch进行捕捉，比如说删除不存在的文件夹、创建已存在的文件夹等，这些操作会直接导致程序崩溃退出，需要捕捉异常去处理；

缺点：没有提供上传下载进度的接口或回调，如果需要展示进度功能的话，就很麻烦了，需要自己计算上传了多少字节，还剩多少字节。对网络异常的处理也不是很友好，毕竟不能像Qt那样直接发信号通知。

另外，FTPClientSession可以通过beginList接口获取服务器上的文件列表，然后通过读取流的方式得到列表内容，但是如果文件名称中带有空格，那么获取到的文件名就会分开了，不是完整的文件名，比如，有个文件名叫 “abc 12 ed.mp3” ,通过流读取到的内容是 “abc” , “12” , “ed.mp3” ，这样读取文件列表就会有很大的问题了。而通过QFtp读取文件列表就是正常的。

还有一个非常重要的问题，FTP上传的数据有两种方式，一种是ASCII码上传，一种是通过二进制数据上传，这两种方式上传会影响上传后的文件大小，而据说QNetworkAccessManager 默认是通过二进制流上传，但是上传后文件大小变了，具体问题 可以看这里，就是因为上传方式导致的，而QNetworkAccessManager 是不能修改上传方式的，这个问题比较严重了。QFtp和FTPClientSession都提供了上传方式的修改，从这一点上来说，QNetworkAccessManager 就很不适合了。

就我个人使用这三种方式的经验来看，QFtp是比较更适合的，能够满足使用需求，不过需要自己处理一些异常情况。

本篇只是简单介绍这三种方式优缺点，接下来会在后期的文章中单独列举demo展示如何使用。以及在实际的代码中遇到的各种各样的坑。