相片网上浏览传输模块技术说明书.doc

相片网上浏览、传输模块技术说明书 1. 编写目的 此需求规格说明书对“相片选择、上传”等功能，做了细致的用户需求分析，明确所要开发的软件应具有的功能、性能与界面，并在此基础上进一步提出概要设计说明书和完成后续设计与开发工作。本说明书的预期读者为外包承接方。 2. 功能目标 本次任务以RIA形式完成，可采用Flex或Silverlight等技术手段。采用如“.net 用户控件”等方式形成模块，由发包公司提供的.net Web 页面调用，从而实现相片浏览、上传下载相片到 FTP 服务器的功能。 3. 性能要求 3.1 文件传输 在同样的网络或网段上，传输速度不低于QQ。 3.2 断点续传 相片文件上传、下载应具有断点续传功能，即上一次如果未上传完成，再次指定上传相同文件，应从已传输文件的末尾部分开始传输。 3.3 防火墙 在FTP数据传输时，应不受到任何防火墙软件的影响，不出现被防火墙阻止的现象。 4. 约束 主流浏览器，如：IE、Firefox、Chrome、Opera 均可以正确使用。 相片文件的传输（包括上传、下载），要求不经过Web服务器，直接由用户计算机传输到指定服务器上。 最终成果能够与.net页面进行结合，供页面调用。如：封装成.net用户控件等方式。 提供测试实例，便于测试，及对调用的指导。 5. 缩略语和术语 5.1 业务系统、业务页面 发包公司使用 ASP.net 编写的 Web 页面或功能。 5.2 外包模块 承接方编写的供业务页面调用的模块，即本次任务。 接口说明 6.1 概述 外包模块不直接参与业务，由用户触发，通过 .net Web 页面调用进行工作。完成“相片选择、预览（查看）”、“相片上传”、“相片下载”功能。职责和边界如下两图： 图表 SEQ 图表 \* ARABIC 1 职责分配图 图表 SEQ 图表 \* ARABIC 2 系统边界图 各模块可以但不限于 .net 用户控件形式编写，所需类的组成及关系如下图（类名、属性名、方法名、事件名也可商讨决定）： 图表 SEQ 图表 \* ARABIC 3 模块明细 6.2 相片选择、查看（ClassFileOperator） 6.2.1 作用 在被Web页面调用后，批量选择、单独查看相片文件，如下两图所示： 图表 SEQ 图表 \* ARABIC 4 选择相片 图表 SEQ 图表 \* ARABIC 5 查看相片 6.2.2 方法 SelectFiles：弹出打开对话框，可以选择一张或多张JPG格式的相片。 Preview：显示相片，占满自身的面积。 6.2.3 事件 OnPreviewError：如果相片格式不正确，导致查看出错，触发此事件。 6.3 相片上传（ClassFileUpload） 6.3.1 作用 将指定文件上传到指定位置。可能多次接收上传指令，每次接收指令后，不打断上一次的工作。 图表 SEQ 图表 \* ARABIC 6 上传相片 6.3.2 属性 Host：FTP主机名。 User：FTP用户名。 Password：User对应的密码。 FileInfo：要上传的文件集合，文件信息成员见 UploadFileDataSetClass。 6.3.3 方法 Upload：上传指定的文件到指定位置。 6.3.4 事件 OnError：上传时如果发生错误，发生此事件。 OnProcess：上传进行中，当传输了一些数据以后，发生此事件，便于调用者获得用户控件的工作状态等信息。在上传过程中，多次产生此事件。 OnComplete：文件全部上传完成，发生此事件。 6.3.5 界面草图 图表 SEQ 图表 \* ARABIC 7 6.4 相片下载（ClassFileDownload） 6.4.1 作用 保持目录结构，将远程目录下载到客户本地计算机中。 图表 SEQ 图表 \* ARABIC 8 下载相片 6.4.2 属性 Host：FTP主机名。 User：FTP用户名。 Password：User对应的密码。 FileInfo：要下载的文件集合，文件信息成员见 DownloadFileDataSetClass。 6.4.3 方法 Download：下载远程目录到（用户）本地计算机中。 6.4.4 事件 OnError：下载时如果发生错误，发生此事件。 OnProcess：下载进行中，当传输了一些数据以后，发生此事件，便于调用者获得用户控件的工作状态等信息。 OnComplete：某批次（ID相同的所有文件）或全部上传完成时，发生此事件。 6.4.5 界面草图 请参见： 图表6。 6.5 上传相关文件信息（UploadFileDataSetClass） ID：编号，多个文件拥有共同的编号。 HostDirect