freecplus框架-ftp客户端

红太狼 2023-07-19 05:51 32阅读 0赞

### 文章目录 ###

*  一、源代码说明
 *  二、概述
 *  三、Cftp类
 *  四、准备测试环境
 *   *  1、创建Linux操作系统用户
     *  2、安装配置ftp服务器
     *  3、配置防火墙
     *  4、准备测试的文件
 *  五、示例程序
 *   *  1、获取服务器文件列表、时间和大小
     *  2、把文件上传到服务器
     *  3、从服务器下载文件
 *  六、获取视频教程
 *  七、版权声明

# 一、源代码说明 #

freecplus是一个Linux系统下的C/C++开源框架，源代码请前往C语言技术网(www.freecplus.net)下载。

本文介绍的是freecplus框架的ftp客户端Cftp类。

Cftp类的声明文件是freecplus/\_ftp.h。

Cftp类的定义文件是freecplus/\_ftp.cpp。

示例程序位于freecplus/demo目录中。

编译规则文件是freecplus/demo/makefile。

Cftp类是在ftplib开源库的基础之上做了二次封装，ftplib开源库的头文件是freecplus/ftplib.h，函数定义文件是freecplus/ftplib.c。

ftplib是C代码，用gcc先编译成lib库文件后，再用g++和\_ftp.cpp以及目标文件一起编译。

# 二、概述 #

本文不会介绍ftp协议的基础知识和ftp命令，在阅读本文之前，您必须熟悉ftp协议和命令才能看懂本文的内容。

# 三、Cftp类 #

类的声明：

class Cftp
    { 
    public:
      netbuf *m_ftpconn;   // ftp连接句柄。
      unsigned int m_size; // 文件的大小，单位：字节。
      char m_mtime[21];    // 文件的修改时间，格式：yyyymmddhh24miss。
    
      // 以下三个成员变量用于存放login方法登录失败的原因。
      bool m_connectfailed;    // 连接失败。
      bool m_loginfailed;      // 登录失败，用户名和密码不正确，或没有登录权限。
      bool m_optionfailed;     // 设置传输模式失败。
    
      Cftp();  // 类的构造函数。
     ~Cftp();  // 类的析构函数。
    
      void initdata();   // 初始化m_size和m_mtime成员变量。
    
      // 登录ftp服务器。
      // host：ftp服务器ip地址和端口，中间用":"分隔，如"192.168.1.1:21"。
      // username：登录ftp服务器用户名。
      // password：登录ftp服务器的密码。
      // imode：传输模式，FTPLIB_PASSIVE是被动模式，FTPLIB_PORT是主动模式，缺省是被动模式。
      bool login(const char *host,const char *username,const char *password,const int imode=FTPLIB_PASSIVE);
      
      // 注销。
      bool logout();
    
      // 获取ftp服务器上文件的时间。
      // remotefilename：待获取的文件名。
      // 返回值：false-失败；true-成功，获取到的文件时间存放在m_mtime成员变量中。
      bool mtime(const char *remotefilename);
    
      // 获取ftp服务器上文件的大小。
      // remotefilename：待获取的文件名。
      // 返回值：false-失败；true-成功，获取到的文件大小存放在m_size成员变量中。
      bool size(const char *remotefilename);
    
      // 改变ftp服务器的当前工作目录。
      // remotedir：ftp服务器上的目录名。
      // 返回值：true-成功；false-失败。
      bool chdir(const char *remotedir);
    
      // 在ftp服务器上创建目录。
      // remotedir：ftp服务器上待创建的目录名。
      // 返回值：true-成功；false-失败。
      bool mkdir(const char *remotedir);
    
      // 删除ftp服务器上的目录。
      // remotedir：ftp服务器上待删除的目录名。
      // 返回值：true-成功；false-失败。
      bool rmdir(const char *remotedir);
    
      // 发送NLST命令列出ftp服务器的目录和文件名。
      // remotedir：ftp服务器的目录名。
      // listfilename：用于保存从服务器返回的目录和文件名列表。
      // 返回值：true-成功；false-失败。
      // 注意：如果列出的是ftp服务器当前目录，remotedir用"","*","."都可以，但是，不规范的ftp服务器可能有差别。
      bool nlist(const char *remotedir,const char *listfilename);
    
      // 从ftp服务器上获取文件。
      // remotefilename：待获取ftp服务器上的文件名。
      // localfilename：保存到本地的文件名。
      // bCheckMTime：文件传输完成后，是否核对远程文件传输前后的时间，保证文件的完整性。
      // 返回值：true-成功；false-失败。
      // 注意：文件在传输的过程中，采用临时文件命名的方法，即在localfilename后加".tmp"，在传输
      // 完成后才正式改为localfilename。
      bool get(const char *remotefilename,const char *localfilename,const bool bCheckMTime=true);
    
      // 向ftp服务器发送文件。
      // localfilename：本地待发送的文件名。
      // remotefilename：发送到ftp服务器上的文件名。
      // bCheckSize：文件传输完成后，是否核对本地文件和远程文件的大小，保证文件的完整性。
      // 返回值：true-成功；false-失败。
      // 注意：文件在传输的过程中，采用临时文件命名的方法，即在remotefilename后加".tmp"，在传输
      // 完成后才正式改为remotefilename。
      bool put(const char *localfilename,const char *remotefilename,const bool bCheckSize=true);
    
      // 删除ftp服务器上的文件。
      // remotefilename：待删除的ftp服务器上的文件名。
      // 返回值：true-成功；false-失败。
      bool ftpdelete(const char *remotefilename);
    
      // 重命名ftp服务器上的文件。
      // srcremotefilename：ftp服务器上的原文件名。
      // dstremotefilename：ftp服务器上的目标文件名。
      // 返回值：true-成功；false-失败。
      bool ftprename(const char *srcremotefilename,const char *dstremotefilename);
    
      /* 以下三个方法如果理解不了就算了，可以不启用。 */
      // 发送LIST命令列出ftp服务器目录中的文件。
      // 参数和返回值与nlist方法相同。
      bool dir(const char *remotedir,const char *listfilename);
    
      // 向ftp服务器发送site命令。
      // command：命令的内容。
      // 返回值：true-成功；false-失败。
      bool site(const char *command);
    
      // 获取服务器返回信息的最后一条(return a pointer to the last response received)。
      char *response();
    };

