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

1、相片网上浏览、传输模块技术说明书1. 编写目的此需求规格说明书对“相片选择、上传”等功能，做了细致的用户需求分析，明确所要开发的软件应具有的功能、性能与界面，并在此基础上进一步提出概要设计说明书和完成后续设计与开发工作。本说明书的预期读者为外包承接方。2. 功能目标本次任务以RIA形式完成，可采用Flex或Silverlight等技术手段。采用如“.net 用户控件”等方式形成模块，由发包公司提供的.net Web 页面调用，从而实现相片浏览、上传下载相片到 FTP 服务器的功能。3. 性能要求3.1 文件传输在同样的网络或网段上，传输速度不低于QQ。3.2 断点续传相片文件上传、下载应具有断

2、点续传功能，即上一次如果未上传完成，再次指定上传相同文件，应从已传输文件的末尾部分开始传输。3.3 防火墙在FTP数据传输时，应不受到任何防火墙软件的影响，不出现被防火墙阻止的现象。4. 约束l 主流浏览器，如：IE、Firefox、Chrome、Opera 均可以正确使用。l 相片文件的传输（包括上传、下载），要求不经过Web服务器，直接由用户计算机传输到指定服务器上。l 最终成果能够与.net页面进行结合，供页面调用。如：封装成.net用户控件等方式。l 提供测试实例，便于测试，及对调用的指导。5. 缩略语和术语5.1 业务系统、业务页面发包公司使用 ASP.net 编写的 Web 页面或

3、功能。5.2 外包模块承接方编写的供业务页面调用的模块，即本次任务。6. 接口说明6.1 概述外包模块不直接参与业务，由用户触发，通过 .net Web 页面调用进行工作。完成“相片选择、预览（查看）”、“相片上传”、“相片下载”功能。职责和边界如下两图：图表 1 职责分配图图表 2 系统边界图各模块可以但不限于 .net 用户控件形式编写，所需类的组成及关系如下图（类名、属性名、方法名、事件名也可商讨决定）：图表 3 模块明细6.2 相片选择、查看（ClassFileOperator）6.2.1 作用在被Web页面调用后，批量选择、单独查看相片文件，如下两图所示：图表 4 选择相片图表 5

4、查看相片6.2.2 方法l SelectFiles：弹出打开对话框，可以选择一张或多张JPG格式的相片。l Preview：显示相片，占满自身的面积。6.2.3 事件l OnPreviewError：如果相片格式不正确，导致查看出错，触发此事件。6.3 相片上传（ClassFileUpload）6.3.1 作用将指定文件上传到指定位置。可能多次接收上传指令，每次接收指令后，不打断上一次的工作。图表 6 上传相片6.3.2 属性l Host：FTP主机名。l User：FTP用户名。l Password：User对应的密码。l FileInfo：要上传的文件集合，文件信息成员见UploadFil

5、eDataSetClass。6.3.3 方法l Upload：上传指定的文件到指定位置。6.3.4 事件l OnError：上传时如果发生错误，发生此事件。l OnProcess：上传进行中，当传输了一些数据以后，发生此事件，便于调用者获得用户控件的工作状态等信息。在上传过程中，多次产生此事件。l OnComplete：文件全部上传完成，发生此事件。6.3.5 界面草图图表 76.4 相片下载（ClassFileDownload）6.4.1 作用保持目录结构，将远程目录下载到客户本地计算机中。图表 8 下载相片6.4.2 属性l Host：FTP主机名。l User：FTP用户名。l Pass

6、word：User对应的密码。l FileInfo：要下载的文件集合，文件信息成员见DownloadFileDataSetClass。6.4.3 方法l Download：下载远程目录到（用户）本地计算机中。6.4.4 事件l OnError：下载时如果发生错误，发生此事件。l OnProcess：下载进行中，当传输了一些数据以后，发生此事件，便于调用者获得用户控件的工作状态等信息。l OnComplete：某批次（ID相同的所有文件）或全部上传完成时，发生此事件。6.4.5 界面草图请参见：图表6。6.5 上传相关文件信息（UploadFileDataSetClass）l ID：编号，多个文件拥有共同的编号。l HostDirectory：服务器上的路径，相片上传到此远程目录中，如：“Dir1Dir2”。l LocalFileName：（用户）本地要上传的文件名，如：“C:PicPAN10001.jpg”。l HostFileName：上传到远程目录中的文件，以此命名。l Status：上传状态。6.6 下载相关文件信息（DownloadFileDataSetClass）l ID：编号。l Ho