linux课程设计ftp概要设计,Ftp客户端概要设计-CSDN博客

Ftp客户端概要设计

1.概述

ftp是基于TCP的文件传输协议，主要是用于控制远程文件，如下载、上传、续传、重命名、删除等。其命令是基于可见字符，易于理解的方式交互的。客户端与服务器端的交互遵循一应一答的方式，而且各命令间遵循一定的顺序。

FTP的应答原则：

a.所有应答都以3个数字开头以“\r\n”结束

b.一个应答的第4位如果为’-’，表示还有后续应答，说明一个命令对应了多个应答

c.对应一个命令的多个应答，其前面的3个数字一样

d.非命令的传输都需要开通另外的通道，并且事先需要说明是主动还是被动

FTP客户端需要实现的功能：

a.登录、退出

b.列出指定路径下的所有文件名称

c.下载文件

d.上传文件

e.续传文件(上传和下载)

f.创建目录

g.重命名文件

功能要求：

a.同时可以上传和下载多个文件，并不相互影响；

b.随时可以终止正在上传或下载的文件，并后续续传；

c.在上传和下载的过程中不影响其他命令的执行；

d.上传和下载文件可以显示进度信息

2.模块设计

根据概述中的说明，建立如下的模块关系：

DSC0000.jpg (10.95 KB, 下载次数: 1)

2016-6-8 11:31 上传

对外操作的接口最终转入控制实例中操作。对于外部传入的ftp基本信息(如服务器名、端口号、用户名密码等信息)需存入基本信息模块。操作模块依赖基本信息模块和传输控制模块。一个操作模块完成简单的一次操作，如列出文件列表、上传文件、下载文件。如果需要多个上传或者下载操作则创建多个操作模块。

控制实例的主要作用是：有效组织一个或多个操作模块。

3.接口设计

由于时间关系，这边实现概述中部分功能。

/**

* 设置当前字符集

bool SetCharset(char* charSet);

/**

* 登录ftp服务器

*@host 主机名称，IP地址或者域名

*@port ftp服务器端口，默认可以填21

*@userName ftp用户名，为NULL表示匿名登录

*@password 用户名对应的密码

*@return 登录成功返回true,否则返回false

bool Login(char* host,unsigned shortport,char* userName,char* password);

/**

* 退出ftp服务器,会中断所有传输操作

*@return 登录成功返回true,否则返回false

bool Logout();

/**

* 创建目录

*@dirPath 以'/'开头，必须为绝对路径

bool Mkdir(char* dirPath);

/**

* 将本地文件上传到服务器上

*@localFile 本地文件

*@remoteFile 服务器的文件(绝对路径)

*@callback 传输回调函数，参考FtpTransferCallback的定义

*@lpcontext 回调函数的上下文参数

*@return 返回控制句柄，通过该句柄可以终端传输等

int PutFile(char* localFile,char*remoteFile,FtpTransferCallback callback,LPVOID lpcontext);

/**

* 将内存中的数据上传到服务器上的文件中保存

*@buffer 内存中的数据

*@nLen 数据长度

*@remoteFile 服务器的文件(绝对路径)

*@callback 传输回调函数，参考FtpTransferCallback的定义

*@lpcontext 回调函数的上下文参数

*@return 返回控制句柄

int PutBuffer(BYTE* buffer,int nLen,char*remoteFile,FtpTransferCallback callback,LPVOID lpcontext);

/**

* 获取下载服务器上的文件

*@remoteFile 服务器上的路径(绝对路径)

*@localFile 本地文件路径

*@callback 传输回调函数，参考FtpTransferCallback的定义

*@lpcontext 回调函数的上下文参数

*@return 返回控制句柄

int GetFile(char* remoteFile,char*localFile,FtpTransferCallback callback,LPVOID lpcontext);

/**

* 下载服务器上的文件到指定的内存中

*@remoteFile 服务器上的文件(绝对路径)

*@buffer 指定的内存

*@nLen 可用的内存大小

*@callback 传输回调函数，参考FtpTransferCallback的定义

*@lpcontext 回调函数的上下文参数

*@return 返回控制句柄

int GetFileToBuffer(char* remoteFile,BYTE*buffer,int nLen,FtpTransferCallback callback,LPVOID lpcontext);

/**

* 在ftp服务器上查找相应的文件

*@findFile 需要查找的文件(绝对路径),查找绝对路径下的所有文件

*@return 成功返回查找到的文件个数

* 没有找到文件则返回0

int FindFile(char*findFile);

/**

* 获取下一个文件信息

*@lpFileInfo 文件属性

*@return 成功返回true,遍历完或失败返回false

bool NextFile(OUT LPFtpFileInfolpFileInfo);

附件1 FTP命令表：

命令描述

ABOR中断数据连接程序

ACCT 系统特权帐号

ALLO 为服务器上的文件存储器分配字节

APPE 添加文件到服务器同名文件

CDUP

CWD

DELE 删除服务器上的指定文件

HELP 返回指定命令信息

LIST 如果是文件名列出文件信息，如果是目录则列出文件列表

MODE 传输模式(S=流模式，B=块模式，C=压缩模式)

MKD 在服务器上建立指定目录

NLST 列出指定目录内容

NOOP无动作，除了来自服务器上的承认

PASS 系统登录密码

PASV请求服务器等待数据连接

PORT

IP 地址和两字节的端口 ID

PWD显示当前工作目录

QUIT从 FTP 服务器上退出登录

REIN重新初始化登录状态连接

REST 由特定偏移量重启文件传递

RETR 从服务器上找回(复制)文件

RMD 在服务器上删除指定目录

RNFR 对旧路径重命名

RNTO 对新路径重命名

SITE 由服务器提供的站点特殊参数

SIZE 获取服务器上文件的大小

SMNT 挂载指定文件结构

STAT 在当前程序或目录上返回信息

STOR 储存(复制)文件到服务器上

STOU 储存文件到服务器名称上

STRU 数据结构(F=文件，R=记录，P=页面)

SYST返回服务器使用的操作系统

TYPE 数据类型(A=ASCII，E=EBCDIC，I=binary)

USER >系统登录的用户名

附件2 FTP响应表：

响应代码解释说明

110新文件指示器上的重启标记

120服务器准备就绪的时间(分钟数)

125打开数据连接，开始传输

150打开连接

200成功

202命令没有执行

211系统状态回复

212目录状态回复

213文件状态回复

214帮助信息回复

215系统类型回复

220服务就绪

221退出网络

225打开数据连接

226结束数据连接

227进入被动模式(IP 地址、ID 端口)

230登录因特网

250文件行为完成

257路径名建立

331要求密码

332要求帐号

350文件行为暂停

421服务关闭

425无法打开数据连接

426结束连接

450文件不可用

451遇到本地错误

452磁盘空间不足

500无效命令

501错误参数

502命令没有执行

503错误指令序列

504无效命令参数

530未登录网络

532存储文件需要帐号

550文件不可用

551不知道的页类型

552超过存储分配

553文件名不允许　　作者:wjh_2010@163.com

如果需要动态库(共享库)请以邮件的方式联系作者。