# 四、准备测试环境 #

在演示示例程序之前，我认为您已经是一个职业的C/C++程序员，熟悉Linux操作系统、熟悉ftp协议。

## 1、创建Linux操作系统用户 ##

创建freecplus用户，用户组为bin，用户根目录为/home/freecplus，密码为freecpluspwd

![在这里插入图片描述][20200306170149537.png]

## 2、安装配置ftp服务器 ##

具体操作请参考C语言技术网（www.freecplus.net）的相关文章，或在网上搜索相关的文章。

## 3、配置防火墙 ##

具体操作请参考C语言技术网（www.freecplus.net）的相关文章，或在网上搜索相关的文章。

## 4、准备测试的文件 ##

把freecplus框架的源代码复制到/home/freecplus目录，如下：

![在这里插入图片描述][20200306170209163.png]

# 五、示例程序 #

## 1、获取服务器文件列表、时间和大小 ##

**示例（demo50.cpp）**

/* * 程序名：demo50.cpp，此程序演示采用freecplus框架的Cftp类获取服务器文件列表、时间和大小。 * 作者：C语言技术网(www.freecplus.net) 日期：20190525 */
    #include "../_ftp.h"
    
    int main(int argc,char *argv[])
    { 
      Cftp ftp;
    
      // 登录远程FTP服务器，请改为您自己服务器的ip地址。
      if (ftp.login("172.16.0.15:21","freecplus","freecpluspwd",FTPLIB_PASSIVE) == false)
      { 
        printf("ftp.login(172.16.0.15:21(freecplus/freecpluspwd)) failed.\n"); return -1;
      }
    
      // 获取服务器上/home/freecplus/*.h文件列表，保存在本地的/tmp/list/tmp.list文件中。
      // 如果/tmp/list目录不存在，就创建它。
      if (ftp.nlist("/home/freecplus/*.h","/tmp/list/tmp.list")==false) 
      {  printf("ftp.nlist() failed.\n"); return -1; }
    
      CFile File;    // 采用freecplus框架的CFile类来操作list文件。
      char strFileName[301];
    
      File.Open("/tmp/list/tmp.list","r");  // 打开list文件。
    
      while(true)    // 获取每个文件的时间和大小。
      { 
        if (File.Fgets(strFileName,300,true)==false) break;
    
        ftp.mtime(strFileName); // 获取文件时间。
        ftp.size(strFileName);  // 获取文件大小。
      
        printf("filename=%s,mtime=%s,size=%d\n",strFileName,ftp.m_mtime,ftp.m_size);   
      }
    }

