客户端设计说明书.doc

南 京 大 学 计算机科学与技术系计算机网络课程设计报告 Alien FTP的设计与实现 客户端设计说明书 完 成 人： 笪庆（061221015） 组 员 ： 笪庆（061221015） 方超（061221021） 单梦凡（061221016） 指导教师： 夏耐 2009年1月 目录 一、 概述 3 二、 开发目标 3 二、参考文档 3 三、开发工具和平台 4 四、测试工具 4 五、 程序结构 4 1）类定义 4 2）主要类接口 5 2.1 CAlienFTPClientDlg类 5 2.2 AlienFTPCmd类 6 3） 线程定义 6 五、 功能模块详细设计 7 1) 登陆 7 2） 退出 8 3） 列目录 8 4） 下载文件 9 5） 上传文件 10 6） 下载目录 11 7） 上传目录 12 8） 删除文件 12 9） 删除目录 12 10） 新建目录 13 11） 断点续传 13 12） 状态计算 14 六、 体会 14 附：实现结果 15 Alien FTP客户端设计说明书 笪庆 061221015 概述 客户端感觉上要比服务器端简单一些，其实不然。就我的开发体会而言，服务器端只要侦听21号端口，若有请求就打开控制通道，然后等待用户的命令做出相应的响应，并打开数据通道进行数据传输（目录列表或者文件），除了某些命令（例如USER和PASS），大部分的命令都是独立的，这就使得服务器端并不会存在复杂的有限状态机，特别是当我们并不需要实现其所有命令的时候（实际上我们实现了15条命令，具体见《协议说明书》）。而客户端则是根据功能需求向服务器端发出各种指令来完成的，但是一些稍复杂的功能，例如目录的下载（或上传），服务器端并不提供这条命令，但是我们可以通过发出一系列其服务器提供的命令的组合来达到这个效果，生成这个命令组合便是客户端需要做的事之一。这就有点像服务器提供少量“机器指令”，客户端则用这些少量的“机器指令”去“搭积木”来完成功能需求。除此之外，客户端还要提供更多的图形元素，例如本地和远程的文件目录列表等。 在我们这个客户端的设计中，我们共完成了登陆，退出，列目录，下载/上传文件，下载/上传目录，删除文件/目录，新建目录，断点续传以及传输过程中状态计算（比如下载速度，下载时间和剩余时间、传输进度百分比的计算等等）等功能，并通过多线程的方法使得整个软件不至于在下载或上传时出现由于某个函数的繁忙计算而导致界面“死掉”的情况。 由于我们是并行开发的，即我完成客户端，同时方超和单梦凡完成服务器端，所以我在开发时就没法用他们写的服务器端来进行测试。取而代之的是，我用了主流的FTP服务器端软件Serv-U来测试我写的客户端。 开发目标 设计并实现一个符合标准FTP协议规范的，拥有登陆，退出，列目录，下载/上传文件，下载/上传目录，删除文件/目录，新建目录，断点续传以及传输过程中状态计算等功能的FTP客户端软件。 二、参考文档 《协议说明书》（我们的前期文档） 《Visual C++ 6.0网络及Internet开发指南》 《Visual C++网络程序设计实例详解》 《Visual C++网络高级编程》 三、开发工具和平台 Visual C++ 6.0，在Windows XP SP3下开发。 之所以选择Visual C++，是因为我本身对于VC的图形界面编程较为熟悉，相对而言对于java的图形界面的编程不是很熟悉（虽然java是以网络应用见长的）。而不同的语言提供的socket接口又大体上差不多，所以我选择了VC来作为开发工具。 四、测试工具 Serv-U 6.3。 正如上文所说，我们是并行开发的，所以我的客户端只能通过连接现有的FTP服务端软件来测试，这里我选择了使用较广，操作方便的Serv-U。 程序结构 1）类定义 class specification CAlienFTPClientDlg 主对话框类，用于图形界面的处理，通过调用AlienFTPCmd类提供的函数实现与服务器的连接与交互。 AlienFTPCmd FTP命令处理类，该类主要负责实现功能需求的各种函数，供CAlienFTPClientDlg直接调用，同时也提供一些基本操作使CAlienFTPClientDlg可以通过这些操作的组合完成复杂的功能。 GetDirName 用于弹出对话框让用户输入待新建的目录的名称 RmdDialog 用于询问用户是否要删除一个远程的非空目录。 RestDialog 本