文件服务器规划设计文档.docx

密级：公开
文件上传服务器
FUS〔file upload service〕
概要设计
项目编号
文档版本号
2011-12-19
归属部门
归属项目
编写人
窗口
情况二：弹出多项选择文件选择窗口
第三步：上传文件
该步骤为根据文件上传组件自动构造参数，将文件上传到FUS Server中。FUS Server接收到传来的文件信息和各种参数后，将文件转存到指定的Storage Server中，并将日志记录到数据库。
第四步：将文件上传后的路径返回到客户端
文件上传组件会把文件真实路径反馈到客户端。
【第五步：当需要人工裁剪时候才会遇到】
进入人工裁剪方式，人工裁剪完毕后继续走第三步和第四步。
典型应用场景如下列图所示：
文件上传组件的设计
文件上传组件为一组js脚本和css样式以及图片、html等的组合。该组件可被放入任何web应用系统中，作为文件上传的支持控件，它不受限于任何其他开发语言〔 、java 、php等〕，但必须基于以上。其目录结构例如如下列图所示
；其已整合了开源的基于jQuery的uploadify插件。：
FUSConfig类的定义，具体属性见下表3-1.
根据fusConfig来确定点击文件上传按钮后的处理情况。
构造与服务端需要的参数，并将文件提交到服务器。
动态显示文件上传进度。
如果需要人工裁剪，提供人工裁剪功能。
调用文件上传后的回调函数将文件真实路径反馈给客户端。
真对FCK有单独的处理过程。
表3-1 FUSConfig配置类的属性设定：
参数名
必须
取值范围
说明
1
serviceUrl
是
字符串
表示fus服务器文件上传请求url。例如：
://
2
appId
是
数值
表示是哪个应用在调用文件服务器的上传。
该值是通过本文档创建应用后所得的值。
3
divId
是
字符串
页面中的div元素id，该元素用来显示已上传的文件信息。
4
callback
是
字符串
表示回调函数名，即当文件上传完毕后，自动回调的函数名字。
5
auto
否
ture/false
true表示选择完文件后是否立即上传。false表示最后统一点击上传后才上传文件。
6
buttonImg
否
字符串
文件上传按钮的图片路径，假设无，则为默认图片。
7
buttonText
否
字符串
文件上传按钮的文字，假设无，则为默认文字——上传文件。
8
cancelImg
否
字符串
取消按钮上的背景图片路径。假设无，则为默认图片。
9
displayData
否
字符串
文件上传过程中的文字提示。
10
sizeLimit
否
数值
所上传的每个文件的最大byte数。
11
removeCompleted
否
ture/false
上传完毕后，显示已上传文件的div是否自动隐藏。
12
multi
否
ture/false
表示是否是一次上传多个文件；假设无该参数默认为false。
queueSizeLimit
否
数值
表示多文件上传时，允许本次上传的最多的文件数。
14
fileExt
否
字符串
允许上传的文件扩展名，多个扩展名之间用英文分号分割。例如：
'*.jpg;*.gif;*.png'
假设无该参数，表示文件类型无限制。
fileDesc
否
字符串
允许上传的文件扩展名在弹出窗口中的显示提示。例如：
'图片文件 (.JPG, .GIF, .PNG) '
15
manuCrop
否
ture/false
该参数只有在mult=false情况下才使用。表示单个图片是否需要人工裁剪，假设无该参数默认为false。
16
picZoom
否
ture/false
表示图片是否需要缩放处理〔按照指定的width和height来设置缩放后的图片大小〕，假设无该参数默认为false。假设有该参数，则同时必须有width和height参数〔可只有1个，假设只有一个，则另一个为等比例缩放〕。
17
maxWidth
否
数值
默认1280
该参数只有在manucrop =true情况下才使用。表示图片所裁剪的宽度像素数。
18
maxHeight
否
数值
默认960
该参数只有在manucrop =true情况下才使用。表示图片所裁剪的高度像素数。
19
thumSize