**运行效果**

![在这里插入图片描述][20200306170253376.png]

## 2、把文件上传到服务器 ##

**示例（demo51.cpp）**

/* * 程序名：demo51.cpp，此程序演示采用freecplus框架的Cftp类上传文件。 * 作者：C语言技术网(www.freecplus.net) 日期：20190525 */
    #include "../_ftp.h"
    
    int main(int argc,char *argv[])
    { 
      Cftp ftp;
    
      // 登录远程FTP服务器，请改为您自己服务器的ip地址。
      if (ftp.login("172.16.0.15:21","freecplus","freecpluspwd",FTPLIB_PASSIVE) == false)
      { 
        printf("ftp.login(172.16.0.15:21(freecplus/freecpluspwd)) failed.\n"); return -1;
      }
    
      // 在ftp服务器上创建/home/freecplus/tmp，注意，如果目录已存在，会返回失败。
      if (ftp.mkdir("/home/freecplus/tmp")==false) {  printf("ftp.mkdir() failed.\n"); return -1; }
      
      // 把ftp服务器上的工作目录切换到/home/freecplus/tmp
      if (ftp.chdir("/home/freecplus/tmp")==false) {  printf("ftp.chdir() failed.\n"); return -1; }
    
      // 把本地的demo51.cpp上传到ftp服务器的当前工作目录。
      ftp.put("demo51.cpp","demo51.cpp");
    
      // 如果不调用chdir切换工作目录，以下代码也可以直接上传文件。
      // ftp.put("demo51.cpp","/home/freecplus/tmp/demo51.cpp");
      
      printf("put demo51.cpp ok.\n");  
    }

## 3、从服务器下载文件 ##

**示例（demo52.cpp）**

/* * 程序名：demo52.cpp，此程序演示采用freecplus框架的Cftp类下载文件。 * 作者：C语言技术网(www.freecplus.net) 日期：20190525 */
    #include "../_ftp.h"
    
    int main(int argc,char *argv[])
    { 
      Cftp ftp;
    
      // 登录远程FTP服务器，请改为您自己服务器的ip地址。
      if (ftp.login("172.16.0.15:21","freecplus","freecpluspwd",FTPLIB_PASSIVE) == false)
      { 
        printf("ftp.login(172.16.0.15:21(freecplus/freecpluspwd)) failed.\n"); return -1;
      }
    
      // 把服务器上的/home/freecplus/tmp/demo51.cpp下载到本地，存为/tmp/test/demo51.cpp。
      // 如果本地的/tmp/test目录不存在，就创建它。
      if (ftp.get("/home/freecplus/tmp/demo51.cpp","/tmp/test/demo51.cpp")==false)
      {  printf("ftp.get() failed.\n"); return -1; }
    
      printf("get /home/freecplus/tmp/demo51.cpp ok.\n");  
    
      // 删除服务上的/home/freecplus/tmp/demo51.cpp文件。
      if (ftp.ftpdelete("/home/freecplus/tmp/demo51.cpp")==false) 
      {  printf("ftp.ftpdelete() failed.\n"); return -1; }
    
      printf("delete /home/freecplus/tmp/demo51.cpp ok.\n");  
    
      // 删除服务器上的/home/freecplus/tmp目录，如果目录非空，删除将失败。
      if (ftp.rmdir("/home/freecplus/tmp")==false) {  printf("ftp.rmdir() failed.\n");return -1; }
    }

# 六、获取视频教程 #

百万年薪程序员录制，《C/C++高性能服务开发基础》视频教程已在CSDN学院发布，优惠价12元，地址如下：  
[https://edu.csdn.net/course/play/29402][https_edu.csdn.net_course_play_29402]

C语言技术网原创文章，转载请说明文章的来源、作者和原文的链接。  
来源：C语言技术网（www.freecplus.net）  
作者：码农有道

如果文章有错别字，或者内容有错误，或其他的建议和意见，请您留言指正，非常感谢！！！

[20200306170149537.png]: /images/20230528/af730ed402034d6198406f655d9b827b.png
[20200306170209163.png]: /images/20230528/b56f8a35465e4c9cb1c863a5159c692f.png
[20200306170253376.png]: /images/20230528/ca770eb8945345e5a0349efabc337beb.png
[https_edu.csdn.net_course_play_29402]: https://edu.csdn.net/course/play/29402